00 — Bản đồ tài liệu WELIFE (DOC-MAP)
Đọc file này trước mọi task. Bộ tài liệu chuẩn để AI và người bám cùng một quy ước liên kết FE · BE · Dashboard · Design.
Trạng thái hiện tại (2026-08-17):
STATUS.md— STUB empty · P9 DONE (26/26) · OWNER Pay/SMS/MoMo.
Quy chuẩn ID (bắt buộc)
| Loại | Pattern | Ví dụ |
|---|---|---|
| Domain | D-<CODE> |
D-FNB, D-RIDES |
| Work package | WP-<CODE>-<nn> |
WP-FNB-01 |
| Screen (design) | SCR-<CODE>-<name> |
SCR-FNB-HOME |
| BE module | api/src/modules/<name> |
merchants |
| FE feature | mobile/src/features/<name> |
fnb |
| Dashboard | dashboard/src/modules/<name> |
fnb-ops |
| API Swagger tag | khớp domain code lower | merchants, rides |
| Acceptance | AC-<CODE>-<nn> |
AC-FNB-01 |
Quy tắc liên kết: mọi PR / task AI phải ghi Domain + WP trong mô tả. Không code ngoài domain đã chọn.
Bộ tài liệu (thứ tự đọc)
| # | File | Mục đích |
|---|---|---|
| ★ | STATUS.md | Snapshot 2026-08-17 · P9 DONE · OWNER Pay/SMS/MoMo |
| 00 | 00-DOC-MAP.md | Mục lục + quy chuẩn ID |
| 01 | 01-MATRIX-TRACEABILITY.md | Ma trận Design↔FE↔BE↔Dash↔Driver · §F BE coverage |
| 02 | 02-ARCHITECTURE.md | Sơ đồ hệ thống, luồng dữ liệu |
| 03 | 03-AI-WORKFLOW.md | Luồng làm việc AI theo WP |
| 04 | 04-SURFACES-CONTRACT.md | Hợp đồng giữa các surface |
| 05 | 05-PHASE-BACKLOG.md | Phase & WP ưu tiên |
| 06 | 06-AI-RULES-EXTENSIONS.md | Rules Cursor + VS Code extensions |
| 07 | 07-ENVIRONMENT.md | Env · Docker · ports · health |
| 08 | 08-FE-ROADMAP-FIGMA-MATRIX.md | Quy tắc FE + lộ trình Figma↔nav↔ma trận |
| 09 | 09-AGENT-AUDIT-QUEUE.md | Hàng đợi STUB→IMP + prompt Cursor |
| 10 | 10-AGENT-AUTONOMOUS-LOOP.md | Loop tự chuyển WP · so ảnh · tự sửa · test local |
| 11 | 11-FE-SURFACE-AUDIT.md | Audit FE/surface sau BE DONE + smoke chain |
| 12 | 12-NEXT-WORK-PLAN.md | Lịch sử P5/P6 · pointer → 16 P7 |
| 13 | 13-FE-SCREEN-GAP-MATRIX.md | Ma trận gap mockup JPG ↔ FE (CON+PAR · soft WP AUTH-UI/SYS) |
| 14 | 14-SCREEN-MATRIX-OFFICIAL.md | Screen Matrix chính thức · 14 board thiếu · nav/RBAC · API · queue DRV→ADM |
| 15 | 15-COMPLETION-AUDIT-MATRIX.md | Hoàn thiện + audit journey UX · P6 (DONE) |
| 16 | 16-PHASE-P7-HARDEN.md | Harden · Release · Ops · OWNER gates |
| 17 | 17-PHASE-P8-GAP-VERTICALS.md | P8 · 6 GAP (charging/transit/home/delivery/qr/bills) + PARTIAL |
| 18 | 18-REPO-STRUCTURE-AUDIT.md | Cấu trúc monorepo · design/mockups · gaps packages/shared |
| 19 | 19-FIGMA-FUNCTION-QUEUE.md | P9 · hoàn thiện chức năng trên hình Figma/JPG · không thêm màn |
| — | design-boards/ | Spec panel 14 board planned (chưa JPG) |
| — | reports/DASHBOARD-AUDIT-PLAN-2026-08-20.md | WP-ADM-AUDIT-01 · 19 màn ADM · gap không API · IA nav |
| — | WP-AUTH-GOOGLE-PREP.md | Google OAuth audit + OWNER Client ID gate |
| — | SECURITY.md | Hardening · checklist production · secrets |
| — | BAO-CAO-TONG-HOP.md | Báo cáo tổng hợp hiện trạng (IMP/STUB + apps) |
| — | AUTH-DRIVER-AUDIT.md | Audit Auth JWT · Driver · Partner gaps |
| — | LOCAL-TEST.md | Checklist test local + smoke |
| — | SMOKE-CHAIN-RESULT.json | Output npm run smoke:chain (latest) |
| — | reports/FUNCTIONAL-AUDIT-2026-08-06.md | WP-FUNCTIONAL-AUDIT-01 final status · corrected classification |
| — | reports/FUNCTIONAL-EXTRA-AUDIT.json | Extra domain API probes (46 checks) |
| — | reports/FIGMA-FE-AUDIT-2026-08-06.md | WP-FIGMA-FE-AUDIT-01 Figma access + CON gap baseline |
| — | reports/FIGMA-FE-FUNCTION-GAP-MATRIX.md | Baseline 2026-08-06 · P9 26/26 supersede function |
| — | reports/DOCS-AUDIT-2026-08-17.md | WP-DOC-AUDIT-01 · audit tài liệu P9 + entry-point |
| — | reports/MOBILE-NAVIGATION-AUDIT.md | Consumer route / tab / stub audit |
| — | design/FIGMA-SCREEN-INVENTORY.md | Figma inventory · SYNC QUEUE COMPLETE (Home→Pharmacy, 2026-08-13) |
| — | design/DESIGN-TOKEN-AUDIT.md | Token audit · local JPG baseline |
| — | references/figma-fe-work-queue.json | P9 FE/Figma function queue (nextRecommended) |
| — | reports/FULL-SCREEN-ERD-AUDIT-2026-08-06.md | Audit tổng màn hình · ERD · mock/API · 404 nav · roadmap |
| — | reports/LOCAL-STABILITY-REPORT-2026-08-06.md | Báo cáo ổn định local (pointer) |
| — | reports/LOCAL-STABILITY-REPORT-2026-08-06-REVISED.md | Gap-closure evidence · LOCAL-STABILITY-GAP-CLOSURE-01 |
| — | reports/REPOSITORY-AUDIT-2026-08-06.md | Repo/mobile/env audit · WP-REPOSITORY-ARCH-ENV-AUDIT-01 |
| — | architecture/REPOSITORY-STRUCTURE.md | Cấu trúc multi-app |
| — | architecture/MOBILE-ARCHITECTURE.md | Consumer Expo architecture |
| — | ROLE-MATRIX.md | WP-AUTH-ROLE-MATRIX-01 · 7 JWT · 4 hat · capability tài xế |
| — | OWNER-GATES.md | OWNER hub: Google · SMS · VNPay · MoMo · EAS · production split |
| — | OWNER-WIRE-CHECKLIST.md | Paste secrets map · WP-OWNER-WIRE-01 |
| — | OWNER-FIREBASE-HYBRID.md | OWNER: Firebase Auth welife-2412 · iOS app · service account |
| — | reports/OWNER-PAY-E2E-2026-08-14.md | VNPay create PASS (2026-08-14) |
| — | reports/OWNER-PAY-E2E-2026-08-17.md | VNPay create PASS (re-smoke 2026-08-17) |
| — | reports/OWNER-SMS-READY-2026-08-14.md | eSMS keys READY · e2e phone OWNER |
| — | reports/OWNER-SMS-MATRIX-AUDIT-2026-08-14.md | Ma trận · sơ đồ · logic audit SMS eSMS (done/fail/blast) |
| — | reports/OWNER-SMS-E2E-2026-08-14.md | Preflight e2e SMS · chờ OWNER |
| — | reports/WP-FE-AUTH-SMS-ESMS-01.md | FE phone → Nest eSMS (thay Firebase Phone) |
| — | reports/OWNER-MOMO-FAIL-2026-08-14.md | MoMo create FAIL · merchant portal |
| — | EAS-BUILD.md | WP-EAS-01/DRV/PAR · profiles · APK links |
| — | architecture/ENVIRONMENT-VARIABLES.md | Env pairing · OWNER gates |
| — | reports/ENV-INVENTORY.md | Env inventory (no secrets) |
| — | reports/REPOSITORY-TREE-CURRENT.md | Tree snapshot |
| — | WP-CHAIN-PLAN.md | Plan A+3 Prisma chain MEDIA→RIDE |
| — | HOMEFIX-GAP.md | Chuẩn mật độ Swagger tham chiếu |
| — | SWAGGER-AUDIT.md | Trạng thái API/docs hiện tại |
| — | SOUND-PACK-AI-BRIEF.md | 28 SFX/ringtone · upload media · brief đội phối âm AI |
| — | architecture/MOBILITY-MATRIX.md | WP-DOC-MOBILITY-MATRIX-01 · gọi xe / FNB / delivery / school-trips · thoát app |
| — | design-index.md | Map file JPG → domain |
| — | FIGMA.md | Kết nối Figma MCP |
| — | BACKUP-POSTGRES.md | WP-BACKUP-PG-01 · cron dump + restore drill |
| — | OSRM-SELF-HOST.md | WP-ROUTE-OSRM-SELF-01 · Vietnam OSRM Docker |
| — | S3-LEASTPRIV.md | WP-S3-LEASTPRIV-01 · MinIO app user |
| — | UBUNTU-DEPLOY.md | Deploy |
Surfaces (bề mặt sản phẩm)
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐
│ Consumer FE │ │ Partner FE │ │ Driver FE │ │ Admin Dash │
│ mobile/ │ │ partner/ │ │ driver/ │ │ dashboard/ │
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘ └──────┬───────┘
│ │ │ │
└────────────────┴────────┬───────┴────────────────┘
│
┌────────────▼────────────┐
│ BE NestJS api/ │
│ Swagger /docs │
│ JWT + RBAC + WS │
└────────────┬────────────┘
│
┌──────────────────┼──────────────────┐
▼ ▼ ▼
PostgreSQL+PostGIS Redis MinIO/S3
Definition of Done (chung)
Một WP chỉ Done khi:
- Design screen ID có trong ma trận
- FE screen/feature path tồn tại (hoặc N/A có lý do)
- BE endpoint trong Swagger (implement hoặc stub ghi rõ)
- Dashboard/Partner/Driver liên quan được nêu (hoặc N/A)
AC-*checklist pass- Không phá quy chuẩn ID / không lệch domain
Canvas sống
Ma trận tương tác (IDE): canvases/welife-doc-matrix.canvas.tsx