Documentation KoproGo

Plateforme open-source de gestion de copropriété pour la Belgique

Note

📺 Tutoriels Vidéo : Chaîne YouTube @koprogo

Retrouvez des tutoriels vidéo pour démarrer avec KoproGo, comprendre l’architecture hexagonale, et découvrir les fonctionnalités avancées de la plateforme.

L’Histoire Humaine Derrière KoproGo

Marie, 72 ans, retraitée à Bruxelles

Son syndic lance des travaux de façade : 15 000€ sa quote-part. Elle conteste les devis qui lui semblent excessifs. Un avocat coûte 2 000€. Sa pension : 1 200€/mois.

Ahmed, 35 ans, intérimaire

Trois mois de chômage technique en 2024. Résultat : 3 200€ d’impayés de charges. Les huissiers interviennent. Les pénalités s’accumulent.

Sofiane, 40 ans, auto-entrepreneur

La toiture de sa copropriété doit être refaite : 12 000€ sa quote-part. Les banques refusent le prêt (pas de CDI). Les travaux sont bloqués. L’immeuble se dégrade.

Ces situations reflètent les défis quotidiens de milliers de copropriétaires en Belgique.

KoproGo apporte des solutions concrètes : plateforme de gestion accessible (5€/mois en cloud, gratuite en self-hosted), Fonds de Solidarité pour membres en difficulté, gouvernance démocratique (ASBL), et architecture optimisée réduisant coûts et empreinte carbone.

Qui Êtes-Vous ? (Choisissez Votre Parcours)

KoproGo s’adresse à différents profils. Choisissez le parcours qui vous correspond :

Introduction Rapide

Le Contexte

En Belgique, 200 000 copropriétés font face à des coûts de gestion élevés (200-500€/mois pour les solutions logicielles existantes), une empreinte carbone importante, et un manque de transparence dans les calculs de charges.

La Solution KoproGo

Une plateforme open-source développée par une ASBL belge :

L’Impact Attendu (5 000 copropriétés)

  • 4M€/an économisés collectivement

  • 840 tonnes CO₂/an évitées

  • 40-60 copropriétaires aidés/an financièrement

Vision 2025-2030

Notre objectif : 5 000 copropriétés belges utilisant KoproGo

Progression par Paliers Mesurables

Palier

Copropriétés

Économies/an

CO₂ évité/an

Impact Social

Validation

100

80k€

-2 tonnes

Beta publique

Viabilité

500

400k€

-15 tonnes

Production ouverte

Impact

1 000

800k€

-107 tonnes

Communauté active

Leadership

2 000

1,6M€

-214 tonnes

Référence belge

Référence

5 000

4M€

-840 tonnes

Leadership EU

Philosophie : Nous livrons quand les capacités sont atteintes, pas selon des dates arbitraires. Chaque palier débloque le suivant.

Chaque fonctionnalité d’aujourd’hui prépare la vision de demain.

→ Découvrez comment : De la Gestion à la Symbiose

Parcours Guidé du Nouveau Contributeur

Important

Vous découvrez KoproGo ? Suivez ce parcours étape par étape !

Étape 1 : Comprendre le Projet (15 min)

  1. Lisez Pourquoi KoproGo Existe - Pourquoi KoproGo existe

  2. Découvrez vision-strategie/vision - La vision à long terme

  3. Explorez vision-strategie/mission - La mission et les valeurs

Étape 2 : Découvrir la Roadmap (20 min)

  1. Consultez Roadmap KoproGo 2025-2030 - La roadmap 2025-2030

  2. Voyez Jalons Atteints - Ce qui est déjà fait

  3. Explorez Jalons À Venir - Ce qui vient ensuite

Étape 3 : Comprendre l’Architecture (30 min)

  1. Lisez architecture/vue-ensemble - Vue d’ensemble de l’architecture

  2. Découvrez architecture/choix-technologiques - Pourquoi Rust, PostgreSQL, etc.

Étape 4 : Commencer à Contribuer (1-2h)

  1. Suivez contribuer/premiers-pas - Premiers pas

  2. Installez le projet : contribuer/installer-projet

  3. Faites votre première contribution : contribuer/faire-premiere-contribution

Besoin d’Aide ?

Ou suivez le parcours complet : Bienvenue dans la Communauté KoproGo !

Chiffres Clés (État Actuel)

Architecture & Code

  • 73 endpoints REST API opérationnels

  • 11 entités du domaine (Organization, Building, Unit, Owner, Expense, etc.)

  • Architecture hexagonale (Domain-Driven Design)

  • Tests E2E automatisés avec Playwright

  • 100% open-source (AGPL-3.0)

Performance Technique

  • 287 req/s soutenus (charge réelle)

  • 752ms latence P99 (1 vCPU)

  • 0,12g CO₂/requête (96% réduction vs solutions SaaS classiques)

  • 99,74% uptime (infrastructure OVH)

  • 128MB RAM par instance (ultra-léger)

Stack Technique

  • Backend : Rust 1.83 + Actix-web 4.9 + PostgreSQL 15

  • Frontend : Astro 4.x + Svelte 4.x (PWA offline-first)

  • Infrastructure : Terraform + Ansible + GitOps

  • Hébergement : OVH France (Gravelines, bas carbone)

Table des Matières

📖 Vision & Stratégie

Comprenez pourquoi KoproGo existe et quelle est sa vision à long terme.

🗺️ Roadmap 2025-2030

Découvrez le chemin vers 5 000 copropriétés et l’impact sociétal prévu.

🏗️ Architecture Technique

Explorez l’architecture hexagonale, les choix technologiques et les patterns utilisés.

🤝 Guide du Contributeur

Apprenez à contribuer au projet, de l’installation à votre première pull request.

📜 Gouvernance & Décisions

Comprenez la gouvernance ASBL, les RFC/ADR et le processus de décision.

💰 Modèle Économique

Découvrez le modèle économique OpenCore et la transparence financière.

💻 Documentation Technique

Documentation technique détaillée pour développeurs.

🛠️ Guides Développeurs

👥 Guides Utilisateurs

🔧 API & Déploiement

🏗️ Architecture Decision Records (ADR)

Historique des décisions d’architecture importantes.

📊 GitHub Project Management

Suivi du projet via GitHub Issues, Milestones et Projects.

🚨 Operations & SRE

Guides d’exploitation, monitoring, backups et incidents.

🔒 Sécurité & Conformité

GDPR, comptabilité belge (PCMN), workflow de facturation et recouvrement.

💰 Finances & Performance

Rapports de performance, simulations de coûts et données financières.

🎨 Frontend & Internationalisation

Composants frontend, templates email et guide i18n.

Rejoignez la Communauté

KoproGo est un projet collaboratif et ouvert. Votre contribution compte !

Tip

Comment Contribuer ?

  • Code : Consultez les issues GitHub étiquetées “good first issue”

  • Documentation : Améliorez cette documentation via pull requests

  • Traductions : Ajoutez le support pour d’autres langues (NL, DE, EN)

  • Tests : Rejoignez le programme beta et testez la plateforme

  • Feedback : Partagez vos idées sur GitHub Discussions

Liens Utiles

Principes Fondamentaux

Note

Nos Valeurs

✅ Open-Source d’abord : Code public, auditable, contributible

✅ Démocratie tarifaire : 1 membre = 1 voix, prix voté en AG

✅ Qualité avant vitesse : Livraison quand c’est prêt, pas selon un calendrier

✅ Écologie par design : Architecture optimisée pour réduire l’empreinte carbone

✅ Transparence totale : Comptabilité publique, décisions ouvertes

✅ Solidarité intégrée : Fonds de solidarité pour membres en difficulté

✅ Souveraineté des données : Hébergement Europe, conformité GDPR stricte

Documentation maintenue par la communauté KoproGo ASBL

Modèle de progression : Capacités et métriques, pas dates fixes

Contact : contact@koprogo.com - GitHub : github.com/gilmry/koprogo