Cursor rule

1---
2description: FastAPI async backend — Pydantic v2, providers, factories, settings for apps/api
3globs: ["apps/api/**"]
4alwaysApply: false
5---
6 
7# FastAPI Backend
8 
9Stack: Python 3.12+, FastAPI, Pydantic v2, async I/O, Ruff, mypy strict, pytest.
10 
11## Architecture (mandatory)
12 
13- Interfaces: `apps/api/src/api/core/interfaces.py`
14- Factories: `apps/api/src/api/core/factories.py`
15- Settings: `apps/api/src/api/core/settings.py` — env-backed only
16- Providers live under `apps/api/src/api/providers/` — never hardcode vendor SDKs in routes or workflows
17 
18## Conventions
19 
20- Async route handlers and async provider methods for I/O.
21- Pydantic models for request/response; separate domain models from API schemas when needed.
22- Raise `HTTPException` with safe user messages; log technical detail without PHI.
23- New providers: implement interface + register in factory; add unit tests with mocks.
24 
25## Commands
26 
27```bash
28pnpm --filter @medlens/api lint
29pnpm --filter @medlens/api typecheck
30pnpm --filter @medlens/api test
31```
32 
33Skill: `.cursor/skills/api-backend/SKILL.md`
34