- Frontend expects
VITE_API_URL(defaults to/api). - Vite dev server proxies
/apitohttp://localhost:3001. - Backend is in
backend/(NestJS + Prisma). - Thermal receipt renderer flags:
VITE_RECEIPT_RENDERER=legacy|react-thermal-printer(safe default:legacy)VITE_RECEIPT_RT_COLUMNS=32(optional, defaults to existing receipt columns)VITE_RECEIPT_RT_CODEPAGE=cp437(optional)VITE_RECEIPT_RT_PRINTER_TYPE=epson|star(optional, defaultepson)
- Keep real secrets only in
.envfiles (ignored by git). - Keep placeholders only in
.env.examplefiles. - Validate examples before push:
npm run check:env-example
- Railway backend production guide:
docs/railway-backend-deployment-guide.md - Deployment UML diagram:
docs/deployment-uml.puml