Bénévole : l'email n'est plus unique (couple, famille)

Plusieurs bénévoles peuvent légitimement partager une même adresse email —
l'architecture l'interdisait : l'import ignorait silencieusement le second
(« duplicate_email_in_file »), et l'ajout manuel renvoyait un 409. Les deux
sont corrigés.

- Migration 0009 : retrait de la contrainte d'unicité (edition_id, email) sur
  `volunteer` (l'index sur `email` seul est conservé).
- Import (`app/importing/service.py`) : l'upsert se fait désormais sur
  (email, nom + prénom), pas sur l'email seul. Un même email revu avec un nom
  différent dans le fichier crée un second bénévole (nouveau code
  `import.row.shared_email`, WARNING) au lieu d'être ignoré ;
  `duplicate_email_in_file` ne se déclenche plus que sur une ligne
  littéralement répétée (même email ET même nom).
- API (`POST`/`PATCH /volunteers`) : retrait du rejet 409
  `volunteer.duplicate_email`, devenu sans objet (le mock ne l'a d'ailleurs
  jamais appliqué à la création manuelle).
- Mock frontend (`mock-client.ts`) : même correction de l'upsert par import,
  pour rester cohérent avec le backend.
- CLAUDE.md à jour (modèle de domaine, règles d'import, journal).

Contrepartie assumée (documentée) : un email re-importé avec un nom
légèrement différent (faute de frappe corrigée) crée désormais un bénévole
de plus signalé, plutôt que de renommer silencieusement l'existant — même
philosophie que la détection sans email, qui ne fusionne jamais rien
automatiquement.

Vérifié : 179 tests backend, ruff, alembic check ; typecheck/lint/build/smoke
frontend ; reseed de démonstration.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM
This commit is contained in:
AdamThomas
2026-09-15 19:38:28 +02:00
co-authored by Claude Sonnet 5
parent fcc42c8d43
commit 897a76ca6d
11 changed files with 193 additions and 70 deletions
+40 -12
View File
@@ -2,6 +2,12 @@
L'import ne porte que l'identité des bénévoles (nom, email, téléphone,
commentaire). Les disponibilités se déclarent dans l'application.
Détection des doublons : upsert sur (email, nom + prénom) — l'email seul ne
suffit pas, plusieurs bénévoles peuvent le partager (couple, famille) ; sans
email, détection sur (nom, prénom) signalée sans upsert automatique. Un même
email revu avec un nom différent crée un bénévole de plus (signalé), jamais
ignoré.
"""
import re
@@ -104,14 +110,20 @@ def run_import(
select(Volunteer).where(Volunteer.edition_id == edition.id)
)
)
by_email = {v.email.lower(): v for v in existing if v.email}
# Plusieurs bénévoles peuvent partager un même email (couple, famille) :
# l'email seul ne suffit pas à identifier un bénévole existant, il faut
# l'associer au nom. `by_name` ne sert qu'aux bénévoles sans email.
by_email_and_name: dict[tuple[str, tuple[str, str]], Volunteer] = {}
by_name: dict[tuple[str, str], Volunteer] = {}
for volunteer in existing:
if not volunteer.email:
key = (normalize(volunteer.last_name), normalize(volunteer.first_name))
key = (normalize(volunteer.last_name), normalize(volunteer.first_name))
if volunteer.email:
by_email_and_name[(volunteer.email.lower(), key)] = volunteer
else:
by_name.setdefault(key, volunteer)
report = ImportReport(dry_run=mapping.dry_run, total_rows=len(table.rows))
row_seen: dict[tuple[str, tuple[str, str]], int] = {}
email_seen: dict[str, int] = {}
name_seen: dict[tuple[str, str], int] = {}
@@ -151,34 +163,50 @@ def run_import(
report.skipped += 1
continue
name_key = (normalize(last_name), normalize(first_name))
if email:
if email in email_seen:
row_key = (email, name_key)
if row_key in row_seen:
# Même email ET même nom déjà vus : la ligne est répétée dans
# le fichier (copier-coller), pas deux bénévoles distincts.
entry.issues.append(
Issue(
code="import.row.duplicate_email_in_file",
severity="ERROR",
field="email",
params={"value": email_raw, "first_line": email_seen[email]},
params={"value": email_raw, "first_line": row_seen[row_key]},
)
)
report.rows.append(entry)
report.skipped += 1
continue
email_seen[email] = line
if email in email_seen:
# Même email, nom différent : deux bénévoles peuvent partager
# une adresse (couple, famille) — on les crée tous les deux,
# simplement signalé pour la coordination.
entry.issues.append(
Issue(
code="import.row.shared_email",
severity="WARNING",
field="email",
params={"value": email_raw, "first_line": email_seen[email]},
)
)
row_seen[row_key] = line
email_seen.setdefault(email, line)
else:
key = (normalize(last_name), normalize(first_name))
if key in name_seen:
if name_key in name_seen:
entry.issues.append(
Issue(
code="import.row.duplicate_name_in_file",
severity="WARNING",
params={"first_line": name_seen[key]},
params={"first_line": name_seen[name_key]},
)
)
else:
name_seen[key] = line
name_seen[name_key] = line
volunteer = by_email.get(email) if email else None
volunteer = by_email_and_name.get((email, name_key)) if email else None
if volunteer is not None:
entry.action = "UPDATED"
entry.issues.append(
@@ -190,7 +218,7 @@ def run_import(
)
else:
if not email:
match = by_name.get((normalize(last_name), normalize(first_name)))
match = by_name.get(name_key)
if match is not None:
entry.issues.append(
Issue(