260311:1638 20260311:1700 n8n workflow

specs/00-overview/00-03-product-vision.md

@@ -0,0 +1,183 @@
+# 🎯 Product Vision Statement — LCBP3-DMS v1.8.0
+
+---
+title: 'Product Vision Statement'
+version: 1.0.0
+status: APPROVED (Internal)
+owner: Nattanin Peancharoen (Product Owner)
+last_updated: 2026-03-11
+related:
+  - specs/00-Overview/README.md
+  - specs/01-Requirements/01-01-objectives.md
+  - specs/00-Overview/00-04-stakeholder-signoff-and-risk.md
+---
+
+---
+
+## 1. 🗣️ Elevator Pitch (30 วินาที)
+
+> **LCBP3-DMS** คือระบบบริหารจัดการเอกสารก่อสร้าง On-Premise ที่ออกแบบมาเพื่อโครงการท่าเรือแหลมฉบัง เฟส 3 โดยเฉพาะ
+>
+> ระบบแปลงกระบวนการอนุมัติเอกสาร RFA ที่เคยใช้เวลา 2–3 สัปดาห์ผ่านอีเมล ให้กลายเป็น Workflow อัตโนมัติที่โปร่งใส ตรวจสอบได้ และเสร็จสิ้นภายใน 3–5 วัน
+>
+> รองรับการทำงานร่วมกันของ 5 องค์กรใน 4 โครงการ ด้วยสิทธิ์การเข้าถึงข้อมูลระดับองค์กร ที่ปลอดภัย ไม่มีข้อมูลรั่วไหลข้ามองค์กร
+
+---
+
+## 2. ❗ Problem Statement
+
+### ปัญหาที่เกิดขึ้นจริง (Pain Points)
+
+| # | ปัญหา | ผลกระทบ |
+|---|------|---------|
+| P1 | **RFA ใช้ Email** → ตามงานยาก, ตกหล่น | Cycle Time 14–21 วัน, งานช้า |
+| P2 | **เลขเอกสารทำมือ** → ซ้ำ, ผิด | ต้องยกเลิกและออกเลขใหม่ |
+| P3 | **ไม่รู้สถานะ** → ต้องโทรถาม | เสียเวลา ≥ 30 นาที/ครั้ง |
+| P4 | **หลาย Version ใน Email** → งง | ใช้แบบเวอร์ชันเก่า ก่อสร้างผิด |
+| P5 | **ไม่มี Audit Trail** → ตรวจสอบยาก | พิสูจน์ไม่ได้ว่าใครอนุมัติ |
+| P6 | **ไม่มี Permission Control** → Contractor เห็นข้อมูลกัน | ความลับทางธุรกิจรั่ว |
+| P7 | **ไม่มีการแจ้งเตือน** → พลาด Deadline | งานเกินเวลา |
+| P8 | **ค้นหาเอกสารยาก** → ต้องขอซ้ำ | ทำงานซ้ำ เสียเวลา |
+
+### ผู้ที่ได้รับผลกระทบ
+
+- **Document Control:** ทำงานซ้ำซ้อน, นับเลขเอกสารมือ
+- **Engineers / Reviewers:** รับงาน Review ช้า ไม่รู้ว่ามีงานรอ
+- **PM / Supervisors:** ไม่มีภาพรวม Status ของเอกสารทั้งหมด
+- **Management:** ไม่สามารถตรวจสอบ Audit Trail ย้อนหลังได้
+
+---
+
+## 3. 🌟 Vision Statement
+
+> **"For construction document teams at LCBP3 who struggle with manual, email-based approval processes, LCBP3-DMS is an on-premise document intelligence platform that delivers automated multi-organization workflows, tamper-proof audit trails, and real-time visibility into every document's lifecycle.**
+>
+> **Unlike general-purpose DMS products, LCBP3-DMS is purpose-built for Thai construction project complexity — multi-contractor isolation, Thai document numbering conventions, and on-premise security requirements — making it the only system that truly fits how LCBP3 teams work."**
+
+### โดยย่อ (3 คำ)
+
+> **"Document. Approve. Trust."**
+
+---
+
+## 4. 🏛️ Strategic Pillars (3 เสาหลัก)
+
+### Pillar 1: ⚡ Speed & Automation
+
+ลด Cycle Time ของ RFA จาก 14 วัน → 3 วัน ด้วย:
+- Auto Document Number (Redis Redlock — ไม่ซ้ำ, ไม่ต้องนับมือ)
+- Workflow Automation (DSL-based — Route, Notify, Track อัตโนมัติ)
+- Instant Notification (Email + LINE + In-App — ไม่ต้องโทรถาม)
+
+### Pillar 2: 🔒 Security & Trust
+
+ไม่มีข้อมูลรั่วไหล ไม่มีการปลอมแปลง ด้วย:
+- 4-Level RBAC (Org Isolation — Contractor A ไม่เห็น Contractor B)
+- Immutable Audit Trail (ทุก Action บันทึก ≥ 7 ปี ไม่แก้ไขได้)
+- ClamAV Virus Scan ทุกไฟล์ + File Encryption at Rest
+- On-Premise Deployment (ข้อมูลไม่ออก Internet)
+
+### Pillar 3: 👁️ Visibility & Control
+
+ทุกคนรู้ว่าเอกสารอยู่ที่ไหน ใครถือ ครบด้วย:
+- Real-time Workflow Diagram (คลิกดู History ทุก Step)
+- Dashboard: My Tasks, Overdue, KPI Cards
+- Elasticsearch Full-text Search (ค้นหาได้ภายใน 500ms)
+- Graceful Degradation (Core ยังทำงานแม้ Service รองล่ม)
+
+---
+
+## 5. 👥 Target Users (Primary)
+
+| Persona | ต้องการอะไร | ได้อะไรจากระบบ |
+|---------|-----------|--------------|
+| **Document Control** | ออกเลข, ส่ง, Track เร็ว | Auto-Number + Workflow Dashboard |
+| **Engineer / Reviewer** | รับแจ้ง, Review ง่าย, Comment | Notification + PDF Viewer + History |
+| **PM / Supervisor** | เห็น Big Picture, ติดตาม Delay | Dashboard KPI + Overdue Alerts |
+| **Management / Auditor** | ตรวจสอบย้อนหลัง | Audit Log + Immutable History |
+| **กทท. (Owner)** | Compliance + Control | Permission Isolation + Reports |
+
+---
+
+## 6. 🗺️ Product Roadmap Vision
+
+```
+Now (v1.8.0 — MVP)
+├── Core DMS: Correspondence, RFA, Transmittal, Circulation
+├── Workflow Engine: DSL-based Multi-Org Approval
+├── Security: RBAC, Audit, ClamAV, JWT
+└── ✅ "Every document has a number, a trail, and a home"
+
+Phase 2 (3–6 เดือน) — Operational Excellence
+├── Advanced Reporting & Export (PDF/Excel)
+├── Visual Workflow Builder (No-code DSL Editor)
+├── LINE Notify Deep Integration (Approve via LINE)
+└── Mobile-Optimized Views
+
+Phase 3 (6–12 เดือน) — Intelligence
+├── AI-assisted Document Classification (Ollama)
+├── Predictive Delay Alerts ("RFA นี้มีโอกาส Delay 70%")
+├── Bulk Legacy Migration Assistant
+└── API Gateway สำหรับ Integration กับ ERP/Cost Systems
+
+Phase 4 (12–24 เดือน) — Enterprise Scale
+├── Multi-Project / Multi-Tenant Architecture
+├── SaaS Option (Cloud Deployment)
+└── ขยายไปใช้กับโครงการท่าเรืออื่นๆ ของ กทท.
+```
+
+---
+
+## 7. ✅ Definition of Success
+
+### MVP Success (Go-Live + 3 เดือน)
+
+| Metric | Target | วิธีวัด |
+|--------|--------|--------|
+| **RFA Cycle Time** | ≤ 5 วัน (จาก 14) | Average จาก Workflow History |
+| **User Adoption** | > 90% Login ทุกวันทำการ | System Analytics |
+| **Error Rate** | < 1% Document Number Error | Audit Log |
+| **Uptime** | ≥ 99.5% | Monitoring Dashboard |
+| **User Satisfaction** | ≥ 4.0/5.0 | Post Go-Live Survey |
+
+### Long-term Success (1 ปีหลัง Go-Live)
+
+> "ทีมไม่จำเป็นต้องส่ง Email เพื่อติดตามเอกสารอีกต่อไป"
+> "เลขเอกสารทุกฉบับถูกต้อง 100% โดยไม่ต้องมีคนนับ"
+> "การตรวจสอบ Audit สามารถทำได้ภายใน 5 นาที"
+
+---
+
+## 8. 🚫 What We Are NOT Building (Guardrails)
+
+การรู้ว่าเราไม่ทำอะไรสำคัญพอกับรู้ว่าเราทำอะไร:
+
+| ❌ ไม่ทำ | เหตุผล | ทางเลือก |
+|---------|-------|---------|
+| ระบบบัญชี / Finance | Out of Scope — ใช้ ERP | SAP / Oracle Integration (Phase 4) |
+| Project Scheduling (Gantt) | Domain ต่างกัน | Microsoft Project / Primavera |
+| HR / Payroll | ไม่เกี่ยวข้อง | ระบบ HR ที่มีอยู่ |
+| Mobile Native App | Phase 2+ | Web Responsive เพียงพอ ช่วงแรก |
+| Cloud SaaS | Data Sovereignty | On-Premise (ADR-005) |
+| AI Document Generation | Risk สูง ใน MVP | Phase 3 (Ollama) |
+| Real-time Video Conferencing | Out of Scope | Microsoft Teams / Zoom |
+
+---
+
+## 9. 📐 Design Principles
+
+1. **Security First** — ไม่มี Feature ไหนสำคัญกว่าความปลอดภัยของข้อมูล
+2. **Data Never Lies** — ทุก Action มี Audit Trail ไม่มีข้อยกเว้น
+3. **Fail Gracefully** — ถ้า Service รองล่ม Core ต้องทำงานต่อได้
+4. **Built for Thailand** — Thai language, Thai calendar, Thai org structure
+5. **On-Premise by Design** — ไม่ส่งข้อมูลออก Internet โดยไม่จำเป็น
+6. **Boring Technology** — ใช้เทคโนโลยีที่ Proven ไม่ใช่ Trendy
+
+---
+
+## 📝 Document Control
+
+- **Version:** 1.0.0 | **Status:** APPROVED (Internal)
+- **Created:** 2026-03-11 | **Owner:** Nattanin Peancharoen
+- **Approved By:** Nattanin Peancharoen (PO) | กทท. Sign-off pending
+- **Classification:** Internal Use Only

specs/00-overview/00-04-stakeholder-signoff-and-risk.md

@@ -0,0 +1,541 @@
+# 📋 Stakeholder Sign-off & Risk Management — LCBP3-DMS v1.8.0
+
+---
+title: 'Stakeholder Sign-off Process & Risk Register'
+version: 1.0.0
+status: DRAFT — Awaiting Stakeholder Review
+owner: Nattanin Peancharoen (Product Owner / System Architect)
+last_updated: 2026-03-11
+related:
+  - specs/01-Requirements/01-05-acceptance-criteria.md
+  - specs/01-Requirements/01-04-user-stories.md
+  - specs/00-Overview/00-06-training-plan.md
+  - specs/06-Decision-Records/ADR-016-security-authentication.md
+---
+
+> [!IMPORTANT]
+> เอกสารนี้ต้องได้รับการ **Sign-off จากตัวแทนทุกองค์กร** ก่อนที่ระบบจะ Go-Live สู่ Production  
+> การ Sign-off ถือเป็นการยืนยันว่าองค์กรรับทราบ Scope, Risks, และพร้อมรับผิดชอบ UAT ในส่วนของตน
+
+---
+
+## ส่วนที่ 1: Stakeholder Sign-off Process
+
+### 1.1 วัตถุประสงค์
+
+การ Sign-off Process ทำหน้าที่:
+1. **ยืนยัน Scope** — ทุกฝ่ายเห็นชอบ Feature ที่จะส่งมอบใน MVP
+2. **ยืนยัน UAT Criteria** — เห็นชอบเกณฑ์การพิจารณาว่า "ผ่าน" คืออะไร (อ้างอิง `01-05-acceptance-criteria.md`)
+3. **ยืนยัน Go-Live Readiness** — แต่ละองค์กรยืนยันว่าทีมพร้อม (Training, Data, User Access)
+4. **รับทราบ Risks** — รับทราบความเสี่ยงที่อาจเกิดขึ้น และ Mitigation Plan
+
+---
+
+### 1.2 Stakeholder Registry
+
+| # | Organization | บทบาทในโครงการ | บทบาทในระบบ DMS | ตัวแทน Sign-off |
+|---|-------------|--------------|----------------|----------------|
+| 1 | **กทท.** (การท่าเรือแห่งประเทศไทย) | Project Owner | System Owner, ผู้ใช้ระดับบน | TBD |
+| 2 | **สค.** (สำนักงานโครงการ) | Project Management | Org Admin, Document Control | TBD |
+| 3 | **TEAM** (ที่ปรึกษาออกแบบ) | Design Consultant | Document Control, Reviewer | TBD |
+| 4 | **คคง.** (คณะกรรมการตรวจงาน) | Construction Supervisor | Reviewer, Approver | TBD |
+| 5 | **ผรม.** (ผู้รับจ้างหลัก) | Main Contractor | Document Control, Submitter | TBD |
+| 6 | **NAP** (ผู้พัฒนาระบบ) | System Developer | Superadmin, Support | Nattanin P. |
+
+---
+
+### 1.3 Sign-off Workflow
+
+```
+Phase 1: Pre-Sign-off Review (T-3 สัปดาห์ก่อน Go-Live)
+┌─────────────────────────────────────────────────────────┐
+│  NAP ส่งร่างเอกสารนี้ให้ตัวแทนทุกองค์กรรีวิว            │
+│  + ส่ง Acceptance Criteria (01-05) ควบคู่               │
+│  + นัด Review Meeting (1 ชั่วโมง) กับทุกฝ่าย             │
+└─────────────────────────────────────────────────────────┘
+              ↓
+Phase 2: Clarification (T-2 สัปดาห์)
+┌─────────────────────────────────────────────────────────┐
+│  แต่ละองค์กรส่ง Comments / ข้อสงสัย กลับมา             │
+│  NAP ตอบและปรับปรุงเอกสาร (ถ้าจำเป็น)                  │
+│  ระบุ Open Issues และ Resolution                        │
+└─────────────────────────────────────────────────────────┘
+              ↓
+Phase 3: UAT (T-2 ถึง T-1 สัปดาห์)
+┌─────────────────────────────────────────────────────────┐
+│  แต่ละองค์กรทดสอบบน Staging ตาม AC Scenarios           │
+│  Internal Trainer นำทีมทำ Hands-on Scenario 1-3        │
+│  บันทึก Issues ใน Bug Tracker                           │
+└─────────────────────────────────────────────────────────┘
+              ↓
+Phase 4: Sign-off (T-1 สัปดาห์)
+┌─────────────────────────────────────────────────────────┐
+│  ทุก P0/P1 Issues ถูก Fix แล้ว                         │
+│  P2/P3 Issues มี Workaround หรือ Timeline Fix           │
+│  ตัวแทนแต่ละองค์กรลงนาม (Section 1.5)                  │
+└─────────────────────────────────────────────────────────┘
+              ↓
+Go-Live ✅
+```
+
+---
+
+### 1.4 Sign-off Criteria (เกณฑ์การอนุมัติ)
+
+**ต้องผ่านทั้งหมดก่อน Sign-off:**
+
+#### Functional Requirements
+- [ ] AC-AUTH-001~005 ผ่าน (Authentication)
+- [ ] AC-ADMIN-001~005 ผ่าน (User & Org Management)
+- [ ] AC-CORR-001~002 ผ่าน (Correspondence Core)
+- [ ] AC-RFA-001~003 ผ่าน (RFA Core)
+- [ ] AC-WF-001~003 ผ่าน (Workflow Engine)
+- [ ] AC-DN-001 ผ่าน (Document Number Concurrent)
+- [ ] AC-STOR-001 ผ่าน (File Storage + ClamAV)
+
+#### Security & Compliance
+- [ ] AC-SEC-001~005 ผ่าน (OWASP Top 10 Security)
+- [ ] AC-AUDIT-001 ผ่าน (Audit Log Coverage)
+- [ ] Penetration Test ผ่าน (Pre Go-Live)
+
+#### Performance
+- [ ] AC-PERF-001 ผ่าน (Response Time < 200ms P90)
+- [ ] AC-PERF-003 ผ่าน (Doc Number Concurrent Safe)
+
+#### Operations
+- [ ] AC-DATA-001 ผ่าน (Backup & DR Test)
+- [ ] Monitoring Stack ทำงาน (Grafana แสดง Metrics)
+- [ ] Alerting ตั้งค่าแล้ว (PagerDuty/Slack หรือ LINE)
+
+#### Readiness
+- [ ] Training ทุก Role เสร็จแล้ว (>90% Attendance)
+- [ ] User Accounts ทุกองค์กรสร้างแล้ว
+- [ ] Support LINE Group พร้อม
+- [ ] ไม่มี Open P0/P1 Issues
+
+---
+
+### 1.5 🖊️ Stakeholder Sign-off Table
+
+> **คำชี้แจง:** การลงนามในตารางนี้หมายถึง ตัวแทนองค์กรได้อ่าน รับทราบ และเห็นชอบกับ:
+> 1. Feature Scope ของ LCBP3-DMS v1.8.0 ตามที่อธิบายใน `specs/01-Requirements/`
+> 2. Acceptance Criteria ตามที่กำหนดใน `01-05-acceptance-criteria.md`
+> 3. Risk Register และ Mitigation Plan ในเอกสารนี้ (ส่วนที่ 2)
+> 4. ยืนยันว่าทีมงานขององค์กรได้รับการ Training และพร้อม Go-Live
+
+| Organization | ตัวแทน | ตำแหน่ง | ลายมือชื่อ | วันที่ | หมายเหตุ |
+|-------------|--------|---------|----------|-------|---------|
+| **กทท.** | | | | | |
+| **สค.** | | | | | |
+| **TEAM** | | | | | |
+| **คคง.** | | | | | |
+| **ผรม.** | | | | | |
+| **NAP** | Nattanin P. | System Architect | | | |
+
+**เงื่อนไข Go-Live:**
+- ต้องได้รับ Sign-off จากอย่างน้อย **4 จาก 5 องค์กร** (กทท., สค., TEAM, คคง./ผรม. อย่างน้อย 1)
+- กทท. **ต้องลงนาม** ในฐานะ Project Owner (Mandatory)
+- หาก < 4 ลายเซ็น → ต้องนัด Emergency Review ก่อน Go-Live
+
+---
+
+### 1.6 Open Issues Log (Pre Sign-off)
+
+> เพิ่ม Issues ที่พบระหว่าง UAT ที่นี่ ก่อน Sign-off
+
+| # | Issue | Priority | หน่วยงานที่พบ | Status | Resolution / Timeline |
+|---|-------|---------|--------------|--------|----------------------|
+| — | *ยังไม่มี Issue (UAT ยังไม่เริ่ม)* | — | — | — | — |
+
+---
+
+## ส่วนที่ 2: Risk Management
+
+### 2.1 Risk Assessment Matrix
+
+```
+           │  ผลกระทบ (Impact)
+           │  ต่ำ (1)   ปานกลาง (2)   สูง (3)   วิกฤต (4)
+───────────┼────────────────────────────────────────────────
+โอกาส  สูง │   🟡 M        🟠 H         🔴 C       🔴 C
+เกิด   กลาง│   🟢 L        🟡 M         🟠 H       🔴 C
+(Prob) ต่ำ │   🟢 L        🟢 L         🟡 M       🟠 H
+
+🔴 C = Critical  🟠 H = High  🟡 M = Medium  🟢 L = Low
+```
+
+| Level | Action Required |
+|-------|----------------|
+| 🔴 Critical | แก้ก่อน Go-Live — Blocker |
+| 🟠 High | ต้องมี Mitigation Plan ก่อน Go-Live |
+| 🟡 Medium | ต้องมี Contingency Plan |
+| 🟢 Low | Monitor + Document |
+
+---
+
+### 2.2 Risk Register
+
+#### 🔴 CRITICAL — ต้องแก้ก่อน Go-Live
+
+---
+
+**RISK-001: ผู้ใช้ปฏิเสธการเปลี่ยนแปลง (User Adoption Failure)**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | People / Change Management |
+| **Probability** | สูง (3) — คนที่คุ้นชิน Email มักต้านระบบใหม่ |
+| **Impact** | วิกฤต (4) — ระบบดีแค่ไหนก็ไร้ประโยชน์ถ้าคนไม่ใช้ |
+| **Level** | 🔴 Critical (3×4=12) |
+| **Trigger Signs** | Login Rate < 50% ในสัปดาห์แรก, Support Tickets > 30/วัน |
+
+**Mitigation (ก่อน Go-Live):**
+- Training ทุก Role ครบตาม `00-06-training-plan.md`
+- Train-the-Trainer ทุกองค์กร (Internal Champion)
+- Demo Session ก่อน Go-Live: แสดงว่าระบบช่วยลดงานจริง
+- ผู้บริหารทุกองค์กร Endorse การใช้ระบบใหม่อย่างเป็นทางการ
+
+**Contingency (ถ้าเกิดขึ้น):**
+- Hypercare Period: เพิ่ม NAP On-site Support 1 สัปดาห์แรก
+- "Buddy System": Internal Trainer นั่งข้างๆ User ใหม่ 2-3 วันแรก
+- Quick Win Campaign: รางวัล/การยอมรับสำหรับ "First 10 Submitters"
+
+**Owner:** Nattanin P. + Internal Trainers ทุกองค์กร
+
+---
+
+**RISK-002: Data Migration Legacy ผิดพลาดหรือล่าช้า**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Technical / Data |
+| **Probability** | สูง (3) — ข้อมูลเก่ามักมี Format ไม่สม่ำเสมอ |
+| **Impact** | สูง (3) — เอกสารเก่าหาย/ผิด → ความน่าเชื่อถือระบบลดลง |
+| **Level** | 🔴 Critical (3×3=9) |
+| **Trigger Signs** | Migration Error Rate > 5%, Duration > กำหนด + 2 สัปดาห์ |
+
+**Mitigation (ก่อน Go-Live):**
+- กำหนด Legacy Data Scope ที่ชัดเจน (ดู Gap 7): วันที่เริ่มต้น, ประเภทเอกสาร
+- Test Migration บน Staging ก่อน (Dry Run 3 รอบ)
+- Validation Script ตรวจ Record Count + Sample Check หลัง Migrate
+- เก็บ Legacy System ไว้ Read-only อย่างน้อย 3 เดือน
+
+**Contingency (ถ้าเกิดขึ้น):**
+- Rollback Plan: เปิด Legacy System กลับมา Operate แบบ Parallel
+- Manual Entry Team: กำหนดทีม Manual Key-in เอกสาร Critical ที่ Migrate ไม่ได้
+- Timeline Extension: เลื่อน Go-Live ได้สูงสุด 4 สัปดาห์ ถ้า Migration ล้มเหลว > 20%
+
+**Owner:** Nattanin P. (Migration Lead) + สค. (Data Provider)
+
+---
+
+**RISK-003: Security Breach / Unauthorized Access**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Security |
+| **Probability** | ต่ำ (1) — Internal Network, Authentication แข็ง |
+| **Impact** | วิกฤต (4) — ข้อมูลโครงการ Confidential รั่วไหล |
+| **Level** | 🟠 High (1×4=4) → **ยก Priority เพราะ Impact สูงมาก** |
+| **Trigger Signs** | Failed Login Spike, Unauthorized 403 Burst, File Access Anomaly |
+
+**Mitigation (ก่อน Go-Live):**
+- Penetration Test โดยทีมภายนอก ก่อน Go-Live
+- Security Checklist `ADR-016` ผ่านทั้งหมด
+- ClamAV Virus Scan ทุกไฟล์อัปโหลด
+- Network Isolation: Backend ไม่ expose ตรงสู่ Internet
+- JWT + CASL RBAC + Helmet.js + Rate Limiting ครบ
+
+**Contingency (ถ้าเกิดขึ้น):**
+- Incident Response Plan: ปิดระบบ + แจ้ง กทท. ภายใน 1 ชั่วโมง
+- Audit Log ทุก Access → ตรวจ Forensics ได้
+- Password Reset Force ทุก User ที่อาจได้รับผลกระทบ
+- แจ้ง DPA (PDPA Compliance) ถ้าข้อมูลส่วนบุคคลรั่วไหล
+
+**Owner:** Nattanin P. (Security) + กทท. IT (Infrastructure)
+
+---
+
+#### 🟠 HIGH — ต้องมี Mitigation Plan ก่อน Go-Live
+
+---
+
+**RISK-004: Infrastructure Downtime (QNAP / Docker)**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Infrastructure / Operations |
+| **Probability** | กลาง (2) — Hardware ล้มเหลวได้ |
+| **Impact** | สูง (3) — ระบบใช้งานไม่ได้ ส่งผลต่อ Deadline เอกสาร |
+| **Level** | 🟠 High (2×3=6) |
+| **Trigger Signs** | Uptime Alert < 99.5%, Container Crash, Disk Full |
+
+**Mitigation:**
+- Docker Health Check + Auto-restart Policy ทุก Container
+- Monitoring: Prometheus + Grafana Alerts (Slack/LINE)
+- Database Backup ทุกวัน (MariaDB Dump + Volume Snapshot)
+- RTO < 4 ชั่วโมง, RPO < 1 ชั่วโมง ตาม ADR-015
+
+**Contingency:**
+- ASUSTOR NAS พร้อม Rollover ถ้า QNAP ล้ม (Manual Process)
+- Runbook: `specs/04-Infrastructure-OPS/` สำหรับ Common Failure Scenarios
+- Emergency Contact: ทีม QNAP Support + NAP On-call
+
+**Owner:** Nattanin P. (DevOps) + กทท. IT (Hardware)
+
+---
+
+**RISK-005: Workflow DSL Configuration ผิดพลาด**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Technical / Configuration |
+| **Probability** | กลาง (2) — DSL ซับซ้อน, Config เยอะ |
+| **Impact** | สูง (3) — Workflow เดินผิด → เอกสารติดอยู่ในระบบ |
+| **Level** | 🟠 High (2×3=6) |
+| **Trigger Signs** | Workflow State ไม่เปลี่ยน, User ร้องเรียนว่า Approve ไม่ได้ |
+
+**Mitigation:**
+- UAT ทดสอบ Workflow ทุก Document Type จนครบ (ตาม AC-WF-001~006)
+- Force Proceed สำหรับ Document Control เป็น Safety Valve
+- Workflow DSL ถูก Version Control (Git) → Rollback ได้
+- Unit Test ครอบคลุม Transition ทุก State ใน DSL
+
+**Contingency:**
+- Force Proceed: Document Control ข้าม Step ที่ติดขัดได้ทันที
+- Admin สามารถ Edit Workflow Definition + Force Re-evaluate ได้
+- Hotfix Deploy ภายใน 24 ชั่วโมง สำหรับ Bug Priority P1
+
+**Owner:** Nattanin P. (Workflow Dev)
+
+---
+
+**RISK-006: Document Number Duplication (Race Condition)**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Technical / Data Integrity |
+| **Probability** | ต่ำ (1) — Redis Redlock + Optimistic Lock ป้องกัน |
+| **Impact** | วิกฤต (4) — เลขซ้ำทำให้ระบบไม่น่าเชื่อถือ |
+| **Level** | 🟠 High (1×4=4) |
+| **Trigger Signs** | Duplicate Key Error ใน Document Numbering Log |
+
+**Mitigation:**
+- Redis Redlock + DB Optimistic Locking (ADR-002)
+- Two-Phase Commit (Reserve → Confirm)
+- Load Test: 50 concurrent requests → Assert ไม่มี Duplicate (AC-PERF-003)
+- Unique Constraint ระดับ DB เป็น Last Resort
+
+**Contingency:**
+- DB Constraint ป้องกัน Record Duplicate จาก SQL Level
+- Audit Log บันทึกทุก Operation → ตรวจสอบและ Correct ได้
+- Admin API: Void + Re-issue เลขที่ผิดพลาด
+
+**Owner:** Nattanin P. (Backend Dev)
+
+---
+
+#### 🟡 MEDIUM — ต้องมี Contingency Plan
+
+---
+
+**RISK-007: Email / LINE Notification Delivery Failure**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Integration |
+| **Probability** | กลาง (2) — Email Server / LINE API อาจมีปัญหา |
+| **Impact** | ปานกลาง (2) — User ไม่รู้มีงาน → Delay |
+| **Level** | 🟡 Medium (2×2=4) |
+
+**Mitigation:** BullMQ Retry 3 ครั้ง + Dead Letter Queue + In-App Notification Fallback
+
+**Contingency:** ผู้ใช้ยังสามารถดู "My Tasks" บน Dashboard ได้โดยไม่ต้องรอ Notification
+
+**Owner:** Nattanin P.
+
+---
+
+**RISK-008: Search Index Out of Sync (Elasticsearch)**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Technical |
+| **Probability** | กลาง (2) — Index lag เกิดได้ |
+| **Impact** | ปานกลาง (2) — ค้นหาไม่เห็นเอกสารใหม่ชั่วคราว |
+| **Level** | 🟡 Medium (2×2=4) |
+
+**Mitigation:** Eventual Consistency — Index ทันที หลัง Document Submit (BullMQ Job)
+
+**Contingency:** Re-index ได้โดย Admin ผ่าน API; Filter-based search ยังใช้ได้แม้ ES ล่ม
+
+**Owner:** Nattanin P.
+
+---
+
+**RISK-009: Scope Creep จาก Stakeholders ระหว่าง UAT**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Project Management |
+| **Probability** | สูง (3) — UAT มักทำให้เห็น Feature ใหม่ที่อยาก |
+| **Impact** | ปานกลาง (2) — Delay Go-Live ถ้าไม่จัดการ |
+| **Level** | 🟡 Medium (3×2=6) |
+
+**Mitigation:**
+- ใช้ Acceptance Criteria (`01-05`) เป็น Scope Gate — ถ้าไม่อยู่ใน AC → Phase 2
+- Change Request Process: ทุก Change Request ต้องผ่าน PO Review ก่อน Accept
+- "Parking Lot" List สำหรับ Feature ที่ดีแต่ไม่ใช่ MVP
+
+**Contingency:**
+- Emergency Change: กรณีที่ Change มีผล Business Critical → PO + กทท. ตัดสิน
+- Timeline Extension: ≤ 2 สัปดาห์ สำหรับ Critical Change ที่ทุกฝ่ายเห็นชอบ
+
+**Owner:** Nattanin P. (PO)
+
+---
+
+**RISK-010: Third-party Service Dependency (ClamAV / Redis / Elasticsearch)**
+
+| Attribute | Detail |
+|-----------|--------|
+| **Category** | Technical / Infrastructure |
+| **Probability** | ต่ำ (1) — On-Premise, ไม่ขึ้น Internet |
+| **Impact** | สูง (3) — ระบบส่วนหนึ่งหยุดทำงาน |
+| **Level** | 🟡 Medium (1×3=3) |
+
+**Mitigation:** Circuit Breaker Pattern — ถ้า Service รอง (Search, Notification) ล่ม → Core CRUD ทำงานต่อ (Graceful Degradation)
+
+**Contingency:** Runbook สำหรับ Restart แต่ละ Container แยกกัน
+
+**Owner:** Nattanin P.
+
+---
+
+#### 🟢 LOW — Monitor & Document
+
+| Risk | Description | Owner |
+|------|-------------|-------|
+| **RISK-011** | ClamAV False Positive — ปฏิเสธไฟล์ปกติ | Nattanin (Whitelist Update) |
+| **RISK-012** | Browser Compatibility — ระบบไม่ทำงานบน IE/Old Safari | Nattanin (Modern Browser Policy) |
+| **RISK-013** | Large File Upload Timeout (>100MB) | Nattanin (Nginx Timeout Config) |
+| **RISK-014** | User กรอกข้อมูลผิด Format แล้วเข้าใจผิดว่าระบบ Bug | Training (FAQ ข้อที่พบบ่อย) |
+| **RISK-015** | Monitoring Stack (Grafana) ล่มทำให้ไม่เห็น Metrics | Nattanin (Alert ผ่าน Uptime Kuma) |
+
+---
+
+### 2.3 Risk Summary Dashboard
+
+| Risk ID | Description | Level | Owner | Status |
+|---------|-------------|-------|-------|--------|
+| RISK-001 | User Adoption Failure | 🔴 Critical | NAP + Trainers | 🔄 Mitigating |
+| RISK-002 | Data Migration Error | 🔴 Critical | NAP + สค. | 🔄 Mitigating |
+| RISK-003 | Security Breach | 🔴 Critical→🟠 High | NAP + กทท. IT | 🔄 Mitigating |
+| RISK-004 | Infrastructure Downtime | 🟠 High | NAP + กทท. IT | 🔄 Mitigating |
+| RISK-005 | Workflow Config Error | 🟠 High | NAP | ✅ AC Test Coverage |
+| RISK-006 | Doc Number Duplicate | 🟠 High | NAP | ✅ Load Test + DB Constraint |
+| RISK-007 | Notification Failure | 🟡 Medium | NAP | ✅ BullMQ Retry + Fallback |
+| RISK-008 | ES Index Out of Sync | 🟡 Medium | NAP | ✅ Eventual Consistency |
+| RISK-009 | Scope Creep | 🟡 Medium | NAP (PO) | 🔄 AC as Gate |
+| RISK-010 | 3rd Party Service Failure | 🟡 Medium | NAP | ✅ Graceful Degradation |
+| RISK-011~015 | Low Risks (5 items) | 🟢 Low | NAP | 📋 Documented |
+
+---
+
+### 2.4 Risk Response Timeline
+
+```
+ปัจจุบัน → T-4 สัปดาห์ (Pre-UAT):
+  ├── RISK-001: Train-the-Trainer เสร็จ
+  ├── RISK-002: Migration Dry Run ครั้งที่ 1 เสร็จ
+  ├── RISK-003: Penetration Test เริ่ม
+  └── RISK-005: Workflow UAT เริ่ม
+
+T-3 → T-2 สัปดาห์ (UAT):
+  ├── RISK-003: PenTest Report ได้รับ + Fix
+  ├── RISK-002: Migration Dry Run ครั้งที่ 2 เสร็จ
+  ├── RISK-006: Load Test 50 Concurrent เสร็จ
+  └── RISK-009: Scope Creep — PO ตัดสิน In/Out
+
+T-1 สัปดาห์ (Pre Go-Live):
+  ├── RISK-001: Training ครบทุก Group
+  ├── RISK-004: DR Test (Backup Restore) เสร็จ
+  └── Sign-off ทุกองค์กร (Section 1.5)
+
+Go-Live:
+  └── RISK-001~010: Active Monitoring (Hypercare)
+```
+
+---
+
+## ส่วนที่ 3: Change Control Process
+
+### 3.1 Change Request Types
+
+| Type | ตัวอย่าง | ผู้อนุมัติ | Timeline |
+|------|---------|----------|---------|
+| **Emergency Fix** | Security Bug, System Down | NAP PO + กทท. | < 4 ชั่วโมง |
+| **Critical Change** | Business Rule ผิดพลาด Critical | NAP PO + 2 Stakeholders | < 2 วัน |
+| **Standard Change** | UI Improvement, Minor Feature | NAP PO | Sprint (2 สัปดาห์) |
+| **Phase Change** | Feature ใหม่นอก MVP Scope | NAP PO + ทุกองค์กร | Phase 2 Planning |
+
+### 3.2 Change Request Form (Template)
+
+```markdown
+## Change Request #[CR-XXX]
+
+**วันที่:** 
+**ผู้ขอ:** 
+**Organization:** 
+**Priority:** Emergency / Critical / Standard
+
+### คำอธิบาย
+[อธิบายการเปลี่ยนแปลงที่ต้องการ]
+
+### เหตุผลธุรกิจ
+[ทำไมต้องเปลี่ยน? ผลกระทบถ้าไม่เปลี่ยน?]
+
+### Acceptance Criteria ของ Change นี้
+[เกณฑ์การ "Done" ของ Change นี้]
+
+### Impact Assessment
+- ผลกระทบต่อ Features อื่น: 
+- ผลกระทบต่อ Timeline:
+- RP&DO (Risk): 
+
+### Decision
+- [ ] Approved → Sprint: ___
+- [ ] Deferred → Phase: ___
+- [ ] Rejected → เหตุผล: ___
+
+**Approved by:** _______________ Date: ___________
+```
+
+---
+
+## ส่วนที่ 4: Escalation Path
+
+```
+ปัญหา Operational ทั่วไป
+  ↓ User (Internal Trainer / Org Admin)
+  ↓ ไม่แก้ได้ใน 4 ชั่วโมง
+NAP Support (Nattanin) — LINE / Email
+  ↓ ไม่แก้ได้ใน 24 ชั่วโมง (P1) หรือ 48 ชั่วโมง (P2)
+Project Management Level (สค. + กทท.)
+  ↓ ไม่แก้ได้ใน 72 ชั่วโมง หรือ กระทบ Milestone
+Executive Level (ผู้บริหาร กทท.)
+  Decision: Emergency Fix / Rollback / Scope Change
+```
+
+---
+
+## 📝 Document Control
+
+- **Version:** 1.0.0 | **Status:** DRAFT — Awaiting Stakeholder Review
+- **Created:** 2026-03-11 | **Owner:** Nattanin Peancharoen (PO)
+- **Next Review:** T-4 สัปดาห์ก่อน Go-Live (Pre-UAT Review Meeting)
+- **Classification:** Confidential — ส่งเฉพาะตัวแทนที่ Sign-off เท่านั้น
+
+> [!NOTE]
+> เมื่อได้รับลายมือชื่อครบทุกองค์กร ให้ Scan และบันทึกฉบับ PDF ไว้ใน  
+> `specs/00-Overview/signed/00-04-stakeholder-signoff-SIGNED.pdf`

specs/00-overview/00-05-kpi-baseline.md

@@ -0,0 +1,564 @@
+# 📊 KPI Baseline Data & Measurement Plan — LCBP3-DMS v1.8.0
+
+---
+title: 'KPI Baseline Data, Measurement Methodology, and Success Tracking'
+version: 1.0.0
+status: DRAFT — Baseline Collection Pending
+owner: Nattanin Peancharoen (Product Owner)
+last_updated: 2026-03-11
+related:
+  - specs/00-Overview/00-03-product-vision.md
+  - specs/00-Overview/README.md
+  - specs/01-Requirements/01-05-acceptance-criteria.md
+  - specs/00-Overview/00-04-stakeholder-signoff-and-risk.md
+---
+
+> [!IMPORTANT]
+> **ต้องเก็บข้อมูล Baseline (As-Is State) ก่อน Go-Live อย่างน้อย T-2 สัปดาห์**  
+> ข้อมูล Baseline คือ "ตัวเลขก่อนระบบ" — ใช้เปรียบเทียบหลัง Go-Live เพื่อพิสูจน์ Value ของระบบ
+
+---
+
+## 1. 🎯 KPI Framework Overview
+
+```
+Business Goal → Success Metric → KPI → Baseline → Target → Measurement Method
+```
+
+### Category ของ KPIs
+
+| Category | วัดอะไร | Primary Audience |
+|----------|--------|----------------|
+| **Efficiency** | ลดเวลาและลดงานซ้ำซ้อน | PM, ผู้บริหาร |
+| **Data Quality** | ความถูกต้องและสมบูรณ์ของข้อมูล | Document Control |
+| **Adoption** | การใช้งานระบบจริง | PO, IT |
+| **System Performance** | ความเสถียรและความเร็ว | Dev, IT |
+| **User Satisfaction** | ความพึงพอใจของผู้ใช้ | PO, Management |
+| **Security/Compliance** | ความปลอดภัยและการตรวจสอบ | กทท., Auditor |
+
+---
+
+## 2. 📋 KPI Register พร้อม Baseline
+
+### KPI-EFF-001: RFA Cycle Time (วัฏจักรอนุมัติ)
+**Category:** Efficiency | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | เวลาเฉลี่ยตั้งแต่ Contractor ส่ง RFA จนถึงได้รับคำตอบสุดท้าย |
+| **หน่วย** | วัน (Calendar Days) |
+| **Baseline (As-Is)** | 📋 **รอเก็บข้อมูล** — ประมาณ 14–21 วัน (จาก Email เดิม) |
+| **Target (Month 1)** | ≤ 7 วัน |
+| **Target (Month 3)** | ≤ 5 วัน |
+| **Target (Month 6)** | ≤ 3 วัน |
+| **วิธีเก็บ Baseline** | Analyze Email Thread: วัน Submit Email → วัน Reply สุดท้าย (30 RFAs ล่าสุด) |
+| **วิธีวัดหลัง Go-Live** | `SELECT AVG(DATEDIFF(closed_date, submitted_date)) FROM workflow_instances WHERE type='RFA' AND status='CLOSED'` |
+| **Frequency** | Monthly Report |
+| **Owner** | PO + สค. (Data Collection) |
+
+**ข้อมูล Baseline ที่ต้องเก็บ:**
+```
+แบบฟอร์ม Baseline RFA:
+- เลขที่ RFA (เดิม):
+- วันที่ส่ง (Email):
+- วันที่ได้รับคำตอบ:
+- ระยะเวลา (วัน):
+- ผลลัพธ์: Approved / AW Comments / Rejected
+- องค์กรที่ส่ง:
+- Discipline:
+```
+
+---
+
+### KPI-EFF-002: Document Number Error Rate
+**Category:** Efficiency + Data Quality | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | % ของเลขเอกสารที่ผิดพลาด (ซ้ำ, ผิด Format, ต้องยกเลิกและออกใหม่) |
+| **หน่วย** | % จากเอกสารทั้งหมดที่ออกในเดือนนั้น |
+| **Baseline (As-Is)** | 📋 **รอเก็บข้อมูล** — ประมาณ 5–15% (จากการนับมือ) |
+| **Target** | 0% (Zero Tolerance — ระบบ Auto-Number) |
+| **วิธีเก็บ Baseline** | สัมภาษณ์ Document Control แต่ละองค์กร + นับจากเอกสาร 3 เดือนล่าสุด |
+| **วิธีวัดหลัง Go-Live** | Count `document_number_reservations.status = 'CANCELLED'` / Total Issued |
+| **Frequency** | Monthly |
+| **Owner** | Document Control (Baseline) + System (Auto-measure) |
+
+---
+
+### KPI-EFF-003: Time to Find Document (ค้นหาเอกสาร)
+**Category:** Efficiency | **Priority:** 🟠 High
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | เวลาเฉลี่ยที่ใช้ค้นหาเอกสารที่ต้องการ |
+| **หน่วย** | นาที |
+| **Baseline (As-Is)** | 📋 **รอเก็บข้อมูล** — ประมาณ 15–30 นาที (ผ่าน Email/Drive แบบเดิม) |
+| **Target** | < 1 นาที (ผ่าน Elasticsearch) |
+| **วิธีเก็บ Baseline** | User Survey + Observation: จับเวลาค้นหาเอกสาร 5 ครั้ง × 5 User |
+| **วิธีวัดหลัง Go-Live** | Search Response Time จาก Elasticsearch API Metrics + User Survey |
+| **Frequency** | Quarterly Survey + Continuous System Metric |
+| **Owner** | PO |
+
+---
+
+### KPI-EFF-004: Manual Follow-up Calls Reduction
+**Category:** Efficiency | **Priority:** 🟠 High
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | จำนวนครั้งที่ต้องโทร/Line เพื่อถามสถานะเอกสารต่อสัปดาห์ |
+| **หน่วย** | ครั้ง/สัปดาห์ (per Document Control) |
+| **Baseline (As-Is)** | 📋 **รอเก็บข้อมูล** — บันทึก 2 สัปดาห์ก่อน Go-Live |
+| **Target** | ลดลง > 80% (Real-time tracking ช่วย) |
+| **วิธีเก็บ Baseline** | Document Control บันทึกจำนวน Follow-up Calls ต่อวัน 2 สัปดาห์ก่อน Go-Live |
+| **วิธีวัดหลัง Go-Live** | Survey (Month 1, Month 3): "สัปดาห์ที่ผ่านมาโทรถามสถานะเอกสารกี่ครั้ง?" |
+| **Frequency** | Monthly Survey |
+| **Owner** | PO + Document Control |
+
+---
+
+### KPI-ADOPT-001: User Adoption Rate (Login Rate)
+**Category:** Adoption | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | % ของ Active Users ที่ Login เข้าระบบอย่างน้อย 1 ครั้ง/วัน |
+| **หน่วย** | % จาก Total Active User Accounts |
+| **Baseline** | N/A (ระบบใหม่ — ไม่มี Baseline) |
+| **Target Week 1** | > 50% |
+| **Target Month 1** | > 70% |
+| **Target Month 3** | > 90% |
+| **วิธีวัด** | `SELECT COUNT(DISTINCT user_id) / total_users FROM audit_logs WHERE action='USER_LOGIN' AND created_at >= today-1` |
+| **Dashboard** | Grafana Panel: "Daily Active Users" |
+| **Frequency** | Daily (Hypercare) → Weekly (Month 2+) |
+| **Owner** | PO + IT |
+
+---
+
+### KPI-ADOPT-002: Feature Adoption Rate (Core Workflows)
+**Category:** Adoption | **Priority:** 🟠 High
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | % ของ Active Users ที่ใช้ Core Feature จริง (ไม่ใช่แค่ Login) |
+| **หน่วย** | % |
+| **Target Month 1** | > 50% ใช้ Dashboard + Search |
+| **Target Month 3** | > 80% ใช้ Workflow (Submit/Approve อย่างน้อย 1 ครั้ง) |
+| **วิธีวัด** | Audit Log Analysis: count unique users ที่มี action = 'DOCUMENT_SUBMITTED' หรือ 'WORKFLOW_TRANSITION' |
+| **Frequency** | Monthly |
+| **Owner** | PO |
+
+---
+
+### KPI-ADOPT-003: Support Ticket Volume Trend
+**Category:** Adoption | **Priority:** 🟠 High
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | จำนวน Support Tickets ต่อสัปดาห์ (Trend ลดลง = ระบบ Usable มากขึ้น) |
+| **หน่วย** | Tickets/สัปดาห์ |
+| **Baseline** | N/A |
+| **Target Week 1** | < 30 tickets (Hypercare acceptable) |
+| **Target Month 1** | < 15 tickets |
+| **Target Month 3** | < 5 tickets |
+| **วิธีวัด** | LINE Group message count (manual) หรือ Helpdesk ticketing tool ถ้ามี |
+| **Frequency** | Weekly |
+| **Owner** | NAP Support |
+
+---
+
+### KPI-PERF-001: API Response Time (P90)
+**Category:** System Performance | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | 90th Percentile response time ของ API requests ทั้งหมด |
+| **หน่วย** | Milliseconds |
+| **Target** | < 200ms (P90) ตาม AC-PERF-001 |
+| **Alert Threshold** | > 500ms ต่อเนื่อง 5 นาที → Alert |
+| **Critical** | > 1000ms ต่อเนื่อง 1 นาที → PagerDuty |
+| **วิธีวัด** | Prometheus + Grafana: `histogram_quantile(0.9, rate(http_request_duration_seconds_bucket[5m]))` |
+| **Frequency** | Continuous (Real-time dashboard) |
+| **Owner** | NAP Dev |
+
+---
+
+### KPI-PERF-002: System Uptime
+**Category:** System Performance | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | % ของเวลาที่ระบบพร้อมใช้งาน (ในเวลาทำงาน 08:00-18:00) |
+| **หน่วย** | % |
+| **Target** | ≥ 99.5% (ตาม ADR-015) |
+| **คำนวณ** | ≥ 99.5% = Downtime ≤ 2.16 ชม./เดือน |
+| **วิธีวัด** | Uptime Kuma + Prometheus: Health Check Endpoint | 
+| **Frequency** | Real-time + Monthly SLA Report |
+| **Owner** | NAP Dev + IT |
+
+**Uptime Calculation Template:**
+```
+เดือน: __________
+Total Hours (08:00-18:00, วันทำงาน): ___ ชั่วโมง
+Downtime รวม: ___ นาที
+Uptime %: ((Total Hours × 60 - Downtime) / (Total Hours × 60)) × 100
+```
+
+---
+
+### KPI-PERF-003: File Scan Success Rate
+**Category:** Security | **Priority:** 🟠 High
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | % ของไฟล์อัปโหลดที่ถูก Scan โดย ClamAV สำเร็จ (ไม่ใช่ Skip หรือ Error) |
+| **หน่วย** | % |
+| **Target** | ≥ 99.9% (ทุกไฟล์ต้อง Scan) |
+| **วิธีวัด** | Audit Log: COUNT(action='FILE_VIRUS_SCAN_COMPLETED') / COUNT(action='FILE_UPLOADED') |
+| **Frequency** | Daily Check |
+| **Owner** | NAP Dev |
+
+---
+
+### KPI-SAT-001: User Satisfaction Score (CSAT)
+**Category:** User Satisfaction | **Priority:** 🟠 High
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | คะแนนความพึงพอใจโดยรวมของผู้ใช้ระบบ (1–5) |
+| **หน่วย** | คะแนน (1.0–5.0) |
+| **Baseline** | N/A |
+| **Target Month 1** | ≥ 3.5/5.0 (ยังอยู่ใน Learning Curve) |
+| **Target Month 3** | ≥ 4.0/5.0 |
+| **Target Month 6** | ≥ 4.3/5.0 |
+| **วิธีวัด** | Google Forms Survey (แบบสอบถาม) |
+| **Frequency** | Month 1, Month 3, Month 6 |
+| **Owner** | PO |
+
+---
+
+### KPI-SAT-002: System Ease of Use Score (SUS-lite)
+**Category:** User Satisfaction | **Priority:** 🟡 Medium
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | "ระบบนี้ง่ายต่อการใช้งาน" (1=ไม่เห็นด้วยมาก, 5=เห็นด้วยมาก) |
+| **หน่วย** | คะแนน (1.0–5.0) |
+| **Target Month 3** | ≥ 4.0/5.0 |
+| **วิธีวัด** | ใน Survey เดียวกับ KPI-SAT-001 |
+| **Frequency** | Month 1, Month 3 |
+| **Owner** | PO |
+
+---
+
+### KPI-SEC-001: Audit Log Coverage Rate
+**Category:** Security/Compliance | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | % ของ User Actions ที่ถูกบันทึกใน Audit Log |
+| **หน่วย** | % |
+| **Target** | 100% (ทุก Action ต้องบันทึก — AC-AUDIT-001) |
+| **วิธีวัด** | Spot Check: ทำ Action → ตรวจ audit_logs ว่ามี Record หรือไม่ (Manual QA ก่อน Go-Live) |
+| **Frequency** | Pre Go-Live Audit + Monthly Spot Check |
+| **Owner** | NAP Dev |
+
+---
+
+### KPI-SEC-002: Security Incident Count
+**Category:** Security | **Priority:** 🔴 Critical
+
+| Attribute | Value |
+|-----------|-------|
+| **คำอธิบาย** | จำนวน Security Incidents ที่ตรวจพบ (Unauthorized access, Virus, etc.) |
+| **หน่วย** | จำนวนครั้ง |
+| **Target** | 0 (Zero Incidents ในเวลาทำงาน) |
+| **Threshold** | > 0 Critical → Immediate escalation |
+| **วิธีวัด** | Security Audit Log Dashboard (Grafana) |
+| **Frequency** | Daily Check (Hypercare) → Weekly |
+| **Owner** | NAP Dev + IT |
+
+---
+
+## 3. 📅 Baseline Data Collection Plan
+
+### T-4 สัปดาห์ก่อน Go-Live: เตรียม
+
+- [ ] ออกแบบ Survey Form สำหรับ User Baseline
+- [ ] เตรียม Template บันทึกข้อมูล Email-based RFAs
+- [ ] นัด Document Control แต่ละองค์กรเพื่อเก็บข้อมูล
+- [ ] กำหนด Baseline Period: 3 เดือนย้อนหลัง (ธ.ค. 2568 – ก.พ. 2569)
+
+### T-3 สัปดาห์: เก็บ Baseline ข้อมูล Process
+
+**สิ่งที่ต้องเก็บ:**
+
+```
+📋 BASELINE COLLECTION FORMS:
+
+Form A: RFA Cycle Time (KPI-EFF-001)
+──────────────────────────────────
+สัมภาษณ์กับ Document Control แต่ละ Org
+เก็บข้อมูล RFA 30 ฉบับล่าสุด (จากระบบเดิม):
+
+| # | เลข RFA เดิม | วันที่ส่ง | วันที่ตอบ | ระยะเวลา (วัน) | ผลลัพธ์ |
+|---|-------------|----------|----------|--------------|--------|
+| 1 |             |          |          |              |        |
+...
+Average: ___ วัน | Min: ___ | Max: ___
+
+Form B: Document Number Error (KPI-EFF-002)
+───────────────────────────────────────────
+จากเอกสาร 3 เดือนล่าสุด:
+- เอกสารที่ออกทั้งหมด: ___ ฉบับ
+- เลขที่ผิดพลาด/ซ้ำ ต้องยกเลิก: ___ ฉบับ
+- Error Rate: ___% 
+
+Form C: Follow-up Calls (KPI-EFF-004)
+────────────────────────────────────
+Document Control บันทึกเป็นเวลา 2 สัปดาห์:
+วันที่ | จำนวนครั้งที่โทรถามสถานะ
+...
+
+Form D: Time to Find Document (KPI-EFF-003)
+───────────────────────────────────────────
+สังเกตการณ์ 5 User × 5 ครั้ง:
+"ค้นหา [เอกสารที่ระบุ] ใช้เวลากี่นาที?"
+| User | ครั้งที่ 1 | 2 | 3 | 4 | 5 | เฉลี่ย |
+...
+```
+
+### T-2 สัปดาห์: เก็บ Baseline ข้อมูล User Perception
+
+```
+📋 PRE-GO-LIVE USER SURVEY (Google Form)
+
+Section 1: ปัญหาปัจจุบัน (ก่อนระบบใหม่)
+1. "ระบบปัจจุบัน (Email) ให้คะแนนความสะดวก" (1–5): ___
+2. "ฉันใช้เวลาค้นหาเอกสารเฉลี่ยครั้งละ" (นาที): ___
+3. "ข้อปัญหาหลักสูงสุด 3 อันดับ" (checkbox)
+4. "ฉันต้องโทรถามสถานะเอกสารสัปดาห์ละ" (ครั้ง): ___
+
+Section 2: ความคาดหวังจากระบบใหม่
+5. "สิ่งที่คาดหวังมากที่สุดจากระบบใหม่": (text)
+6. "ความกังวลเกี่ยวกับการเปลี่ยนระบบ": (text)
+```
+
+---
+
+## 4. 📊 KPI Dashboard Template
+
+### Monthly KPI Report Template
+
+```markdown
+# Monthly KPI Report — LCBP3-DMS
+Period: [เดือน ปี] | Generated: [วันที่]
+
+## 🟢 On Track / 🟡 Watch / 🔴 Off Track
+
+| KPI | Baseline | Target | Actual | Status | Delta |
+|-----|---------|--------|--------|--------|-------|
+| RFA Cycle Time | ___ วัน | ≤ 5 วัน | ___ วัน | 🟢/🟡/🔴 | ___% |
+| Doc Number Error | ___% | 0% | ___% | 🟢/🟡/🔴 | ___% |
+| User Adoption | N/A | ≥ 70% | ___% | 🟢/🟡/🔴 | ___% |
+| API P90 | N/A | < 200ms | ___ms | 🟢/🟡/🔴 | ___% |
+| Uptime | N/A | ≥ 99.5% | ___% | 🟢/🟡/🔴 | ___% |
+| CSAT Score | N/A | ≥ 4.0 | ___ | 🟢/🟡/🔴 | ___% |
+
+## 🔍 Highlights
+[Key findings this month]
+
+## ⚠️ Issues & Actions
+| Issue | Impact | Action | Owner | Deadline |
+...
+
+## 📈 Trend Charts
+[Link to Grafana Dashboard]
+```
+
+---
+
+## 5. 📈 Target vs. Baseline Summary Table
+
+| KPI ID | ชื่อ KPI | หน่วย | Baseline | Target M1 | Target M3 | Target M6 |
+|--------|---------|------|---------|----------|----------|----------|
+| KPI-EFF-001 | RFA Cycle Time | วัน | ~14-21 | ≤ 7 | ≤ 5 | ≤ 3 |
+| KPI-EFF-002 | Doc Number Error | % | ~5-15% | < 1% | 0% | 0% |
+| KPI-EFF-003 | Time to Find Doc | นาที | ~15-30 | < 3 | < 1 | < 1 |
+| KPI-EFF-004 | Follow-up Calls | ครั้ง/สัปดาห์ | ~10-20 | < 10 | < 5 | < 2 |
+| KPI-ADOPT-001 | User Adoption | % | N/A | > 50% | > 70% | > 90% |
+| KPI-ADOPT-002 | Feature Adoption | % | N/A | > 30% | > 60% | > 80% |
+| KPI-ADOPT-003 | Support Tickets | ครั้ง/สัปดาห์ | N/A | < 30 | < 15 | < 5 |
+| KPI-PERF-001 | API Response P90 | ms | N/A | < 200 | < 200 | < 200 |
+| KPI-PERF-002 | System Uptime | % | N/A | ≥ 99.5% | ≥ 99.5% | ≥ 99.9% |
+| KPI-PERF-003 | File Scan Success | % | N/A | 100% | 100% | 100% |
+| KPI-SAT-001 | CSAT Score | /5.0 | Survey Pre | ≥ 3.5 | ≥ 4.0 | ≥ 4.3 |
+| KPI-SAT-002 | Ease of Use | /5.0 | Survey Pre | ≥ 3.5 | ≥ 4.0 | ≥ 4.2 |
+| KPI-SEC-001 | Audit Coverage | % | N/A | 100% | 100% | 100% |
+| KPI-SEC-002 | Security Incidents | ครั้ง | N/A | 0 | 0 | 0 |
+
+---
+
+## 6. 🔧 Technical Measurement Implementation
+
+### Grafana Dashboard Panels (ต้องสร้างก่อน Go-Live)
+
+```yaml
+# Prometheus Metrics to Collect:
+panels:
+  - title: "RFA Cycle Time (Avg)"
+    query: |
+      avg(
+        timestamp(workflow_closed_at) - timestamp(workflow_submitted_at)
+      ) by (month) WHERE type = 'rfa'
+    unit: days
+    
+  - title: "Daily Active Users"
+    query: |
+      count(distinct user_id) FROM audit_logs 
+      WHERE action = 'USER_LOGIN' AND date = today
+    
+  - title: "API P90 Response Time"
+    query: |
+      histogram_quantile(0.90,
+        rate(http_request_duration_seconds_bucket[5m])
+      )
+    unit: ms
+    alert_threshold: 500
+
+  - title: "System Uptime (30d)"
+    query: avg_over_time(up[30d]) * 100
+    unit: percent
+    
+  - title: "File Virus Scan Queue"
+    query: bullmq_queue_size{queue="virus-scan"}
+    
+  - title: "Support Tickets This Week"
+    query: custom_metric (manual input)
+```
+
+### SQL Queries for Business KPIs
+
+```sql
+-- KPI-EFF-001: RFA Cycle Time (ต่อเดือน)
+SELECT 
+    DATE_FORMAT(wi.submitted_at, '%Y-%m') AS month,
+    COUNT(*) AS total_rfas,
+    AVG(DATEDIFF(wi.closed_at, wi.submitted_at)) AS avg_days,
+    MIN(DATEDIFF(wi.closed_at, wi.submitted_at)) AS min_days,
+    MAX(DATEDIFF(wi.closed_at, wi.submitted_at)) AS max_days,
+    PERCENTILE_CONT(0.50) WITHIN GROUP (ORDER BY DATEDIFF(wi.closed_at, wi.submitted_at)) AS median_days
+FROM workflow_instances wi
+WHERE wi.document_type = 'RFA'
+    AND wi.status = 'CLOSED'
+    AND wi.closed_at IS NOT NULL
+GROUP BY DATE_FORMAT(wi.submitted_at, '%Y-%m')
+ORDER BY month DESC;
+
+-- KPI-ADOPT-001: Daily Active Users
+SELECT 
+    DATE(created_at) AS date,
+    COUNT(DISTINCT user_id) AS daily_active_users,
+    (SELECT COUNT(*) FROM users WHERE is_active = 1) AS total_active_users,
+    ROUND(COUNT(DISTINCT user_id) * 100.0 / 
+          (SELECT COUNT(*) FROM users WHERE is_active = 1), 1) AS adoption_rate
+FROM audit_logs
+WHERE action = 'USER_LOGIN'
+    AND created_at >= DATE_SUB(NOW(), INTERVAL 30 DAY)
+GROUP BY DATE(created_at)
+ORDER BY date DESC;
+
+-- KPI-EFF-002: Document Number Error Rate
+SELECT 
+    DATE_FORMAT(created_at, '%Y-%m') AS month,
+    COUNT(*) AS total_reserved,
+    SUM(CASE WHEN status = 'CANCELLED' THEN 1 ELSE 0 END) AS cancelled,
+    ROUND(SUM(CASE WHEN status = 'CANCELLED' THEN 1 ELSE 0 END) * 100.0 / COUNT(*), 2) AS error_rate_pct
+FROM document_number_reservations
+WHERE created_at >= DATE_SUB(NOW(), INTERVAL 6 MONTH)
+GROUP BY DATE_FORMAT(created_at, '%Y-%m');
+```
+
+---
+
+## 7. 📋 User Survey Templates
+
+### Post Go-Live Survey (Month 1 & Month 3)
+
+```
+📝 LCBP3-DMS User Satisfaction Survey
+Period: [เดือน] | ใช้เวลา: ประมาณ 3 นาที
+
+Section 1: ภาพรวม
+━━━━━━━━━━━━━━━
+Q1. โดยรวม ระบบ LCBP3-DMS ช่วยให้การทำงานของคุณดีขึ้น?
+    ⬜ 1-ไม่เลย  ⬜ 2  ⬜ 3  ⬜ 4  ⬜ 5-ดีขึ้นมาก
+
+Q2. ระบบนี้ง่ายต่อการใช้งานมากแค่ไหน?
+    ⬜ 1-ยากมาก  ⬜ 2  ⬜ 3  ⬜ 4  ⬜ 5-ง่ายมาก
+
+Section 2: Feature Specific
+━━━━━━━━━━━━━━━━━━━━━━━━
+Q3. Feature ที่คุณใช้บ่อยที่สุด: (checkbox, เลือกได้หลายข้อ)
+    ⬜ Dashboard  ⬜ สร้าง Correspondence  ⬜ Review RFA
+    ⬜ ค้นหาเอกสาร  ⬜ Circulation  ⬜ ดู Workflow
+
+Q4. Feature ที่ยังมีปัญหาหรืออยากให้ปรับปรุง: (text)
+    _______________________________________________
+
+Section 3: เปรียบเทียบกับระบบเดิม
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Q5. เวลาค้นหาเอกสาร เปรียบกับระบบเดิม:
+    ⬜ เร็วกว่ามาก  ⬜ เร็วกว่านิดหน่อย  ⬜ เหมือนเดิม  ⬜ ช้ากว่า
+
+Q6. จำนวนครั้งที่ต้องโทรถามสถานะ เปรียบกับเดิม:
+    ⬜ น้อยกว่ามาก  ⬜ น้อยกว่า  ⬜ เหมือนเดิม  ⬜ มากกว่า
+
+Section 4: Open Feedback
+━━━━━━━━━━━━━━━━━━━━
+Q7. สิ่งที่คุณชอบมากที่สุดในระบบนี้: _______________
+Q8. สิ่งที่คุณอยากให้ปรับปรุงเร่งด่วนที่สุด: ___________
+Q9. คะแนนรวม (NPS): 0-10 — "คุณจะแนะนำระบบนี้ให้เพื่อนร่วมงาน?"
+    0──────────────────10
+    [0-6: Detractor] [7-8: Passive] [9-10: Promoter]
+```
+
+---
+
+## 8. 📊 KPI Review Meeting Agenda Template
+
+```markdown
+# LCBP3-DMS Monthly KPI Review — [เดือน ปี]
+วันที่: | เวลา: 30 นาที | ผู้เข้าร่วม: PO, IT, Document Control Lead
+
+## Agenda
+
+1. KPI Dashboard Review (10 นาที)
+   - Performance KPIs: Uptime, API Response
+   - Efficiency KPIs: RFA Cycle Time, Error Rate
+   - Adoption KPIs: DAU, Feature Adoption
+   
+2. Status Discussion (10 นาที)
+   - 🔴 Off Track KPIs: root cause + action plan
+   - 🟡 Watch KPIs: monitoring plan
+   
+3. User Feedback Summary (5 นาที)
+   - Key themes from support tickets
+   - Survey results (if applicable)
+   
+4. Actions for Next Month (5 นาที)
+   - [Action] | [Owner] | [Deadline]
+
+## Notes / Decisions
+```
+
+---
+
+## 📝 Document Control
+
+- **Version:** 1.0.0 | **Status:** DRAFT — Baseline Collection Pending
+- **Created:** 2026-03-11 | **Owner:** Nattanin Peancharoen
+- **Baseline Collection Deadline:** T-2 สัปดาห์ก่อน Go-Live
+- **First KPI Review:** T+1 เดือนหลัง Go-Live
+- **Classification:** Internal Use Only

specs/00-overview/00-06-training-plan.md

@@ -0,0 +1,414 @@
+# 🎓 Training & Change Management Plan — LCBP3-DMS v1.8.0
+
+---
+title: 'Training & Change Management Plan'
+version: 1.0.0
+status: DRAFT
+owner: Nattanin Peancharoen (Product Owner / System Architect)
+last_updated: 2026-03-11
+related:
+  - specs/00-Overview/README.md
+  - specs/01-Requirements/01-01-objectives.md
+  - specs/01-Requirements/01-02-business-rules/01-02-01-rbac-matrix.md
+---
+
+## 1. 🎯 วัตถุประสงค์
+
+> **"ระบบที่ดีที่สุดก็ล้มเหลวได้ ถ้าผู้ใช้ไม่รู้วิธีใช้"**
+
+แผนนี้ครอบคลุม:
+1. **Training Curriculum** — หลักสูตรฝึกอบรมแยกต่อ Role
+2. **Training Materials** — สื่อและเอกสารการฝึกอบรม
+3. **Train-the-Trainer** — กระบวนการเตรียม Trainer ภายในองค์กร
+4. **Support Desk Setup** — ระบบ Support หลัง Go-Live
+5. **Change Management** — การสื่อสารและรับมือกับ Change
+
+---
+
+## 2. 📅 Training Timeline
+
+```
+T-4 สัปดาห์ก่อน Go-Live:
+├── สร้าง Training Materials ครบ
+├── ติดตั้ง Staging Environment สำหรับ Training
+└── เตรียม Trainer (Train-the-Trainer)
+
+T-3 สัปดาห์:
+├── Training: Superadmin + Org Admin (ทุกองค์กร)
+└── UAT Pre-check กับ Admin ทุกคน
+
+T-2 สัปดาห์:
+├── Training: Document Control (ทุกองค์กร)
+└── UAT ทดสอบ Workflow จริงบน Staging
+
+T-1 สัปดาห์:
+├── Training: Engineers / Reviewers / Viewers
+├── UAT Sign-off
+└── Dry Run Go-Live
+
+Go-Live Day:
+├── Hypercare Support (8:00–18:00 on-call)
+└── ทีม Dev พร้อม Hotfix ตลอด
+
+T+1 เดือน:
+├── Hypercare สิ้นสุด
+└── Handover ไป Standard Support
+```
+
+---
+
+## 3. 👥 Target Audience & Training Groups
+
+| Group | Role ในระบบ | ผู้เข้าอบรม | ระยะเวลา | รูปแบบ |
+|-------|------------|------------|---------|-------|
+| **A** | Superadmin | ทีม NAP (1-2 คน) | 4 ชั่วโมง | 1-on-1 Workshop |
+| **B** | Org Admin | 1 คนต่อองค์กร × 5 องค์กร | 3 ชั่วโมง | Group Workshop |
+| **C** | Document Control | 1-3 คนต่อองค์กร | 4 ชั่วโมง | Group Workshop |
+| **D** | Engineer / Reviewer | หลายคนต่อองค์กร | 2 ชั่วโมง | Group + Self-paced |
+| **E** | Viewer / Auditor | ผู้บริหาร + Observer | 1 ชั่วโมง | Video + Quick Guide |
+
+> **หมายเหตุ:** Train-the-Trainer: แต่ละองค์กรมี Trainer 1 คน ก่อนอบรมองค์กรอื่น
+
+---
+
+## 4. 📚 Training Curriculum per Role
+
+### 4.1 Group A — Superadmin (4 ชั่วโมง)
+
+**เป้าหมาย:** ดูแลระบบทั้งหมด, Config Master Data, จัดการ Permission
+
+| Module | หัวข้อ | เวลา |
+|--------|--------|------|
+| A1 | System Architecture Overview (ภาพรวมระบบ, Docker, QNAP) | 30 นาที |
+| A2 | สร้าง Organization, Project, Contract | 30 นาที |
+| A3 | User Management — สร้าง/แก้ไข/Deactivate User | 20 นาที |
+| A4 | Document Number Template Config | 30 นาที |
+| A5 | Workflow DSL — อ่านและแก้ไข Workflow Definitions | 45 นาที |
+| A6 | Permission & RBAC Matrix — กำหนดสิทธิ์ระดับ Global | 30 นาที |
+| A7 | Audit Log & Security Monitoring | 20 นาที |
+| A8 | Backup & Restore (DR Runbook) | 20 นาที |
+| A9 | Troubleshooting Guide (Common Issues) | 15 นาที |
+| — | **Q&A + Hands-on Practice** | 20 นาที |
+
+**Deliverables:**
+- [ ] Admin Quick Reference Card (A4 1 หน้า)
+- [ ] System Admin Runbook (PDF)
+- [ ] Access ไปยัง Grafana + phpMyAdmin Dashboard
+
+---
+
+### 4.2 Group B — Org Admin (3 ชั่วโมง)
+
+**เป้าหมาย:** จัดการ User ภายในองค์กร, กำหนดสิทธิ์ระดับ Org
+
+| Module | หัวข้อ | เวลา |
+|--------|--------|------|
+| B1 | ภาพรวมระบบและ Role ของ Org Admin | 20 นาที |
+| B2 | เพิ่ม/แก้ไข/Deactivate User ในองค์กร | 30 นาที |
+| B3 | กำหนด Role: Document Control / Editor / Viewer | 20 นาที |
+| B4 | Assign User เข้า Project และ Contract | 20 นาที |
+| B5 | ดู Audit Log ภายในองค์กร | 15 นาที |
+| B6 | จัดการ Tags สำหรับองค์กร | 15 นาที |
+| B7 | การรับมือ Lock Account / Reset Password | 20 นาที |
+| — | **Hands-on Practice บน Staging** | 30 นาที |
+| — | **Q&A** | 10 นาที |
+
+**Deliverables:**
+- [ ] Org Admin User Manual (PDF, 10-15 หน้า)
+- [ ] User Onboarding Checklist
+
+---
+
+### 4.3 Group C — Document Control (4 ชั่วโมง)
+
+**เป้าหมาย:** สร้าง/ส่ง/ติดตามเอกสารทุกประเภท, จัดการ Workflow
+
+| Module | หัวข้อ | เวลา |
+|--------|--------|------|
+| C1 | ภาพรวมระบบ DMS — ทำไมต้องเปลี่ยนจาก Email? | 15 นาที |
+| C2 | Login + Dashboard + My Tasks | 15 นาที |
+| C3 | **สร้าง Correspondence** — Draft → Submit → Track | 30 นาที |
+| C4 | **สร้าง RFA + Shop Drawing** — Draft → Submit via Transmittal | 45 นาที |
+| C5 | Upload ไฟล์ — Drag-and-Drop, Main vs Supporting, Virus Scan | 20 นาที |
+| C6 | **Circulation Sheet** — สร้าง, Assign, กำหนด Deadline | 30 นาที |
+| C7 | ติดตามสถานะ Workflow + Workflow Diagram | 20 นาที |
+| C8 | Force Proceed / Revert Workflow (กรณีพิเศษ) | 15 นาที |
+| C9 | ค้นหาเอกสาร + Advanced Filter | 15 นาที |
+| C10 | Notification Settings + LINE Notify | 15 นาที |
+| — | **Hands-on: ทำ Scenario จริงบน Staging** | 40 นาที |
+| — | **Q&A** | 20 นาที |
+
+**Hands-on Scenarios (Staging):**
+1. สร้าง Correspondence → Submit → Track Workflow
+2. สร้าง RFA + Transmittal → ส่ง → รอ Response
+3. รับ Correspondence → สร้าง Circulation → Assign
+
+**Deliverables:**
+- [ ] Document Control User Manual (PDF, 20-30 หน้า)
+- [ ] Quick Reference Card: Document Types & Workflow States
+- [ ] Video Tutorial: "สร้างและส่ง RFA" (15 นาที)
+- [ ] FAQ Document (10 ข้อที่พบบ่อย)
+
+---
+
+### 4.4 Group D — Engineer / Reviewer (2 ชั่วโมง)
+
+**เป้าหมาย:** รับและ Review เอกสาร, ตอบ RFA, ดู Circulation
+
+| Module | หัวข้อ | เวลา |
+|--------|--------|------|
+| D1 | Login + Dashboard + Notification Bell | 15 นาที |
+| D2 | ดู Correspondence ที่รับเข้ามา + PDF Viewer | 20 นาที |
+| D3 | **Review RFA** — Approved / w.Comments / Rejected | 30 นาที |
+| D4 | ดู Shop Drawing ใน PDF Viewer (Streaming) | 15 นาที |
+| D5 | ตอบ Circulation ที่ได้รับมอบหมาย | 15 นาที |
+| D6 | ค้นหาเอกสาร + ดู Workflow History | 10 นาที |
+| D7 | ตั้งค่า Notification (Email/LINE) | 5 นาที |
+| — | **Q&A** | 10 นาที |
+
+**Deliverables:**
+- [ ] Reviewer Quick Guide (A4 2 หน้า)
+- [ ] Video Tutorial: "วิธี Review RFA" (10 นาที)
+
+---
+
+### 4.5 Group E — Viewer / Auditor / Management (1 ชั่วโมง)
+
+**เป้าหมาย:** ดู Dashboard, ค้นหา, ดาวน์โหลดรายงาน
+
+| Module | หัวข้อ | เวลา |
+|--------|--------|------|
+| E1 | Login + Dashboard Overview | 10 นาที |
+| E2 | ค้นหาเอกสารและดู Status | 15 นาที |
+| E3 | อ่านเอกสารใน PDF Viewer | 10 นาที |
+| E4 | ดู Audit Log (สำหรับ Auditor) | 10 นาที |
+| E5 | ตั้งค่า Notification | 5 นาที |
+| — | **Q&A** | 10 นาที |
+
+**Deliverables:**
+- [ ] Viewer Quick Start (A4 1 หน้า, ภาษาไทย + อังกฤษ)
+
+---
+
+## 5. 🎥 Training Materials Checklist
+
+### 5.1 เอกสาร (Documents)
+
+| Material | Target | สถานะ | Deadline |
+|----------|--------|-------|---------|
+| System Admin Runbook | Group A | ⬜ ต้องสร้าง | T-4 สัปดาห์ |
+| Org Admin User Manual | Group B | ⬜ ต้องสร้าง | T-4 สัปดาห์ |
+| Document Control User Manual | Group C | ⬜ ต้องสร้าง | T-4 สัปดาห์ |
+| Reviewer Quick Guide | Group D | ⬜ ต้องสร้าง | T-3 สัปดาห์ |
+| Viewer Quick Start | Group E | ⬜ ต้องสร้าง | T-3 สัปดาห์ |
+| Glossary / คำศัพท์ระบบ | ทุก Role | ✅ มี (`00-02-glossary.md`) | — |
+| FAQ (10 ข้อพบบ่อย) | Group C, D | ⬜ ต้องสร้าง | T-2 สัปดาห์ |
+
+### 5.2 Video Tutorials
+
+| Video | ความยาว | Target | สถานะ |
+|-------|--------|--------|-------|
+| ภาพรวมระบบ (System Intro) | 5 นาที | ทุก Role | ⬜ |
+| วิธีสร้างและส่ง Correspondence | 10 นาที | Group C | ⬜ |
+| วิธีสร้างและส่ง RFA + Transmittal | 15 นาที | Group C | ⬜ |
+| วิธี Review RFA | 10 นาที | Group D | ⬜ |
+| วิธีสร้าง Circulation Sheet | 8 นาที | Group C | ⬜ |
+| ค้นหาเอกสารและใช้ Filter | 5 นาที | ทุก Role | ⬜ |
+
+> **เครื่องมือแนะนำ:** OBS Studio (Screen Record) + CapCut / DaVinci Resolve (Edit) + Loom (Quick Share)
+
+### 5.3 Hands-on Training Scenarios (บน Staging)
+
+```markdown
+Scenario 1: "ส่ง RFA ครั้งแรก" (Group C)
+───────────────────────────────────────
+1. Login ด้วย Account Contractor A
+2. Upload Shop Drawing (ไฟล์ PDF ตัวอย่าง)
+3. สร้าง RFA Type: Shop Drawing — Discipline: STR
+4. สร้าง Transmittal → แนบ RFA → Submit
+5. ยืนยัน: Notification ถูกส่ง | เลขเอกสารถูกออก
+
+Scenario 2: "Review และ Approve RFA" (Group D)
+─────────────────────────────────────────────
+1. Login ด้วย Account Engineer (TEAM หรือ คคง.)
+2. ดู Notification Bell → เปิด RFA ที่ได้รับ
+3. ดู Shop Drawing ใน PDF Viewer
+4. คลิก "Approved with Comments" + กรอก Comment
+5. ยืนยัน: Contractor ได้รับ Notification
+
+Scenario 3: "สร้าง Circulation และติดตาม" (Group C)
+───────────────────────────────────────────────
+1. รับเอกสาร Correspondence ใน Inbox
+2. สร้าง Circulation Sheet → Assign Main, Action, Info
+3. กำหนด Deadline 3 วัน
+4. Assignee Login → ดู My Tasks → ตอบกลับ
+5. Document Control ปิด Circulation
+```
+
+---
+
+## 6. 🏆 Train-the-Trainer Program
+
+### 6.1 เป้าหมาย
+แต่ละองค์กรมี **Internal Trainer** 1 คน ที่สามารถ:
+- สอน User ใหม่ในองค์กรได้ด้วยตัวเอง
+- ตอบ FAQ เบื้องต้นโดยไม่ต้องติดต่อ NAP
+- รายงาน Issues ผ่าน Support Channel ได้ถูกต้อง
+
+### 6.2 Internal Trainer คุณสมบัติ
+- มักเป็น **Document Control** อาวุโส หรือ Org Admin
+- เข้าร่วม Training Group A หรือ C ก่อน
+- ผ่าน Hands-on Practice Scenario ทั้ง 3 ครบ
+- ได้รับ "Trainer Kit" (Materials + Access พิเศษ)
+
+### 6.3 Trainer Kit
+```
+📦 Trainer Kit ประกอบด้วย:
+├── 📄 User Manuals (ทุก Role) — สำหรับแจกจ่าย
+├── 🎥 Video Tutorials — ลิงก์ internal host
+├── 🃏 Training Scenario Scripts (3 Scenarios)
+├── ❓ FAQ Document
+├── 📊 Staging Environment Access (ไม่กระทบ Production)
+└── 📞 Escalation Contact: Nattanin (Line/Email)
+```
+
+---
+
+## 7. 🆘 Support Desk Setup
+
+### 7.1 Support Tiers
+
+```
+Level 1 — Internal Trainer (Self-service, 0-4 ชั่วโมง)
+│  └── FAQ Document + Video Tutorials
+│       ↓ ถ้าแก้ไม่ได้
+Level 2 — Org Admin / Document Control (4-24 ชั่วโมง)
+│  └── ติดต่อ Internal Trainer ขององค์กร
+│       ↓ ถ้าแก้ไม่ได้
+Level 3 — NAP Support (1-2 วันทำการ)
+   └── LINE Group / Email → Nattanin
+        ↓ ถ้าเป็น Bug หรือ System Issue
+Level 4 — Dev Team (Hotfix / Patch)
+   └── Fix + Deploy + Notify
+```
+
+### 7.2 Support Channels
+
+| Channel | ใช้เมื่อ | Response Time |
+|---------|---------|--------------|
+| **LINE Group** (NAP-DMS Support) | ปัญหาเร่งด่วน, ถามวิธีใช้ | 2-4 ชั่วโมง (ในเวลาทำงาน) |
+| **Email** nattanin@[domain] | รายงาน Bug, ขอ Feature | 1-2 วันทำการ |
+| **FAQ Document** | ปัญหาทั่วไป | ทันที (Self-service) |
+| **Video Tutortials** | ต้องการดูวิธีใช้ซ้ำ | ทันที (Self-service) |
+
+### 7.3 Hypercare Period (Go-Live Month 1)
+
+**สัปดาห์ 1-2 (Go-Live):**
+- NAP ทีม On-Call: 08:00–18:00 ทุกวันทำการ
+- Daily Check-in กับ Internal Trainers ทุกองค์กร (15 นาที)
+- Bug Tracker: บันทึก Issues ทั้งหมด (Priority P0-P3)
+
+**สัปดาห์ 3-4:**
+- On-Call: ตามปกติ (Response ภายใน 4 ชั่วโมง)
+- Weekly Review: สรุป Issues + แก้ไข + FAQ Update
+
+**หลัง 1 เดือน:**
+- Standard Support (Level 1-4 ตามปกติ)
+- Monthly Review Meeting
+
+### 7.4 Bug Priority & SLA
+
+| Priority | ตัวอย่าง | Response | Resolution |
+|----------|---------|---------|-----------|
+| **P0 — Critical** | ระบบล่ม, Data Loss | 30 นาที | 4 ชั่วโมง |
+| **P1 — High** | Login ไม่ได้, เอกสารหาย | 2 ชั่วโมง | 24 ชั่วโมง |
+| **P2 — Medium** | Feature ทำงานผิด | 4 ชั่วโมง | 3 วัน |
+| **P3 — Low** | UI ผิดเล็กน้อย, Typo | 24 ชั่วโมง | 2 สัปดาห์ |
+
+---
+
+## 8. 📢 Change Management Communication Plan
+
+### 8.1 Communication Timeline
+
+| เวลา | ข้อความ | ช่องทาง | ผู้รับ |
+|------|---------|---------|-------|
+| T-8 สัปดาห์ | Announcement: ระบบใหม่กำลังจะมา | Email + LINE | ผู้บริหารทุกองค์กร |
+| T-4 สัปดาห์ | Training Schedule แจ้งรายละเอียด | Email | Org Admin ทุกองค์กร |
+| T-2 สัปดาห์ | Training Reminder + Staging Access | Email + LINE | ทุก User |
+| T-1 สัปดาห์ | "1 สัปดาห์แล้ว!" + Go-Live Date | Email + LINE | ทุก User |
+| Go-Live Day | Go-Live Announcement + Support Contact | Email + LINE | ทุก User |
+| T+2 สัปดาห์ | Feedback Survey (Google Form) | Email | ผู้ใช้งานทุกคน |
+| T+1 เดือน | Summary Report ต่อผู้บริหาร | Meeting | Project Management |
+
+### 8.2 Key Messages
+
+**สำหรับผู้บริหาร:**
+> "ระบบ LCBP3-DMS ช่วยให้ติดตามสถานะเอกสารได้ Real-time, ลดเวลา Cycle RFA จาก 2 สัปดาห์เหลือ 3 วัน, และมี Audit Trail ครบถ้วน"
+
+**สำหรับ Document Control:**
+> "ระบบนี้ช่วยลดการทำงานซ้ำซ้อนจาก Email ไปสู่ Workflow อัตโนมัติ เลขเอกสารออกอัตโนมัติ ไม่ต้องจำหรือนับมือ"
+
+**สำหรับ Engineer / Reviewer:**
+> "รับ Notification ทันทีเมื่อมี RFA ใหม่ ดู PDF ในระบบโดยไม่ต้อง Download คลิก Approve ได้เลย"
+
+### 8.3 Resistance Management
+
+| กลุ่มที่อาจต้าน | เหตุผล | วิธีรับมือ |
+|--------------|-------|-----------|
+| ผู้ใช้ที่คุ้นชิน Email | "Email ง่ายกว่า" | แสดง Case Study: วันไหน RFA ตกหล่น |
+| ผู้บริหารอาวุโส | "ไม่ถนัด IT" | เน้น: ดูสถานะได้ 1 คลิก, ไม่ต้องโทรถาม |
+| Document Control | "งานเพิ่มขึ้น" | แสดง: Auto-Number, Auto-Notify ลดงานจริง |
+| IT/Ops ที่คุ้นระบบเดิม | "Server อะไรอีก" | ADR-015, Docker ง่ายต่อ Maintain |
+
+---
+
+## 9. 📊 Training KPIs & Success Criteria
+
+| KPI | Target | วิธีวัด |
+|-----|--------|--------|
+| Training Attendance | > 90% ของ Users ทุก Group | Sign-in Sheet |
+| Post-Training Quiz Score | > 80% เฉลี่ย | Online Quiz (Google Form) |
+| Hands-on Scenario Pass Rate | > 90% ทำ Scenario 1-3 ได้ | Trainer Assessment |
+| Support Tickets Week 1 | < 20 tickets (แสดง Training มีประสิทธิภาพ) | Support Log |
+| User Adoption Month 1 | > 70% Login ทุกวันทำการ | System Analytics |
+| User Adoption Month 3 | > 90% Active Users | System Analytics |
+| Satisfaction Score | > 4.0/5.0 | Feedback Survey (T+2 สัปดาห์) |
+
+---
+
+## 10. ✅ Training Readiness Checklist (Pre Go-Live)
+
+### Materials
+- [ ] System Admin Runbook สร้างเสร็จ + Review แล้ว
+- [ ] Document Control User Manual สร้างเสร็จ
+- [ ] Quick Guides (Reviewer, Viewer) สร้างเสร็จ
+- [ ] Video Tutorials อย่างน้อย 3 clips
+- [ ] FAQ Document (10+ ข้อ) สร้างเสร็จ
+- [ ] Training Scenarios (Staging Data) เตรียมพร้อม
+
+### Infrastructure
+- [ ] Staging Environment Deploy แล้ว (Mirror Production)
+- [ ] Test Users ทุก Role สร้างแล้ว (1 ชุดต่อ Org)
+- [ ] Email + LINE Notify บน Staging ทำงาน (Test Mode)
+- [ ] Staging URL แจ้ง Trainers แล้ว
+
+### People
+- [ ] Internal Trainer แต่ละองค์กร ระบุชื่อแล้ว
+- [ ] Train-the-Trainer Session เสร็จแล้ว
+- [ ] Training Schedule แจ้งทุกคนแล้ว
+- [ ] Support LINE Group สร้างแล้ว + เพิ่ม Users
+
+### Process
+- [ ] Bug Report Process อธิบายให้ Trainers แล้ว
+- [ ] Escalation Path ชัดเจน
+- [ ] Hypercare Schedule ตกลงกันแล้ว (ว่าใครรับผิดชอบวันไหน)
+
+---
+
+## 📝 Document Control
+
+- **Version:** 1.0.0 | **Status:** DRAFT
+- **Created:** 2026-03-11 | **Owner:** Nattanin Peancharoen
+- **Next Review:** T-4 สัปดาห์ก่อน Go-Live
+- **Classification:** Internal Use Only

specs/00-overview/README.md

@@ -206,6 +206,16 @@ lcbp3/
 | ------------------ | ---------------------------------------------------------------------------------- | ------------------------------------- |
 | **Overview**       | [Glossary](./00-02-glossary.md)                                                          | Technical terminology & abbreviations |
 | **Overview**       | [Quick Start](./00-01-quick-start.md)                                                    | 5-minute getting started guide        |
+| **Overview**       | [🎯 Product Vision](./00-03-product-vision.md)                                            | Vision Statement, Strategy, Guardrails |
+| **Overview**       | [📊 KPI Baseline & Measurement](./00-05-kpi-baseline.md)                                  | 14 KPIs, Baseline Forms, SQL Queries  |
+| **Overview**       | [🎓 Training Plan](./00-06-training-plan.md)                                              | Training curriculum & change management |
+| **Overview**       | [📋 Stakeholder Sign-off & Risk](./00-04-stakeholder-signoff-and-risk.md)                 | Sign-off process, Risk Register, Change Control |
+| **Overview**       | [🚀 Release Management Policy](../04-Infrastructure-OPS/04-08-release-management-policy.md) | SemVer, Release Gates, Hotfix, Rollback Policy |
+| **Requirements**   | [📖 User Stories](../01-Requirements/01-04-user-stories.md)                               | 27 User Stories (8 Epics, MoSCoW)     |
+| **Requirements**   | [🛡️ Edge Cases & Business Rules](../01-Requirements/01-06-edge-cases-and-rules.md)         | 37 Edge Cases ป้องกัน Bug              |
+| **Requirements**   | [🖼️ UI/UX Wireframes](../01-Requirements/01-07-ui-wireframes.md)                          | 26 Screens, Navigation Map, Design System |
+| **Data**           | [📦 Migration Business Scope](../03-Data-and-Storage/03-06-migration-business-scope.md)    | 20,000 Docs, 3 Tiers, Go/No-Go Gates  |
+| **Requirements**   | [✅ Acceptance Criteria (UAT)](../01-Requirements/01-05-acceptance-criteria.md)            | MVP Go-Live criteria & UAT Sign-off   |
 | **Requirements**   | [Functional Requirements](../01-requirements/01-03-functional-requirements.md)        | Feature specifications                |
 | **Requirements**   | [Document Numbering](../01-requirements/01-03.11-document-numbering.md)               | Document numbering requirements       |
 | **Architecture**   | [System Architecture](../02-architecture/02-01-system-architecture.md)                   | Overall system design                 |