# Regnum

Jeu de cartes en ligne multijoueur (2-4 joueurs). Collecte des points en jouant des cartes de royaume simultanément pendant X tours.

## Stack

- **Frontend** : Vue 3 + Phaser 3 + Pinia
- **Backend** : Node.js + Express + Socket.io
- **Temps réel** : WebSockets

## Structure

```
regnum/
├── client/          # Vue 3 + Phaser 3
│   ├── src/
│   │   ├── views/   # HomeView, LobbyView, GameView
│   │   ├── game/    # Scènes Phaser (Boot, Game) + objets + items/buildings/events
│   │   ├── stores/  # Pinia store
│   │   ├── services/# Socket.io client
│   │   └── utils/   # Fonctions pures partagées (HUD, etc.)
│   └── test/unit/   # Tests unitaires Vitest (store, utils)
├── server/          # Node.js
│   ├── src/
│   │   ├── game/    # Room, RoomManager, cards, items, buildings, events
│   │   └── index.js # Serveur Express + Socket.io
│   └── test/game/   # Tests unitaires node:test (moteur de jeu)
└── e2e/             # Tests d'intégration Playwright (client+serveur réels)
    └── tests/
```

## Lancement

### Serveur
```bash
cd server
npm install
npm run dev
```

### Client
```bash
cd client
npm install
npm run dev
```

Ouvrir `http://localhost:5173`

## Tests

Le projet a 3 niveaux de tests, à exécuter indépendamment :

### 1. Tests unitaires — serveur (moteur de jeu)

Logique pure de `Room.js` / `cards.js` / `items.js` (règles, gains, achats, effets permanents), avec le test runner natif de Node.js :

```bash
cd server
npm test            # exécution unique
npm run test:watch  # mode watch
```

### 2. Tests unitaires — client (store, utilitaires)

Store Pinia et fonctions pures du HUD (`hudUtils.js`), avec Vitest :

```bash
cd client
npm run test:unit        # exécution unique
npm run test:unit:watch  # mode watch
```

### 3. Tests d'intégration E2E (client + serveur réels)

Parcours complets (créer/rejoindre une salle, jouer des tours, acheter un objet, fin de partie) pilotés dans un vrai navigateur Chromium via Playwright, avec de vrais clients Socket.io. `webServer` dans `e2e/playwright.config.js` démarre automatiquement le serveur et le client si besoin.

```bash
cd e2e
npm install                # première fois seulement
npx playwright install chromium  # première fois seulement, si besoin
npm test                   # exécution unique
npm run test:ui            # mode interactif (debug)
```

## Règles

### Principe général

- 2 à 4 joueurs par partie, chacun avec son propre deck des mêmes 12 personnages (seule la couleur d'équipe change).
- Chaque joueur commence avec une main de 4 cartes ; le reste du deck (8 cartes) est pioché une carte par tour.
- La partie dure **12 tours**. Elle se termine avant si tous les joueurs n'ont plus ni carte en main ni carte à piocher.
- Chaque tour, tous les joueurs choisissent **simultanément** une carte (cachée), puis les cartes sont révélées et résolues en même temps.

### Les 4 jauges

Chaque personnage possède 4 attributs (valeurs de 1 à 6), qui correspondent à 4 jauges cumulées par le joueur pendant toute la partie :

| Jauge | Icône |
|---|---|
| Nourriture | 🟡 |
| Guerre | 🔴 |
| Santé | 🟢 |
| Diplomatie | 🔵 |

### Résolution d'un tour

Pour chaque attribut, un joueur compare la valeur de sa carte jouée à celle de son **voisin de gauche** (ordre des joueurs dans la partie, en boucle) :

```
gain = max(0, ma_valeur - valeur_du_voisin_de_gauche)
```

Le gain (jamais négatif) est ajouté à la jauge correspondante du joueur. Le score total d'un joueur est la somme de ses 4 jauges.

### Les 12 personnages

Reine, Prince, Boucher, Médecin, Apothicaire, Fou du Roi, Assassin, Paysan, Bourreau, Chevalier, Marchand, Évêque — chacun avec un profil d'attributs différent (ex : le Paysan est fort en Nourriture mais faible en Diplomatie, l'Assassin est très fort en Guerre mais faible partout ailleurs).

### Objets achetables

Pendant la phase de sélection, un joueur peut dépenser des points d'une jauge pour acheter un objet, qui procure un **effet permanent** pour le reste de la partie tant qu'il le possède. Chaque objet coûte 3 points et n'existe qu'en **un seul exemplaire** pour toute la partie (premier arrivé, premier servi) :

| Objet | Jauge liée | Effet |
|---|---|---|
| Trébuchet | 🔴 Guerre | Double le gain de Guerre à chaque tour |
| Charrue | 🟡 Nourriture | Double le gain de Nourriture à chaque tour |
| Trousse du Médecin | 🟢 Santé | Garantit +2 en Santé à chaque tour, quel que soit le résultat |
| Sceau Royal | 🔵 Diplomatie | Copie le meilleur gain de Diplomatie parmi tous les autres joueurs |

En cas de conflit (plusieurs joueurs achètent le même objet le même tour), c'est le joueur le plus proche du **"premier joueur"** du tour (rôle qui tourne entre les joueurs à chaque tour) qui l'obtient ; les autres conservent leurs points.

### Bâtiments achetables

Comme les objets, mais un bâtiment coûte des points sur **deux jauges à la fois** et garantit un minimum sur chacun de ses deux attributs à chaque tour, avec un **bonus de synergie** (+1 supplémentaire) si l'objet lié au même attribut est aussi possédé par le joueur. Un seul exemplaire de chaque bâtiment existe pour toute la partie, avec la même règle de priorité que les objets en cas de conflit d'achat.

| Bâtiment | Coût | Effet de base | Synergie |
|---|---|---|---|
| Église | 3 🟢 Santé + 2 🔵 Diplomatie | +1 Santé et +1 Diplomatie garantis chaque tour | +1 Santé supplémentaire si la Trousse du Médecin est possédée ; +1 Diplomatie supplémentaire si le Sceau Royal est possédé |
| Château Royal | 3 🟡 Nourriture + 2 🔴 Guerre | +1 Nourriture et +1 Guerre garantis chaque tour | +1 Nourriture supplémentaire si la Charrue est possédée ; +1 Guerre supplémentaire si le Trébuchet est possédé |

### Cartes Événement

En plus de sa carte personnage, un joueur peut piocher et jouer des cartes Événement à chaque tour :

- **Pioche** : en phase de sélection, un joueur peut acheter une pioche pour un coût fixe de **1 point dans chacune des 4 jauges**, une seule tentative par tour. La carte piochée provient d'un **deck partagé** de 18 cartes (3 exemplaires de chacun des 6 événements ci-dessous), mélangé au démarrage de la partie et commun à tous les joueurs.
- **Main d'événements** : les cartes piochées mais pas encore jouées s'accumulent dans une main personnelle limitée à **2 cartes**. Un joueur choisit librement, tour par tour, de jouer l'une de ses cartes (au maximum une par tour) ou de la garder.
- **Résolution** : toutes les cartes Événement jouées un même tour sont résolues **avant** le calcul des gains des cartes personnage (les jauges reflètent donc déjà leurs effets au moment de la comparaison des personnages). Une carte jouée est toujours défaussée après résolution, qu'elle ait ou non atteint son plein effet.

| Événement | Effet | Synergie |
|---|---|---|
| Récolte exceptionnelle | +2 Nourriture | +1 Nourriture supplémentaire avec la Charrue |
| Épidémie | Tous les joueurs perdent 1 Santé | Avec la Trousse du Médecin : un adversaire choisi perd 2 Santé à la place. Avec l'Église (prioritaire sur la Trousse) : tous les adversaires perdent 2 Santé à la place |
| Levée des troupes | +2 Guerre, -1 Diplomatie | +2 Guerre supplémentaires avec le Trébuchet (soit 4 Guerre au total) |
| Accord royal | +1 Diplomatie pour soi ; un joueur choisi gagne 1 Diplomatie ; un joueur choisi (peut être différent) perd 1 Diplomatie | +1 Diplomatie supplémentaire avec le Sceau Royal |
| Complot découvert | Jusqu'à la fin du tour, annule pour son porteur les effets négatifs des autres cartes Événement jouées ce tour | — |
| Grande fête au château | +1 Nourriture, +1 Diplomatie | Pioche 1 carte Événement supplémentaire avec le Château Royal |

### Fin de partie

Le joueur avec le score total (somme des 4 jauges) le plus élevé après 12 tours remporte la partie.