Gcheck : Quelle UX pour intégrer licenses et engagements forgerons/tech?

[1000i100]

Voici le début du README qui illustre le projet :

Ğcheck

Faciliter l’intégration des license/engagements et checklist avec une bonne ergonomie dans les apps de l’écosystème Ğ1/Duniter.

Démo en ligne : https://gcheck-1be171.pages.duniter.org/
Code source : https://git.duniter.org/tools/gcheck

@Claude

Rédigé par @Claude (IA) puis relu et corrigé par @1000i100

Structure globale

• Support multilingue : démo en français, anglais et espagnol ; les autres langues, espéranto compris, sont servies par le moteur dès que la traduction existe en amont.
• Architecture modulaire : cœur métier pur, sans DOM ni entrées-sorties, interfaces séparées (démo web, CLI), quatre portages à parité.
• Moteur gcheck-core disponible en Rust sur crates.io : contenus officiels embarqués, mettre à jour la dépendance suffit à être à jour. Avec la feature terminal, une checklist se déroule en un seul appel dans une application en ligne de commande comme g1cli.
• Moteur gcheck-core disponible en TypeScript sur npm : même API, mêmes contenus embarqués.
• Moteur gcheck-core disponible en Python sur PyPI : même API, mêmes contenus embarqués.
• Moteur gcheck_core disponible en Dart sur pub.dev : même API, mêmes contenus embarqués.
• Les quatre moteurs ne peuvent pas diverger : des cas de test métier communs (tests/conformance/cases.json) sont exécutés par les quatre, conformité des hash incluse.
• Contenus officiels synchronisés depuis leur source de vérité, g1_monetary_license, et vérifiés avant chaque build.
• Hash de contenu, identique dans les quatre moteurs : une application sait qu’un contenu a changé depuis ce que son utilisateur a validé.
• Contenus propres à une application acceptés, prioritaires sur ceux embarqués — ou seuls.
• Démo web utilisable hors connexion et facile à packager en app (PWA, Service Worker qui signale ses mises à jour).

Fonctionnalités checklists

• Une question à la fois, en plein écran : réponse par bouton ou par swipe, barre de progression, préambule affiché avant les questions.
• Tirage configurable par checklist : toutes les questions, ou N par catégorie et/ou N au total, dans l’ordre du fichier ou en ordre aléatoire.
• Passation déjà réussie : la démo mémorise dans le navigateur la checklist réussie et propose de la valider directement. Si elle a changé depuis, elle repose les questions à jour.
• Verdict explicite : succès, avertissement (validable en connaissance de cause) ou échec, avec les questions ratées, la réponse attendue et le message associé.
• CLI gcheck (Rust) : list, check, validate. Chaque version publie des binaires statiques pour Linux x86_64 et arm64 (.deb, .AppImage, archive) et pour Windows.

Fonctionnalités license/engagements

• Documents de référence (licence Ğ1, engagements forgeron et comité technique) synchronisés depuis la même source de vérité, proposés en markdown, en page HTML et en fragment HTML à insérer dans une application, avec un hash de contenu et les versions antérieures : une application sait si l’utilisateur a accepté une version périmée et peut lui montrer ce qui a changé.
• Lecture et acceptation dans la démo : contenu intégral avec défilement, case « J’ai lu et compris ce document. Je m’engage à en respecter les modalités. », validation.
• État d’acceptation dans la démo : la page d’accueil distingue d’un coup d’œil “jamais accepté”, “version antérieure”, “version actuelle” ; toute version gardée est consultable (et acceptable individuellement, pour les besoins de la démo).
• Diff des changements : une version périmée s’ouvre sur les différences, deux colonnes sur grand écran, parties inchangées repliées. Ajout, suppression, modification et déplacement sont clairement distincts, même à l’intérieur d’une ligne.

[1000i100]

Projet mis à jour pour faciliter l’intégration dans d’autres languages et gérer aussi bien les checklist que les documents d’engagement/licenses eux-même.

Demo	Question	Echec

License	Actualisée

Sur ordinateur

En ligne de commande

[HugoTrentesaux]

@1000i100 pour info j’ai ajouté un item à la charte au sujet de l’utilisation de l’IA sur le forum : Charte du Forum - #6 by HugoTrentesaux. Je t’invite à mettre le readme dans un bloc citation.

J’aimerais bien creuser ce que tu as fait mais j’ai d’autres priorités en ce moment et relire gcheck pose les mêmes questions que relire la MR Ğ1cli.

[1000i100]

Voila qui est fait