Hồ sơ bệnh án

● Đang làm★ NewLPO2026-04-30

clinical-recordclinicmedicalappointmentauditbefore-afterdermatologycosmetic-surgerysales-safedoctor-workbenchcustomer-intakego-livehasurapermission-specrefuse-procedurecompliance-auditprint-designuser-guide

Mô tả

Package tài liệu cho tính năng số hóa hồ sơ bệnh án tại Diva, áp dụng cho phòng khám Da liễu (DL) và Phẫu thuật Thẩm mỹ (TM). Bản v2.4.0 hardening toàn diện 3 vòng: (1) đóng các lỗ hổng nhất quán cross-spec UI/PRD/Dev/QA — chốt 6 bước trợ lý cấu hình + đóng customer_id=NULL walk-in + bổ sung luồng "Khách từ chối thủ thuật" DEC-024 + rule câu xác nhận tự gõ DEC-021; (2) thêm 3 file canonical mới — permission-spec.md (P1-P12 phân quyền 22 action × 9 role + Compliance UI SCR-18 + 44 TC-PERM-*), print-design-spec.md (A4 mockup 7 biểu mẫu + versioning + retention 10 năm), user-guide.md (hướng dẫn 7 vai trò end-user + KH + FAQ + hotline); (3) UI Spec bổ sung 7 variant per role cho SCR-01 + SCR-18 Compliance Audit Viewer. Vẫn giữ Dynamic Permission v2, Ma trận ranh giới ảnh hưởng, B0 baseline UI hiện tại, bản giấy ký tay là gốc pháp lý, no raw clinical runtime user, live gate theo clinic_module_publication, và các surface vận hành như Trang xem an toàn (Sale), Bàn việc bác sĩ, Phiếu khách tự khai, Trang điều phối phòng khám và Chốt ngày phòng khám.

Tài liệu

File	Nội dung	Đọc bởi
Tóm tắt quyết định	Cửa vào 5 phút, phạm vi, quyết định, rủi ro và đường đọc tiếp	PO, Sếp, TL, Delivery
PRD	19 FR, 44 DEC, glossary canonical 34 thuật ngữ, formulas, metrics	Tất cả
UI Spec	18 SCR + 7 variant per role SCR-01 + Dynamic Permission gating + copy tiếng Việt + states + edge cases 12 nhóm	FE, UI/UX, QA
Dev Spec	Data model 18 bảng, 13 action + 4 trigger, migration 7 phase, security, traceability	BE, FE, TL
QA Test Plan	108 core TC + 44 TC-PERM-* dẫn xuất từ permission-spec, seed data, entry/exit	QA
Permission Spec	Canonical phân quyền P1-P12: 22 action × 9 role + resolver Go + branch_mode + portal + cache + migration + masking matrix + emergency governance + Compliance UI	Security, BE, FE, QA, Compliance
Print Design Spec	Canonical bản in pháp lý PR1-PR9: A4 mockup chi tiết 7 biểu mẫu + versioning v1/v2 + retention 10 năm + PDF generation config	Designer, FE, Print/PDF service Dev, Legal
User Guide	Hướng dẫn vận hành end-user — 7 vai trò + KH + 15 FAQ + roster hotline + onboarding tour	BS, Y tá, Lễ tân, Sale, QL CN, Compliance, Admin/Ops
Go-Live	Cổng sẵn sàng, thứ tự deploy, rollback, sign-off	Ops, TL
Handoff	RACI, timeline, blockers B-1..B-20, delivery note	PM, TL

Tính năng chính

• Bật/tắt module phòng khám theo chi nhánh, kèm trợ lý cấu hình 6 bước (5 cấu hình + 1 kiểm tra sẵn sàng R-01..R-10).
• Tạo lượt khám từ đơn hoặc walk-in; walk-in buộc tạo KH inline (customer_id không rỗng theo schema NOT NULL); link đơn muộn bằng order.reference_appointment_id.
• Điền BA Da liễu và Thẩm mỹ trên phần mềm, in ra để ký tay rồi tải bản scan đã ký lên hệ thống — bản giấy ký tay vẫn là gốc pháp lý theo TT46/2018.
• 7 biểu mẫu pháp lý có A4 mockup chi tiết trong print-design-spec.md: BA DL, BA TM, Cam đoan, Cam kết, Đơn thuốc, Phiếu dị ứng (TT51/2017), Phiếu theo dõi điều trị.
• Phân 3 tầng dữ liệu bằng Dynamic Permission v2 canonical — 22 action × 9 role × 5 portal × 4 branch_mode + emergency override governance + cache TTL 60s + migration backward-compat preset; UI vận hành đọc qua secure view/action; Sale tuyệt đối không thấy tầng 3 (hard-deny).
• Luồng "Khách từ chối thủ thuật" (DEC-024): hộp thoại trong Cam đoan → huỷ order_item thủ thuật + ghi sổ "Kết quả: Khách từ chối thủ thuật" + giữ BA DL nếu có + NTF-14 thông báo QL CN/Sale.
• Rule câu xác nhận tự gõ trong Cam đoan (DEC-021): ≥20 ký tự, chứa "đồng ý"/"thực hiện", FE chặn dán + audit nhịp gõ chống auto-typer.
• SCR-18 Compliance Audit Viewer — Compliance officer xem medical_record_access_log + emergency override sessions + anomaly alert + export Excel cho Sở Y tế.
• Có Trang xem an toàn (Sale), Bàn việc bác sĩ (6 nhóm việc), Phiếu khách tự khai (token 15 phút), sổ khám/sổ thủ thuật, dị ứng config-driven, audit log và Chốt ngày phòng khám cuối ngày.
• 7 variant wireframe per role cho SCR-01 (Customer Detail tab Hồ sơ bệnh án): BS cùng CN / BS khác CN / Y tá / Sale → SCR-13 / no permission / loading-error-empty / emergency override active.
• Khóa ranh giới ảnh hưởng cho feature lớn: module ảnh hưởng trực tiếp có người phụ trách/việc/test, module gián tiếp có guard, module không ảnh hưởng có smoke regression D6 và cổng go-live TC-15.
• Go-live chỉ mở theo clinic_module_publication.status='live' AND effective_at <= now(); production rollback sau D0 giữ DB và dữ liệu audit.
• User Guide cho end-user — 7 vai trò có quy trình ngày làm việc + lỗi thường gặp + 15 FAQ + roster hotline D0 + onboarding tour 5-step.

Lịch sử thay đổi

Version	Ngày	Thay đổi	File	Ảnh hưởng
v2.4.0	30/04/2026	Hoàn chỉnh package end-user: thêm user-guide.md v1.0.0 (10 mục, 7 role + KH + FAQ + hotline) và print-design-spec.md v1.0.0 (PR1-PR9, A4 mockup chi tiết 7 biểu mẫu). UI Spec thêm 7 variant per role cho SCR-01 (A: BS cùng CN, B: BS khác CN, C: Y tá, D: Sale redirect, E: no permission, F: loading/error/empty, G: emergency override active) khớp permission-spec.md P10 field masking. RACI/blocker handoff thêm B-18..B-20.	User Guide, Print Design Spec, UI Spec, Handoff	All
v2.3.0	30/04/2026	Tách Permission Spec canonical: permission-spec.md v1.0.0 (P1-P12) — 22 action × 9 role default seed + resolver Go signature + 4 branch_mode behavior + 5 portal isolation + is_pos_only enforce + emergency override governance (rate limit, session 1h, cron expire, manual revoke) + cache TTL 60s + migration M101-M107 + field masking matrix per view_mode + Compliance UI SCR-18 + 44 TC-PERM-* test matrix. PRD FR-011 mở rộng 8 AC (AC-011.13..20) trỏ về permission-spec.	Permission Spec, PRD, UI Spec, Dev Spec, QA	Security + BE + FE + QA + Compliance
v2.2.0	30/04/2026	Đóng các lỗ hổng nhất quán UI ↔ PRD ↔ Dev ↔ QA: chuẩn hoá trợ lý 6 bước (5 cấu hình + Kiểm tra sẵn sàng) + redo wireframe stepper SCR-04; loại nhánh customer_id=NULL walk-in (buộc tạo KH inline); thêm CTA "Tạo đơn từ lượt khám" SCR-03; bổ sung luồng "Khách từ chối thủ thuật" DEC-024 (hộp thoại + huỷ order_item + audit + NTF-14); chuẩn hoá rule câu xác nhận tự gõ DEC-021 (≥20 ký tự, chứa "đồng ý"/"thực hiện", FE chặn dán, audit nhịp gõ); sửa lỗi search-replace live → đang hoạt động; sửa "POS portal" → "cổng tablet quầy theo token"; Việt hoá nhất quán; bổ sung +5 cột clinical_record cho refuse procedure; thêm action refuse_clinical_procedure C5.5B; thêm Trigger 4 NTF-14; bổ sung 9 TC mới (TC-030A/B/C/D + TC-090/A/B/C + TC-NTF-14). Total core TC = 108.	UI Spec, PRD, Dev Spec, QA, Decision Brief, Handoff	All
v2.0.0	30/04/2026	Refactor full theo glossary canonical 34 thuật ngữ + template po-ba-workflow mới (G3.7 cổng kiểm tra độ đầy đủ UI). Đổi B-PITFALLS thành B-QUALITY (rủi ro thiếu sót). Giữ 100% DEC/FR/AC.	PRD, UI Spec, Dev Spec, QA	All
v1.5.10	29/04/2026	Biên tập lại văn phong UI/business theo tiếng Việt SaaS thẩm mỹ viện; cập nhật A9 Glossary cho kiểm tra sẵn sàng, phân loại DV-KT, xem khẩn cấp, thông tin KH tự khai và tải scan; không đổi scope/FR/AC	PRD, UI Spec, QA	PO + UI/UX + FE + QA
v1.5.9	28/04/2026	Rà lại UI Spec theo Vietnamese UI Copy Contract: nhãn trạng thái, hành động, loading/trống/lỗi/không có quyền dùng tiếng Việt tự nhiên	UI Spec	PO + UI/UX + FE + QA
v1.5.8	28/04/2026	Làm rõ trạng thái bàn giao sau review kỹ thuật	Decision Brief, Handoff	PO + TL + QA + Delivery
v1.5.7	28/04/2026	Bổ sung Ma trận ranh giới ảnh hưởng	Decision Brief, PRD, Dev Spec, QA, Go-Live, Handoff	All
v1.5.6	28/04/2026	Đồng bộ Dynamic Permission v2: thêm DEC-043, canonical action matrix, UI B5 theo action/portal	PRD, UI Spec, Dev Spec, QA, Go-Live, Handoff	All
v1.5.5	28/04/2026	Bổ sung độ bao phủ cho feature lớn: B1.0 bản đồ trải nghiệm theo vai trò, B3.0 ma trận bao phủ flow/case	UI Spec	PO + UI/UX + FE + QA
v1.5.1	28/04/2026	Hardening sau review đa góc nhìn: no raw clinical runtime, live gate theo publication, form write qua action validate	Decision Brief, PRD, UI Spec, Dev Spec, QA, Go-Live, Handoff	All
v1.1	21/04/2026	Chốt 3 quyết định Day-1: walk-in late-link qua order.reference_appointment_id, cross-branch manual fallback + emergency override, UI surface bám BranchDetail / CustomerDetail	PRD, UI Spec, Dev Spec, QA	All
v1.0	21/04/2026	Khởi tạo package Hồ sơ bệnh án	—	All