Technical overview

Nội dung này hiện chưa có sẵn bằng ngôn ngữ của bạn.

This section is for engineers and operators integrating or deploying the system.

Monorepo layout

Orchestration: Turborepo — root package.json scripts call turbo run … for apps/* and packages/* (see turbo.json).
Workspaces: apps/backend, apps/admin-web, apps/vendor-web, apps/docs, packages/shared.

Layer	Location	Notes
API	`apps/backend`	NestJS, TypeORM, MySQL, Swagger
Admin UI	`apps/admin-web`	Vite, React, React Router
Vendor UI	`apps/vendor-web`	Vite, React, POS + dashboard
Shared UI	`packages/shared`	Components and helpers
Docs	`apps/docs`	This Starlight site (Astro + Starlight)

Interactive OpenAPI and Swagger UI ship with the backend. Default UI path: /docs (configurable via SWAGGER_PATH). REST routes use global prefix /api/v1 (Swagger UI and OpenAPI JSON are excluded from that prefix).
Set SWAGGER_ENABLED=false to disable Swagger (e.g. hardened production).

Architecture — processes, static SPAs, Docker, deploy script.
Backend architecture (NestJS) — bootstrap, globals, Throttler, ValidationPipe, module layout.
Backend modules — auth / admin / vendor / pos / health route map.
Backend API catalog — full endpoint list from OpenAPI (regenerate with npm run openapi:export in apps/backend).
System test cases (index) — happy/unhappy scenario catalogue by module, coverage checklist, E2E mapping.
API conventions — prefixes, Swagger URLs, production base URL placeholder.
Authentication — admin, vendor, and customer auth entrypoints.
Environment — backend .env.example index.