93 lines
5.2 KiB
Markdown
93 lines
5.2 KiB
Markdown
# Training Course Dropdown Review
|
|
|
|
## Summary
|
|
|
|
ปรับฟอร์ม Create/Edit Training Record ให้แสดงฟิลด์หลักสูตรเป็น dropdown ตามค่าเริ่มต้น และแสดงช่องกรอกชื่อหลักสูตรเองเฉพาะเมื่อผู้ใช้เลือก `อื่น ๆ` โดยยังคงบันทึก `courseName` ทุกครั้ง และบันทึก `courseId` เฉพาะกรณีเลือกจาก Course Master
|
|
|
|
## Files Changed
|
|
|
|
- `src/features/training-records/components/training-record-form.tsx`
|
|
- `src/features/training-records/components/training-record-course-combobox.tsx`
|
|
- `src/features/training-records/schemas/training-record.ts`
|
|
|
|
## UI Changes
|
|
|
|
- ฟิลด์ `ชื่อหลักสูตร *` แสดงเป็น dropdown/select แบบเต็มความกว้าง
|
|
- รายการหลักสูตรแสดงจาก Active Course Master
|
|
- ตัวเลือกสุดท้ายของ dropdown คือ `อื่น ๆ`
|
|
- เมื่อเลือก `อื่น ๆ` จะเปลี่ยนเป็น text input แบบเต็มความกว้าง
|
|
|
|
## Course Dropdown Behavior
|
|
|
|
- dropdown แสดงหลักสูตร active เท่านั้น
|
|
- รูปแบบการแสดงผล:
|
|
- ถ้ามี `courseCode` ใช้ `courseCode - courseName`
|
|
- ถ้าไม่มี `courseCode` ใช้ `courseName`
|
|
- เมื่อเลือกหลักสูตรจาก master:
|
|
- ตั้งค่า `courseId`
|
|
- ตั้งค่า `courseName`
|
|
- auto-fill `organizer` ถ้ามี
|
|
- auto-fill `hours` จาก `standard_hours` ถ้ามี
|
|
|
|
## Custom Course Behavior
|
|
|
|
- เมื่อเลือก `อื่น ๆ`
|
|
- ซ่อน dropdown
|
|
- แสดง input `ชื่อหลักสูตรอื่น ๆ *`
|
|
- ตั้งค่า `courseId = null`
|
|
- ใช้ค่าจาก input ไปบันทึกเป็น `courseName`
|
|
- มีปุ่ม `เปลี่ยนกลับไปเลือกจากหลักสูตร`
|
|
- ล้างชื่อหลักสูตร custom
|
|
- กลับไปแสดง dropdown
|
|
- เคลียร์ `courseId` และ `courseName`
|
|
|
|
## Edit Mode Behavior
|
|
|
|
- ถ้า record เดิมมี `courseId`
|
|
- เปิดมาด้วย dropdown ที่เลือกหลักสูตรเดิมไว้
|
|
- ถ้า record เดิมมี `courseId = null` และมี `courseName`
|
|
- เปิดมาด้วย text input ของ custom course
|
|
- แสดงชื่อหลักสูตรเดิมใน input
|
|
|
|
## Validation Rules
|
|
|
|
- ถ้าไม่ได้เลือก `อื่น ๆ`:
|
|
- ต้องเลือกหลักสูตรจาก dropdown
|
|
- แสดงข้อความ `กรุณาเลือกหลักสูตร`
|
|
- ถ้าเลือก `อื่น ๆ`:
|
|
- ต้องกรอกชื่อหลักสูตร
|
|
- แสดงข้อความ `กรุณากรอกชื่อหลักสูตร`
|
|
- ชั่วโมงอบรมต้องมากกว่า 0
|
|
- แสดงข้อความ `กรุณาระบุจำนวนชั่วโมงอบรม`
|
|
|
|
## Database Behavior
|
|
|
|
- บันทึก `courseName` ทุกครั้ง
|
|
- ถ้าเลือกจาก Course Master:
|
|
- บันทึก `courseId`
|
|
- ถ้าเลือก `อื่น ๆ`:
|
|
- บันทึก `courseId = null`
|
|
- ไม่มีการลบ field `courseName`
|
|
|
|
## Manual Test Checklist
|
|
|
|
- Create form shows course dropdown by default.
|
|
- Active Course Master records are shown in dropdown.
|
|
- "อื่น ๆ" appears as the last option.
|
|
- Selecting Course Master saves courseId and courseName.
|
|
- Selecting Course Master auto-fills provider if available.
|
|
- Selecting Course Master auto-fills hours if available.
|
|
- Selecting "อื่น ๆ" changes dropdown to text input.
|
|
- Custom course name is required when "อื่น ๆ" is selected.
|
|
- "เปลี่ยนกลับไปเลือกจากหลักสูตร" works.
|
|
- Edit existing master course shows dropdown selected.
|
|
- Edit existing custom course shows text input.
|
|
- HRD review page still shows course name correctly.
|
|
- Reports still show course name correctly.
|
|
- Mobile layout works.
|
|
|
|
## Known Limitations
|
|
|
|
- งานนี้ยังใช้ query course list เดิมและดึงมาชุดเดียวสำหรับ dropdown จึงยังไม่ได้เพิ่ม pagination หรือ server-side search
|
|
- หากมีหลักสูตรเดิมที่ถูกปิดใช้งานไปแล้ว แต่ record อ้างอิงอยู่ ระบบจะยังแสดงค่าที่เคยบันทึกได้ใน edit mode ผ่าน option ที่เติมเข้ามาชั่วคราว
|