Development Guide

Tài liệu này tập trung vào hướng dẫn dev/local. Yêu cầu & roadmap xem docs/requirements/.

Prerequisites

• Node.js >= 20
• Yarn 1.x (repo đang pin yarn@1.22.22)
• Docker + Docker Compose v2

Install

yarn install

Environment

• Copy .env.example → .env.development (hoặc chỉnh file hiện có).
• Repo hiện dùng các file env: .env.development, .env.staging, .env.production.

Run infrastructure (Docker)

docker compose --env-file .env.development -f docker-compose.dev.yml up -d

Run services

# All services (parallel)
yarn dev

# Or single service
yarn dev:gateway

Lint / format / typecheck

yarn format:check
yarn lint
yarn typecheck

Testing

yarn test