WELIFE Docs Swagger Admin Web

Local DEV environment ready — 2026-08-11

Bootstrap đủ để code WELIFE (không cần OWNER secret).

Toolchain

Tool Version
Node ≥20 (máy: v24.18.0)
npm 11.x
Docker + Compose OK
Git OK

Đã chạy

  1. npm run env:bootstrap — merge env packs (không xoá secret)
  2. npm install — api · mobile · driver · partner · dashboard
  3. npm run infra:up — Postgres :5434 · Redis :6380 · MinIO :9000/:9001
  4. docker compose --profile mail up -d mailpit — OTP email inbox
  5. npx prisma generate + migrate deploy — 26 migrations, no pending
  6. npm run api:dev — Nest listening :3000
  7. npm run env:check — PASS (WARN Firebase SA optional)

URL local (code)

Surface Env API / WS
Consumer mobile/.env.local http://192.168.1.109:3000 (LAN device)
Driver / Partner .env cùng LAN
Dashboard dashboard/.env http://127.0.0.1:3000/api/v1
Swagger — http://localhost:3000/docs
Chat WS probe — http://localhost:3000/chat
Mailpit UI — http://localhost:8025 (nếu map port mặc định)

Lệnh hằng ngày

$env:NODE_OPTIONS='--use-system-ca'   # Windows TLS / npm / Expo
cd D:\welife
npm run infra:up
npm run api:dev                       # terminal 1
cd mobile; npm run start:clear        # terminal 2 (Consumer)
# optional:
# npm run driver:start
# npm run partner:start
# npm run dashboard:dev

OWNER (không chặn code local)

VNPay sandbox đã bật trước đó (PAYMENTS_MOCK=false) nếu giữ trong api/.env.

Không cần cho MVP code