v1.0.0 · Toàn bộ phân hệ đã hoàn thành

Cơm Tấm Má Tư

Hệ thống quản lý vận hành nhà hàng

Next.js 16.2 React 19.2 TypeScript 6.0 Tailwind 4.2 Supabase Turborepo 2.9
19
Bảng dữ liệu
6
Hàm RPC
8
Vai trò nhân sự
13
Phân hệ có ACL
Tiến độ phân hệ

Tiến độ phát triển

8 phân hệ · 8 đã hoàn thành · sẵn sàng v1.0.0

M0
Khung quản trị
Hoàn thành
Hoàn thành 100%
M1
Thực đơn
Hoàn thành
Hoàn thành 100%
M2
POS
Hoàn thành
Hoàn thành 100%
M3
KDS
Hoàn thành
Hoàn thành 100%
M4
Thanh toán
Hoàn thành
Hoàn thành 100%
M5
Kho hàng
Hoàn thành
Hoàn thành 100%
M6
Kế toán
Hoàn thành
Hoàn thành 100%
M7
Nhân sự & tiền lương
Hoàn thành
Hoàn thành 100%
Sơ đồ phụ thuộc

Sơ đồ phụ thuộc

Mỗi phân hệ kế thừa lớp nền của phân hệ trước

M0 Quản trị ✅ Hoàn thành M1 Thực đơn ✅ Hoàn thành M2 POS ✅ Hoàn thành M3 KDS 🔜 Tiếp theo M4 Thanh toán ✅ Hoàn thành M5 Kho hàng ✅ Hoàn thành M6 Kế toán ✅ Hoàn thành M7 Nhân sự ✅ Hoàn thành Hoàn thành Tiếp theo Planned Direct dep Sequential
Architecture

System Architecture

Request flow from browser to database

Browser React 19 / RSC
→
proxy.ts Auth · ACL · Rate limit
→
App Router Next.js 16 · Server Actions
→
Supabase PostgREST · Auth · RLS
Single-tenant · Multi-branch L0 Tenant → L1 Branch JWT claims: tenant_id · branch_id · role RLS on every table NUMERIC(15,2) money BIGINT identity PK
Tính năng

Đã làm & Sắp đến

Tổng hợp phần đã làm và phần tiếp theo

✅
Đã hoàn thành (M0 – M7)
M0 · Khung quản trị
  • Bố cục quản trị & điều hướng thanh bên
  • Quản lý chi nhánh (nhiều chi nhánh)
  • CRUD nhân sự kèm phân vai
  • Cấu hình hệ thống & phân hệ ACL
M1 · Thực đơn
  • Danh mục & món bán
  • Biến thể: size / khẩu phần / combo
  • Tùy chọn thêm (add-on, topping)
  • Quản lý món phụ
M2 · POS
  • POS với giỏ hàng & tìm kiếm
  • Chọn bàn / khu vực
  • Gửi đơn & in hóa đơn
  • Quản lý ca quầy thu ngân
Quản lý phạm vi

Hạng mục hoãn lại

Các hạng mục đã biết và chủ động dời sang sprint sau

M4
Đối soát giá phía máy chủ
Tổng tiền giỏ hàng cần được kiểm tra lại ở server action checkout — dời sang phân hệ Thanh toán, nơi giữ logic hoàn tiền và đối soát
Tương lai
Phạm vi chi nhánh cho area manager
Vai trò cho phép quản lý giám sát nhiều nhưng không phải mọi chi nhánh — cần thiết kế thêm JWT claims; dời sang sau v1.0