ADR-0021 — Critique sourcée : challenger (et défendre) avec une référence ou une pièce

Statut	✅ Accepté — 2026-06-19
Portée	Revue contradictoire (ADR-0008) : modèle MessageRevue, endpoints revue.py, écran cabinet/Revue.tsx. Vaut pour senior ET externe (et le junior en réponse/défense)
Décision	Un message de critique/réponse/défense peut porter une référence du Référentiel et une pièce jointe (contre-source) — optionnelles, comme une justification (ADR-0009)
Réf.	ADR-0008 — Revue contradictoire ; ADR-0009 — Justification à deux niveaux

🎯 À retenir

Jusqu'ici une critique était texte seul. Le reviewer pouvait dire « ce taux me paraît faible » mais pas opposer une source. Désormais, en ouvrant un fil (ou en y répondant), on peut lier une entrée du Référentiel (« contredit IAS 19 §83 ») et joindre une contre-source (un rapport concurrent). Cela vaut pour les deux reviewers — senior et externe — et, par symétrie, pour le junior quand il répond ou défend (on challenge ET on défend avec des sources). Le client ne voit jamais les fils.

Contexte

ADR-0008 a posé la revue contradictoire ancrée : des fils de critique par champ, un cycle ouvert → répondu | maintenu → résolu. Mais un MessageRevue ne portait que du texte. Repéré en QA senior : le reviewer peut déjà ouvrir les pièces justificatives du junior (vérifier la source), mais il ne peut pas :

• pointer une référence normative opposée (le Référentiel existe pourtant, ADR-0009) ;
• joindre une pièce de contre-source (un document externe) ;

bref, challenger la source ou l'interprétation avec une source. Or c'est le cœur d'une revue d'actuaire : opposer une norme ou une donnée, pas seulement une opinion.

Décision

• D-SRC-1 — Message sourçable. MessageRevue gagne referentiel_cle (entrée du Référentiel) et une pièce optionnelle (piece_nom / piece_chemin / piece_taille). Mêmes champs qu'une justification (ADR-0009) ; une pièce par message suffit.
• D-SRC-2 — Symétrie reviewer ↔ junior. Le senior et l'externe sourcent leurs critiques (selon leur étape, comme l'ouverture de fil — D-REV-4) ; le junior assigné source ses réponses/défenses. On challenge avec une source, on défend avec une source.
• D-SRC-3 — Pièces ouvrables, immuables. Le staff en périmètre ouvre les pièces (du junior comme du reviewer) pour vérifier (déjà le cas pour les justifications). Les pièces de message suivent l'immuabilité des messages (jamais supprimées).
• D-SRC-4 — Réutilisation. Le lien Référentiel réutilise le composant RefOptions (catalogue + entrées base) ; l'upload/download de pièce mirrore les pièces de justification (etude.py). Aucune nouvelle table — colonnes optionnelles sur le message.

Conséquences

• Positif. La revue devient réellement contradictoire et sourcée : « votre 4 % contredit le rendement BEAC que voici » (référence + pièce), le junior répond/défend avec sa propre source. La boucle se ferme par un dialogue d'éléments, pas d'avis.
• Limite assumée. Une pièce par message (pas de galerie) ; le referentiel_cle est la clé texte (comme les justifications), pas une FK — cohérent avec ADR-0009, pas une régression. Le client reste hors des fils (la critique sourcée est de la cuisine staff).

Déclencheur de réexamen

• Si un message doit porter plusieurs pièces, ou si le referentiel_cle doit devenir une vraie relation (intégrité) → introduire une table MessagePiece / une FK et re-statuer (même question que pour les justifications, à traiter une fois pour toutes).