This repository has been archived on 2026-07-08. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
core-hub/workplans/CORE-WP-0003-fastapi-postgres-foundation.md

62 lines
1.7 KiB
Markdown

---
id: CORE-WP-0003
type: workplan
title: "Build FastAPI/Postgres foundation"
domain: infotech
repo: core-hub
status: finished
owner: codex
topic_slug: custodian
created: "2026-06-27"
updated: "2026-06-27"
state_hub_workstream_id: "ef913c8c-2a50-4970-9a9d-0cb65dc996cd"
---
# Build FastAPI/Postgres foundation
Create the first Core Hub runtime on the natural Coulomb stack.
## Scaffold Python Project
```task
id: CORE-WP-0003-T01
status: done
priority: high
state_hub_task_id: "3db032d8-7ac6-424e-8bbe-3debd332241b"
```
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: done
priority: high
state_hub_task_id: "d01d6169-a0c6-4689-b986-49ea6cd218b9"
```
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: done
priority: high
state_hub_task_id: "23c57f3e-425e-47d8-9fb5-9cc6366f2167"
```
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: done
priority: medium
state_hub_task_id: "a1790376-3f63-4eed-8f2f-c059eb1304db"
```
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 .`.