System design
Context (C4 — Level 1)
flowchart LR
U[👤 Người dùng] -->|mở trang, nhập A + B| F[Frontend app]
F -->|GET /api/sum| B[Backend API]
B --> R[(Response JSON)]
Container (C4 — Level 2)
flowchart TB
subgraph FE["Frontend · port 8080"]
HTML[index.html]
JS[app.js · lib.js]
STATIC["static server · node http"]
end
subgraph BE["Backend · port 3000"]
API["server.js · node http"]
LIB["lib.js · parse + sum"]
end
Browser["Browser"] --> STATIC
STATIC --> HTML
STATIC --> JS
JS -->|"fetch CORS"| API
API --> LIB
Quyết định thiết kế
- Stateless, không database — request/response là đủ cho phép tính tổng.
- Contract-first — FE/BE cùng đọc
specs/api-contract.yaml, không bên nào tự định nghĩa lại endpoint.
- CORS
* cho môi trường dev (FE :8080 → BE :3000); khi lên production phải giới hạn origin.