coulomb/core-hub
Archived
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Start Core Hub FastAPI replacement foundation

Browse Source
This commit is contained in:
Bernd Worsch
2026-06-27 11:41:26 +02:00
parent 75963233b6
commit 1e87adbcbb
37 changed files with 3292 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
workplans/CORE-WP-0003-fastapi-postgres-foundation.md
View File

@@ -4,7 +4,7 @@ type: workplan
title: "Build FastAPI/Postgres foundation"
domain: infotech
repo: core-hub
status: ready
status: finished
owner: codex
topic_slug: custodian
created: "2026-06-27"
@@ -20,42 +20,42 @@ Create the first Core Hub runtime on the natural Coulomb stack.
```task
id: CORE-WP-0003-T01
status: todo
status: done
priority: high
state_hub_task_id: "3db032d8-7ac6-424e-8bbe-3debd332241b"
```
Add Python packaging, app layout, dependency declaration, local dev commands, and test runner. Target Python 3.12, FastAPI, Pydantic v2, SQLAlchemy async, Alembic, asyncpg, httpx, and pytest.
Result 2026-06-27: Added `pyproject.toml`, `uv.lock`, `Makefile`, `src/core_hub/`, `tests/`, and dependency declarations for FastAPI, Pydantic v2, SQLAlchemy async, Alembic, asyncpg, httpx, uvicorn, pytest, ruff, and aiosqlite test support.
## Add Health and OpenAPI Baseline
```task
id: CORE-WP-0003-T02
status: todo
status: done
priority: high
state_hub_task_id: "d01d6169-a0c6-4689-b986-49ea6cd218b9"
```
Implement health/readiness endpoints and generated OpenAPI. Ensure local run/test commands are documented in agent rules.
Result 2026-06-27: Implemented `/healthz`, `/readyz`, generated OpenAPI, `/api/v2/openapi.json`, `/api/v2/openapi.yaml`, and an OpenAPI export script.
## Add Database Foundation
```task
id: CORE-WP-0003-T03
status: todo
status: done
priority: high
state_hub_task_id: "23c57f3e-425e-47d8-9fb5-9cc6366f2167"
```
Create SQLAlchemy base models, Alembic configuration, initial migrations, async database session wiring, and test database fixtures.
Result 2026-06-27: Added SQLAlchemy base/session wiring, initial models for hubs, capability manifests, and API consumers, Alembic configuration, first migration, and async sqlite test fixture proving metadata creation.
## Add CI-Ready Checks
```task
id: CORE-WP-0003-T04
status: todo
status: done
priority: medium
state_hub_task_id: "a1790376-3f63-4eed-8f2f-c059eb1304db"
```
Add formatting/lint/test commands suitable for the normal platform workflow. Avoid Haskell/Nix/devenv dependencies.
Result 2026-06-27: Added `make test`, `make lint`, `make run`, and `make openapi`. Verification passed with `uv run --extra dev pytest` and `uv run --extra dev ruff check .`.