v3.1 — 30/04/2026

Thay đổi	Section	Ảnh hưởng
Cập nhật lịch sử thay đổi v3.1 và reading time	Lịch sử thay đổi	All

Tổng hợp tài chính đơn hàng

Lễ tân/Manager/Kế toán xem tổng quan tài chính 1 đơn dịch vụ (doanh thu, đã thu, còn nợ, chi phí, lợi nhuận tạm tính) ngay trong sidebar trái màn chi tiết đơn /e/service-order/:id, giảm thời gian tra cứu từ 3-5 phút xuống dưới 5 giây. Phân quyền field-level qua Dynamic Permission: summary cho Manager/Lễ tân/Kế toán, full P&L cho Admin/BOD.

Tài liệu

File	Nội dung	Đọc bởi
Decision Brief	Tóm tắt 5 phút package	PO, TL, Sếp
PRD	7 FR + 8 công thức nghiệp vụ + glossary	Tất cả
UI Spec	Wireframe + Field×Surface + State×Screen + quality review	FE, UI/UX
Dev Spec	Action handler + migration + hook + permission	BE, FE, TL
QA Test Plan	50 test case + 7 permission test	QA
Handoff	RACI + timeline 14 ngày + blocker	TL, Delivery

Quyết định chính

• DEC-001: Build action backend GetOrderFinancialSummary, KHÔNG aggregate ở FE
• DEC-003: Phân quyền qua Dynamic Permission v2: 2 action view_financial_summary + view_financial_pnl
• DEC-006: Chi phí vật tư trạng thái Đang phát triển, KHÔNG cộng vào P&L (Phase 2)
• DEC-012: fixed_cost_amount là high-water mark — refund không làm giảm
• DEC-015: Cảnh báo lỗ chỉ cho user có view_financial_pnl, copy ghi rõ "Chưa gồm chi phí vật tư"

Phạm vi

✅ Trong phạm vi: Section TÀI CHÍNH sidebar, action backend, App Settings rate, snapshot fixed_cost, hook high-water, 2 permission action, cảnh báo đơn lỗ.

❌ Ngoài phạm vi day-1: Chi phí vật tư cộng P&L, BCTC kế toán, đơn product/prepaid, export Excel, notification SMS/Email cảnh báo lỗ, per-branch rate, backfill order cũ.

Lịch sử thay đổi

Version	Ngày	Thay đổi	File	Ảnh hưởng
v3.1	30/04/2026	Siết UI Spec: thêm UX principles, variant wireframes, Role×Variant và đổi phần review sang ngôn ngữ public-friendly	UI Spec, PRD, QA, Handoff	FE/UI/QA
v3.0	30/04/2026	Initial release theo template po-ba-workflow v3	All	All