scaffold: initial repository structure

This commit is contained in:
Matt Johnson 2026-05-15 19:16:24 +00:00
commit 36ebbcb250
12 changed files with 102 additions and 0 deletions

20
README.md Normal file
View file

@ -0,0 +1,20 @@
# Central
Central is the data hub spine for the infrastructure. Adapters normalize upstream sources into a canonical event shape, publish CloudEvents to NATS/JetStream, and archive to TimescaleDB for historical query. Single-LXC deployment.
## Status
Phase 0 — scaffold. Not yet operational.
## Architecture
- Python 3.12 (uv-managed)
- NATS + JetStream for live event bus
- TimescaleDB + PostGIS for archive and geospatial query
- One supervisor process managing adapter lifecycle
- One archive consumer process persisting events to TimescaleDB
- Both processes systemd-managed
## License
MIT. See LICENSE.