C4 — Component diagram (per service)

Typical service internal layout:

services/<name>/src/
├── main.ts                   — boot + config + entitlement gate
├── app.ts                    — createApp() wiring
├── handlers/                 — HTTP route handlers (thin)
├── services/                 — business logic, returns Result<T, AppError>
├── repositories/             — Drizzle queries (only place with raw SQL)
├── schemas/                  — Zod schemas (registered in finnest meta registry)
└── events/                   — defineEvent(...) descriptors

Shared packages (@finnest/core, /openapi, /db, /events, /fapi, /entitlements, /feature-flags) are consumed as workspace deps.