CLAUDE.md

1# AI Service Instructions
2 
3This directory contains the FastAPI service for Python-native workloads: ML inference, document extraction, OCR or parsing workflows, model-facing APIs, and compute-heavy jobs.
4 
5## Commands
6 
7Run from `ai-service/`:
8 
9```sh
10python -m uvicorn app.main:app --reload
11python -m ruff check .
12python -m pytest
13python -m mypy app
14```
15 
16## Rules
17 
18- Keep route handlers thin and focused on HTTP concerns.
19- Put reusable behavior in `app/domains/` services and schemas.
20- Use explicit Pydantic request and response models.
21- Preserve strict typing and keep `mypy app` clean.
22- Treat extraction results as candidate data until validated or confirmed.
23- Keep generated explanations non-diagnostic and patient-safe.
24- For endpoint changes, define the request/response contract and tests before broad implementation.
25