onboarding.md

ONBOARDING — Project Atlas

Bienvenue sur Project Atlas Ce document explique comment on travaille ici.
Il est aussi important que le README technique.

Objectif du projet

Atlas est une API de facturation B2B. Objectif principal : zéro régression fonctionnelle lors des évolutions.

Tout changement doit préserver :

• la justesse des calculs
• la traçabilité
• la stabilité en production

Principes clés (à respecter absolument)

1. La fiabilité > la vitesse

   • Une PR lente mais sûre est toujours préférable.
   • En cas de doute : on s'arrête et on clarifie.

2. Pas de magie

   • Le code doit être lisible par un humain fatigué à 18h.
   • Pas d'optimisation obscure sans justification écrite.

3. Chaque changement est réversible

   • Feature flags > hard switches
   • Migrations backward-compatible par défaut

Quand t'arrêter

Arrête-toi immédiatement si :

• tu n'es pas sûr de l'impact métier
• tu modifies un comportement existant sans test
• tu ne comprends pas une partie du code que tu touches

Dans ces cas-là : (1) documente la question, (2) demande de l'aide, (3) n'improvise pas

Ce qui est valorisé ici

• Simplifier plutôt qu'ajouter
• Supprimer du code est une victoire
• Dire "je ne sais pas" est un signal positif

Ce qui est mal vu

• Forcer une solution pour "avancer"
• Copier-coller sans comprendre
• Introduire une dépendance sans justification claire

Rappel important

Ton rôle n'est pas d'écrire du code. Ton rôle est de maintenir un système fiable dans le temps.

Si tu respectes ça, tu fais du bon travail ici.