commit

docs/uat-seed-data-review.md

@@ -0,0 +1,100 @@
+# UAT Seed Data Review
+
+## 1. Records generated
+
+- Organization: ชุดข้อมูล UAT 2569 (`uat-2569`)
+- HRD owner account: `uat2569.hrd@training.local`
+- Employee password: `UAT12345!`
+- Employees: 50
+- Courses: 40
+- Training Records: 250
+- Announcements: 15
+- Notifications: 300
+- Audit Logs: 500
+- Training Policy Year: Thai 2569 (stored as Gregorian 2026)
+
+## 2. Distribution summary
+
+### Employee distribution by department
+
+- IT: 8 คน
+- Operations: 9 คน
+- HRD: 8 คน
+- Sales: 8 คน
+- Engineering: 9 คน
+- Accounting: 8 คน
+
+### Training record distribution by department
+
+- IT: 35 รายการ
+- HRD: 30 รายการ
+- Accounting: 35 รายการ
+- Sales: 45 รายการ
+- Engineering: 55 รายการ
+- Operations: 50 รายการ
+
+### Training status distribution
+
+- approved: 165 รายการ
+- pending: 49 รายการ
+- rejected: 36 รายการ
+
+### Approved K/S/A hours distribution
+
+- K: 431.0 ชั่วโมง
+- S: 285.0 ชั่วโมง
+- A: 181.0 ชั่วโมง
+
+### Monthly approved trend
+
+- 2026-01: 13 รายการอนุมัติ
+- 2026-02: 10 รายการอนุมัติ
+- 2026-03: 11 รายการอนุมัติ
+- 2026-04: 12 รายการอนุมัติ
+- 2026-05: 13 รายการอนุมัติ
+- 2026-06: 14 รายการอนุมัติ
+- 2026-07: 15 รายการอนุมัติ
+- 2026-08: 17 รายการอนุมัติ
+- 2026-09: 16 รายการอนุมัติ
+- 2026-10: 15 รายการอนุมัติ
+- 2026-11: 14 รายการอนุมัติ
+- 2026-12: 15 รายการอนุมัติ
+
+## 3. Dashboard validation
+
+The generated dataset was shaped to support meaningful dashboard output:
+
+- Department Ranking:
+  - multiple departments have approved-hour activity
+  - Engineering and Operations contain higher approved-hour volume
+- Course Ranking:
+  - repeated course usage creates stable top-course results
+  - expected top courses:
+- Project Management Fundamentals: 92.0 ชั่วโมง
+- การบริหารคลังสินค้าและรหัสสินค้า: 68.0 ชั่วโมง
+- Secure Coding Awareness: 49.0 ชั่วโมง
+- Root Cause Analysis: 49.0 ชั่วโมง
+- เทคนิคการเจรจาต่อรองการขาย: 42.0 ชั่วโมง
+- K/S/A Distribution:
+  - approved records include mixed K/S/A category coverage
+- Monthly Trend:
+  - approved records are spread across all 12 months of Thai year 2569
+
+## 4. Report validation
+
+The seed set supports report verification for:
+
+- employee-level training history
+- HRD organization-wide pending review visibility
+- approved vs pending vs rejected comparison
+- yearly filtering for Thai year 2569
+- course-level and department-level aggregation
+- notification center pagination and unread counts
+- audit log filtering by module and action
+
+## 5. Known limitations
+
+- Thai year 2569 is stored in the database as Gregorian year 2026 because application queries use Gregorian year boundaries
+- Seeded notifications and announcements include the [UAT2569] marker for easy identification during UAT
+- No certificate files are generated in this seed set
+- This script seeds a dedicated UAT organization and does not try to merge into existing business organizations