Delivers the append-only audit trail system for all compliance-critical
actions per the TRA-246 acceptance criteria.
- tracking/models.py: AuditEvent model with ORM-level immutability guard
(save raises on update, delete raises on direct call)
- tracking/audit.py: single record() call point; never raises in production
- tracking/admin.py: read-only Django admin for AuditEvent inspection
- tracking/migrations/0001_initial.py: DB schema with composite indexes
- tracking/serializers.py: PII metadata gating (oidc_sub stripped for
non-admin callers)
- tracking/views.py: read-only AuditEventViewSet (IsPrivileged + 60/min
throttle)
- tracking/urls.py: registers audit/events/ router
- tracking/management/commands/prune_audit_log.py: retention enforcement
command with --dry-run and --class filter; writes access.admin_action
event on real prune runs
- config/settings/base.py: AUDIT_RETENTION_DAYS per event class + audit
throttle rate
- api/exceptions.py: wires access.permission_denied audit event on every
PermissionDenied exception (M1 integration point)
- tests/test_audit.py: 26-event taxonomy coverage, immutability, retention,
API permission, PII gating, and service helper unit tests
Co-Authored-By: Paperclip <noreply@paperclip.ing>