Workflow
- •Read docs/ARCHITECTURE.md and docs/DATA_MODEL.md first.
- •Keep layers strict: Controller -> Service -> Repository.
- •Prefer DTOs at boundaries; never expose persistence entities directly.
- •Any schema change must include a migration and a brief update to docs/DATA_MODEL.md.
- •Add at least one test for critical logic (service or repository).