Cơm Tấm Má Tư — Project Status

Module Progress

Tiến độ phát triển

8 modules · 3 shipped · 1 in queue · 4 planned

Admin Shell · Khung quản trị

Shipped

Hoàn thành 100%

Thực đơn · Menu

Shipped

Hoàn thành 100%

POS · Point of Sale

Shipped

Hoàn thành 100%

KDS · Kitchen Display

Done

Schema + UI + Realtime 100%

Thanh toán · Payment

Done

Schema + Actions + Webhook (MVP) 70%

Kho hàng · Stock

Done

Schema + CRUD + Adjustments (MVP) 60%

Kế toán · Finance

Done

HĐĐT + Revenue Dashboard (MVP) 50%

Nhân sự · HR / Payroll

Done

Employees + Shifts + Attendance (MVP) 50%

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 – M2)

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

✅

MVP Done (M3 – M7) — Pending: Admin UI + Real API Integration

M3 · KDS — Kitchen Display System ✅

✅ Realtime kitchen order queue (derived from order_items)
✅ Bump workflow per station with optimistic locking
✅ Station + category configuration
✅ Order age indicators & alerts

M4 · Thanh toán (Payment) ✅ MVP

✅ Cash, VietQR, MoMo provider interfaces (SOLID)
✅ Atomic payment RPC (race-condition safe)
✅ MoMo webhook with HMAC + amount validation
✅ End-of-day reconciliation
⏳ Real VietQR/MoMo API integration (mock)
⏳ Refund flows

M5 · Kho hàng (Stock) ✅ MVP

✅ Ingredients CRUD + stock levels per branch
✅ Stock movements with auto-update trigger
✅ Min/max stock alerts
⏳ PO/GRN/3-way matching (post-pilot)

M6 · Kế toán (Finance) ✅ MVP

✅ HĐĐT invoice provider interface (MISA ready)
✅ Revenue dashboard (materialized views)
✅ VAT rate from system settings
⏳ Real MISA API integration (mock)
⏳ VAS accounting / financial statements

M7 · Nhân sự (HR) ✅ MVP

✅ Employee records (extends profiles)
✅ Shifts + shift assignments
✅ Attendance check-in/check-out
⏳ Payroll calculation (manual for pilot)

Scope Management

Deferred Items

Known items intentionally deferred to a future sprint

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

Tiến độ phát triển

Sơ đồ phụ thuộc

System Architecture

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

Deferred Items