# V5 Online Services

The V5 backend is split into 16 TypeScript / NestJS workspace packages under
`apps/v5/*`. Each service owns one online contract from the Unreal
`V5OnlineServices` catalog and ships the same operational surface:

- NestJS module, controller, service, and `main.ts` entrypoint.
- `contract.json` aligned to the shared service catalog.
- Per-service Dockerfile.
- Kubernetes deployment, service, and multi-region failover manifests.
- Vitest contract coverage for success, outage, authorization, and service
  specific policy.

Shared definitions and pure contract runtime live in `apps/v5/service-shared`.
The root failover plan is `apps/v5/k8s/multi-region-failover.yaml`.
