# CLAUDE.md

## Project
Python FastAPI application with SQLAlchemy ORM, Alembic migrations, and pytest.

## Commands
- `uv run fastapi dev` — start dev server
- `uv run pytest` — run tests
- `uv run alembic upgrade head` — run migrations
- `uv run ruff check .` — lint
- `uv run ruff format .` — format

## Code Style
- Use type hints everywhere
- Use Pydantic models for request/response schemas
- Use dependency injection for database sessions
- Follow Google Python style guide
- Keep functions under 30 lines

## Architecture
- app/api/ — route handlers
- app/models/ — SQLAlchemy models
- app/schemas/ — Pydantic schemas
- app/services/ — business logic
- app/core/ — config, security, deps

## Database
- Always create Alembic migrations for schema changes
- Use async SQLAlchemy sessions
- Never use raw SQL — use the ORM