REST endpoints handle create, schedule, and query flows, while WebSockets push live status so operators do not refresh to watch a run.
Control plane
API & CoreThe Control plane is the product brain — FastAPI surfaces and secaudit_core orchestration for profiles, AuditFlow, jobs, and reports.
FastAPI provides REST and WebSocket APIs. secaudit_core manages profiles, AuditFlow, jobs, and reports
Where it sits in the stack
- 01 Access layer
- 02Control plane Focus
- 03 Data and messaging
- 04 Execution layer
- 05 Managed targets
How requests move
- 01
UI or API client sends a request
- 02
FastAPI authenticates and validates input
- 03
secaudit_core applies domain rules
- 04
Work is persisted and queued for workers
What this layer does
-
FastAPI REST for CRUD, scheduling, and exports
-
WebSocket channels for live job and scan status
-
secaudit_core domain logic for profiles and AuditFlow
-
One policy surface for jobs, waivers, and reports
secaudit_core owns the domain model: imported profiles, discovery tasks, compliance jobs, remediation, waivers, and report delivery.
Everything the UI shows is mediated here, which keeps business rules consistent whether the request came from a click, a schedule, or an API client.