@stevermeister/fastapi-modern

# FastAPI Project - Project Guidelines

## Project Overview
Built with FastAPI following modern async Python best practices and clean architecture.

## Development Guidelines

### Project Structure
- Use domain-driven structure:
  - `app/api` - API routes
  - `app/core` - Core functionality
  - `app/models` - Database models
  - `app/schemas` - Pydantic schemas
  - `app/services` - Business logic
  - `app/repositories` - Data access

### Architecture
- Follow async patterns throughout
- Use dependency injection
- Implement proper layered architecture
- Separate business logic from routes

### Coding Standards
- Use Python 3.11+ features
- Implement proper type hints everywhere
- Use Pydantic V2 for validation
- Follow async/await patterns
- Use SQLAlchemy 2.0 async
- Implement proper error handling
- Use FastAPI dependency injection

### Code Quality Tools
- Pre-commit hooks:
  - Black formatting
  - Ruff for linting
  - Mypy for type checking
  - Pytest execution
- Additional checks:
  - Security scanning
  - Dependency updates
  - API documentation validation

### Development Environment

#### Requirements
- Python version: 3.11+
- Package manager: Poetry/pip
- FastAPI: 0.100+

#### Testing Requirements
- Pytest for testing
- Pytest-asyncio for async tests
- Httpx for API testing
- Coverage threshold: 85%

#### Dependencies
Core:
- FastAPI 0.100+
- Pydantic V2
- SQLAlchemy 2.0
- Alembic for migrations
- Python-jose for JWT

#### Production
- Uvicorn/Gunicorn
- Proper CORS
- Rate limiting
- Caching
- Monitoring

### Security
- JWT authentication
- OAuth2 flows
- Proper password hashing
- SQL injection prevention
- XSS protection

### Performance
- Use async database queries
- Implement caching
- Connection pooling
- Response compression