---
id: CORE-WP-0003
type: workplan
title: "Build FastAPI/Postgres foundation"
domain: infotech
repo: core-hub
status: ready
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: 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

```task
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

```task
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

```task
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.