Tiến độ — Cách đọc

Folder này chứa mọi file phản ánh "dự án đang ở đâu, làm gì, còn gì". Anh nên bookmark 3 file đầu (changelog, features, gaps-and-plan) — chiếm 90% câu hỏi tiến độ.

Map câu hỏi → file

Câu hỏi	File	Cách đọc
"Hôm qua / tuần này ship gì?"	`changelog.md`	Cuộn bảng `Timeline` xuống đáy — entry mới nhất ở dưới
"Feature X đã làm chưa?"	`features.md`	Tìm Epic, xem checkbox `[x]` (done) / `[ ]` (chưa) / 🚧 (đang làm)
"Test coverage hiện tại?"	`testing.md`	Bảng `Tổng quan` đầu file: số API + e2e + web vitest + playwright
"Roadmap còn gì làm?"	`features.md` §Roadmap	Chia 3 tier: Ngắn hạn / Trung hạn (1-2 tháng) / Dài hạn (3-6 tháng) + Superadmin
"Sprint hiện tại đang nhắm Pxx nào?"	`gaps-and-plan.md`	P0 (blocker) → P1 (sprint hiện tại) → P2 (next) → P3 (sau)
"Đã ship nhưng còn gap gì?"	`DEFERRED.md`	Auto-gen từ `DEFER:<id>` tags — cột trigger nói gap unblock khi nào
"Trạng thái chi tiết per booking transition?"	`../flows/status-matrix/`	7 file (01-create → 07-edge-cases) + checkbox per case

Workflow đề xuất khi muốn check tổng quan

Bức tranh 80% — Mở features.md, đọc:
- Mermaid status-matrix dependency ở đầu
- Epic 6 (Payment) + Epic 10 (Loyalty) — 2 area đang active nhất
- §Roadmap — biết phần nào trong plan
Tuần qua làm gì — Mở changelog.md, scroll xuống đáy đọc 5-10 entry mới nhất (mỗi entry = 1 commit/ship).
Sprint nhắm Pxx nào — Mở gaps-and-plan.md, section P1 = đang queue làm.

Nếu cần dig sâu hơn: docs site documents.<domain> (xem ../operations/deploy-docs-site.md) có sidebar điều hướng full.

Quick snapshot (cập nhật manual khi có milestone lớn)

Snapshot dưới đây có thể drift sau ship mới — luôn cross-check với changelog.md đáy và features.md checkbox để có số liệu chính xác.

Cập nhật lần cuối: 2026-04-25 (sau ship Status-matrix P1-4)

✅ DONE      Tenant + Onboarding (7-step wizard)
             Resource (staff + schedule + time-off)
             Service Catalog
             Booking Engine + Status machine
             Customer + TenantCustomer
             Payment DDD/Hexagonal foundation
             Bambora Classic adapter live
             Customer Portal (Google OAuth, account, 13 Playwright tests)
             Loyalty L1-L3 (schema + helper + reserve)
             Status-matrix P0-1/2/3 + P1-1/2/3/4/5/8/9/10/11 (12 items shipped)
             Role-based access control (API + Web + 7 E2E tests, mobile blocker cleared)
             Docs system (audit + Việt-first + mermaid coverage 18%→44%)

🚧 IN PROGRESS   Loyalty L4-L6 (lifecycle listeners + customer UI)

⏳ NEAR-TERM     SMS booking confirmation
                Production SMTP vendor (defer p1-4-smtp-vendor)
                Reconciliation cron (P2-13)

⏳ MID-TERM      Mobile app (Expo, role audit unblocked)
                Push notifications · WebSocket · Subdomain routing
                Staff self-pick on mobile · Offline sync (WatermelonDB)

⏳ LONG-TERM     Stripe / Vipps / Nets adapters (drop-in via PaymentProviderPort)
                Multi-location (Organization layer above Tenant)
                Analytics · Admin Portal (impersonate flow) · POS integration

Test coverage (2026-04-25): 1332 API unit + 59 e2e · 137 web vitest + 25 Playwright · 1 @integration

Open defers: 7 (xem DEFERRED.md)

Khi nào update file nào

Khi anh	Update file
Ship 1 commit / feature	`changelog.md` (thêm entry timeline, cập nhật Test Coverage table)
Ship Epic-level milestone	`features.md` (tick checkbox `[x]`) + Quick snapshot ở trên
Ship Status-matrix Pxx	`flows/status-matrix/*` checkbox `[x]` + `gaps-and-plan.md` mark done
Add `DEFER:<id>` tag	Chạy `yarn --cwd docs defer:write` regen `DEFERRED.md`
Add test mới	`testing.md` Tổng quan + breakdown per module
Plan thay đổi	`features.md` §Roadmap + (nếu Pxx mới) `gaps-and-plan.md`

Quy ước chi tiết: ../rules/development-rules.md §7a (docs maintenance checklist trước mỗi commit).