# Architecture

## Product context

- Đối tượng: nhóm sinh viên kinh tế chuẩn bị gian hàng bán đồ uống/bánh gói.
- Mục tiêu: quyết định giá, cơ cấu, hòa vốn, so sánh rủi ro lượng khách, nhập đơn thử và demo trước giám khảo.
- Hạ tầng: shared hosting Tenten cPanel Jupiter; không yêu cầu runtime server động.

## Static web

```
Browser / HTTPS
  index.html
    styles.css — market day editorial tokens
    engine.js — calculationEngine + scenarioEngine + salesService + insightEngine
    app.js — view + events + storage + CSV + print
  localStorage — hoi-cho-lab.market-day.v2
```

`engine.js` là hàm thuần (trừ `createOrder` gắn ID và timestamp) được chia sẻ cho Dashboard, Scenario Arena, Break-even Lab, Insight Coach và Pitch Mode. Không thực hiện lại công thức trong component. Không có backend, API key, database hay form tự gửi mạng.

## Quyết định UX

- Sidebar desktop, menu đóng/mở mobile.
- Các vùng content khác nhau về nhịp: hero editorial, KPI strip, ledger table, form bán thử, mô phỏng đồ thị, pitch canvas.
- Form trạng thái success/error, nút disabled, dialog confirm, focus visible, skip link và reduced motion.
- `index.html` và asset đường dẫn tương đối để chạy ở Document Root độc lập.

## Thỏa hiệp / giới hạn

- Dự báo giả định 1 khách = 1 phần; không tự suy đoán nhiều phần/khách.
- Một phiên bán; không nhân đôi chi phí cố định vì tên đề “cuối tuần”.
- Số phần dự kiến KHÔNG tự trừ như tồn kho; nhập đơn chỉ theo dõi số bán thử.
- Data localStorage trên một trình duyệt/thiết bị, có giới hạn khoảng trống, không đồng bộ.
- Biểu đồ là SVG tự dựng, không phụ thuộc thư viện CDN.
- Đã có Export/Import JSON toàn bộ trạng thái với xác nhận ghi đè; CSV xuất riêng lịch sử đơn.
- Print PDF sử dụng tính năng in của browser; không phải server-side PDF.
