decision/docs/adr/0010-objections-et-coquilles-validees.md

0010 — Objections « redit » / « contredit », coquilles validées, messagerie

Remplace 0004 (contradictions signalées) et complète 0003 (corriger n'est pas voter), dont la règle de la coquille ne change pas. Décisions d'Yvv du 2026-10-30 (revue) ; la messagerie dans l'application et la coquille d'un texte du seed validée par un administrateur sont les choix par défaut d'orch. Lot F, 2026-10-31. Révisée le 2026-11-01 (décision d'Yvv, lot G) : sur une version retenue, on peut encore retirer son vote ou voter « contre », jamais ajouter un « pour ». Révisée par 0012 (2026-11-02, lot V) : un « pour » dont la preuve arrive sur la chaîne pendant qu'une objection retient la version est écarté ; il ne compte plus « tel qu'il est signé ».

Contexte. Le signalement de contradiction (0004) bloquait l'entrée en vigueur sans dire à qui revenait le geste suivant, et une coquille corrigée par n'importe qui changeait le texte d'un autre sans lui demander. Yvv, 2026-10-30 :

• « Faudrait un "redit" en option avec "contredit" → faut rendre plus explicite que l'objection doit être levée par l'auteur de la dernière arrivée pour être une proposition votable. Pour ce qui constitue une répétition → modifier l'article cible ; pour une contradiction → reformuler. → ping messagerie TrustinWallet → Lever l'objection ou Réitérer l'objection ; si pas de réponse sous 3j, alors "levée". »
• « Corriger coquille → ping auteur pour valid → idem 3j ça passe auto, mais auteur a toujours la main tant que c'est pas le texte en vote. Sinon seule une coquille validée corrige le texte en vote. » (« le texte en vote » : le texte en vigueur.)

Décision

Les objections — crates/ld-engine/src/objection.rs

• Une objection dit qu'une version redit une autre (elle la répète) ou la contredit, motif à l'appui (10 à 600 signes). Elle porte sur deux versions de texte de deux articles différents, ouvertes ou en vigueur — jamais deux textes en vigueur (both_in_force).
• Elle retient la dernière arrivée des deux (date de soumission, à défaut de création, puis l'ordre d'écriture) ; jamais un texte en vigueur : si la dernière arrivée est en vigueur, c'est l'autre qui est retenue. La version retenue est fixée quand l'objection est faite.
• Tant que l'objection tient, la version retenue ne prend plus de « pour » et n'entre pas en vigueur, quelles que soient ses voix. Yvv, 2026-11-01, à la question « pendant qu'une objection retient une version, que permet-on ? » : « Retirer ou "contre" ». Chacun peut retirer son vote ou passer à « contre » ; personne ne peut ajouter un « pour » (vote direct, vote groupé, bulletin de la chaîne : 409 objection, et une ligne refusée refuse tout le vote). La version ne peut que perdre des voix tant qu'elle est retenue ; à la levée, elle n'entre qu'avec les voix encore là. Les votes déjà faits restent ; un bulletin scellé avant l'objection et confirmé après compte tel qu'il est signé pour « contre » et le retrait ; son « pour » est écarté (0012). Règle : ld_engine::objection::may_cast, appliquée par DocState::admits.
• Une personne n'a qu'une objection debout sur une même paire (objection_exists).
• L'auteur de la version retenue répond : pour une redite, il modifie l'article visé (une proposition liée à l'objection, sur l'article de l'autre version, partie de son texte) ; pour une contradiction, il reformule (une révision de fond de sa version, ou une proposition liée sur son propre article). Une révision de fond de l'une ou l'autre des deux versions vaut réponse ; une coquille, non. Une version du seed n'a pas d'auteur : tout membre du groupe peut y répondre par une proposition liée.
• Une réponse donne la main à la personne qui objecte : un message lui demande de lever ou de réitérer dans les 3 jours ; sans geste de sa part, l'objection est levée à l'échéance. Un seul tour à la fois : une autre réponse pendant son tour ne change ni le message ni l'échéance. Réitérer rend la main à l'auteur (tour suivant, sans échéance pour lui).
• Lever : la personne qui a fait l'objection, à tout moment, ou un administrateur de trustinWallet. Réitérer : elle seule. Retirer une des deux versions met fin à l'objection. Une levée relance l'adoption : la version libérée entre en vigueur si les voix encore là suffisent.
• Règles d'accès : trustin_access::lifts_objection, reiterates_objection.

Qui	Quoi	Effet	Échéance
tout membre du groupe	faire une objection « redit » ou « contredit »	la dernière arrivée (jamais un texte en vigueur) ne prend plus de « pour » — « contre » et retrait seulement — et n'entre pas en vigueur ; message à son auteur	—
l'auteur de la version retenue (tout membre pour une version du seed)	modifier l'article visé (redit) ou reformuler (contredit)	la main passe à la personne qui objecte ; message « lever ou réitérer »	3 jours pour elle
la personne qui objecte	lever	la version reprend des « pour », et entre en vigueur si les voix encore là suffisent	—
la personne qui objecte	réitérer	la main revient à l'auteur ; message « réponds à nouveau »	aucune pour l'auteur
personne	(3 jours sans geste après une réponse)	levée « 3 jours sans suite »	—
un administrateur	lever	levée « par un administrateur »	—
l'auteur	retirer sa version	l'objection prend fin	—

Les coquilles validées — crates/ld-engine/src/correction.rs

La règle de la coquille (0003, edit.rs) ne change pas ; ce qui change, c'est qui la laisse entrer.

• Sur son propre texte (l'auteur de la version ; un administrateur pour un texte du seed), la correction s'applique tout de suite, comme avant.
• Sur celui d'un autre, elle attend : un message à l'auteur de la version (aux administrateurs qui ouvrent le groupe, pour un texte du seed) avec valider / refuser ; sans réponse sous 3 jours, elle s'applique d'elle-même.
• Tant que le texte n'est pas en vigueur, l'auteur garde la main : il peut revenir sur une correction appliquée (révision « correction retirée ») ou appliquer finalement une correction refusée, tant que le texte est celui sur lequel elle a été écrite.
• En vigueur, seule une correction validée change le texte : elle attend la validation (ou l'échéance, qui vaut validation), et un refus est définitif.
• Deux corrections en attente sur un même texte : chacune est jugée contre le texte voté ; à l'application, la correction doit tomber sur le texte qu'elle a lu — sinon (une autre correction, une révision de fond ou un retrait est passé entre-temps) elle est périmée et l'interface demande de recharger.
• Les traductions restent éditoriales : elles ne passent pas par une validation.
• L'historique dit qui a écrit la correction et qui l'a validée (ou qu'elle est passée à l'échéance) ; la correction en attente se lit, avec son diff, dans « Détails ».
• Règle d'accès : trustin_access::answers_typo.

Qui	Quoi	Effet	Échéance
l'auteur de la version (un administrateur pour un texte du seed)	corriger une coquille	appliquée tout de suite, les votes restent	—
tout autre membre	corriger une coquille	en attente ; message à l'auteur (aux administrateurs pour un texte du seed)	3 jours, puis appliquée
l'auteur (ou un administrateur pour le seed)	valider / refuser	appliquée / laissée de côté	—
l'auteur, texte pas encore en vigueur	revenir au texte d'avant, ou appliquer finalement	la main reste à l'auteur	—
texte en vigueur	—	seule une correction validée (ou passée à l'échéance) le change ; un refus est définitif	—

La messagerie — crates/ld-server/src/messages.rs

Une boîte « Messages » dans l'application, au menu, avec le nombre de non-lus (une pastille sur le bouton du menu en mobile) ; pas de courriel. Un message porte un objet (une objection, une coquille), son texte — dit par l'interface, dans la langue de la personne —, les gestes que l'objet lui demande maintenant (répondre, lever ou réitérer, valider ou refuser) et son échéance ; un message traité n'offre plus de geste et dit ce qu'il est devenu. Chacun ne lit que les siens (trustin_access::reads_message) ; agir sur l'objet lit ses messages. Un message ne se montre que tant que la personne ouvre le groupe dont il parle.

Les échéances — crates/ld-server/src/deadlines.rs

Trois jours (ANSWER_DAYS). Le balayage d'adoption (toutes les 5 minutes) passe les échéances, et une fois au démarrage : une échéance passée pendant un arrêt est prise dès la reprise. L'horloge du serveur est injectable (AppState::clock) : les tests l'avancent, sans attendre ; la route /api/dev/clock n'existe qu'avec la connexion de développement.

La migration 0008

Additive. Les signalements gardent leur table (signals) et y gagnent le genre, la version retenue, le tour, l'échéance, la réponse et la cause de la levée ; chaque signalement existant devient un « contredit » sans perte : levé, il le reste (par son auteur, un administrateur ou une révision, selon lifted_by) ; debout, il retient la dernière arrivée selon la règle ci-dessus (s'il visait deux textes aujourd'hui tous deux en vigueur, il ne retient rien et se lève à la main). Aucun message n'est créé pour le passé. S'y ajoutent les tables typos (les corrections des autres) et messages, et sur les révisions la correction d'origine et qui l'a validée.

Coût. Une version retenue attend son auteur aussi longtemps qu'il ne répond pas : c'est la dernière arrivée, c'est à elle de s'expliquer. Pendant ce temps, ceux qui la soutiennent ne peuvent pas la renforcer : un nouveau « pour » attend la levée, alors qu'un « contre » ou un retrait compte tout de suite. Une personne qui réitère sans fin garde une version hors du vote : un administrateur peut lever. Une coquille d'un autre met jusqu'à trois jours à paraître, et sur un texte du seed elle attend un administrateur.