dofus-manager/docs/architecture/13-development-workflow.md

13. Development Workflow

Local Development Setup

# 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

# .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

---