Kiến Trúc Level 7: Tiêu Chuẩn Sản Xuất (Production Ready)
Hệ thống VinhPhatERP được xây dựng trên nền tảng kiến trúc phân lớp hiện đại (Level 7 Architecture), giúp đảm bảo tính cô lập, bảo mật và khả năng bảo trì tối ưu.
6 Lớp Cấu Trúc Chính
| 1. Infra (Hạ tầng) | src/services/: Quản lý kết nối trung gian (Supabase, Auth). |
| 2. Contract (Hợp đồng) | src/schema/: Trung tâm định nghĩa Zod validation và Enum dùng chung. |
| 3. API (Giao tiếp) | src/api/: Định nghĩa các hàm RPC và Fetching dữ liệu thuần túy. |
| 4. Logic (Use-Cases) | src/features/*/use*.ts: Các Custom Hook đóng vai trò là "bộ não" nghiệp vụ. |
| 5. UI (Tính năng) | src/features/: Chứa các Component và Page theo từng module riêng biệt. |
| 6. App/Integration | src/app/plugins.ts: Nơi đăng ký tập trung tất cả các module vào hệ thống. |
Quy Tắc Vàng Trong Triển Khai
-
🚫 Cô lập tuyệt đối: Không dùng relative import (
../../) giữa các feature khác nhau. Sử dụng Path Alias để quản lý import sạch sẽ. - 📱 Mobile-First: Mọi giao diện phải được ưu tiên hiển thị trên thiết bị di động trước khi lên Desktop.
-
🛡️ Type Safety: Nghiêm cấm sử dụng
as any. Tất cả logic nghiệp vụ phải được định nghĩa bằng Interface/Type rõ ràng.
Tài liệu hướng dẫn vận hành kỹ thuật - VinhPhatERP Core Team