# 13. Development Workflow

## Local Development Setup

```bash
# 1. Clone repository
git clone <repo-url>
cd dofus-manager

# 2. Install dependencies
pnpm install

# 3. Setup environment
cp .env.example .env
# Edit .env with your values

# 4. Start database
docker compose up -d postgres

# 5. Run migrations
pnpm prisma migrate dev

# 6. Seed database (optional)
pnpm prisma db seed

# 7. Start development server
pnpm dev
```

## Environment Variables

```bash
# .env.example

# Database
DATABASE_URL="postgresql://postgres:postgres@localhost:5432/dofus_manager?schema=public"

# App
APP_URL="http://localhost:3000"
NODE_ENV="development"

# Session
SESSION_SECRET="your-secret-key-min-32-chars"

# Optional: DofusDB
DOFUSDB_CACHE_TTL="3600"
```

## Git Workflow

```
main (production)
  │
  └── develop (staging)
        │
        ├── feature/add-character-filters
        ├── feature/team-management
        └── fix/progression-update-bug
```

## Branch Naming

- `feature/*` - New features
- `fix/*` - Bug fixes
- `refactor/*` - Code refactoring
- `docs/*` - Documentation updates
- `chore/*` - Maintenance tasks

## Commit Convention

```
<type>(<scope>): <description>

Types: feat, fix, docs, style, refactor, test, chore
Scope: characters, accounts, teams, progressions, auth, ui

Examples:
feat(characters): add bulk delete functionality
fix(progressions): correct date formatting
docs(readme): update setup instructions
```

---