# Local Development Guide

## Prerequisites
- Python 3.12+
- PostgreSQL 16+ or 17
- Redis 7+

## Quickstart

```bash
# 1. Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate

# 2. Install dependencies
pip install -r requirements.txt

# 3. Configure .env
cp .env.example .env

# 4. Run migrations
alembic upgrade head

# 5. Seed permissions
python scripts/seed_plans.py

# 6. Run tests
pytest -v

# 7. Start API dev server
uvicorn apps.api.main:app --reload --port 8000
```
