Feature Status Matrix
Mục tiêu: 1 bảng duy nhất để biết feature đang ở đâu (spec/UI/API/entities/RBAC). Quy ước: update-in-place, không tạo bản mới. SoT trạng thái delivery/runtime: file này là nguồn chuẩn;
02_SPECS/MODULE_INDEX.mdchỉ phản ánh legacy planning snapshot.
MiniApp V2 Packet Coverage Snapshot (2026-02-27)
- Packet coverage: 36/36 (100%) theo
WI-MA-S*trên board. - Nguồn chuẩn packet index:
02_SPECS/workitems/WI-MA_PACKET_INDEX.md. - Nguồn chuẩn sprint board:
03_TRACEABILITY/WORKITEM_BOARD.md. - Trạng thái: No missing packet.
Status Enum
- NOT_STARTED: chưa làm
- SPEC_ONLY: có spec nhưng chưa UI/API
- UI_MOCK: UI mock có nhưng backend chưa (hoặc mock api)
- API_ONLY: backend có nhưng UI chưa
- IN_PROGRESS: đang làm
- DONE: xong + test
- MISMATCH: lệch spec/UI/API cần quyết định hoặc refactor
- DEPRECATED: bỏ, có thay thế
Legacy ↔ Runtime Status Mapping (Reference)
Legacy Plan Status (02_SPECS/MODULE_INDEX.md) | Runtime Status (this matrix) | Interpretation |
|---|---|---|
⚪ TODO | NOT_STARTED / SPEC_ONLY | Chưa có thực thi hoặc mới có spec |
🟡 Partial | IN_PROGRESS / API_ONLY / UI_MOCK | Có thực thi một phần, chưa hoàn chỉnh |
✅ | IN_PROGRESS hoặc DONE (theo evidence) | Legacy hoàn tất kế hoạch không mặc định là runtime DONE |
Conflict rule: trạng thái runtime/delivery luôn lấy theo bảng này.
Matrix
| Feature Key | Feature Name | Surface | Priority | Canonical Ref (CKB) | Portal Route / Screen | MiniApp Screen | API Endpoints | Entities | Permissions/Roles | Status | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| CORE.IAM | IAM & Auth | All | P0 | 03_MODULES/IAM/10_REQUIREMENTS.md | /login, /workspace | n/a | POST /v2/iam/auth/* | User, Identity | Public | IN_PROGRESS | Core flow chạy tốt, nhưng module spec chi tiết chưa được viết trong specs/modules/IAM |
| CORE.TENANT | Multi-tenancy | All | P0 | 03_MODULES/TENANT/10_REQUIREMENTS.md | /workspace, /onboarding, AdminTeam | n/a | POST /v2/tenants, GET /v2/tenants/:id/provisioning | Tenant, Membership | TENANT_CREATE_OPEN | IN_PROGRESS | Contract test migration settings đã pass (tenant-settings); còn checklist rollout để chốt DONE |
| CORE.ZALO-WEB | Zalo Login (Portal) | Portal | P0 | 03_MODULES/ZALO/10_REQUIREMENTS.md | ZaloCenter | n/a | POST /v2/iam/auth/zalo-login | User, Identity | Public | IN_PROGRESS | Đã có endpoint, cần module spec + test matrix theo scenario lỗi |
| CORE.ZALO-MINI | Zalo Login (Mini) | MiniApp | P0 | 03_MODULES/ZALO/10_REQUIREMENTS.md | n/a | /auth/login | POST /v2/iam/auth/zalo-tenant-login | User, Identity | Public | IN_PROGRESS | Luồng có sẵn theo DEC-002, chưa có module spec chi tiết |
| CAT.PRODUCTS | Catalog (Tenant) | All | P1 | 03_MODULES/CATALOG/10_REQUIREMENTS.md | ProductList, ProductForm | /pages/catalog | /v2/catalog/products, /v2/catalog/brands | Product, Category, Brand | CAT_MANAGE | DONE | Portal đã map API thật + filter/search server-side + error state; smoke backend PASS (nx test catalog), blocker type-check legacy ngoài scope catalog đã được gỡ; closeout 04_OPERATIONS/18_WI-PB-001_CLOSEOUT_2026-02-27.md |
| COM.ORDER | Cart & Order | All | P1 | 03_MODULES/ORDER/10_REQUIREMENTS.md | OrderList, OrderDetail | /pages/cart, /pages/order | /v2/ecommerce/orders | Order, Cart | ORDER_MANAGE | IN_PROGRESS | Có tests và DEC-007, nhưng thiếu module spec đầy đủ |
| INV.STOCK | Inventory WMS | Portal | P1 | 03_MODULES/INVENTORY/10_REQUIREMENTS.md | InventoryDashboard | n/a | /v2/supply-chain/inventory | Stock* | INV_MANAGE | IN_PROGRESS | API/UI có, cần đóng gói flow vận hành và edge-case spec |
| CRM.PARTNER | Unified CRM | Portal | P1 | 03_MODULES/CRM/10_REQUIREMENTS.md | PartnerList, CustomerList | n/a | /v2/crm/partners | Partner | CRM_MANAGE | IN_PROGRESS | Có controller và permissions, thiếu spec module chính thức |
| CT.CMS | CMS Articles | Both | P2 | 03_MODULES/CMS/10_REQUIREMENTS.md | CMS, ArticleForm | /pages/blog | /v2/content/cms/articles | Article | CMS_MANAGE | IN_PROGRESS | Route/API có, chưa có spec module CMS trong specs/modules |
| CT.ESN | Internal Comms | Portal | P2 | 03_MODULES/ESN/10_REQUIREMENTS.md | InternalComms | n/a | /v2/content/comms | CommsPost, Event | COMMS_MANAGE | IN_PROGRESS | Controller có, test coverage module còn thấp |
| MKT.VOUCHER | Vouchers | Both | P2 | 03_MODULES/VOUCHER/10_REQUIREMENTS.md | VoucherList | /pages/promo | /v2/marketing/vouchers | Voucher | VOUCHER_MANAGE | IN_PROGRESS | Nghiệp vụ chính có, cần module spec và test cases rule đầy đủ |
| FILE.MGMT | File Management | Backend | P1 | 02_SPECS/modules/file-management/10_REQUIREMENTS.md | n/a (portal pending) | n/a | /v2/files/* | FileAsset, TenantFilePolicy, TenantFileEntitlement, FileUsageLedger, FileShareLink, FileMigration | FILE_* | IN_PROGRESS | Runtime backend đã có policy/entitlement/upload/preflight/assets/share/usage/migration + metadata update/restore; portal route/page chưa implement, pending contract test closeout |
| AI.STUDIO | AI Studio/KB | Portal | P2 | 03_MODULES/AI/10_REQUIREMENTS.md | AIStudio, DataSources | n/a | /v2/ai/* | AiDocument, Profile | AI_MANAGE | IN_PROGRESS | API/UI đã nối, cần hardening spec connectors/observability |
| ADMIN.GLOBAL | System Admin | Portal | P1 | 03_MODULES/ADMIN/10_REQUIREMENTS.md | /admin/plugins | n/a | GET /v2/admin/plugins/* | InstalledPlugin | SYSTEM_ADMIN | IN_PROGRESS | Luồng admin chạy, nhưng master spec admin chưa được chuẩn hóa |
| MKT.AFFILIATE | Affiliate/Loyalty | Both | P3 | 03_MODULES/AFFILIATE/10_REQUIREMENTS.md | AffiliateProgram, CustomerLoyaltyPage | n/a | /v2/crm/loyalty/* | LoyaltyTier, PointTransaction, MembershipCondition | AFFILIATE_MANAGE | IN_PROGRESS | Portal page /crm/loyalty wired to API (conditions CRUD + evaluate), Affiliate tab hardcoded |
| SYS.BILLING | Billing/Usage | Portal | P2 | 03_MODULES/BILLING/10_REQUIREMENTS.md | /admin/billing | n/a | /v2/billing/* | Subscription | BILLING_MANAGE | IN_PROGRESS | Portal wired to API (getActiveSubscription, getUsageSummary); usage/summary endpoint now implemented (was stub) |
| CRM.INBOX | Unified Inbox | Both | P2 | 03_MODULES/INBOX/10_REQUIREMENTS.md | /comms/inbox | n/a | /v2/crm/inbox/* | Conversation | INBOX_MANAGE | IN_PROGRESS | Endpoint đầy đủ, test module chưa có đủ contract coverage |
| SYS.MDM | Master Data | Backend | P1 | 03_MODULES/MDM/10_REQUIREMENTS.md | /admin/master-data/* | n/a | /v2/admin/mdm/* | GlobalUOM, GlobalAttribute | SYSTEM_ADMIN | IN_PROGRESS | Cần module spec MDM và checklist migration data |
| SYS.NOTIFY | Notification Hub | Both | P1 | 03_MODULES/NOTIFY/10_REQUIREMENTS.md | n/a | n/a | /v2/content/notifications/* | Notification | NOTIFY_VIEW/NOTIFY_MANAGE | IN_PROGRESS | Permission typing fixed: 'NOTIFY_*' as any → PermissionString enum; 4 in-app endpoints now guarded |
| SYS.PLUGIN | Plugin System | Portal | P1 | 03_MODULES/PLUGIN/10_REQUIREMENTS.md | /admin/plugins | n/a | /v2/admin/plugins | Plugin | PLUGIN_MANAGE | IN_PROGRESS | Flow có nhưng chưa có module spec enterprise hoàn chỉnh |
| INV.PROCURE | Procurement | Portal | P2 | 03_MODULES/PROCUREMENT/10_REQUIREMENTS.md | PurchaseOrderList | n/a | /v2/supply-chain/procurement | PurchaseOrder | PROC_MANAGE | IN_PROGRESS | Logic chính + tests có, thiếu module spec/policy edge cases |
| COM.SHIPPING | Shipping Layer | Portal | P2 | 03_MODULES/SHIPPING/10_REQUIREMENTS.md | ShippingList, ShippingDetail | n/a | /v2/supply-chain/shipping | ShippingOrder | SHIP_MANAGE | IN_PROGRESS | Đã có endpoint, test coverage hiện bằng 0 theo scan module |
| CRM.VENDORS | Vendor Mgmt | Portal | P2 | 03_MODULES/PARTNER/10_REQUIREMENTS.md | VendorList, VendorDetail | n/a | /v2/crm/partners | Partner | CRM_MANAGE | IN_PROGRESS | API/UI có, cần chốt luồng vendor compliance trong spec |
| SC.PRODUCTION | Production Orders | Portal | P2 | n/a | ProductionList, ProductionDetail | n/a | /v2/supply-chain/production/* | WorkOrder | PROD_MANAGE | IN_PROGRESS | NEW: Portal pages + real-provider wired (CRUD + status + progress); backend 5 endpoints |
| FIN.BALANCE | Balance/Wallet | Portal | P2 | n/a | BalanceWallet (/balance) | n/a | /v2/balance/* | Wallet, BalanceTransaction | BILLING_VIEW | IN_PROGRESS | NEW: Portal page wired to API (getWallet, getTransactions, adjustBalance); backend 3 endpoints |
| INT.ZALO | Zalo Integration | Portal | P2 | 03_MODULES/ZALO/10_REQUIREMENTS.md | ZaloCenter (/marketing/zalo) | n/a | /v2/integrations/zalo/* | ConnectedOA, ZnsTemplate | SYSTEM_ADMIN | IN_PROGRESS | Portal refactored from hardcoded → API-driven (getConnectedOAs, getZnsTemplates); backend 4 endpoints |
Bảng này được chuẩn hóa và rehydrate từ
docs_delivery_v2/03_MODULES/*. Canonical CKB nằm tạibaseline/imported_sources/docs_delivery_v2/.
Audit note (2026-02-27): status đã hiệu chỉnh theo code truth v2 + độ đầy đủ tài liệu hiện tại; sẽ nâng lại DONE theo checklist ở 04_OPERATIONS/09_CHECKLISTS.md.
MiniApp V2 note (2026-02-27): packet readiness cho chuỗi WI-MA-S* đã đạt full coverage 36/36; theo dõi execution tiếp theo tại 03_TRACEABILITY/WORKITEM_BOARD.md.
WI-MA-S4-004 Closeout Sync (2026-02-27)
AC-01(Feature status update) được đóng theo quy tắc 2 lớp:- Runtime/domain-level status tiếp tục theo bảng Matrix hiện tại (file này).
- Toàn bộ
MA.*feature keys được maintain trạng thái kỹ thuật chi tiết (Spec/BE/FE/Test tags) tại03_TRACEABILITY/FEATURE_TAG_MATRIX_MINIAPP_V2.md.
- Kết quả sync: không có MA key thiếu trạng thái; packet coverage vẫn 36/36 theo
02_SPECS/workitems/WI-MA_PACKET_INDEX.md. - Cross-check nguồn chuẩn execution:
03_TRACEABILITY/WORKITEM_BOARD.md. AC-02(API traceability update): FILE contracts đã mở rộng mapping tới/v2/files/*bao gồm policy/quota/upload/preflight/metadata lifecycle/share/migration.