lcbp3/specs/01-requirements/01-04-user-stories.md

📖 User Stories — LCBP3-DMS v1.8.1

---

title: 'User Stories — All Modules' version: 1.8.1 status: updated owner: Nattanin Peancharoen (Product Owner) last_updated: 2026-03-24 related:

• specs/01-Requirements/01-01-objectives.md
• specs/01-Requirements/01-05-acceptance-criteria.md
• specs/01-Requirements/01-03-modules/
• specs/01-Requirements/01-06-edge-cases-and-rules.md

---

📖 วิธีอ่าน

• Format: As a [role] / I want to [goal] / So that [benefit]
• Priority: 🔴 M (Must) | 🟠 S (Should) | 🟡 C (Could) | ⚫ W (Won't-Now)
• SP: Story Points (Fibonacci) — 1 SP ≈ ความซับซ้อนระดับ Login
• AC Link: → [AC-XXX-YYY] อ้างอิง 01-05-acceptance-criteria.md

---

👥 Epic 1: Authentication & User Management

US-001 — Login เข้าระบบ

Priority: 🔴 M | SP: 2 | AC: AC-AUTH-001, AC-AUTH-002

As a ผู้ใช้งานทุกประเภท
I want to login ด้วย Username + Password
So that ฉันเข้าถึงระบบตามบทบาทของตนได้

Done When:

• Login สำเร็จ → Dashboard | Password ผิด → Error กลางๆ
• ผิดเกิน 5 ครั้งใน 1 นาที → 429 Rate Limit
• Audit Log: LOGIN_SUCCESS / LOGIN_FAILED + IP

---

US-002 — เปลี่ยนรหัสผ่านครั้งแรก

Priority: 🔴 M | SP: 2 | AC: AC-AUTH-003

As a ผู้ใช้งานใหม่ที่เพิ่งถูกสร้างโดย Admin
I want to ถูกบังคับเปลี่ยนรหัสผ่านใน Login ครั้งแรก
So that ฉันมีรหัสผ่านที่ฉันรู้คนเดียว

Done When:

• Login ครั้งแรก → Redirect หน้าเปลี่ยน Password ทันที (ผ่านไม่ได้)
• Password ใหม่ต้องผ่าน Policy (8+ ตัว, อักษรใหญ่-เล็ก-ตัวเลข)

---

US-003 — จัดการ Profile ส่วนตัว

Priority: 🟠 S | SP: 2

As a ผู้ใช้งานทุกประเภท
I want to แก้ไขข้อมูลส่วนตัวและเปลี่ยนรหัสผ่าน
So that ฉันดูแล Account ของตัวเองได้

Done When:

• แก้ไข ชื่อ, Email, ช่องทาง Notification ได้
• เปลี่ยน Password ต้องยืนยัน Password เก่า

---

US-004 — Superadmin สร้างองค์กร + Project + Contract

Priority: 🔴 M | SP: 5 | AC: AC-ADMIN-001, AC-ADMIN-002

As a Superadmin
I want to สร้าง Organization, Project, Contract และผูกความสัมพันธ์กัน
So that ระบบพร้อมให้แต่ละองค์กรเริ่มทำงานได้

Done When:

• สร้าง Org → แต่งตั้ง Org Admin ได้ทันที
• สร้าง Project → ผูก Organizations (หลายองค์กร)
• สร้าง Contract → 1 Contractor ต่อ 1 Contract
• กำหนด Document Number Template ต่อ Project

---

US-005 — Org Admin จัดการ User ในองค์กร

Priority: 🔴 M | SP: 3 | AC: AC-ADMIN-003

As a Org Admin
I want to เพิ่ม/แก้ไข/Deactivate User และกำหนด Role
So that ทีมงานเข้าถึงระบบได้ตามหน้าที่

Done When:

• เพิ่ม User → Email แจ้ง Credentials อัตโนมัติ
• Deactivate ได้ (ไม่ Delete — Audit ยังอยู่)
• เห็นเฉพาะ User ในองค์กรตัวเอง

---

US-006 — Permission Isolation ระหว่าง Contractor

Priority: 🔴 M | SP: 2 | AC: AC-ADMIN-004

As a ระบบ
I want to ป้องกัน Contractor A เห็นข้อมูล Contractor B
So that ข้อมูลทางธุรกิจของแต่ละ Contractor เป็นความลับ

Done When:

• Contractor A→ ไม่เห็น List เอกสาร B | พยายาม Access URL ตรงๆ → 403
• Audit Log บันทึก Unauthorized Attempt

---

📨 Epic 2: Correspondence Management

US-007 — สร้าง Correspondence Draft

Priority: 🔴 M | SP: 5 | AC: AC-CORR-001

As a Document Control
I want to สร้าง Correspondence (Letter/RFI) ในสถานะ Draft พร้อมแนบไฟล์
So that เตรียมเอกสารได้ก่อนส่งโดยองค์กรอื่นยังไม่เห็น

Done When:

• Form: Subject, To (หลายองค์กร), CC, Doc Type, Attachments (PDF/ZIP)
• Drag-and-Drop Multi-file | ClamAV Scan ทุกไฟล์
• Auto-Save Draft → LocalStorage (กันข้อมูลสูญ)
• ผู้ใช้นอกองค์กรไม่เห็น Draft

---

US-008 — Submit Correspondence + Auto Number

Priority: 🔴 M | SP: 5 | AC: AC-CORR-002

As a Document Control
I want to Submit Correspondence และให้ระบบออกเลขอัตโนมัติ
So that เอกสารได้รับเลขที่ไม่ซ้ำและส่งถึงผู้รับทันที

Done When:

• ออกเลขตาม Template (เช่น LCBP3-สค.-กทท.-LETTER-0001-68)
• เลขไม่ซ้ำแม้ Submit พร้อมกัน (Redis Redlock)
• สถานะ → SUBMITTED | Workflow Instance ถูกสร้าง
• ผู้รับ → Email + In-App Notification

---

US-009 — ดู Correspondence ใน Inbox

Priority: 🔴 M | SP: 3 | AC: AC-CORR-003

As a Document Control ขององค์กรผู้รับ
I want to เห็น Correspondence ที่ส่งมาถึงองค์กรในรายการ
So that ดำเนินการได้ทันที (สร้าง Circulation, ตอบกลับ)

Done When:

• List แสดง Received/Sent แยก | PDF Viewer ในแอป (Streaming)
• ดาวน์โหลดไฟล์แนบได้ (ถ้ามีสิทธิ์)
• อ้างอิงเอกสารด้วย UUID (ADR-019)

---

US-010 — อ้างอิง + Tag เอกสาร

Priority: 🟠 S | SP: 3 | AC: AC-CORR-004

As a Document Control
I want to อ้างอิงเอกสารเก่าและกำหนด Tag หลาย Tag
So that จัดกลุ่มเอกสารและ Navigate ข้าม Thread ได้

Done When:

• ค้นหาและเลือก Reference Documents | Link ระหว่างเอกสาร (คลิก Navigate ด้วย UUID)
• กำหนด Tag หลาย Tag | ค้นหาได้จาก Tag

---

US-011 — ยกเลิก Correspondence (Admin)

Priority: 🟡 C | SP: 2 | AC: AC-CORR-005

As a Org Admin / Superadmin
I want to ยกเลิก Correspondence ที่ Submit แล้ว พร้อมระบุเหตุผล
So that เอกสารที่ส่งผิดถูกระงับโดยมีหลักฐาน Audit

Done When:

• ต้องกรอก cancel_reason | สถานะ → CANCELLED
• Editor/Viewer ทำ Cancel ไม่ได้ → 403

---

📋 Epic 3: RFA Management

US-012 — สร้าง RFA + Shop Drawing

Priority: 🔴 M | SP: 8 | AC: AC-RFA-001

As a Document Control ของ Contractor
I want to สร้าง RFA พร้อม Upload Shop Drawing
So that ยื่นขออนุมัติแบบก่อสร้างจากที่ปรึกษาได้อย่างเป็นระบบ

Done When:

• Form: RFA Type, Discipline, Shop Drawing (PDF/DWG/ZIP)
• 1 Shop Drawing Revision = 1 RFA เท่านั้น (EC-RFA-001 enforced)
• ClamAV Scan | Draft ไม่เห็นข้ามองค์กร (เฉพาะ originator)
• Project/Contract/Dicipline Selector แบบ dynamic (ไม่ hardcoded)

---

US-012a — แก้ไข Draft RFA (Edit)

Priority: 🔴 M | SP: 3 | AC: AC-RFA-007

As a Document Control ของ Contractor
I want to แก้ไขข้อมูล RFA ในสถานะ Draft
So that แก้ไขข้อผิดพลาดก่อน Submit ได้

Done When:

• แก้ไขได้: Subject, Body, Remarks, Description, Due Date
• แก้ไขได้: Details JSON (schema_version คงที่)
• ห้ามแก้ไขหากสถานะไม่ใช่ DFT → Error 403

---

US-012b — ยกเลิก Draft RFA (Cancel)

Priority: 🟠 S | SP: 2 | AC: AC-RFA-008

As a Document Control ของ Contractor
I want to ยกเลิก RFA ที่ยังไม่ Submit (สถานะ Draft)
So that ลบรายการที่สร้างผิดออกจากระบบ

Done When:

• ยกเลิกได้เฉพาะสถานะ DFT
• เปลี่ยนสถานะเป็น CC (Cancelled)
• บันทึก Audit Log: CANCELLED + user + timestamp
• Shop Drawing Revision ที่ถูกผูก → ปลดผูก (available สำหรับ RFA ใหม่)

---

US-012c — ค้นหาและกรองรายการ RFA

Priority: 🔴 M | SP: 5 | AC: AC-RFA-009

As a Document Control / Engineer
I want to ค้นหา RFA ด้วย Project, Status, Keyword
So that หาเอกสารที่ต้องการได้รวดเร็ว

Done When:

• Filter: Project (จาก Project Selector), Status Code (DFT/FAP/1A/4X/CC), Revision Status (CURRENT/OLD/ALL)
• Search: เลขเอกสาร, Subject
• RBAC: DFT → เห็นเฉพาะ originator org | สถานะอื่น → เห็นตามสิทธิ์ปกติ
• Pagination: 20 items/page, แสดง total count

---

US-013 — Submit RFA ผ่าน Transmittal

Priority: 🔴 M | SP: 8 | AC: AC-RFA-002, AC-TRM-001

As a Document Control ของ Contractor
I want to สร้าง Transmittal รวม RFA หลายฉบับ ส่งไปยังที่ปรึกษา
So that ส่งเอกสารเป็นชุด ที่ปรึกษาได้รับทุกฉบับพร้อมกัน

Done When:

• Transmittal → เลือก RFA หลายฉบับ | ออกเลขเองเป็น Correspondence
• สถานะ → FAP (For Approval) | Workflow Instance ถูกสร้าง
• ผู้รับ → Notification | สถานะ SUBMITTED
• สร้าง Workflow Instance อัตโนมัติ
• อ้างอิงเอกสารด้วย UUID (ADR-019)
• RFA แต่ละฉบับ → ออกเลขตาม Format LCBP3-RFA-{DISCIPLINE}-{SEQ}

---

US-014 — Review RFA (Approved / w.Comments / Rejected)

Priority: 🔴 M | SP: 5 | AC: AC-RFA-003~005

As a Engineer ของ Supervisor Organization
I want to เปิดดู Shop Drawing และให้คำตอบ RFA
So that Contractor ได้รับผลพิจารณาและดำเนินการต่อได้

Done When:

• PDF Viewer Streaming | ปุ่ม: Approved (1A) / Approved w/Comments (1B) / Rejected (4X)
• Comment บังคับสำหรับ 1B และ 4X
• Originator → Notification | Workflow History บันทึกครบ
• อ้างอิงเอกสารด้วย UUID (ADR-019)

---

US-015 — ยื่น RFA Revision ใหม่หลัง Reject

Priority: 🟠 S | SP: 5 | AC: AC-RFA-006

As a Document Control ของ Contractor
I want to สร้าง RFA Revision ใหม่ (Rev.B) หลัง Rev.A ถูก Rejected
So that แก้ไขและยื่น Shop Drawing เวอร์ชันใหม่ได้

Done When:

• Rev.B ผูกกับ Shop Drawing Rev.B | Rev.A ยังดูได้
• Revision Code เปลี่ยนตาม Sequence (A→B→C)

---

📐 Epic 4: Drawing Management

US-016 — Upload Contract Drawing

Priority: 🟠 S | SP: 5 | AC: AC-DRW-001

As a Document Control ของ Design Consultant
I want to Upload แบบคู่สัญญา (Contract Drawing) พร้อมกำหนดหมวดหมู่
So that Contractor ใช้อ้างอิงใน Shop Drawing ได้

Done When:

• Upload PDF → Drawing Number, Category, Discipline
• Shop Drawing Link Reference กับ Contract Drawing ได้

---

US-017 — Upload Shop Drawing + Revision Control

Priority: 🟠 S | SP: 5 | AC: AC-DRW-002, AC-DRW-003

As a Document Control ของ Contractor
I want to Upload Shop Drawing พร้อม Reference Contract Drawing และจัดการ Revision
So that ผู้ Review เห็น Revision ล่าสุด และ History ทุก Revision

Done When:

• ค้นหาและเลือก Contract Drawing ที่ Reference
• Rev.ใหม่ → Rev.เก่า Mark "Superseded" แต่ยังดูได้
• 1 Revision = 1 RFA เท่านั้น (Constraint enforced)

---

⚙️ Epic 5: Workflow Engine

US-018 — ดู Workflow Diagram ของเอกสาร

Priority: 🟠 S | SP: 3 | AC: AC-WF-004

As a ผู้ใช้งานที่มีสิทธิ์ดูเอกสาร
I want to เห็น Workflow Diagram แบบ Visual
So that รู้ทันทีว่าเอกสารอยู่ขั้นตอนไหน ใครถืออยู่

Done When:

• Workflow Diagram แสดง State ปัจจุบัน (Highlight)
• คลิก Step ที่ผ่านมา → Audit Log ย่อย (ใคร/เมื่อไหร่/Comment)
• Step ที่ยังไม่ถึง → Disabled Style
• อ้างอิงเอกสารด้วย UUID (ADR-019)

---

US-019 — Approve / Reject ผ่าน Workflow

Priority: 🔴 M | SP: 5 | AC: AC-WF-002, AC-WF-003

As a Reviewer ที่ถูก Assign ใน Workflow
I want to Approve / Reject เอกสารในขั้นตอนที่ฉันรับผิดชอบ
So that Workflow เดินหน้าหรือส่งกลับตามการตัดสินใจ

Done When:

• เห็นปุ่ม Action เฉพาะ Step ที่เป็นของฉัน
• Wrong Role → ปุ่มซ่อน / 403 ถ้าเรียก API ตรงๆ
• ทุก Action → Workflow History + Timestamp + Audit Log
• อ้างอิงเอกสารด้วย UUID (ADR-019)

---

US-020 — Force Proceed + Revert (Document Control)

Priority: 🟡 C | SP: 3 | AC: AC-WF-005

As a Document Control
I want to บังคับข้ามหรือย้อน Workflow Step ในกรณีพิเศษ
So that Workflow ที่ติดขัดถูก Unblock ได้อย่างมีหลักฐาน

Done When:

• ปุ่ม "Force Proceed" / "Revert" เห็นได้เฉพาะ Document Control ขึ้นไป
• ต้องกรอก reason | Audit Log: FORCE_PROCEED / REVERT

---

US-021 — กำหนด Deadline ใน Workflow

Priority: 🟡 C | SP: 3 | AC: AC-WF-006

As a Document Control
I want to กำหนด Deadline ให้แต่ละ Organization ใน Workflow
So that ดำเนินการทันเวลา ไม่เกิดความล่าช้า

Done When:

• กำหนด Due Date ต่อ Org ใน Workflow
• เกิน Deadline → Dashboard Overdue Badge + Notification
• 2 วันก่อน → Reminder Notification

---

📄 Epic 6: Circulation Sheet

US-022 — สร้าง Circulation Sheet

Priority: 🟠 S | SP: 5 | AC: AC-CIRC-001

As a Document Control ภายในองค์กร
I want to สร้างใบเวียนสำหรับ Correspondence พร้อมกำหนดผู้รับผิดชอบ
So that งานถูก Assign ชัดเจนและมีหลักฐาน

Done When:

• กำหนด Main / Action / Information Assignees (หลายคน)
• Assignees → In-App + Email Notification
• Internal Only (ไม่เห็นข้ามองค์กร)
• อ้างอิงเอกสารด้วย UUID (ADR-019)

---

US-023 — ติดตาม Circulation Deadline + ปิด

Priority: 🟠 S | SP: 3 | AC: AC-CIRC-002, AC-CIRC-003

As a Assignee / Document Control
I want to เห็น Deadline งานของฉันและปิด Circulation เมื่อเสร็จ
So that ไม่พลาดงาน และ Track สถานะได้ชัดเจน

Done When:

• Dashboard My Tasks แสดง Deadline + Overdue Badge
• ปิด Circulation → สถานะ CLOSED + Timestamp
• My Tasks ลบรายการที่ปิดแล้ว
• อ้างอิงเอกสารด้วย UUID (ADR-019)

---

🔍 Epic 7: Search & Notifications

US-024 — ค้นหาเอกสาร Full-text

Priority: 🟠 S | SP: 5 | AC: AC-SRCH-001

As a ผู้ใช้งานทุกประเภท
I want to ค้นหาเอกสารด้วย Keyword ได้รวดเร็ว
So that พบเอกสารที่ต้องการโดยไม่ต้องจำเลขที่แม่นยำ

Done When:

• ผล Search < 500ms (Elasticsearch) | ค้นจาก เลขเอกสาร, Subject, Tag
• แสดงเฉพาะเอกสารที่มีสิทธิ์เห็น

---

US-025 — รับ Notification (Email + In-App)

Priority: 🟠 S | SP: 5 | AC: AC-NOTIF-001, AC-NOTIF-002

As a ผู้ใช้งาน
I want to รับ Email และ In-App Notification เมื่อมี Event เกี่ยวข้องกับฉัน
So that ไม่พลาดงานโดยไม่ต้องเช็คระบบตลอดเวลา

Done When:

• Email ถูกส่งภายใน 5 นาที หลัง Event (BullMQ Queue)
• Bell Icon Unread Count | คลิก → Navigate ไปเอกสาร (ใช้ UUID)
• Retry 3 ครั้ง ถ้าส่งไม่ได้ → Dead Letter Queue

---

💾 Epic 8: File & Dashboard

US-026 — Upload ไฟล์ + ดู PDF ในแอป

Priority: 🟠 S | SP: 5 | AC: AC-STOR-001, AC-STOR-003

As a Document Control / Reviewer
I want to Upload ไฟล์หลายไฟล์และดู PDF ในแอปได้เลย
So that ทำงานเร็วขึ้นและลดความเสี่ยงข้อมูลรั่วจาก Download

Done When:

• Drag-and-Drop Multi-file | ClamAV Scan < 30s
• In-App PDF Viewer (Range Requests Streaming)
• ปุ่ม Download → Disabled สำหรับ Viewer-only

---

US-027 — Dashboard KPI ส่วนตัว

Priority: 🟠 S | SP: 5 | AC: AC-DASH-001

As a ผู้ใช้งานทุกประเภท
I want to เห็น Dashboard สรุปงานของฉันทันทีที่ Login
So that รู้สถานะงานโดยไม่ต้องไล่ดูแต่ละ Module

Done When:

• KPI Cards: Pending RFA, Pending Correspondence, Overdue Circulation
• My Tasks Table: Circulation ที่ค้าง + Deadline
• Filter ตาม Permission ของ User

---

📊 Story Map Summary

Epic	Stories	🔴 Must	🟠 Should	🟡 Could
Auth & Users	US-001~006	4	1	1
Correspondence	US-007~011	2	2	1
RFA	US-012015, 012a012c	4	3	0
Drawing	US-016~017	0	2	0
Workflow	US-018~021	1	1	2
Circulation	US-022~023	0	2	0
Search & Notify	US-024~025	0	2	0
File & Dashboard	US-026~027	0	2	0
รวม	30	11	15	4

MVP Sprint Focus: US-001006, US-007008, US-012015, US-012a012c, US-019 — ครอบคลุม Core Happy Path ทั้งหมด

---

📝 Document Control

• Version: 1.8.1 | Status: Updated
• Created: 2026-03-11 | Updated: 2026-03-24 | Owner: Nattanin Peancharoen
• Changes: Added US-012a~012c (Edit/Cancel/Search RFA), Updated Epic 3 story count, Added RBAC filtering details
• Classification: Internal Use Only