Platform architecture
Constellation OS is a control plane for mixed-vendor constellations: one telemetry schema, one fleet graph, one prediction layer, and one operator console.
System diagram
Gateways / fleet agent
│
▼
Constellation HTTP API ──► Telemetry store
│ │
├── Prediction service │
│ │
▼ ▼
Web console ◄──── Operators / automation (IDE, CI)
(globe · timeline · assistant)
Components
| Component | Role |
|---|---|
| Console | Globe, timeline, assistant, settings |
| HTTP API | Topology, telemetry ingest, predictions, federation |
| Fleet agent | Edge CLI for topology pull and telemetry push |
| Telemetry store | Time series keyed to node_id and link identifiers |
| Prediction service | Tiered ML models (bronze → custom) |
| Identity | Cognito SSO; API tokens with server validation |
| Knowledge Base | Authenticated documentation (this site) |
Data flow
- Topology defines nodes and links—the fleet graph.
- Telemetry ingest writes metrics aligned to that graph.
- Console reads topology + telemetry for live view and replay.
- Predictions consume context (node, link, time) and return forecasts.
- Assistant orchestrates queries, charts, and model calls over the same context.
Deployment topology
| Surface | Hosting |
|---|---|
| Marketing | Static export |
| Console SPA | S3 + CloudFront at /app/ |
| Knowledge Base | S3 + CloudFront at docs.* |
| API & models | Regional services per program (cloud or customer VPC) |
Enterprise programs run dedicated regions on AWS, Azure, GCP, GovCloud, or air-gapped infrastructure.
Repository layout (engineering)
| Path | Role |
|---|---|
apps/console-app | Console SPA |
apps/docs | Knowledge Base |
packages/fleet-agent | Edge agent |
infra/ | AWS CDK, SSM, deploy IAM |