C4 Architecture
This page adds C4-style views of the platform so readers can move from system context to deployable containers and then into the main application internals.
Reading Guide
- Context: who and what interacts with the platform.
- Container: deployable runtime pieces and their responsibilities.
- Component: the major logical parts inside the FastAPI application.
System Context
Container View
Deployment View
This view narrows the container model to the swarm deployment and public-routing path used in this repository.
FastAPI Application Components
HySpex Ingestion Component View
This view zooms in on the bulk-ingestion and campaign-orchestration path, which is one of the most operationally sensitive parts of the system.
Notes
- The C4 diagrams intentionally stay stable even when individual endpoints or scripts evolve.
- Use System Diagrams for the currently deployed topology and Request Flows for request-level behavior.
- Use Workflow Diagrams and Storage and Manifests for operational and data-lifecycle views.