Lifecycle documentation
This directory holds locked behavioral specifications for workflows, API contracts, caching, and permissions. Implementation in apps/ must follow these docs unless an ADR explicitly supersedes them.
Contents
| Area | Path | Purpose |
|---|---|---|
| Maintenance | maintenance/README.md | End-to-end maintenance request lifecycle, roles, data model intent |
| Status transitions | maintenance/status-transitions.md | Allowed status and departmentApprovalStatus transitions |
| Permissions | maintenance/permissions-matrix.md | Who may perform which actions; permissions object semantics |
| Snapshots | maintenance/snapshot-behavior.md | finalSnapshot shape, immutability, UI rules |
| Cache — user | cache/user.md | User profile resolution for relatedUsers |
| Cache — maintenance | cache/maintenance.md | Maintenance list/detail invalidation and read paths |
| Cache — system | cache/system.md | System settings / feature flags cache (when applicable) |
| Cache — session | cache/session.md | Session and auth-adjacent cache expectations |
Architecture cross-links
- High-level system overview:
../architecture/systems/maintenance-lifecycle.md - Compliance and long-term retention are out of scope for v1; see
../security/data-retention-and-privacy.mdfor future alignment.
Change process
- Update the relevant file under
docs/lifecycle/. - If behavior changes are significant, add or update an ADR under
docs/architecture/decisions/. - Keep
maintainer/phases/maintenance-handoff.mdin sync for developer handoff (shorter operational summary).