mirror of https://github.com/zvx-echo6/central.git synced 2026-06-10 11:54:37 +02:00

Central - data hub spine. Adapters -> NATS/JetStream -> archive.

Python 89.1%
HTML 9.3%
CSS 1.3%
PLpgSQL 0.3%

Find a file

malice 0dd83a340e v0.10.3: rip out state_511_atis adapter (superseded by itd_511 v0.10.0; Castle Rock legacy shape EOL per sister-site discovery) (#88 ) Closes #88 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-06-06 14:44:00 -06:00
docs	v0.10.3: rip out state_511_atis adapter (superseded by itd_511 v0.10.0; Castle Rock legacy shape EOL per sister-site discovery) (#88 )	2026-06-06 14:44:00 -06:00
etc-templates
scripts
sql	v0.10.3: rip out state_511_atis adapter (superseded by itd_511 v0.10.0; Castle Rock legacy shape EOL per sister-site discovery) (#88 )	2026-06-06 14:44:00 -06:00
src/central	v0.10.3: rip out state_511_atis adapter (superseded by itd_511 v0.10.0; Castle Rock legacy shape EOL per sister-site discovery) (#88 )	2026-06-06 14:44:00 -06:00
systemd
tests	v0.10.3: rip out state_511_atis adapter (superseded by itd_511 v0.10.0; Castle Rock legacy shape EOL per sister-site discovery) (#88 )	2026-06-06 14:44:00 -06:00
.gitattributes
.gitignore
.python-version
CHANGELOG.md
LICENSE
pyproject.toml
README.md
uv.lock

README.md

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

Testing

See docs/test-database.md for test database setup.

License

MIT. See LICENSE.