mirror of
https://github.com/zvx-echo6/central.git
synced 2026-05-21 18:14:44 +02:00
83b1e45fa8
- Add docs/test-database.md with one-time setup, DSN convention, reset instructions, and explanation of why PostGIS is not in migrations - Update docs/migrations.md with "Extensions are not in migrations" section explaining superuser requirement - Restore geom GEOMETRY(Geometry, 4326) column to test fixture now that central_test has PostGIS installed - Add CREATE EXTENSION IF NOT EXISTS postgis to test fixture for self-bootstrap (central_test is superuser) - Add Testing section to README.md pointing to docs/test-database.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
24 lines
706 B
Markdown
24 lines
706 B
Markdown
# 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](docs/test-database.md) for test database setup.
|
|
|
|
## License
|
|
|
|
MIT. See LICENSE.
|