core-hub/workplans/CORE-WP-0003-fastapi-postgres-foundation.md

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_id

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
CORE-WP-0003	workplan	Build FastAPI/Postgres foundation	infotech	core-hub	ready	codex	custodian	2026-06-27	2026-06-27	ef913c8c-2a50-4970-9a9d-0cb65dc996cd

Build FastAPI/Postgres foundation

Create the first Core Hub runtime on the natural Coulomb stack.

Scaffold Python Project

id: CORE-WP-0003-T01
status: todo
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.

Add Health and OpenAPI Baseline

id: CORE-WP-0003-T02
status: todo
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.

Add Database Foundation

id: CORE-WP-0003-T03
status: todo
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.

Add CI-Ready Checks

id: CORE-WP-0003-T04
status: todo
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.