Architecture

Reference index for architecture boundaries, API map, and migration history.

Last verified: 2026-03-04

Narrative surface on www: /engineering

Purpose

  • Reference index for architecture boundaries, API map, and migration history.
  • docs/architecture/INDEX.md: > **Class:** `SSOT-ARCH`
  • docs/architecture/overview.md: <!-- Extracted from SSOT_ARCHITECTURE.md — System Overview -->

Runtime/Stack

  • docs/architecture
  • apps/cupola/public

Endpoints

  • /api/ground-control/auth
  • /api/ground-control/download/[product]
  • /api/ground-control/licenses
  • /api/weather-station/activations
  • /api/weather-station/auth
  • /api/weather-station/check-updates
  • /api/weather-station/deactivate-remote
  • /api/weather-station/download/[product]
  • /api/weather-station/licenses
  • /api/weather-station/refresh

Contracts/Seams

  • apps/cupola/schemas/platform-architecture.schema.json (schema contract)

Version/Release/Deploy/Test truth pointers

  • architecture_data.json: apps/cupola/public/architecture_data.json (generated=2026-03-03T19:37:04Z)
  • implementation_inventory.json: apps/cupola/public/implementation_inventory.json (generated=2026-03-03T19:37:05Z via generate-implementation-data v1.0.0)

Observability/Runbooks

  • scripts/docs_audit.sh
  • tools/generators/check_architecture_drift.py

Ownership/Escalation

  • Architecture docs owner: Keith Hetrick (repo maintainer).
  • Architecture drift triage: Keith Hetrick; evidence logged via docs/research/changelog.md.

Changelog/Research links

Canonical docs index: /docs | Docs home: /