260324:2133 Refactor correspondence & rfa

2026-03-24 21:33:59 +07:00
parent 42fc9fa502
commit aa82b890a5
42 changed files with 2617 additions and 233 deletions
@@ -3,19 +3,119 @@
 ---

 title: 'Objectives'
-version: 1.8.0
-status: first-draft
+version: 1.8.1
+status: updated
 owner: Nattanin Peancharoen
-last_updated: 2026-02-23
-related: -
+last_updated: 2026-03-24
+related:
+
+- specs/00-Overview/00-03-product-vision.md
+- specs/01-Requirements/01-04-user-stories.md
+- specs/01-Requirements/01-05-acceptance-criteria.md
+- specs/01-Requirements/01-03-modules/01-03-00-index.md
+- specs/06-Decision-Records/ADR-005-technology-stack.md

 ---

-สร้างเว็บแอปพลิเคชันสำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System - DMS) แบบครบวงจร ที่เน้นความปลอดภัยสูงสุด ความถูกต้องของข้อมูล (Data Integrity) และรองรับการขยายตัวในอนาคต (Scalability) โดยแก้ไขปัญหา Race Condition และเพิ่มความเสถียรในการจัดการไฟล์ และใช้ Unified Workflow Engine ในการจัดการกระบวนการอนุมัติทั้งหมดเพื่อความยืดหยุ่น
+> [!NOTE]
+> เอกสารนี้กำหนด **วัตถุประสงค์และขอบเขตของ LCBP3-DMS** ซึ่งเป็นเอกสารอ้างอิงหลักสำหรับการตัดสินใจทางสถาปัตยกรรมและ Feature Prioritization

- มีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร
- ช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล
- เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์
- ปรับปรุงความปลอดภัยของระบบด้วยมาตรการป้องกันที่ทันสมัย
- เพิ่มความทนทานของระบบด้วยกลไก resilience patterns
- สร้างระบบ monitoring และ observability ที่ครอบคลุม
+---
+
+## 1. 🎯 วัตถุประสงค์หลัก (Primary Objectives)
+
+สร้างระบบบริหารจัดการเอกสารโครงการ (Document Management System) สำหรับโครงการก่อสร้างท่าเรือแหลมฉบังระยะที่ 3 ที่รองรับองค์กรผู้มีส่วนได้ส่วนเสียหลายฝ่าย ได้แก่ กทท., สค., ผรม., คคง. โดยมีเป้าหมายดังนี้:
+
+| # | วัตถุประสงค์ | KPI ที่วัดได้ | สถานะ |
+|---|------------|------------|------|
+| O-01 | จัดการวงจรชีวิตเอกสาร (Correspondence, RFA, Transmittal) แบบครบวงจร | Document turnaround time ลดลง ≥ 50% จาก Manual | 🔄 UAT |
+| O-02 | บังคับใช้ RBAC 4 ระดับ (Global/Org/Project/Contract) ผ่าน CASL | ไม่พบ Unauthorized Access ใน Penetration Test | ✅ Done |
+| O-03 | ป้องกัน Race Condition ในการออกเลขเอกสาร ด้วย Redis Redlock | Duplicate document number = 0 ใน load test 50 concurrent | ✅ Done |
+| O-04 | ตรวจสอบไวรัสทุกไฟล์ที่อัปโหลด ด้วย ClamAV | Malware detection rate = 100% จาก EICAR test | ✅ Done |
+| O-05 | รองรับ Full-text Search ข้ามเอกสารทั้งหมด ด้วย Elasticsearch | Search response time < 500ms สำหรับ 10K documents | ✅ Done |
+| O-06 | รองรับ ~20,000 เอกสารที่มีอยู่เดิม ผ่าน Migration Bot (n8n + Ollama) | Migration accuracy ≥ 95% | 🔄 Planned |
+| O-07 | บันทึก Audit Log ทุก Action ที่สำคัญในระบบ | Audit trail ครบ 100% สำหรับ CRUD + Workflow events | ✅ Done |
+| O-08 | ระบบพร้อมรองรับ 100 concurrent users โดยไม่มี degradation | API response time < 200ms (P95) ที่ 100 VUs | 🔄 UAT |
+
+---
+
+## 2. 🧩 ขอบเขตระบบ (Scope)
+
+### ✅ In Scope — ฟีเจอร์ที่พัฒนาใน LCBP3-DMS
+
+| Module | คำอธิบาย | อ้างอิง |
+|--------|---------|--------|
+| **Correspondence** | จดหมาย/เอกสารระหว่างองค์กร พร้อม Workflow | US-001~005 |
+| **RFA (Request for Approval)** | ขออนุมัติ Shop Drawing พร้อม Transmittal | US-006~012c |
+| **Transmittal** | ส่งเอกสารจำนวนมากพร้อมกัน | US-013~015 |
+| **Shop Drawing** | จัดการแบบก่อสร้างพร้อม Revision History | US-016~018 |
+| **Contract Drawing** | จัดการแบบคู่สัญญา | US-019~020 |
+| **As-built Drawing** | จัดการแบบ As-built พร้อม Revision | US-021~022 |
+| **Circulation Sheet** | เวียนเอกสารภายในองค์กร | US-023~025 |
+| **Document Numbering** | ออกเลขเอกสารอัตโนมัติ พร้อม Format Config | ADR-002 |
+| **Workflow Engine** | State machine สำหรับกระบวนการอนุมัติ | ADR-001 |
+| **RBAC** | สิทธิ์ 4 ระดับผ่าน CASL | ADR-016 |
+| **Full-text Search** | ค้นหาข้ามเอกสารทั้งหมด | Elasticsearch |
+| **Audit Log** | บันทึกทุก Action สำคัญ | — |
+| **Notifications** | แจ้งเตือน In-App, Email, LINE | ADR-008 |
+| **Admin Panel** | จัดการ Users, Orgs, Projects, Configs | SCR-022~026 |
+| **Migration Bot** | นำเข้าเอกสารเดิม ~20K docs | ADR-017 |
+
+### ❌ Out of Scope — ไม่รวมในโครงการนี้
+
+- ระบบบัญชี / ERP Integration
+- Mobile Native App (iOS/Android) — รองรับเฉพาะ Responsive Web
+- Electronic Signature (e-Signature) ตามกฎหมาย
+- Video Conference / Real-time Collaboration Editor
+- IoT / Sensor Data Integration
+
+---
+
+## 3. 🏗️ บริบทธุรกิจ (Business Context)
+
+**โครงการ:** ท่าเรือแหลมฉบัง ระยะที่ 3 (Laem Chabang Port Phase 3)
+**ผู้ใช้งาน:** 4 องค์กรหลัก — กทท. (PAT), สค. (PMC), ผรม. (Contractor), คคง. (Consultant)
+**ปัญหาเดิมที่แก้ไข:**
+
+- เอกสารเดิมอยู่ในรูปแบบกระดาษและไฟล์กระจัดกระจาย (~20,000 รายการ)
+- ไม่มีระบบ Version Control สำหรับแบบก่อสร้าง
+- กระบวนการอนุมัติต้องส่งเอกสารผ่านอีเมลหรือมือ ใช้เวลานาน
+- ไม่มีการตรวจสอบสิทธิ์ที่รัดกุม ทำให้ข้อมูลรั่วไหลได้
+- ไม่มี Audit Trail สำหรับการตรวจสอบย้อนหลัง
+
+---
+
+## 4. 📐 Architectural Principles (หลักการออกแบบ)
+
+| หลักการ | รายละเอียด | ADR |
+|--------|---------|-----|
+| **Security-First** | RBAC ทุก Endpoint, JWT, Helmet.js, ClamAV | ADR-016 |
+| **Data Integrity** | UUID-based routing (ป้องกัน IDOR), Optimistic Locking | ADR-019 |
+| **No Magic Migrations** | แก้ไข Schema SQL โดยตรง ไม่ใช้ ORM Migration | ADR-009 |
+| **Thin Controller** | Business Logic อยู่ใน Service Layer เท่านั้น | — |
+| **Unified Workflow** | State Machine เดียวสำหรับทุก Workflow | ADR-001 |
+| **Hybrid Identifier** | INT PK (internal) + UUIDv7 (public API) | ADR-019 |
+| **Queue-based Notifications** | BullMQ → Email/LINE/In-App async | ADR-008 |
+| **Observable System** | Prometheus + Loki + Grafana | ADR-010 |
+
+---
+
+## 5. ✅ เกณฑ์ความสำเร็จ (Success Criteria)
+
+ระบบถือว่าพร้อม Go-Live เมื่อ:
+
+- [ ] UAT ผ่าน ≥ 95% ของ Test Cases ใน `01-05-acceptance-criteria.md`
+- [ ] ไม่พบ Critical Bug (Severity 1) ที่ค้างอยู่
+- [ ] Performance Test ผ่านที่ 100 concurrent users (API < 200ms P95)
+- [ ] Security Audit ผ่าน (0 High/Critical Vulnerabilities)
+- [ ] Sign-off จากตัวแทนทั้ง 4 องค์กร ตาม `00-04-stakeholder-signoff-and-risk.md`
+- [ ] Runbook และ Backup/Recovery Plan พร้อม ตาม `04-02-backup-recovery.md`
+
+---
+
+## 📝 Document Control
+
+- **Version:** 1.8.1 | **Status:** updated
+- **Created:** 2026-02-23 | **Updated:** 2026-03-24 | **Owner:** Nattanin Peancharoen
+- **Changes:** Expanded from stub to full objectives document — added KPI table, scope, business context, architectural principles, success criteria
+- **Classification:** Internal Use Only
@@ -3,8 +3,8 @@
 ---

 title: 'Functional Requirements: Correspondence Management'
-version: 1.8.1
-status: updated
+version: 1.8.2
+status: implemented
 owner: Nattanin Peancharoen
 last_updated: 2026-03-24
 related:
@@ -168,3 +168,24 @@ Correspondence ใช้ Unified Workflow Engine — ดูรายละเอ
 | **EC-CORR-003** | Originator และ Recipient เป็นองค์กรเดียวกัน → Block (ใช้ Circulation แทน) | 🟡 Medium |

 ดูรายละเอียดครบที่ `01-06-edge-cases-and-rules.md` หมวด "Module 7: Correspondence Edge Cases"
+
+---
+
+## 3.2.11. Implementation Status (v1.8.2)
+
+| Feature | Status | หมายเหตุ |
+|---|---|---|
+| Create/Update/List/Detail Correspondence | ✅ Done | Phase 1 |
+| File Attachments (two-phase upload) | ✅ Done | Phase 2 |
+| Recipients (TO/CC), Submit Workflow | ✅ Done | Phase 3 |
+| Elasticsearch Indexing | ✅ Done | Phase 4 |
+| Cancel + In-App Notifications (cancel/submit) | ✅ Done | Phase 4 |
+| Reference Selector (outgoing/incoming) | ✅ Done | Phase 5 |
+| Tag Manager (assign/remove tags) | ✅ Done | Phase 5–6 |
+| Search `/search` — status filter + pagination | ✅ Done | Phase 6.1 |
+| Circulation Status Card in detail sidebar | ✅ Done | Phase 6.2 |
+| Revision History UI (timeline) | ✅ Done | Phase 6.3 |
+| Due Date Reminder (`@Cron` daily at 08:00) | ✅ Done | Phase 6.4 |
+| Email notification via Nodemailer/BullMQ | ✅ Done | Phase 7.1 — type `'EMAIL'` → NotificationProcessor sends Nodemailer |
+| Unit tests (service layer ≥ 80%) | ✅ Done | Phase 7.2 — 8 backend + 5 frontend tests |
+| Bulk operations (bulk cancel/export) | ✅ Done | Phase 7.3 — `POST /bulk-cancel`, `GET /export-csv`, CSV button |