central/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](docs/test-database.md) for test database setup.

## License

MIT. See LICENSE.
scaffold: initial repository structure 2026-05-15 19:16:24 +00:00			`# 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`

docs: add test database setup, restore geom to test fixture - 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> 2026-05-17 18:26:48 +00:00			`## Testing`

			`See [docs/test-database.md](docs/test-database.md) for test database setup.`

scaffold: initial repository structure 2026-05-15 19:16:24 +00:00			`## License`

			`MIT. See LICENSE.`