Implementation Roadmap (Living)

Đường hướng triển khai gồm 8 Work Packages. Tham chiếu file gốc baseline/imported_sources/FITZALO_V2_MASTER_PLAN/IMPLEMENTATION_ROADMAP_FULL.md.

Định nghĩa Hoàn thành (Definition of Done - DoD)

Mỗi Module trước khi đóng Phase phải thoả mãn:

1. Có Unit Test (coverage logic) + API Contract Testing.
2. DTO validated, RBAC @Permissions tích hợp ở mọi enpoints.
3. Pass các Governance Gates:
   • GOV-AUDIT: Flow Audit Stamping đúng chuẩn (injected at service layer).
   • D-008 (Population): Output đúng định dạng FK + Summary, có support whitelist include.
   • DEC-004 (Timezone): Output ra DB và Client chuẩn 100% ISO-8601 UTC.
4. Tài liệu Traceability (tại docs_hub_v3/03_TRACEABILITY/) cập nhật Matrix thành DONE.

---

Các Phase Triển Khai

Phase 0 — Governance & Baseline (DONE/ONGOING)

• Chốt naming, routing, specs architecture theo Docs Hub V3.
• Chuẩn hoá Decision Log (RBAC, Tenancy, Timezone).

Phase 1 — Core Platform Foundation

• IAM: Auth/JWT, Roles/Perm, Membership lifecycle.
• Tenancy: Tenant management, switch context.
• System: Audit Log, Event Bus (dispatcher/outbox), Notification Hub base.

Phase 2 — Master Data & Catalog

• Catalog: PIM, Product/Category, SKU constraint.
• Global MDM: UoM, Global Attributes.

Phase 3 — Commerce (Orders & Voucher)

• E-Commerce: OMS Flow (State machine, Refund, Split).
• Voucher: Engine rules, Limits, Auto-apply.

Phase 4 — Supply Chain

• Inventory (WMS): Stock Quants, Moves, Valuation.
• Procurement: PO Lifecycle + GRN.

Phase 5 — CRM & Loyalty

• CRM: Unified Partner.
• Loyalty & Affiliate: Tiers, Commission, Ledger points.

Phase 6 — Content & AI

• CMS & Internal Comms: Articles, ESN Feed.
• AI Studio: Knowledge Base RAG + Connectors.

Phase 7 — Integrations, Admin & Zalo Ecosystem

• Zalo Auth Web/MiniApp (Dual Flow).
• ZNS Notifications & Plugin billing models.