Module Inventory — Diva Group

Tổng quan tất cả modules trong hệ thống. Cập nhật khi thêm/xóa module.

Summary

• 21 FE modules (active), 100% đã đủ 3-layer docs
• 11 deep-dive packages trên 10 modules cho các flow rủi ro cao
• 408 FE pages/routes trực tiếp theo inventory hiện tại
• 14 BE services (Go + Hasura)
• 11 databases, 500+ tables
• 3 platform variants: Admin, POS, CRM

Modules

Module	Scope	Groups	Pages	Docs	Priority
ecommerce	Đơn hàng, kho, dịch vụ, sản phẩm, voucher	7	135	🟢	P0
salary	Lương, import/export, dual-record	6	12	🟢	P0
wallet	Ví, giao dịch, commission, refund	3	0	🟢	P0
user	Nhân viên, khách hàng, branch, department	4	18	🟢	P1
report	Báo cáo vận hành, doanh thu, CRM, KPI	5	46	🟢	P1
crm	CRM khách hàng, ticket, assignment	3	17	🟢	P1
notification	Email, SMS, ZNS, push	4	12	🟢	P2
projects	Dự án, task, workflow tour	3	6	🟢	P2
settings	Cấu hình hệ thống và master data	10	91	🟢	P2
cms	Content, campaign, voucher, event	5	30	🟢	P3
dashboard	6 dashboard điều hành	6	6	🟢	P3
kpi	KPI definition, dashboard, metric log	4	4	🟢	P3
affiliate	Cộng tác viên, referral, payout	4	10	🟢	P3
achievement	Huy hiệu cá nhân, phòng ban, program	2	4	🟢	P3
gamification	Lucky-shaking campaign, gift, notification	1	5	🟢	P3
complaint	Khiếu nại, thanh tra, bổ sung hồ sơ	1	3	🟢	P3
conversation	Chat, hội thoại, call	1	1	🟢	P3
timekeeping	Lịch làm việc, chấm công, import	2	3	🟢	P3
auth	Đăng nhập, OTP, reset password	1	4	🟢	P3
homepage	Landing page sau đăng nhập	1	1	🟢	P3
geo	Địa chỉ, subdivision, place lookup	1	0	🟢	P3

Legend: 🟢 Đủ 3 layers | 🟡 Có overview | 🔴 Chưa có doc

Notes

• Groups = số cụm nghiệp vụ chính trong overview.md.
• Pages = số page/route trực tiếp của module; wallet và geo không có page module-local riêng nên hiển thị 0.
• Các module lớn như ecommerce, settings, report, user, notification, cms đang dùng pattern đa-domain nhưng vẫn được quản lý như một module trong inventory này.
• Các package đào sâu flow lớn nằm dưới docs/modules/<module>/deep-dives/ và không thay thế 3-layer docs cơ bản.

Doc Layers

Layer	File pattern	Nội dung	Viết bởi
1. Overview	overview.md	Module scope, pages, actors, integration	PO + AI
2. Business Rules	{domain}.md	Luồng nghiệp vụ, rules, RBAC, edge cases	PO + AI
3. Technical Map	{domain}.technical.md	Routes, FE map, GraphQL/API, tables, findings	AI + source audit
4. Deep Dive	deep-dives/<slug>/	Flow audit, state machine, side effects, bug/drift register	AI + source audit

Deep-Dive Coverage

Module	Packages
affiliate	approval-and-payout
complaint	case-lifecycle
conversation	runtime-and-provider-boundary
crm	ticket-workflow
ecommerce	refund-withdraw, inventory-operations
gamification	lucky-shaking
kpi	lifecycle-and-notification
projects	task-lifecycle-and-tour-income
timekeeping	request-working-schedule
wallet	transaction-request-and-commission

Cross-module findings register: docs/modules/phase-2-findings.md

Phases

Phase	Modules	Status
Phase 1	salary, wallet	✅ Done
Phase 2	ecommerce (core domains)	✅ Done
Phase 3	user, report, crm	✅ Done
Phase 4	14 modules còn lại	✅ Done
Phase 5	Naming, structure, cross-links, inventory cleanup	✅ Done