KoproGo Documentation

Documentation complète du projet KoproGo ASBL.

📚 Structure Documentation

🎯 Documents Principaux (À Jour 2025)

Business & Stratégie

  • BUSINESS_PLAN_BOOTSTRAP.md ⭐

    • LE business plan officiel ASBL 2025-2028

    • Modèle hybride OpenCore (Cloud 1€/copro + Self-hosted gratuit)

    • Projections, team, roadmap, unit economics

    • Utiliser celui-ci (le plus récent et complet)

  • BUSINESS_PLAN.md 📦

    • Version précédente (modèle startup avec levée de fonds)

    • ARCHIVÉ : Ne plus utiliser, remplacé par BUSINESS_PLAN_BOOTSTRAP.md

    • Gardé pour historique seulement

Infrastructure & Déploiement

  • VPS_DEPLOYMENT.md ⭐

    • Guide complet déploiement VPS OVH France

    • Pour ASBL cloud multi-tenant OU self-hosting manuel

    • Architecture, setup, maintenance, troubleshooting

  • DEPLOY_GITOPS.md ⭐ NOUVEAU

    • Déploiement self-hosted avec auto-update GitHub

    • Installation 1-click, GitOps, rollback, backups

    • Recommandé pour utilisateurs self-hosted

  • INFRASTRUCTURE_ROADMAP.md ⭐

    • Évolution infrastructure selon croissance

    • Phase 1 (VPS) → Phase 4 (Kubernetes HA)

    • Capacités validées par tests de charge

Performance & Technique

  • PERFORMANCE_REPORT.md ⭐

    • Tests de charge officiels (Grafana k6)

    • 99.74% uptime, 287 req/s sur 1 vCPU

    • Calculs CO₂ (0.12g/req OVH France)

    • Capacité: 1,000-1,500 copros par vCPU

📦 Documents Archivés (docs/archive/)

✅ Nettoyage effectué le 25/10/2025

Tous les documents obsolètes ont été déplacés vers docs/archive/ :

archive/ (anciens business plans):

  • BUSINESS_PLAN.md (modèle startup avec levée de fonds)

  • ROADMAP.md (roadmap obsolète)

  • MARKET_ANALYSIS.md

  • ANALYSIS.md

  • NEW_ISSUES.md

  • ISSUE_004_COMPLETION_GUIDE.md

  • PRIORITIES_TABLE.md

archive/root-md/ (fichiers root obsolètes):

  • DEPLOYMENT_VPS.md (doublon de VPS_DEPLOYMENT.md)

  • infrastructure.md (stub)

archive/load-tests-troubleshooting/ (problèmes résolus):

  • PANIC_FIXES.md (fixes Oct 24-25)

  • TROUBLESHOOTING_401.md (fixes JWT)

  • IMPLEMENTATION_SUMMARY.md (rate limiting)

  • CHANGELOG_RATE_LIMITING.md

  • SESSION_SUMMARY.md (backend session)

📖 Guide de Lecture Recommandé

Pour Nouveaux Contributeurs

  1. README.md (racine) : Vue d’ensemble projet

  2. BUSINESS_PLAN_BOOTSTRAP.md : Comprendre le modèle ASBL

  3. DEPLOY_GITOPS.md : Installer sa propre instance

  4. CLAUDE.md (racine) : Architecture technique hexagonale

Pour ASBL / Admins

  1. BUSINESS_PLAN_BOOTSTRAP.md : Stratégie et finances

  2. VPS_DEPLOYMENT.md : Maintenir infra cloud

  3. INFRASTRUCTURE_ROADMAP.md : Planifier scaling

  4. PERFORMANCE_REPORT.md : Benchmarks et capacités

Pour Utilisateurs Self-Hosted

  1. DEPLOY_GITOPS.md : Installation automatique

  2. VPS_DEPLOYMENT.md : Setup manuel détaillé

  3. PERFORMANCE_REPORT.md : Dimensionner son VPS

🔄 Maintenance Documentation

Fréquence updates :

  • BUSINESS_PLAN_BOOTSTRAP.md : Annuel (ou si changement majeur)

  • PERFORMANCE_REPORT.md : Après chaque test de charge

  • VPS_DEPLOYMENT.md : Quand nouvelle version infrastructure

  • DEPLOY_GITOPS.md : Quand workflow GitOps change

  • changelog.md : À chaque release

Responsable : ASBL KoproGo (Conseil d’Administration)

Dernière mise à jour : Janvier 2025

Contact : contact@koprogo.com (à créer)