commit

plans/hrd-import-training-records.md

@@ -0,0 +1,58 @@
+## Import Training Records
+
+ในเมนู **ประวัติการอบรม** ฝั่ง Admin / Staff HRD / HRD ให้เพิ่มปุ่ม:
+
+- ดาวน์โหลด Template Excel
+- นำเข้าประวัติการอบรม
+
+## Workflow
+
+1. HRD กดดาวน์โหลด Template Excel
+2. HRD กรอกข้อมูลประวัติการอบรมของพนักงานหลายคน
+3. HRD กดนำเข้าประวัติการอบรม
+4. ระบบตรวจสอบข้อมูลในไฟล์
+5. หาก Import สำเร็จ ให้สร้าง Training Record ให้พนักงานโดยตรงเป็นสถานะ `Approved`
+
+## Permission
+
+ผู้ที่สามารถ Import ได้:
+
+- Admin
+- Staff HRD
+- HRD
+- HRD Manager
+- IT Admin
+- Super Admin
+
+Employee ไม่สามารถ Import ได้
+
+## Template Excel ควรมี Field
+
+- employee_code
+- course_name
+- training_date
+- training_type
+- location_type
+- hours
+- category
+- provider
+- note
+
+## Validation
+
+- employee_code ต้องมีอยู่ในระบบ
+- course_name ต้องไม่ว่าง
+- training_date ต้องเป็นวันที่ถูกต้อง
+- hours ต้องมากกว่า 0
+- category ต้องเป็น K, S หรือ A
+- หากมี Error ให้แสดงรายการแถวที่ผิดพลาด
+- Import สำเร็จเฉพาะแถวที่ผ่าน หรือใช้แนวทางทั้งไฟล์ต้องผ่านทั้งหมดก่อน Import ตามที่ระบบปัจจุบันรองรับ
+
+## Result
+
+หลัง Import สำเร็จ:
+
+- สร้าง Training Record ให้พนักงาน
+- Status = `Approved`
+- บันทึก Audit Log
+- แสดงจำนวนรายการที่สำเร็จ/ผิดพลาด