Aller au contenu

ADR-003 — Hiérarchie de précédence des sources (fiche consolidée)
Statut Accepted (cible conditionnelle, voir Conséquences)
Date 07/05/2026 (S19 mid-week)
Décideurs Romain BAZIL, Nicolas Léonard
Origine Synchro S19 mid-week §3

Contexte

La fiche consolidée applique une hiérarchie de précédence par champ pour choisir quelle source faire foi quand il y a divergence. Quatre sources :

  • AM Override : validations / éditions manuelles dans la vue consolidée
  • Déclaratif Bubble : ce que le porteur a saisi dans son espace
  • Messagerie interne CRM : échanges entre porteur, AM et équipe
  • Data Extraction : informations extraites des documents par les agents IA

L'ordre initial place Data Extraction en bas tant que sa fiabilité n'est pas démontrée. Cet ordre devient dangereux avec la validation automatique : il ferait prévaloir du déclaratif Bubble qui n'est justifié par aucun document.

Décision

Ordre actuel (V1, transitoire)

Tant que la validation AM est exigée systématiquement, l'ordre n'a pas d'impact opérationnel (tout passe par AM Override de toute façon) :

1. AM Override
2. Déclaratif Bubble
3. Messagerie interne
4. Data Extraction

Ordre cible (à activer dès qu'on bascule en validation auto + Data Extraction fiabilisé)

1. AM Override         (autoritaire, dernier mot)
2. Data Extraction     (fiabilisé via chantier freelances)
3. Messagerie interne  (vivante, peut contredire des éléments figés)
4. Déclaratif Bubble   (stale snapshot, jamais mis à jour ensuite)

Critère "fraîcheur de la donnée" intégré

À utiliser pour pondérer la précédence : Bubble peut dater de plusieurs semaines, l'apport / la nature du projet peuvent avoir changé entre temps. La messagerie reflète la conversation vivante, donc plus à jour.

Rationale

Pourquoi AM Override en #1

L'AM est le seul acteur qui peut explicitement dire « j'ai vu, j'ai vérifié, voilà la valeur ». C'est une déclaration humaine traçable, avec stamp et date. Aucune source automatique ne peut être plus autoritaire.

Pourquoi Data Extraction monte en #2 (cible)

Data Extraction lit les documents officiels (compromis, bilans, baux). Une fois fiabilisé via le chantier freelances + cascade convergence, c'est la source la plus dense en information vérifiable.

Pourquoi Messagerie en #3

La messagerie reflète des échanges vivants : si le porteur dit "finalement j'ai 80k€ d'apport et pas 100k€" dans un message daté, c'est plus à jour que la fiche Bubble figée à la création. Mais c'est du déclaratif sans document.

Pourquoi Bubble en #4 (cible)

Romain : « Le déclaratif Bubble et la messagerie n'ont pas de valeur en soi. C'est justement pour ça qu'on les avait traités à part. On ne peut pas se baser dessus. »

Bubble = snapshot du moment de la création de la fiche, jamais mis à jour ensuite. Risque concret : pré-valider automatiquement un apport déclaré il y a 6 semaines qui ne reflète plus la réalité.

Conséquences

Condition d'activation de l'ordre cible

L'ordre cible est conditionné à deux prérequis :

  1. Validation auto activée sur convergence (fin de la validation systématique AM, voir ADR-001)
  2. Data Extraction fiabilisé via plusieurs approches indépendantes et une cascade de convergence

Tant que ces deux conditions ne sont pas remplies → on garde l'ordre transitoire.

Ce qu'il faut faire

  • Documenter la hiérarchie par champ dans la doc in-app (voir ADR-006)
  • Préciser les règles de pré-fill par défaut dans le code.
  • Acter la bascule via un nouvel ADR (ADR-007 à venir) quand on flippe le switch

Ce qu'il faut éviter

  • Pré-valider automatiquement le déclaratif Bubble seul : fait sauter tout l'intérêt d'avoir conçu un système isolé pour le déclaratif
  • Considérer la messagerie comme du document officiel : c'est du déclaratif vivant, pas une source vérifiée

Alternatives écartées

  • Bubble en #2 (V1 actuelle) : non justifié dès qu'on auto-valide → risque de pré-valider du déclaratif obsolète
  • Pas de hiérarchie, tout le monde au même niveau : casse l'auto-validation, oblige systématiquement à arbitrer
  • Ordre dynamique calculé par LLM : trop complexe pour une V1, anti-pattern "less is more"

Synthèse des échanges

La validation automatique impose de faire remonter les sources documentaires fiabilisées. Le déclaratif figé reste utile comme signal, mais sa fraîcheur et son absence de preuve empêchent de le traiter comme source prioritaire.

Voir aussi

Sources