Aller au contenu

🤝 CONTRIBUTING.md — Contribuer à Arkalia-LUNA Pro

Bienvenue dans le dépôt arkalia-luna-pro. Ce guide décrit les bonnes pratiques à respecter pour contribuer efficacement et de manière professionnelle.

📊 ÉTAT ACTUEL DU SYSTÈME (Mise à jour 27/01/2025)

✅ SUCCÈS MAJEUR - CI/CD 100% Verte !

  • 671 tests passés (642 unitaires + 29 intégration) ✅
  • Couverture : 59.25% (bien au-dessus du seuil de 28%) ✅
  • Temps d'exécution : 31.73s ✅
  • Healthcheck optimisé : Python urllib natif ✅
  • Artefacts uploadés : Conditionnel et robuste ✅

📁 Structure du projet

  • Chaque module IA = un dossier dans modules/<nom_du_module>/
  • Aucun code métier dans arkalia_master_loop.py → uniquement orchestration
  • Fichiers séparés pour :
  • core.py → logique métier principale du module
  • config/, logs/, state/ → données internes du module
  • tests/ → tests unitaires avec pytest

⚙️ Setup local (devstation)

# 1. Cloner le dépôt
git clone https://github.com/athalia-siwek/arkalia-luna-pro.git
cd arkalia-luna-pro

# 2. Activer l’environnement Python
source /Volumes/T7/arkalia-luna-venv/bin/activate

# 3. Initialiser les hooks de pré-commit
pre-commit install

# 4. Vérifier la qualité du code
black .
ruff check .
pytest

✅ Conventions à respecter

  • Formatage avec black
  • Lint avec ruff
  • Respect strict de la structure modulaire
  • Aucun fichier .DS_Store, __pycache__/, ou fichier temporaire dans le dépôt
  • Commits clairs avec emoji + résumé court (ex: 🧠 ajout ZeroIA loop adaptative)

📦 Versionnage

Le système utilise bumpver pour incrémenter proprement les versions.

bumpver update

🧪 Tests

Les tests doivent être isolés dans tests/ par module.

# Tests unitaires avec couverture
pytest tests/unit/ --cov=modules --cov-report=html

# Tests d'intégration
pytest tests/integration/ -c pytest-integration.ini

# Tests de chaos
pytest tests/chaos/ -v

# Tests de performance
pytest tests/performance/ -v

# Tests de sécurité
pytest tests/security/ -v

🎯 Métriques de Performance Actuelles

Métrique Valeur Statut
Tests passés 671/671 ✅ 100%
Couverture 59.25% ✅ >28%
Temps CI 31.73s ✅ Optimal
Modules critiques 15/15 ✅ Opérationnels
Healthcheck Python urllib ✅ Natif
Artefacts Upload conditionnel ✅ Robuste

📅 Mise à jour

Fichier généré le : 2025-01-27 Merci de contribuer à un projet IA propre et durable ✨

© Athalia — Arkalia System

Dernière mise à jour : 27 Janvier 2025 - 18:50