Technical Reference¶
Detailed technical documentation for developers extending and maintaining the RotaCC system. This is reference material — the Admin Guide covers running the system day to day without any of this.
Domain vocabulary (the project's canonical terms and the words deliberately avoided) is defined in the repository's root CONTEXT.md.
Pages¶
| Page | Description |
|---|---|
| Data Model | Core models, enums, relationships, and validation rules |
| Rota Algorithm | 6-phase generation pipeline, deficit-based allocation, CP-SAT optimisation |
| Leave System | Leave types, quota system, validation rules, approval workflow |
| Calculations | Targets, shift counting, leave and entitlement calculations |
| Alerts | Alert types, generation triggers, resolution workflow |
| AI Agent API | The v3 AI agent interface with transactional writes |
| Celery Tasks | Background tasks, periodic jobs, error handling |
| Audit Trail | Change tracking, querying, configuration |
| Design System | UI tokens, components, template structure, frontend libraries |