Backend Module Workflow

external-ready

Contract-first flow for creating and wiring backend modules.

Recommended flow

Scaffold API/feature slice first when possible.
Implement domain/application/infrastructure layers.
Wire module providers and ports in Nest module.
Bind adapters through contract-first oRPC router.

Fast-path commands

bun run scaffold:orpc --audience admin --name reports-list --method GET
bun run scaffold:vertical-slice --audience admin --capability reports --name list --method GET

Layer boundaries

domain: entities, value objects, domain errors/events
application: use cases + ports
infrastructure: repository/provider implementations
interface: transport adapters

Verification

bun run typecheck
bun run check:contract-first
bun run check:projection-policy
bun run depcruise:backend

See complete reference in docs/guides/creating-a-module.md.

Feature Scaffolding

Build frontend and vertical slices quickly with scaffold commands.

Database Migrations

Drizzle migration workflow for schema evolution and safe rollout.

On this page

Recommended flow Fast-path commands Layer boundaries Verification