mirror of
https://github.com/zvx-echo6/central.git
synced 2026-08-26 17:31:39 +00:00
bb0b8c5e02
Migration 036 (avalanche_org adapter row) was code-shipped in v0.10.10 (PR #98) but the SQL file was never committed to the repo. It has been applied in production since 2026-06-18; this commit adds the file so clean rebuilds can reach the same schema state. Also bumps pyproject.toml version from the stale 0.3.0 to 0.14.6 to match the deployed tag, and updates the README Status section to reflect current reality (~22 adapters, three systemd units, operational). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
31 lines
1.2 KiB
Markdown
31 lines
1.2 KiB
Markdown
# Central
|
|
|
|
Central is the data hub spine for the Echo6 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
|
|
|
|
**Operational** (v0.14.6) — deployed on utility CT 104 (`central.echo6.mesh`).
|
|
|
|
~22 adapters live across traffic, wildfire, weather, space-weather, hydrology, earthquakes, avalanche, disasters, and satellite. CloudEvents published to NATS/JetStream, archived to TimescaleDB/PostGIS. FastAPI + HTMX GUI/API on :8000.
|
|
|
|
Three systemd units on a single LXC:
|
|
- `central-supervisor` — adapter lifecycle manager
|
|
- `central-archive` — NATS consumer persisting events to TimescaleDB
|
|
- `central-gui` — FastAPI + HTMX web interface / API (:8000)
|
|
|
|
## 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](docs/test-database.md) for test database setup.
|
|
|
|
## License
|
|
|
|
MIT. See LICENSE.
|