fastapi-app

1# fastapi-app
2 
3Bootstrap a new FastAPI backend the way this owner builds them: async SQLAlchemy
42.0 with asyncpg, Alembic migrations, Pydantic v2 settings, a layered structure
5(routers, services, models, schemas), JWT auth, and the house git and CI
6workflow. Deployable to a container or Vercel.
7 
8First read the shared rules (they override anything you remember):
9`../shared/house-rules.md`, `../shared/no-ai-attribution.md`,
10`../shared/git-and-ci.md`, `../shared/docs-and-context.md`,
11`../shared/hardening.md`, and (for public repos) `../shared/open-source-docs.md`.
12 
13## Step 0. Get the brief, then ask the variant questions (hard stop)
14 
15This is a hard stop. Do not run any scaffolding command until the user has
16answered.
17 
18First, get the project brief: one paragraph on what the service does, its main
19resources and endpoints, who calls it, and any hard constraints. If the user has
20not given one, ask for it. The brief drives naming, the domain modules, and the
21data model.
22 
23Then ask the variant questions. If a choice has multiple options, ask; do not
24assume. Ask in one batch, then proceed.
25 
261. Repo visibility: private, open-source, or private-plus-open-source.
272. Auth: JWT (python-jose or PyJWT), OAuth (Google), API-key, or none yet.
283. Database: Postgres via async SQLAlchemy + asyncpg (default), or none yet.
294. Dependency tooling: `uv` (default, fast) or `pip` + `requirements.txt`.
305. Admin UI: SQLAdmin, or none.
316. Deploy target: Docker container (default) or Vercel serverless.
32…