🎓 CWIE BRU — Co-op Supervision System

ระบบบริหารจัดการและนิเทศงานสหกิจศึกษา (Cooperative Education Management & Supervision System)
ระบบสำหรับบริหารจัดการและติดตามการฝึกงานสหกิจศึกษาของนักศึกษา ตั้งแต่การเลือกสถานประกอบการ การจัดสรรอาจารย์นิเทศ การวางแผนตารางนิเทศ การบันทึกผลและประเมินผล ไปจนถึงการคำนวณค่าใช้จ่ายในการนิเทศ

สถานะปัจจุบัน: เริ่มพัฒนาเฉพาะ UI ด้วย Mock Data ก่อน โดยยังไม่เชื่อม Backend หรือฐานข้อมูล ดูแนวทางที่ dosc/architecture.md

ระบบถูกออกแบบมาเพื่อรองรับ 3 บทบาทหลักตามกระบวนการสหกิจศึกษา:

• จัดการข้อมูล Master Data: เพิ่ม ลบ แก้ไข และสืบค้นข้อมูลนักศึกษา อาจารย์ และสถานประกอบการ
• นำเข้าและส่งออกข้อมูล: นำเข้า-ส่งออกข้อมูลนักศึกษาด้วยไฟล์ CSV และ Excel (.xlsx) พร้อมระบบตรวจสอบความถูกต้อง
• จัดการรอบสหกิจศึกษา: จัดการข้อมูลปีการศึกษา ภาคเรียน และเปิด-ปิดสถานะรอบสหกิจ
• จัดสรรพื้นที่และความรับผิดชอบ: กำหนดพื้นที่รับผิดชอบให้อาจารย์ตามภูมิภาค จังหวัด หรือสถานประกอบการ
• วางแผนและจัดตารางนิเทศ: คัดกรองนักศึกษาเพื่อสร้างและแก้ไขตารางนิเทศ (แบ่งเป็นการนิเทศครั้งที่ 1 และ 2)
• ระบบตรวจสอบเวลาชนกัน (Conflict Detection): ตรวจสอบตารางเวลาที่ซ้ำหรือชนกันของอาจารย์ นักศึกษา และสถานประกอบการ
• คำนวณค่าใช้จ่าย: บันทึกค่าเดินทาง ค่าที่พัก ค่าเบี้ยเลี้ยง/อาหาร และคำนวณสรุปยอดรวมค่าใช้จ่าย

• เข้าสู่ระบบ / ยืนยันตัวตน: ระบบเข้าสู่ระบบตามสิทธิ์อาจารย์
• ดูตารางนิเทศ: ดูตารางนิเทศที่ตนเองได้รับมอบหมาย แยกตามครั้งที่ 1 และ 2
• ดูข้อมูลนักศึกษาและสถานประกอบการ: ค้นหาและดูรายละเอียดนักศึกษาและสถานประกอบการที่ได้รับมอบหมาย
• อัปเดตสถานะการนิเทศ: บันทึกสถานะ (จัดตารางแล้ว, นิเทศเสร็จแล้ว, เลื่อน, ยกเลิก)
• บันทึกผลและข้อเสนอแนะ: บันทึกผลการนิเทศ ความก้าวหน้า และข้อเสนอแนะ
• ประเมินผล: ประเมินสมรรถนะนักศึกษา และประเมินสถานประกอบการหลังการนิเทศ

• เข้าสู่ระบบ / ยืนยันตัวตน: ระบบเข้าสู่ระบบสำหรับนักศึกษา
• ค้นหาและเลือกสถานประกอบการ: ค้นหา ดูข้อมูล และเลือกสถานประกอบการที่ต้องการไปปฏิบัติงาน
• ตรวจสอบผลการยืนยัน: ดูสถานประกอบการที่ได้รับการยืนยันเป็นสถานที่ฝึกงานของตนเอง
• ดูตารางนิเทศ: ดูตารางนิเทศของตนเอง (ครั้งที่นิเทศ วันที่ เวลา สถานประกอบการ และอาจารย์ผู้รับผิดชอบ)

ciwie-comsci/
├── app/
│   ├── assets/
│   │   └── css/main.css          # Tailwind CSS configuration
│   ├── components/               # UI Presentational Components
│   ├── composables/              # Business Logic & Shared State
│   ├── layouts/                  # Layouts (default, admin, student, etc.)
│   ├── pages/                    # File-based Routing
│   └── app.vue                   # Root Application Component
├── server/
│   ├── api/                      # Nitro API Endpoints
│   ├── middleware/               # Server-side Auth & RBAC Middleware
│   └── utils/                    # Server Utilities
├── prisma/
│   └── schema.prisma             # Deferred until the Backend phase
├── dosc/
│   ├── requirement.md            # Requirement Documentation
│   ├── architecture.md           # UI-first Architecture
│   └── ui-plan.md                # UI Checkpoints and Acceptance Plan
├── Dockerfile                    # Multi-stage Production Dockerfile
├── docker-compose.yml            # Legacy Backend scaffold; migrate as one unit later
├── nuxt.config.ts                # Nuxt Configuration
├── package.json
└── AGENTS.md                     # Coding Guidelines for AI & Developers

• Node.js: v20 หรือ v22+
• Package Manager: pnpm (แนะนำเวอร์ชัน 10 ขึ้นไป)
• ระยะ UI ยังไม่ต้องติดตั้งหรือเปิด Database

git clone https://github.com/jirayu-ct-dev/ciwie-comsci.git
cd ciwie-comsci
pnpm install

pnpm dev

เปิดเบราว์เซอร์และเข้าไปที่ http://localhost:3000

ระยะ UI ยังไม่เปิดใช้ Session, Prisma หรือเครื่องมือนำเข้าไฟล์ใน runtime Dependency เหล่านี้จะติดตั้งและตั้งค่าพร้อมกันเมื่อเริ่ม Checkpoint ที่เกี่ยวข้อง

ระยะ UI ให้รันด้วย pnpm dev เป็นหลัก หากใช้ Docker ให้ใช้ Compose project cowier-demo เพียงชุดเดียว: cowier-app ที่พอร์ต 3000 และ cowier-mysql ที่พอร์ต 3307 โดยฐานข้อมูลอยู่ใน volume cowier-demo_mysql_data อย่าเปิด dev server และ Docker app บนพอร์ต 3000 พร้อมกัน

docker compose config --quiet
docker compose up -d --build
docker compose ps
docker compose logs --tail 100 app
docker compose stop

ตั้งค่ารหัสผ่านใน .env ให้ตรงกับฐานข้อมูลเดิมก่อนเริ่ม Compose; การเปลี่ยน environment ไม่ได้เปลี่ยนรหัสผ่านใน volume ที่สร้างแล้ว ห้ามใช้ down -v หรือ volume prune หากต้องการเก็บข้อมูล API สมัครบริษัทยังเป็น mock ไม่ได้บันทึกลง MySQL แม้ database container จะทำงาน

หลัง cleanup วันที่ 2026-09-04 เก็บ volume ciwie-comsci_mysql_data ของชุดซ้ำไว้ เพื่อกู้ข้อมูล ไม่ได้รวมข้อมูลเข้าฐานหลัก ส่วน container ชุดซ้ำถูกลบแล้ว แอปพอร์ต 3000 เดิมยังทำงานโดยมี Compose label เก่า ciwie-comsci; การ deploy ครั้งถัดไปต้องหยุดและลบเฉพาะ cowier-app เดิมก่อน compose up เพื่อให้ Compose สร้าง label ที่ถูกต้อง (ข้อมูล mock ใน memory จะหายเมื่อ restart) ไม่ต้องลบ cowier-mysql หรือ volume ใด ๆ

# รัน Dev Server พร้อม Hot Module Replacement
pnpm dev

# ตรวจสอบและสร้าง Types
pnpm postinstall

# Build โปรเจกต์สำหรับ Production
pnpm build

# พรีวิว Production Build
pnpm preview

# Prisma validation/migration จะเริ่มใช้ในระยะ Backend

โปรเจกต์นี้พัฒนาขึ้นสำหรับระบบบริหารจัดการสหกิจศึกษา สงวนลิขสิทธิ์ตามข้อตกลงของสถาบัน/องค์กร