← Accueil

Open source et co-construction

D'ici la fin de l'année, nous allons ouvrir les domaines métier de la plateforme, en open source, et dans une démarche de co-construction avec une communauté de développeurs et d'experts de l'épargne salariale.

Pourquoi ouvrir les domaines métier

Les règles de l'épargne salariale sont publiques : Code du travail, Code monétaire et financier, bulletin officiel des finances publiques, règlement général de l'AMF, etc. Chaque acteur les a pourtant mises en œuvre de son côté, et chaque loi de finances rouvre le chantier chez chacun.

Le périmètre ouvert

Le périmètre ouvert sera celui des domaines métier : leur modèle de données, leurs processus, leur implémentation, ainsi que les jeux de tests et la documentation.

La plateforme en compte dix.

Les outils de travail

GitLab comme outil central et lieu de vérité. Il s'agit d'une proposition, à discuter avec les premiers contributeurs.

Les outils

  • GitLab. Code, tickets, merge requests, intégration continue.
  • Site de documentation. Généré depuis les dépôts à chaque version.Consulter ↗
  • Visioconférence et tableau blanc. Pour les échanges et les séances de conception avec les experts.

Les artefacts, dans les dépôts

  • Spécifications en Markdown
  • Processus en BPMN
  • Modèles de données. Diagrammes en texte (Mermaid).
  • Contrats OpenAPI et AsyncAPI. Les API et les événements de chaque domaine.
  • Tests d'acceptation en Gherkin. Des tableaux d'exemples lisibles par un expert, exécutés par l'intégration continue.
  • Journal des décisions (ADR). Une page par décision, proposée par merge request.

Le processus de contribution

  1. Proposer

    Ouvrir une issue pour proposer une évolution, préciser une fonctionnalité, décrire un bug, etc.

  2. Prioriser

    Les mainteneurs du domaine qualifient l'issue et la placent dans le backlog, selon l'urgence réglementaire et l'intérêt commun.

  3. Spécifier

    Écrire une proposition dans un document en markdown. Les experts la relisent avant le développement.

  4. Développer

    Implémenter la spécification. La CI rejoue tous les tests du domaine.

  5. Tester

    Les experts valident les résultats sur les cas d'acceptation en Gherkin. Un cas manquant devient un nouveau test.

  6. Publier

    Release versionnée, avec son changelog et la date d'entrée en vigueur des règles.

La gouvernance

La gouvernance de chaque domaine est basée sur trois rôles.

Contributeur

Ouvre des issues, propose des spécifications ou des merge requests.

Reviewer

Relit les propositions dans sa spécialité, technique ou métier.

Mainteneur de domaine

Un binôme développeur et expert métier. Il gère le backlog, arbitre les contributions et anime la revue mensuelle.

Les décisions sont prises dans chaque domaine, par consensus, et consignées dans les ADR. En cas de désaccord, un comité réunissant les mainteneurs de tous les domaines tranche. Ce comité fixe aussi les règles communes et publie la roadmap.

Plateforme Epargne Salariale anime la communauté.

La licence

La licence que nous proposons d'utiliser cherche un équilibre : encourager les contributions, en demandant à ceux qui utilisent un domaine de partager leurs améliorations, sans recourir à une licence qui contamine les systèmes de ceux qui l'utilisent. L'obligation de partage porte donc uniquement sur les domaines.

Il s'agit d'une proposition, à discuter avec les premiers contributeurs avant la publication du premier domaine.

Rejoindre les premiers contributeurs

Vous développez ? Vous pratiquez l'épargne salariale dans un cabinet, chez un teneur de compte, dans une direction des ressources humaines ? Nous constituons le premier cercle de contributeurs, domaine par domaine.

Écrivez-nous : contact [arobase] plateforme-epargne-salariale.fr