VinhPhat ERP — Báo cáo Trạng thái Dự án
Ngày báo cáo: 05/09/2026
Ngày bắt đầu dự án: 20/03/2026 (~5.5 tháng)
Quy mô: 40 modules | ~1,500 source files | 335 DB migrations
1. Tổng quan Trạng thái Các Module
Nhóm A — ĐÃ HOÀN THÀNH (Sẵn sàng sử dụng)
| # |
Module |
Files |
Tình trạng |
| 1 | Auth (Đăng nhập/Phân quyền) | Login, Session, Route Guard, Role-based Nav | Hoàn chỉnh |
| 2 | Customers (Khách hàng) | CRUD, Search, Filter, Credit Limit Check | Hoàn chỉnh |
| 3 | Suppliers (Nhà cung cấp) | CRUD, Filter by Category, KPI Cards | Hoàn chỉnh |
| 4 | Employees (Nhân viên) | CRUD, Role KPI Cards, Mobile Cards | Hoàn chỉnh |
| 5 | Yarn Receipts (Nhập sợi) | Form, List, Status Flow | Hoàn chỉnh |
| 6 | Raw Fabric (Kho vải mộc) | Quản lý cuộn, Chất lượng A/B/C, Vị trí kho | Hoàn chỉnh |
| 7 | Finished Fabric (Vải thành phẩm) | Bulk Form, Columns, TraceChain, Transitions | Hoàn chỉnh |
| 8 | Fabric Catalog (Danh mục vải) | DataTablePremium, KPI, Filters | Hoàn chỉnh |
| 9 | Color Catalog (Danh mục màu) | Linked to BOM & Dyeing | Hoàn chỉnh |
| 10 | Yarn Catalog (Danh mục sợi) | Linked to Yarn Receipts | Hoàn chỉnh |
| 11 | BOM (Định mức nguyên liệu) | Form, List, DataTablePremium | Hoàn chỉnh |
| 12 | Work Orders (Lệnh sản xuất) | Form, Detail, Yarn Table, Greige Estimator | Hoàn chỉnh |
| 13 | Dyeing Orders (Lệnh nhuộm) | Form, List, Detail, Roll Integration | Hoàn chỉnh |
| 14 | Looms (Máy dệt) | Quản lý thiết bị, trạng thái, truy xuất | Hoàn chỉnh |
| 15 | Orders (Đơn hàng) | CRUD, Detail, AuditLog, CreditOverride, Reserve | Hoàn chỉnh |
| 16 | Quotations (Báo giá) | Form, List, Detail, Print | Hoàn chỉnh |
| 17 | Contracts (Hợp đồng) | Form, Detail, Sign, Cancel, Link Order, Audit | Hoàn chỉnh |
| 18 | Shipments (Xuất hàng) | Form, AdHoc, RollPicker, Verify, Delivery Confirm | Hoàn chỉnh |
| 19 | Payments (Thu/Chi tiền) | Payment, Expense, Account, CashFlow, DebtSummary | Hoàn chỉnh |
| 20 | Inventory (Tồn kho) | Dashboard, KPI Cards, Breakdown Tables | Hoàn chỉnh |
| 21 | Reports (Báo cáo) | Revenue, Debt, Inventory, Production, Overdue | Hoàn chỉnh |
| 22 | Dashboard (Bảng điều khiển) | KPI Cards, Charts, Recent Orders, Upcoming Debts | Hoàn chỉnh |
| 23 | Settings (Cài đặt) | Company, Numbering, Print, Permission, UI, Finance | Hoàn chỉnh |
| 24 | Weaving Invoices (Hóa đơn dệt) | Quản lý hóa đơn gia công | Hoàn chỉnh |
Nhóm B — ĐÃ XÂY DỰNG nhưng CẦN KIỂM TRA & HOÀN THIỆN
| # |
Module |
Vấn đề cần xử lý |
| 25 | Customer Portal | UI có (~29KB CSS), 8 sub-modules — cần test luồng end-to-end, đảm bảo khách hàng tự xem đơn/nợ chính xác |
| 26 | Supplier Portal | 13 files, nhiều pages — cần test luồng RFQ, PO, báo giá từ phía NCC |
| 27 | Driver Portal | Layout + Page có — cần test luồng nhận đơn, xác nhận giao |
| 28 | Chat / Unified Feed | ChatDrawer, Inbox, Widget có — cần test realtime messaging |
| 29 | CRM | Module nhỏ — cần xác nhận scope, có thể merge vào Customers |
| 30 | Notifications | Kiến trúc Clean (domain/application/infrastructure) — cần test delivery |
| 31 | Approval Workflows | PoC page có, Designer có — cần hoàn thiện engine phê duyệt |
| 32 | Operations (Tiến độ/KPI) | Cần test task management, KPI tracking |
| 33 | Order Kanban | Cần test drag-drop, status transitions |
| 34 | Recurring Transactions | Cần test auto-generate payments |
| 35 | Shipping Rates | Cần test tính cước tự động |
| 36 | Contract Templates | Cần test template generation |
Nhóm C — CẦN HOÀN THIỆN (theo PLAN.md checklist)
| Hạng mục |
Chi tiết |
| Settings trang hoàn chỉnh | Kiểm tra prefix chứng từ, diagnostics cơ bản |
| Lookup components | Tạo lookup tái sử dụng cho Orders, Payments, Yarn Receipts |
| RLS (Row Level Security) | Tạo migration mới, đảm bảo data isolation theo role |
| Loading/Error/Empty States | Rà soát toàn bộ, đảm bảo skeleton + error feedback đầy đủ |
| Test Coverage | Thêm test cho các luồng nghiệp vụ quan trọng |
| Offline Queue | Mở rộng khi CRUD chính ổn định |
| Lint & Typecheck sạch | Đảm bảo 0 errors, 0 warnings toàn codebase |
2. ĐỀ XUẤT: Nên Tập Trung Vào Đâu Trước Khi Khai Trương?
Ưu tiên 1 — LUỒNG CỐT LÕI (Must-have, làm xong mới launch)
Đây là luồng tiền và luồng hàng — nếu sai thì doanh nghiệp thiệt hại trực tiếp.
Báo giá → Đơn hàng → Sản xuất → Xuất kho → Thu tiền
| Việc cần làm |
Tại sao? |
| Test end-to-end luồng bán hàng | Tạo báo giá → chuyển đơn → xuất kho → thu tiền — phải chạy thông suốt |
| Test end-to-end luồng sản xuất | Nhập sợi → lệnh SX → vải mộc → nhuộm → thành phẩm — stock phải đúng |
| Kiểm tra DB triggers | shipment → trừ tồn kho, payment → giảm công nợ — phải chính xác |
| Kiểm tra Credit Limit Check | Đặt hàng phải check công nợ, vượt hạn mức → cảnh báo |
| Loading/Error states | Mọi page đều phải có skeleton, error message, empty state |
Ưu tiên 2 — BẢO MẬT & ỔN ĐỊNH (Must-have cho production)
| Việc cần làm |
Tại sao? |
| RLS (Row Level Security) | Ngăn user xem/sửa data không thuộc quyền |
| Phân quyền hoàn chỉnh | Staff không được xóa đơn, Viewer không được sửa |
| Lint + Typecheck clean | npm run check phải pass 0 errors |
| Error handling | Không có catch {} rỗng, mọi lỗi phải feedback cho user |
Ưu tiên 3 — PORTALS (Nice-to-have, có thể launch sau)
| Module |
Có thể tắt khi launch? |
| Customer Portal | Có — khách hàng có thể gọi điện/Zalo thay vì tự tra |
| Supplier Portal | Có — NCC có thể gửi hóa đơn trực tiếp |
| Driver Portal | Có — tài xế có thể nhận lệnh qua điện thoại |
| Chat | Có — team có thể dùng Zalo nội bộ |
| Approval Workflows | Có — phê duyệt có thể làm thủ công |
| Recurring Transactions | Có — nhập tay từng lần |
3. KHI KHAI TRƯƠNG — Web Sẽ Được Sử Dụng Như Thế Nào?
3.1. Ai dùng gì?
[Chủ doanh nghiệp / Giám đốc]
├─ Dashboard — xem KPI tổng quan
├─ Reports — doanh thu, tồn kho, công nợ
└─ Settings — quản lý hệ thống
[Nhân viên Kinh doanh]
├─ Customers — quản lý khách hàng
├─ Quotations — tạo báo giá
├─ Contracts — quản lý hợp đồng
└─ Orders — tạo & theo dõi đơn hàng
[Nhân viên Kho]
├─ Yarn Receipts — nhập sợi
├─ Raw Fabric — quản lý vải mộc
├─ Finished Fabric — quản lý thành phẩm
├─ Inventory — kiểm soát tồn
└─ Shipments — xuất hàng
[Quản lý Xưởng]
├─ Work Orders — lệnh sản xuất
├─ Dyeing Orders — lệnh nhuộm
├─ Looms — quản lý máy dệt
└─ BOM — định mức nguyên liệu
[Kế toán]
├─ Payments — thu tiền, chi tiền
├─ Debts — theo dõi công nợ
└─ Weaving Invoices — hóa đơn gia công
3.2. Một ngày làm việc điển hình
| Thời điểm |
Ai |
Làm gì trên web |
| Sáng sớm | Chủ DN | Mở Dashboard → xem doanh thu hôm qua, đơn hàng mới, công nợ sắp đến hạn |
| 8:00 | Kho | Nhập sợi mới về (Yarn Receipts) → hệ thống cập nhật tồn kho tự động |
| 8:30 | Xưởng | Xem Work Orders → bắt đầu dệt → cập nhật trạng thái máy dệt |
| 9:00 | Sales | Nhận yêu cầu khách → tạo Báo giá → gửi khách duyệt |
| 10:00 | Sales | Khách duyệt → chuyển thành Đơn hàng → hệ thống check công nợ tự động |
| Trong ngày | Xưởng | Cập nhật tiến độ sản xuất → vải mộc xong → chuyển nhuộm |
| Chiều | Kho | Vải thành phẩm nhập kho → chọn cuộn xuất cho đơn hàng → tạo Shipment |
| Chiều | Kế toán | Khách thanh toán → tạo Phiếu thu → công nợ tự động giảm |
| Cuối ngày | Chủ DN | Xem Reports → doanh thu, tồn kho, đơn trễ hạn |
3.3. Cách truy cập
| Thiết bị |
Trải nghiệm |
| Laptop/PC | Đầy đủ tính năng, bảng biểu rộng, báo cáo chi tiết |
| Điện thoại | Mobile-first, card view, thao tác nhanh tại kho/xưởng |
| Tablet | Phù hợp cho quản lý xưởng đi kiểm tra tại chỗ |
3.4. Hosting & Triển khai
| Thành phần |
Nền tảng |
Chi phí ước tính |
| Frontend (React) | Vercel (đã có vercel.json) | Free tier hoặc ~$20/tháng |
| Database + Auth | Supabase | Free tier hoặc ~$25/tháng (Pro) |
| API Server (Hono) | Vercel Functions hoặc Railway | ~$5-10/tháng |
4. ROADMAP ĐỀ XUẤT — Từ bây giờ đến Khai trương
Lộ trình đến Khai trương (DateFormat: YYYY-MM-DD)
[Ưu tiên 1: Test & Fix luồng cốt lõi]
- 2026-09-06 (5d): Test E2E luồng Bán hàng
- 2026-09-06 (5d): Test E2E luồng Sản xuất
- 2026-09-11 (3d): Fix DB triggers & data integrity
- 2026-09-11 (4d): Loading/Error/Empty states
[Ưu tiên 2: Bảo mật & Ổn định]
- 2026-09-15 (3d): RLS migration
- 2026-09-15 (3d): Phân quyền hoàn chỉnh
- 2026-09-18 (2d): Lint + Typecheck clean
[Ưu tiên 3: Polish]
- 2026-09-20 (3d): Rà soát UX toàn bộ
- 2026-09-23 (2d): Training data & hướng dẫn
[Khai trương]
- 2026-09-25: Go Live (milestone)
Ước tính: Với tốc độ hiện tại, dự án có thể khai trương trong ~3 tuần nếu tập trung vào Ưu tiên 1 & 2. Các Portal (khách hàng, NCC, tài xế) có thể mở sau khi hệ thống core chạy ổn định.