dofus-manager/docs/prd/epic-1-foundation-core-entities.md

Epic 1: Foundation & Core Entities

Goal: Établir les fondations du projet (setup, Docker, Prisma, CI/CD) et implémenter le CRUD complet pour les entités de base : Serveurs, Comptes et Personnages. À la fin de cet epic, l'utilisateur peut créer, consulter, modifier et supprimer des serveurs, comptes et personnages.

Story 1.1: Project Setup & Infrastructure

As a developer, I want a fully configured TanStack Start project with Docker and GitLab CI, so that I can start development with a working local environment and deployment pipeline.

Acceptance Criteria:

1. TanStack Start project initialized with TypeScript strict mode
2. Docker Compose configuration with app service and PostgreSQL 16
3. Prisma configured and connected to PostgreSQL
4. shadcn/ui installed with base components (Button, Input, Card, Table)
5. ESLint + Prettier configured with recommended rules
6. GitLab CI pipeline: build, lint, test stages
7. Dockerfile multi-stage pour production build
8. README avec instructions de setup local
9. Application démarre et affiche une page d'accueil "Dofus Manager"

Story 1.2: Database Schema - Core Entities

As a developer, I want a Prisma schema with Server, Account, and Character models, so that the data structure is defined and migrations are ready.

Acceptance Criteria:

1. Model Server: id, name, createdAt, updatedAt
2. Model Account: id, name, ogrines (integer), createdAt, updatedAt
3. Model Character: id, name, class (enum 17 classes), level (1-200), serverId (FK), accountId (FK), createdAt, updatedAt
4. Enum CharacterClass avec les 17 classes Dofus
5. Relations définies : Character → Server (N:1), Character → Account (N:1)
6. Migration initiale générée et appliquée
7. Seed script avec données de test (2 serveurs, 3 comptes, 10 personnages)

Story 1.3: Server CRUD

As a user, I want to manage servers (create, view, edit, delete), so that I can add the Dofus servers I play on.

Acceptance Criteria:

1. Page /servers affiche la liste des serveurs en tableau
2. Bouton "Ajouter" ouvre un formulaire modal de création
3. Formulaire avec champ nom (requis, unique)
4. Actions Edit/Delete sur chaque ligne (icônes au hover)
5. Confirmation avant suppression
6. Toast de confirmation après chaque action
7. Validation : nom non vide, unicité vérifiée côté serveur
8. Serveurs triés par nom alphabétique

Story 1.4: Account CRUD

As a user, I want to manage my Dofus accounts (create, view, edit, delete), so that I can organize my characters by account.

Acceptance Criteria:

1. Page /accounts affiche la liste des comptes en tableau (nom, ogrines, nb personnages)
2. Bouton "Ajouter" ouvre un formulaire modal de création
3. Formulaire avec champs : nom (requis), ogrines (optionnel, défaut 0)
4. Actions Edit/Delete sur chaque ligne
5. Clic sur un compte navigue vers /accounts/:id (fiche détail)
6. Page détail affiche infos compte + liste des personnages associés
7. Suppression compte impossible si personnages associés (message d'erreur)
8. Toast de confirmation après chaque action

Story 1.5: Character CRUD

As a user, I want to manage my characters (create, view, edit, delete), so that I can track all my Dofus characters.

Acceptance Criteria:

1. Page /characters affiche la liste des personnages en tableau (nom, classe, niveau, serveur, compte)
2. Bouton "Ajouter" ouvre un formulaire modal de création
3. Formulaire avec champs : nom (requis), classe (select), niveau (1-200), serveur (select), compte (select)
4. Actions Edit/Delete sur chaque ligne
5. Clic sur un personnage navigue vers /characters/:id (fiche détail)
6. Page détail affiche toutes les infos du personnage
7. Icônes de classe affichées (optionnel: images ou emojis)
8. Tableau paginé (20 items par page)
9. Toast de confirmation après chaque action

Story 1.6: Navigation & Layout

As a user, I want a consistent navigation layout, so that I can easily move between sections of the app.

Acceptance Criteria:

1. Sidebar de navigation avec liens : Dashboard, Personnages, Comptes, Serveurs
2. Layout responsive : sidebar collapse sur mobile
3. Breadcrumb sur les pages de détail
4. Page active mise en évidence dans la sidebar
5. Header avec titre de l'application
6. Dark mode toggle (état persisté en localStorage)

---