Vœu de compagnon : être affecté avec 0 à N autres bénévoles

Nouveau vœu sur la fiche du bénévole — « je voudrais être affecté avec tel(s)
bénévole(s) » — pris en compte à la fois pour le rendre visible et par le
solveur.

Backend :
- `VolunteerCompanionWish` (`volunteer_id`, `companion_id`, à sens unique,
  `CHECK (volunteer_id <> companion_id)`) — migration 0010.
- API : `wished_companion_ids` sur `VolunteerCreate`/`Update`/`Read`, mêmes
  règles que les autres vœux (ids inconnus → 422 `volunteer.unknown` ; se
  souhaiter soi-même → 422 `volunteer.cannot_wish_self`).
- Solveur (`engine.py`) : bonus (+25 par correspondance) si un des compagnons
  souhaités du candidat est déjà affecté (décision déjà prise) au créneau —
  cumulable si plusieurs compagnons sont présents. Comme les autres termes de
  l'objectif, un bonus/malus, jamais une contrainte.
- Seed de démo : ~20 % des bénévoles ont un vœu de compagnon (couple, amis).

Frontend :
- Fiche bénévole (`ConfigVolunteers.tsx`) : sélecteur de compagnons (ajout et
  édition), avec une bulle d'aide expliquant le sens unique et l'effet sur le
  solveur — c'est ce qui « fait apparaître » le lien entre bénévoles.
- Panneau d'affectation : badge « avec N compagnon(s) souhaité(s) » sur un
  candidat, et bonus correspondant dans le classement par défaut
  (`candidateChanceScore`).
- Mock (`runSolver`) : même bonus, pour que la démonstration se comporte
  pareil que le vrai solveur.

CLAUDE.md à jour (modèle de domaine, section 4, journal).

Vérifié : 194 tests backend (dont 13 nouveaux), ruff, alembic check ;
typecheck/lint/build/smoke frontend ; solveur testé en direct sur le jeu de
démo reseedé (0,25 s, 47 suggestions).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM

backend/app/seed.py

@@ -31,6 +31,7 @@ from app.models import (
     Shift,
     Volunteer,
     VolunteerArtist,
+    VolunteerCompanionWish,
     VolunteerPositionWish,
 )
 from app.validation import (
@@ -47,8 +48,8 @@ SEED = 20260709
 DEMO_EDITION_NAME = "Festival des Lucioles"
 DEMO_COORDINATION_PASSWORD = "coordination-lucioles-2026"
 DEMO_YEAR = 2026
-START = dt.date(2026, 7, 9)
-END = dt.date(2026, 7, 12)
+START = dt.date(2026, 10, 30)
+END = dt.date(2026, 10, 31)
 
 FIRST_NAMES = [
     "Camille",
@@ -214,6 +215,7 @@ class Summary:
     artists: int = 0
     position_wishes: int = 0
     artist_wishes: int = 0
+    companion_wishes: int = 0
     warnings: Counter = field(default_factory=Counter)
     blocking: int = 0
 
@@ -229,6 +231,7 @@ class Summary:
             f"  Artistes programmés    : {self.artists}",
             f"  Vœux de poste déclarés : {self.position_wishes}",
             f"  Vœux d'artiste déclarés : {self.artist_wishes}",
+            f"  Vœux de compagnon déclarés : {self.companion_wishes}",
             f"  Avertissements actifs : {sum(self.warnings.values())}",
         ]
         for code, count in sorted(self.warnings.items()):
@@ -398,6 +401,20 @@ def build(session: Session, *, rng: random.Random | None = None) -> Summary:
                     VolunteerArtist(volunteer_id=volunteer.id, artist_id=artist.id)
                 )
                 n_artist_wishes += 1
+    # Vœux de compagnon (couple, amis) : à sens unique, choisis parmi les
+    # autres bénévoles déjà créés.
+    n_companion_wishes = 0
+    for volunteer in volunteers:
+        others = [v for v in volunteers if v.id != volunteer.id]
+        roll = rng.random()
+        n_wishes = 2 if roll < 0.03 else (1 if roll < 0.23 else 0)
+        for companion in rng.sample(others, k=min(n_wishes, len(others))):
+            session.add(
+                VolunteerCompanionWish(
+                    volunteer_id=volunteer.id, companion_id=companion.id
+                )
+            )
+            n_companion_wishes += 1
     # Disponibilités : chaque bénévole déclare, pour ~80 % des jours, une
     # large fenêtre couvrant la journée et la nuit (06:00 → 04:00 le lendemain).
     _FULL_DAY = (dt.time(6, 0), dt.time(4, 0))
@@ -519,6 +536,7 @@ def build(session: Session, *, rng: random.Random | None = None) -> Summary:
         artists=len(artists),
         position_wishes=n_position_wishes,
         artist_wishes=n_artist_wishes,
+        companion_wishes=n_companion_wishes,
     )
     _verify(session, edition, summary)
     return summary