1# Copilot Instructions
2
3## Language & Framework
4This is a Python 3.12 project using FastAPI with SQLAlchemy 2.0 (async).
5We use Pydantic v2 for validation and Alembic for migrations.
6
7## Code Style
8- Use type hints on all function signatures
9- Prefer `async def` for route handlers and database operations
10- Use dependency injection via FastAPI's `Depends()` system
11- Name variables descriptively: `user_repository` not `ur`
12- Keep functions under 30 lines; extract helpers for complex logic
13
14## Architecture Patterns
15- Repository pattern for all database access (`app/repositories/`)
16- Service layer for business logic (`app/services/`)
17- Route handlers should only validate input, call services, format output
18- Use Pydantic models for all API request/response schemas
19
20## Error Handling
21- Raise domain-specific exceptions from `app/exceptions.py`
22- Never catch bare `Exception` — always catch specific types
23- Return RFC 7807 Problem Details JSON for all API errors
24
25## Testing
26- Use pytest with pytest-asyncio for async test support
27- Factory Boy for test fixtures (`tests/factories/`)
28- Every endpoint needs at least: happy path, validation error, not found
29- Use `httpx.AsyncClient` for integration tests, not TestClient
30
31---
32
33## Scoped Instructions (.github/instructions/react.instructions.md)
34
35```markdown
36---
37applyTo: "src/components/**/*.tsx"
38---
39- Use functional components with TypeScript interfaces for props
40- Prefer named exports over default exports
41- Use Tailwind CSS utility classes for styling
42- Keep components under 150 lines
43```