# 📚 Documentation Kohinos

**Dernière mise à jour:** 13 Novembre 2025
**Version:** 2.5.4+

---

## 🚀 Démarrage Rapide

**Nouveau sur Kohinos ?** Commencez ici :

1. **[README.md](README.md)** - Présentation générale du projet
2. **[INSTALL.md](INSTALL.md)** - Guide d'installation
3. **[docs/HOW_TO_DEVELOP.md](docs/HOW_TO_DEVELOP.md)** - 🌟 **Guide de développement complet (français)** - Pour les développeurs humains
4. **[docs/installation/](docs/installation/)** - Guides d'installation détaillés
5. **[CLAUDE.md](CLAUDE.md)** - Instructions pour Claude Code (IA)
6. **[AGENTS.md](docs/AGENTS.md)** - Contexte complet pour les agents IA

---

## 📋 Documentation Principale (Racine)

| Fichier | Description |
|---------|-------------|
| **[README.md](README.md)** | Vue d'ensemble du projet Kohinos |
| **[INSTALL.md](INSTALL.md)** | Guide d'installation de base |
| **[SPECS.md](SPECS.md)** | Spécifications techniques détaillées |
| **[CHANGELOG.md](CHANGELOG.md)** | Journal des modifications par version |
| **[CLAUDE.md](CLAUDE.md)** | Instructions pour l'assistant IA Claude Code (détaillé) |
| **[AGENTS.md](docs/AGENTS.md)** | Contexte complet pour tous les agents IA (technique) |

## 👨‍💻 Documentation pour Développeurs

| Fichier | Description |
|---------|-------------|
| **[docs/HOW_TO_DEVELOP.md](docs/HOW_TO_DEVELOP.md)** | 🌟 **Guide de développement complet (français)** - Workflow, standards, tests, commandes |

---

## 📁 Documentation Organisée par Catégorie

### 🏦 SEPA (Paiements Automatiques)
**Dossier:** [docs/sepa/](docs/sepa/) | **Guide d'accueil:** [README.md](docs/sepa/README.md)

Le système SEPA permet les prélèvements automatiques pour les cotisations SSA et MLC.

| Fichier | Description |
|---------|-------------|
| **[START_HERE_SEPA_MLC.md](docs/sepa/START_HERE_SEPA_MLC.md)** | 🌟 Point d'entrée - Commencez ici |
| **[SEPA_SYSTEM_DOCUMENTATION.md](docs/sepa/SEPA_SYSTEM_DOCUMENTATION.md)** | Documentation complète du système |
| **[SEPA_MLC_README.md](docs/sepa/SEPA_MLC_README.md)** | Guide utilisateur MLC |
| **[SEPA_QUICK_REFERENCE.md](docs/sepa/SEPA_QUICK_REFERENCE.md)** | Référence rapide développeur |
| **[SEPA_EXECUTION_GUIDE.md](docs/sepa/SEPA_EXECUTION_GUIDE.md)** | Guide d'exécution des prélèvements |
| **[SEPA_DOCUMENTATION_INDEX.md](docs/sepa/SEPA_DOCUMENTATION_INDEX.md)** | Index de la documentation SEPA |
| **[SEPA_ANNUAL_DEBIT_DATE_CONFIGURATION.md](docs/sepa/SEPA_ANNUAL_DEBIT_DATE_CONFIGURATION.md)** | Configuration date de prélèvement annuel |
| **[START_HERE_SEPA_MANDATE.md](docs/sepa/START_HERE_SEPA_MANDATE.md)** | Guide des mandats SEPA |
| **[SEPA_MANDATE_PDF_TEST_GUIDE.md](docs/sepa/SEPA_MANDATE_PDF_TEST_GUIDE.md)** | Test génération PDF mandats |
| **[SEPA_MLC_INTEGRATION_PLAN.md](docs/sepa/SEPA_MLC_INTEGRATION_PLAN.md)** | Plan d'intégration MLC |
| **[LISEZ_MOI_SEPA_MANDATS.md](docs/sepa/LISEZ_MOI_SEPA_MANDATS.md)** | Guide mandats (FR) |
| **[IMPLEMENTATION_SEPA_MLC_SYNTHESE.md](docs/sepa/IMPLEMENTATION_SEPA_MLC_SYNTHESE.md)** | Synthèse implémentation |
| **[README_SEPA_REFACTORING.md](docs/sepa/README_SEPA_REFACTORING.md)** | Refactoring SEPA |

**Guide de démarrage SEPA :**
```bash
# Lire d'abord
docs/sepa/START_HERE_SEPA_MLC.md

# Configuration
docs/sepa/SEPA_ANNUAL_DEBIT_DATE_CONFIGURATION.md

# Exécution
docs/sepa/SEPA_EXECUTION_GUIDE.md
```

---

### 💰 SSA (Sécurité Sociale Alimentaire)
**Dossier:** [docs/ssa/](docs/ssa/) | **Guide d'accueil:** [README.md](docs/ssa/README.md)

La SSA (Solidoume) est le système de soutien alimentaire automatisé.

| Fichier | Description |
|---------|-------------|
| **[SSA_REFACTORING_REPORT.md](docs/ssa/SSA_REFACTORING_REPORT.md)** | 🌟 Rapport principal de refactoring du système SSA |
| **[SSA_INSTALLATION_PATCH.md](docs/ssa/SSA_INSTALLATION_PATCH.md)** | Correctifs installation SSA (étapes 3 et 9) |
| **[SSA_CONTROLLER_REFACTORING_SUMMARY.md](docs/ssa/SSA_CONTROLLER_REFACTORING_SUMMARY.md)** | Résumé refactoring contrôleurs |
| **[SSA_COMMAND_COTISATION_FIX.md](docs/ssa/SSA_COMMAND_COTISATION_FIX.md)** | Correctifs commande cotisation |
| **[SSA_REACTIVATION_FIX.md](docs/ssa/SSA_REACTIVATION_FIX.md)** | Correctifs réactivation SSA |
| **[SSA_MULTI_CAISSE_HELLOASSO_FIX.md](docs/ssa/SSA_MULTI_CAISSE_HELLOASSO_FIX.md)** | Multi-caisse HelloAsso |
| **[SSA_COTISATION_HELLOASSO_CORRECTION.md](docs/ssa/SSA_COTISATION_HELLOASSO_CORRECTION.md)** | Corrections HelloAsso |
| **[SSA_FINAL_CORRECTIONS_SUMMARY.md](docs/ssa/SSA_FINAL_CORRECTIONS_SUMMARY.md)** | Résumé corrections finales |
| **[SSA_REDISTRIBUTION_DEBUG_IMPROVEMENTS.md](docs/ssa/SSA_REDISTRIBUTION_DEBUG_IMPROVEMENTS.md)** | Améliorations debug redistribution |
| **[SSA_REDISTRIBUTION_PARTICIPANT_ANALYSIS.md](docs/ssa/SSA_REDISTRIBUTION_PARTICIPANT_ANALYSIS.md)** | Analyse participants |
| **[SSA_TEMPLATE_COTISATION_DISPLAY.md](docs/ssa/SSA_TEMPLATE_COTISATION_DISPLAY.md)** | Templates cotisation |
| **[SSA_TWIG_EXTENSION_FIX.md](docs/ssa/SSA_TWIG_EXTENSION_FIX.md)** | Correctifs Twig extension |

**Commandes SSA :**
```bash
# Exécuter SSA (simulation)
php bin/console kohinos:ssa:execute --test

# Exécuter SSA (réel)
php bin/console kohinos:ssa:execute

# Exécuter SSA avec simulation redistribution
php bin/console kohinos:ssa:execute --execute --test
```

---

### 🧪 Tests & Qualité
**Dossier:** [docs/testing/](docs/testing/) | **Guide d'accueil:** [README.md](docs/testing/README.md)

Documentation des tests et de la qualité du code.

**Guides Principaux:**

| Fichier | Description |
|---------|-------------|
| **[START_HERE_TESTS.md](docs/testing/START_HERE_TESTS.md)** | 🌟 Point d'entrée tests |
| **[TESTING_WORKFLOW.md](docs/testing/TESTING_WORKFLOW.md)** | 🔄 Workflow tests (dev, pre-commit, CI) |
| **[TESTS_INDEX_MASTER.md](docs/testing/TESTS_INDEX_MASTER.md)** | Index principal des tests |
| **[TESTS_QUICK_REFERENCE.md](docs/testing/TESTS_QUICK_REFERENCE.md)** | Référence rapide |
| **[TESTS_NEXT_STEPS.md](docs/testing/TESTS_NEXT_STEPS.md)** | Prochaines étapes |
| **[SECURITY_TESTS_REPORT.md](docs/testing/SECURITY_TESTS_REPORT.md)** | Rapport tests sécurité |
| **[TESTS.md](docs/testing/TESTS.md)** | Guide général des tests |
| **[TESTS_ACTION_PLAN.md](docs/testing/TESTS_ACTION_PLAN.md)** | Plan d'action tests |
| **[SEPA_PROCESSING_COMMAND_TESTS.md](docs/testing/SEPA_PROCESSING_COMMAND_TESTS.md)** | Tests commande SEPA (54 tests) |

**Sessions Tests Nov 2025 (Campagne d'Amélioration):**

| Fichier | Description |
|---------|-------------|
| **[SYNTHESE_FINALE_NOV_01_COMPLETE.md](docs/testing/SYNTHESE_FINALE_NOV_01_COMPLETE.md)** | 📊 Synthèse Sessions 1-3 (Nov 1) |
| **[SESSION_4_NOV_02_ISOLATION_INVESTIGATION.md](docs/testing/SESSION_4_NOV_02_ISOLATION_INVESTIGATION.md)** | 🔍 Session 4: Investigation isolation |
| **[SESSION_5_NOV_02_QUICK_FIXES.md](docs/testing/SESSION_5_NOV_02_QUICK_FIXES.md)** | ⚡ Session 5: Corrections rapides |
| **[SESSION_6_NOV_02_QUICK_WINS.md](docs/testing/SESSION_6_NOV_02_QUICK_WINS.md)** | 🎯 Session 6: Gains rapides |
| **[SESSION_7_NOV_02_FINAL_VALIDATION.md](docs/testing/SESSION_7_NOV_02_FINAL_VALIDATION.md)** | ✅ Session 7: Validation finale |
| **[SESSIONS_4-7_FINAL_SUMMARY.md](docs/testing/SESSIONS_4-7_FINAL_SUMMARY.md)** | 📋 Résumé Sessions 4-7 |
| **[SESSION_8_NOV_02_FINAL_PUSH.md](docs/testing/SESSION_8_NOV_02_FINAL_PUSH.md)** | 🔥 Session 8: Push final (7 errors) |
| **[SESSION_9_NOV_02_DATABASE_CLEANUP.md](docs/testing/SESSION_9_NOV_02_DATABASE_CLEANUP.md)** | ⭐ Session 9: DB Cleanup (95.6%!) |
| **[DATABASE_CLEANUP_GUIDE.md](docs/testing/DATABASE_CLEANUP_GUIDE.md)** | 🛠️ Guide nettoyage DB test |

**Lancer les tests (Workflow recommandé):**
```bash
# 1. Nettoyer la base de données de test (IMPORTANT!)
php bin/console doctrine:database:drop --force --env=test && \
php bin/console doctrine:database:create --env=test && \
php bin/console doctrine:migrations:migrate --no-interaction --env=test && \
php bin/console hautelook:fixtures:load --purge-with-truncate --no-interaction --env=test

# 2. Exécuter les tests avec process isolation
vendor/bin/phpunit --process-isolation --no-coverage

# Développement local (rapide - sans isolation)
vendor/bin/phpunit tests/MonTest.php

# Tests spécifiques avec isolation
vendor/bin/phpunit --process-isolation tests/Role/AdherentFunctionalTest.php

# Avec couverture
vendor/bin/phpunit --coverage-html coverage/
```

**Métriques actuelles (Session 9 - Nov 2, 2025 avec --process-isolation):**
- Tests: 677
- ✅ Passing: **648 (95.6%)** ⬆️ +154 tests depuis Oct
- ❌ Failures: 15 (2.2%)
- ⚠️ Errors: **3 (0.4%)** ⬇️ -4 errors Session 9
- ⏭️ Skipped: 48 (7.1%) - 6 Known Issues UserGroup cascade
- ⏳ Incomplete: 51 (7.5%)
- 📊 Assertions: 2009
- **Progrès total:** +23.8% passing (71.8% → 95.6%)

**Erreurs restantes:**
1. AdherentFunctionalTest::testAdherentRouteAccess (HTTP 500)
2-3. SuperAdminDashboardFunctionalTest (2 errors - process isolation FOS UserBundle)

**Note:** Toujours utiliser `--process-isolation` pour des résultats fiables. Le nettoyage de la base de données de test est maintenant obligatoire avant chaque run important (voir [DATABASE_CLEANUP_GUIDE.md](docs/testing/DATABASE_CLEANUP_GUIDE.md)).

---

### 💳 HelloAsso (Intégration Paiements)
**Dossier:** [docs/helloasso/](docs/helloasso/) | **Guide d'accueil:** [README.md](docs/helloasso/README.md)

Système d'intégration des paiements HelloAsso.

| Fichier | Description |
|---------|-------------|
| **[PENDING_PAYMENT_SYSTEM_DOCUMENTATION.md](docs/helloasso/PENDING_PAYMENT_SYSTEM_DOCUMENTATION.md)** | 🌟 Système de paiements en attente |
| **[HELLOASSO_SERVICE_REFACTORING.md](docs/helloasso/HELLOASSO_SERVICE_REFACTORING.md)** | Refactoring service HelloAsso |
| **[REFACTORING_HELLOASSO_COMPLETE.md](docs/helloasso/REFACTORING_HELLOASSO_COMPLETE.md)** | Refactoring complet |
| **[HELLOASSO_PAYMENT_SERVICE_SOLIDOUME_ITEM_UPDATE.md](docs/helloasso/HELLOASSO_PAYMENT_SERVICE_SOLIDOUME_ITEM_UPDATE.md)** | Mise à jour SolidoumeItem |

---

### 📧 Emails & Notifications
**Dossier:** [docs/email/](docs/email/) | **Guide d'accueil:** [README.md](docs/email/README.md)

Système de notifications par email.

| Fichier | Description |
|---------|-------------|
| **[EMAIL_SYSTEM_REDESIGN.md](docs/email/EMAIL_SYSTEM_REDESIGN.md)** | 🌟 Refonte du système email |
| **[EMAIL_DIAGNOSTIC_GUIDE.md](docs/email/EMAIL_DIAGNOSTIC_GUIDE.md)** | Guide de diagnostic |
| **[SOLUTION_EMAIL_RAPIDE.md](docs/email/SOLUTION_EMAIL_RAPIDE.md)** | Solutions rapides |
| **[TASK_EMAIL_NOTIFICATIONS.md](docs/email/TASK_EMAIL_NOTIFICATIONS.md)** | Tâches notifications |

---

### 🔨 CI/CD & Déploiement
**Dossier:** [docs/ci-cd/](docs/ci-cd/) | **Guide d'accueil:** [README.md](docs/ci-cd/README.md)

Documentation du déploiement et de l'intégration continue.

| Fichier | Description |
|---------|-------------|
| **[DEPLOIEMENT_PRODUCTION_GUIDE.md](docs/ci-cd/DEPLOIEMENT_PRODUCTION_GUIDE.md)** | 🌟 Guide complet de déploiement |
| **[DEPLOIEMENT_QUICK_GUIDE.md](docs/ci-cd/DEPLOIEMENT_QUICK_GUIDE.md)** | Guide rapide |
| **[GITLAB_CI_DOCUMENTATION.md](docs/ci-cd/GITLAB_CI_DOCUMENTATION.md)** | Documentation GitLab CI |
| **[GITLAB_CI_QUICK_REFERENCE.md](docs/ci-cd/GITLAB_CI_QUICK_REFERENCE.md)** | Référence rapide CI |
| **[GITLAB_CI_FINAL_SUMMARY.md](docs/ci-cd/GITLAB_CI_FINAL_SUMMARY.md)** | Résumé final GitLab CI |

---

### ⚙️ Installation & Configuration
**Dossier:** [docs/installation/](docs/installation/) | **Guide d'accueil:** [README.md](docs/installation/README.md)

Guides d'installation et de configuration détaillés.

| Fichier | Description |
|---------|-------------|
| **[FIRST_INSTALL_README.md](docs/installation/FIRST_INSTALL_README.md)** | 🌟 Première installation rapide |
| **[DATABASE_DOWNLOAD_GUIDE.md](docs/installation/DATABASE_DOWNLOAD_GUIDE.md)** | Téléchargement de la base de données |
| **[CONFIG_SETUP_GUIDE.md](docs/installation/CONFIG_SETUP_GUIDE.md)** | Configuration détaillée |
| **[FIRST_INSTALL_AUTO_DB.md](docs/installation/FIRST_INSTALL_AUTO_DB.md)** | Installation automatique BDD |
| **[QUICK_START_DATABASE_DOWNLOAD.md](docs/installation/QUICK_START_DATABASE_DOWNLOAD.md)** | Quick start BDD |
| **[SCRIPT_DATABASE_SUMMARY.md](docs/installation/SCRIPT_DATABASE_SUMMARY.md)** | Scripts BDD |
| **[SCRIPT_CORRECTIONS_APPLIED.md](docs/installation/SCRIPT_CORRECTIONS_APPLIED.md)** | Corrections appliquées |

---

### ⚙️ Configuration & Paramètres Globaux
**Dossier:** [docs/](docs/) | **Interface Admin:** `/admin/app/globalparameter/list`

Documentation de l'interface d'administration et des paramètres globaux Kohinos.

| Fichier | Description |
|---------|-------------|
| **[ADMIN_GLOBAL_PARAMETERS_INTERFACE.md](docs/ADMIN_GLOBAL_PARAMETERS_INTERFACE.md)** | 🌟 Guide complet de l'interface admin |
| **[GLOBAL_PARAMETERS_CODE_IMPLICATIONS.md](docs/GLOBAL_PARAMETERS_CODE_IMPLICATIONS.md)** | 📖 Implications techniques de chaque paramètre |
| **[GLOBAL_PARAMETERS_IMPLICATIONS.md](docs/GLOBAL_PARAMETERS_IMPLICATIONS.md)** | Vue fonctionnelle des paramètres |
| **[GLOBAL_PARAMETERS_PAYMENT_MODULES.md](docs/GLOBAL_PARAMETERS_PAYMENT_MODULES.md)** | Modules de paiement détaillés |

**Guides de refactoring (référence développeur) :**
- [GLOBAL_PARAMETER_ADMIN_REFACTORING.md](docs/GLOBAL_PARAMETER_ADMIN_REFACTORING.md) - Documentation technique refonte v2.0
- [REFACTORING_COMPLETE_V3.md](docs/REFACTORING_COMPLETE_V3.md) - Refactoring v3.0 complet
- [CORRECTIONS_FINALES_GLOBALPARAM.md](docs/CORRECTIONS_FINALES_GLOBALPARAM.md) - Corrections finales
- [CORRECTION_SWITCHES_CLIQUABLES.md](docs/CORRECTION_SWITCHES_CLIQUABLES.md) - Correction technique switches

**Points clés :**
- Interface moderne avec switches Bootstrap
- Organisation par modules thématiques (MLC, SSA, Cotisations, SEPA, etc.)
- Sauvegarde différée (formulaire global)
- Sous-rubriques pour modules complexes
- Documentation détaillée des implications de chaque paramètre dans le code

---

### 🪟 Windows & WSL
**Dossier:** [docs/windows-wsl/](docs/windows-wsl/) | **Guide d'accueil:** [README.md](docs/windows-wsl/README.md)

Configuration pour environnement Windows avec WSL.

| Fichier | Description |
|---------|-------------|
| **[LISEZ_MOI_MAINTENANT.md](docs/windows-wsl/LISEZ_MOI_MAINTENANT.md)** | 🌟 Démarrage rapide Windows |
| **[QUICK_START_GUIDE.md](docs/windows-wsl/QUICK_START_GUIDE.md)** | Guide de démarrage rapide WSL + Windows |
| **[SOLUTION_ACCES_WINDOWS.md](docs/windows-wsl/SOLUTION_ACCES_WINDOWS.md)** | Configuration complète |
| **[SOLUTION_FICHIER_HOSTS_VERROUILLE.md](docs/windows-wsl/SOLUTION_FICHIER_HOSTS_VERROUILLE.md)** | Fichier hosts verrouillé |
| **[HOSTS_FILE_FIX.md](docs/windows-wsl/HOSTS_FILE_FIX.md)** | Correction du problème de fichier hosts |
| **[MANUAL_INTERVENTION_REQUIRED.md](docs/windows-wsl/MANUAL_INTERVENTION_REQUIRED.md)** | Interventions manuelles |

---

### 🔄 Refactoring & Migrations
**Dossier:** [docs/refactoring/](docs/refactoring/) | **Guide d'accueil:** [README.md](docs/refactoring/README.md)

Rapports de refactoring et migrations techniques.

| Fichier | Description |
|---------|-------------|
| **[MENU_BUNDLE_MIGRATION_SUMMARY.md](docs/refactoring/MENU_BUNDLE_MIGRATION_SUMMARY.md)** | 🌟 Migration MenuBundle (résolution erreur interfaces) |
| **[CIVIL_YEAR_MIGRATION_REPORT.md](docs/refactoring/CIVIL_YEAR_MIGRATION_REPORT.md)** | Migration année civile |
| **[PASSWORD_VISIBILITY_TOGGLE.md](docs/refactoring/PASSWORD_VISIBILITY_TOGGLE.md)** | Toggle visibilité mot de passe |
| **[SQL_BUG_FIX_NON_RECURRENT.md](docs/refactoring/SQL_BUG_FIX_NON_RECURRENT.md)** | Correctifs SQL |
| **[USER_ADHERENT_CONTROLLER_SSA_SUPPORT.md](docs/refactoring/USER_ADHERENT_CONTROLLER_SSA_SUPPORT.md)** | Support SSA UserAdherentController |
| **[FIX_ASSETS_SUMMARY.md](docs/refactoring/FIX_ASSETS_SUMMARY.md)** | Correctifs assets frontend |
| **[FRONTEND_DEPENDENCIES.md](docs/refactoring/FRONTEND_DEPENDENCIES.md)** | Dépendances frontend |

---

## 🗂️ Archives

**Dossier:** [docs/archive/](docs/archive/)

Documentation historique archivée (rapports de sessions, anciennes implémentations, etc.)

| Sous-dossier | Contenu |
|--------------|---------|
| **sessions/** | Rapports de sessions de développement (49+ fichiers dont SESSION_SUMMARY_OCT_22.md) |
| **sepa/** | Rapports d'implémentation SEPA historiques (SEPA_REFACTORING_VISUAL_SUMMARY.md, SEPA_EXECUTION_LEGACY.md) |
| **testing/** | Anciens rapports de tests |
| **installation/** | Anciennes versions des guides d'installation |
| **windows-wsl/** | Anciennes solutions Windows/WSL |
| **tasks/** | Anciennes listes de tâches (TACHES_RESTANTES_KOHINOS.md) |
| **misc/** | Divers documents historiques (DOCUMENTATION_REORGANIZATION_SUMMARY.md) |

---

## 🎯 Guides par Tâche

### "Je veux installer Kohinos"
1. [INSTALL.md](INSTALL.md) - Installation de base
2. [docs/installation/FIRST_INSTALL_README.md](docs/installation/FIRST_INSTALL_README.md) - Installation détaillée
3. [docs/installation/DATABASE_DOWNLOAD_GUIDE.md](docs/installation/DATABASE_DOWNLOAD_GUIDE.md) - Base de données

### "Je veux déployer en production"
1. [docs/ci-cd/DEPLOIEMENT_PRODUCTION_GUIDE.md](docs/ci-cd/DEPLOIEMENT_PRODUCTION_GUIDE.md)
2. [docs/ci-cd/GITLAB_CI_DOCUMENTATION.md](docs/ci-cd/GITLAB_CI_DOCUMENTATION.md)

### "Je veux configurer SEPA"
1. [docs/sepa/START_HERE_SEPA_MLC.md](docs/sepa/START_HERE_SEPA_MLC.md)
2. [docs/sepa/SEPA_SYSTEM_DOCUMENTATION.md](docs/sepa/SEPA_SYSTEM_DOCUMENTATION.md)
3. [docs/sepa/SEPA_EXECUTION_GUIDE.md](docs/sepa/SEPA_EXECUTION_GUIDE.md)

### "Je veux comprendre SSA"
1. [docs/ssa/SSA_REFACTORING_REPORT.md](docs/ssa/SSA_REFACTORING_REPORT.md)
2. Voir les commandes SSA ci-dessus

### "Je veux lancer les tests"
1. [docs/testing/START_HERE_TESTS.md](docs/testing/START_HERE_TESTS.md)
2. [docs/testing/TESTS_QUICK_REFERENCE.md](docs/testing/TESTS_QUICK_REFERENCE.md)

### "Je développe sur Windows/WSL"
1. [docs/windows-wsl/LISEZ_MOI_MAINTENANT.md](docs/windows-wsl/LISEZ_MOI_MAINTENANT.md)
2. [docs/windows-wsl/SOLUTION_ACCES_WINDOWS.md](docs/windows-wsl/SOLUTION_ACCES_WINDOWS.md)

### "Je veux configurer les paramètres globaux"
1. [docs/ADMIN_GLOBAL_PARAMETERS_INTERFACE.md](docs/ADMIN_GLOBAL_PARAMETERS_INTERFACE.md) - Guide de l'interface admin
2. [docs/GLOBAL_PARAMETERS_CODE_IMPLICATIONS.md](docs/GLOBAL_PARAMETERS_CODE_IMPLICATIONS.md) - Implications techniques
3. Accéder à `/admin/app/globalparameter/list` dans l'admin

---

## 🔍 Recherche Rapide

**Vous cherchez de la documentation sur :**

- **SEPA** → [docs/sepa/](docs/sepa/)
- **SSA / Solidoume** → [docs/ssa/](docs/ssa/)
- **Tests** → [docs/testing/](docs/testing/)
- **HelloAsso** → [docs/helloasso/](docs/helloasso/)
- **Emails** → [docs/email/](docs/email/)
- **Déploiement** → [docs/ci-cd/](docs/ci-cd/)
- **Installation** → [docs/installation/](docs/installation/)
- **Paramètres Globaux** → [docs/ADMIN_GLOBAL_PARAMETERS_INTERFACE.md](docs/ADMIN_GLOBAL_PARAMETERS_INTERFACE.md)
- **Windows/WSL** → [docs/windows-wsl/](docs/windows-wsl/)
- **Refactoring** → [docs/refactoring/](docs/refactoring/)
- **Archives** → [docs/archive/](docs/archive/)

---

## 🤝 Contribution

Pour contribuer à la documentation :

1. Les nouveaux documents vont dans `docs/[catégorie]/`
2. Les documents historiques vont dans `docs/archive/[catégorie]/`
3. Mettez à jour ce fichier `DOCUMENTATION.md` après ajout
4. Utilisez le format Markdown avec des titres clairs
5. Ajoutez des exemples de code quand pertinent

---

## 📞 Support

- **Documentation technique:** Voir [SPECS.md](SPECS.md)
- **Pour Claude Code (IA):** Voir [CLAUDE.md](CLAUDE.md)
- **GitLab Issues:** https://gitlab.com/federation-kohinos/kohinos/-/issues
- **Contact:** federation@kohinos.fr

---

**🎉 Documentation réorganisée le 24 Octobre 2025**
**📋 Documentation Paramètres Globaux ajoutée le 25 Octobre 2025**
**📁 Scripts et fichiers texte réorganisés le 26 Octobre 2025**
*Navigation facilitée • Structure claire • Maintenance simplifiée*