CLAUDE.md

1# apps/api — Claude context
2 
3FastAPI backend (`@medlens/api`), Python 3.12+.
4 
5## Commands
6 
7```bash
8pnpm --filter @medlens/api dev
9pnpm --filter @medlens/api lint
10pnpm --filter @medlens/api typecheck
11pnpm --filter @medlens/api test
12pnpm --filter @medlens/api test:integration
13```
14 
15## Layout
16 
17```text
18src/api/
19  core/         interfaces.py, factories.py, settings.py
20  providers/    auth, storage, db, ocr, llm
21  workflows/    report_processing.py, etc.
22  domain/       domain models
23  main.py       FastAPI app
24tests/
25  unit/
26  integration/
27```
28 
29## Conventions
30 
31- All providers via interfaces + factories — never hardcode vendors in routes.
32- Async I/O; Pydantic v2 schemas; env-backed settings.
33- No PHI in logs; safety filters on AI output.
34 
35## Guidance for agents
36 
37- Treat this package as a FastAPI service and follow the official FastAPI, Pydantic, and Uvicorn guidance for request handling, validation, and deployment.
38- When working with integrations or async flows, consult the relevant package documentation before introducing new patterns.
39- Keep the API contract consistent with the web and mobile apps by using shared schemas and package conventions.
40 
41## Skills
42 
43- `api-backend` — FastAPI, OpenAPI, Postgres
44- `ai-workflows` — LangGraph, prompts, RAG
45- `parser-pipeline` — OCR, extractors
46- `safety-privacy` — medical guardrails
47 
48Reference: `docs/02-architecture/04-ADAPTER_FACTORY_GUIDE.md`
49