Skip to main content
View as Markdown

Contribuer

Sovrium se construit au grand jour et accueille les contributions. Que vous corrigiez une faute, amélioriez la documentation, signaliez un bug ou proposiez une fonctionnalité, cette page explique comment démarrer.

Façons de contribuer

  • Signaler un bug ou demander une fonctionnalité — ouvrez une issue sur GitHub avec une description claire et, si possible, une reproduction minimale.
  • Améliorer la documentation — ces pages font partie du dépôt ; les corrections et clarifications sont toujours bienvenues.
  • Soumettre une pull request — implémentez un correctif ou une fonctionnalité et ouvrez une PR pour relecture (nécessite une certification — voir ci-dessous).

Devenir contributeur certifié

Ouvrir des issues et signaler des bugs est ouvert à tout le monde. Soumettre du code, en revanche, requiert de devenir un contributeur certifié. Pour obtenir votre certification, contactez-nous à contribute@sovrium.com et nous vous accompagnerons dans la démarche.

Nous avons instauré cette étape de façon délibérée. Le volume de pull requests non sollicitées et générées par IA a rendu la contribution ouverte intenable pour de nombreux projets — les mainteneurs passent plus de temps à trier des correctifs bâclés et écrits par des machines qu'à construire. La certification nous permet de :

  • Préserver notre capacité de relecture pour le vrai travail — nous ne sommes pas submergés par un flot de PR automatisées et opportunistes.
  • Garantir une communauté de contributeurs de qualité — les contributeurs certifiés comprennent le code, l'architecture et les standards avant de livrer.

La certification n'est ni un péage ni un concours de popularité — c'est un court échange pour confirmer que vous êtes une personne qui contribuera avec soin. Une fois certifié, vos pull requests sont relues et fusionnées comme toutes les autres.

Avant de commencer

  • Parcourez les issues et pull requests existantes pour éviter de dupliquer le travail.
  • Pour tout changement non trivial, ouvrez d'abord une issue afin de discuter de l'approche avant d'écrire du code — cela fait gagner du temps à tout le monde.
  • En contribuant, vous acceptez que votre contribution soit placée sous la Business Source License 1.1 du projet.

Mise en place de l'environnement

Sovrium fonctionne sur Bun (1.3+). Clonez le dépôt et installez les dépendances :

git clone https://github.com/sovrium/sovrium
cd sovrium
bun install

Lancez l'application depuis les sources :

bun run start chemin/vers/votre/app.ts

Validez un fichier de configuration par rapport au schéma :

bun run src/cli/index.ts validate chemin/vers/votre/app.ts

Conventions de code

  • TypeScript partout, écrit pour le runtime Bun.
  • Commits conventionnels — préfixez vos messages par feat:, fix:, docs:, refactor:, chore:, etc.
  • Gardez des changements ciblés — un changement logique par pull request accélère la relecture.
  • Respectez le style du code environnant ; le formateur et le linter du dépôt définissent les conventions.

Soumettre une pull request

  1. Forkez le dépôt et créez une branche de travail.
  2. Effectuez votre changement avec un message de commit conventionnel et clair.
  3. Ouvrez une pull request décrivant ce qui change et pourquoi.
  4. Répondez aux retours de relecture — les mainteneurs vous aideront à mener le changement jusqu'à la fusion.

Note sur la marque

Contribuer au code ne confère aucun droit sur le nom ou le logo Sovrium. Voir la page Marque déposée pour l'usage autorisé de la marque.

Voir aussi