Contribuer

Dernière révision : 23 septembre 2026 · Nouveautés de la plateforme

Comment le code de la plateforme est organisé, construit et vérifié.

Organisation du dépôt

La plateforme est un projet Maven multi-modules. Le socle applicatif, le studio, le moteur, le CMS, la messagerie et le frontend y sont des modules distincts, assemblés par une distribution unique.

Langues

Le code et ses commentaires sont en anglais. Le texte affiché passe par les fichiers de traduction, dont la couverture est vérifiée à chaque construction. La documentation d'exploitation est écrite en français et en anglais.

Vocabulaire

Les libellés visibles nomment les briques par leur rôle — moteur de workflow, messagerie, coordinateur, registre — et non par la technologie qui les implémente. Le nom technique reste dans le code.

Construction et vérification

ÉtapeCe qu'elle produitBloquante
Compilationles artefacts des modulesoui
Tests et couvertureles rapports de test et la tendance de couvertureinstable si un test échoue
Complexitéun rapport par modulenon
Nomenclature logiciellel'inventaire des dépendancesnon
Vulnérabilitésle rapport des dépendances vulnérablesinstable si les critiques augmentent
Distributionl'archive déployableoui

Le choix de laisser peu d'étapes bloquantes est délibéré : la base de code porte une dette dont un seuil dur arrêterait la chaîne dès le premier passage. Le seuil de couverture porte donc sur les lignes modifiées, ce qui empêche la dette de croître sans exiger de la rembourser d'un coup.

Tests

Un correctif s'accompagne du test qui échouait avant lui. La vérification porte sur le résultat observable — l'écran affiché, la ligne écrite, le message reçu — plutôt que sur le code de retour d'un appel.

Documentation de la plateforme Clomoon, éditée par Clover Consulting. Les pages de ce site sont des contenus du CMS : elles se modifient dans le studio ou la console, et une page ajoutée apparaît sans redéploiement.

Contributing

Last revised 23 September 2026 · Platform changelog

How the platform's code is organised, built and checked.

Repository layout

The platform is a multi-module Maven project. The application core, the studio, the engine, the CMS, the messaging service and the frontend are separate modules, assembled into a single distribution.

Languages

Code and its comments are in English. Displayed text goes through the translation files, whose coverage is checked on every build. The operations documentation is written in French and in English.

Vocabulary

Visible labels name the building blocks by their role — workflow engine, messaging, coordinator, ledger — rather than by the technology behind them. The technical name stays in the code.

Build and checks

StepWhat it producesBlocking
Compilationthe module artefactsyes
Tests and coveragetest reports and the coverage trendunstable if a test fails
Complexityone report per moduleno
Software bill of materialsthe dependency inventoryno
Vulnerabilitiesthe report of vulnerable dependenciesunstable if criticals increase
Distributionthe deployable archiveyes

Leaving few blocking steps is deliberate: the code base carries debt that a hard threshold would stop the pipeline on from the very first run. The coverage threshold therefore applies to changed lines, which prevents the debt from growing without demanding that it be repaid at once.

Tests

A fix comes with the test that failed before it. Verification looks at the observable result — the rendered screen, the written row, the received message — rather than at the status code of a call.

Documentation for the Clomoon platform, published by Clover Consulting. The pages of this site are CMS content: they are edited in the studio or the console, and a page that is added shows up without a redeployment.