Contribuer à Aurora Nexus

Principes

• Sécurité d’abord : ne commitez jamais de secrets (.env, tokens, clés API, PEM/SSH, exports contenant des credentials).
• Stabilité : préférer des changements ciblés et testés ; éviter les refactors “massifs” sans discussion.
• Multi-langue : tout texte UI ajouté/modifié doit être décliné en FR/EN/DE/ES/PT.
• Traçabilité : toute évolution “sensible” (cache, providers, prompts, Connect) doit rester auditée côté DB (config_audit_log) et tracée dans queries_log.

Mise en place (dev)

bash ops/dev_up.sh

Tests locaux (équivalent CI : suite “rapide”) :

bash ops/dev_test.sh

Par défaut, ops/dev_test.sh exécute une suite “rapide” (mêmes vérifications que la CI). Pour exécuter toute la suite Pytest (incluant des tests d’intégration), utilisez :

FULL_TESTS=1 bash ops/dev_test.sh

Style & qualité

• Python : indentation 4 espaces, snake_case, Pydantic typé.
• Next.js : composants PascalCase, appels API avec gestion d’erreurs explicite.
• Migrations SQL : additives autant que possible (ADD COLUMN IF NOT EXISTS, CREATE TABLE IF NOT EXISTS), nommées NN_DESCRIPTION.sql.

Ajouter une variable d’environnement

1. Ajouter la variable dans .env.example.
2. Si le wizard doit la générer : l’ajouter dans ops/install_wizard/models.py + ops/install_wizard/envfile.py.
3. Documenter dans docs/03_Configuration/10-ENV-Reference.md si nécessaire.

Pull Requests

• Décrire le changement et son impact (fonctionnel + sécurité).
• Inclure les étapes de test.
• Si UI : captures d’écran + vérification des 5 langues.