v1.0.0 · All Modules Shipped

Cơm Tấm Má Tư

Hệ thống Quản lý Vận hành Nhà hàng — Restaurant Management System

Next.js 16.2 React 19.2 TypeScript 6.0 Tailwind 4.2 Supabase Turborepo 2.9
19
Database Tables
6
RPC Functions
8
Staff Roles
13
ACL-Protected Modules
Module Progress

Tiến độ phát triển

8 modules · 8 shipped · v1.0.0 ready

M0
Admin Shell · Khung quản trị
Shipped
Hoàn thành 100%
M1
Thực đơn · Menu
Shipped
Hoàn thành 100%
M2
POS · Point of Sale
Shipped
Hoàn thành 100%
M3
KDS · Kitchen Display
Shipped
Hoàn thành 100%
M4
Thanh toán · Payment
Shipped
Hoàn thành 100%
M5
Kho hàng · Stock
Shipped
Hoàn thành 100%
M6
Kế toán · Finance
Shipped
Hoàn thành 100%
M7
Nhân sự · HR / Payroll
Shipped
Hoàn thành 100%
Dependency Graph

Sơ đồ phụ thuộc

Each module builds on the foundation of the previous

M0 Admin ✅ Shipped M1 Thực đơn ✅ Shipped M2 POS ✅ Shipped M3 KDS 🔜 Next M4 Payment ✅ Shipped M5 Kho hàng ✅ Shipped M6 Kế toán ✅ Shipped M7 Nhân sự ✅ Shipped Shipped Next 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
Features

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

Breakdown of shipped features and upcoming work

✅
Đã hoàn thành (M0 – M7)
M0 · Admin Shell
  • Admin layout & sidebar navigation
  • Branch management (multi-branch)
  • Staff CRUD with role assignment
  • System settings & ACL module
M1 · Thực đơn (Menu)
  • Categories & menu items
  • Variants: size / portion / combo
  • Modifiers (add-ons, toppings)
  • Side dishes management
M2 · POS Terminal
  • POS terminal with cart & search
  • Table / zone selection
  • Order submit & bill printing
  • Cash register session management
Scope Management

Deferred Items

Known items intentionally deferred to a future sprint

M4
Server-side price validation
Cart total must be re-validated at checkout server action — deferred to Payment module where refund/reconciliation logic lives
Future
Area manager branch scoping
Role allowing a manager to oversee multiple but not all branches — requires additional JWT claims design; deferred to post-v1.0