============================
Jalons Atteints
============================

:Date: 2025-01-19
:État: Ce qui est déjà fait

.. contents:: Table des matières
   :depth: 2
   :local:

Introduction
============

Cette page présente les **jalons déjà atteints** par KoproGo. Elle démontre la **maturité technique** du projet et valide la **faisabilité** de la vision 2025-2030.

.. tip::
   **Le projet est déjà opérationnel !**

   KoproGo n'est pas un concept : c'est une plateforme fonctionnelle avec 73 endpoints API, des tests automatisés, et une infrastructure en production.

Jalon 0 : Fondations Techniques ✅
===================================

**État** : **COMPLÉTÉ** (Automne 2025)

**Capacité débloquée** : 10-20 early adopters (beta fermée)

**Conformité légale** : 30% (features CRUD de base)

Architecture & Code
-------------------

✅ **Architecture Hexagonale Implémentée**

* Domain layer (entités avec invariants)
* Application layer (use cases + ports)
* Infrastructure layer (adapters web, database)
* Séparation stricte des couches
* Dependency inversion respectée

✅ **73 Endpoints REST API Opérationnels**

* Buildings : 6 endpoints (CRUD + stats)
* Units : 8 endpoints (CRUD + owners management)
* Owners : 7 endpoints (CRUD + units relationship + history)
* Expenses : 12 endpoints (CRUD + workflow approval + payment reminders)
* Meetings : 6 endpoints (CRUD + attendees)
* Documents : 6 endpoints (CRUD + upload)
* Auth : 5 endpoints (login, register, refresh, logout, switch-role)
* Accounts (PCMN) : 7 endpoints
* Payment Reminders : 8 endpoints
* Unit Owners : 8 endpoints (multi-owner support)

✅ **11 Entités du Domaine**

1. Organization
2. User (avec multi-role support)
3. Building
4. Unit
5. Owner
6. UnitOwner (relation N-N avec pourcentages)
7. Expense (avec workflow approval)
8. InvoiceLineItem (lignes de facturation + TVA)
9. Meeting
10. Document
11. Account (PCMN belge)
12. PaymentReminder (workflow recouvrement)

Tests & Qualité
---------------

✅ **Tests E2E Automatisés (Playwright)**

* 45+ scénarios E2E
* Backend + Frontend intégration
* Visual regression testing
* Tests cross-browser

✅ **Tests Unitaires & Intégration**

* Domain : 100% couverture (tests in-module)
* Application : Use cases testés
* Infrastructure : Tests intégration PostgreSQL (testcontainers)
* BDD : Scénarios Cucumber/Gherkin

✅ **Load Tests Validés**

* **287 req/s** soutenus (charge réelle)
* **752ms** latence P99 (1 vCPU)
* **99,74% success rate** (26 échecs sur 17 200 requêtes)
* **128MB RAM** utilisée (sur 2GB disponibles)

Performance & Écologie
----------------------

✅ **Performance Validée en Production**

* Throughput : 287 req/s soutenu
* Latency P99 : 752ms (1 vCPU VPS)
* Memory : 128MB utilisée
* CPU : < 20% utilisation moyenne
* Uptime : 99,74%

✅ **Empreinte Carbone Mesurée**

* **0,12g CO₂/requête** (mesuré en production)
* vs 11,5g concurrence (96% réduction)
* Datacenter OVH Gravelines (60g CO₂/kWh)
* Architecture Rust optimisée

Infrastructure & Sécurité
--------------------------

✅ **Infrastructure Production (Issue #39, #40, #41, #43)**

* VPS OVH s1-2 (1 vCPU, 2GB RAM) - 6,30€/mois
* Docker + GitOps (auto-deploy)
* LUKS Encryption at-rest (AES-XTS-512)
* Backups quotidiens GPG + S3 off-site
* Monitoring : Prometheus + Grafana + Loki

✅ **Sécurité Renforcée**

* TLS 1.3 (Let's Encrypt)
* JWT authentication + refresh tokens
* Hashing passwords (Argon2id)
* Firewall UFW (ports 22, 80, 443)
* Fail2ban (SSH, Traefik, API abuse)
* Suricata IDS (détection intrusions)
* CrowdSec WAF (threat intelligence)

Documentation
-------------

✅ **Documentation Sphinx Complète**

* 50+ documents RST
* Architecture détaillée (backend, frontend, infra)
* Guides utilisateurs (syndic, owner, comptable)
* ADR (Architecture Decision Records)
* RFC (Request For Comments)
* API documentation
* Tutoriels vidéo YouTube

✅ **Workflows Git Documentés**

* Pre-commit hooks (format + lint)
* Pre-push hooks (lint + test)
* Conventional commits
* DCO (Developer Certificate of Origin)
* Pull request templates

Jalon 1 : Sécurité & GDPR (En Cours) 🔄
========================================

**État** : **70% COMPLÉTÉ**

**Capacité débloquée** : 50-100 copropriétés (beta publique)

**Conformité légale** : 40%

Déjà Fait
---------

✅ **Infrastructure Sécurisée** (Issues #39, #40, #41, #43)

* LUKS Encryption at-rest ✅
* Backups GPG + S3 ✅
* Monitoring/Alerting ✅
* Intrusion Detection (Suricata) ✅
* WAF (CrowdSec) ✅
* fail2ban + SSH hardening ✅

En Cours
--------

⏳ **GDPR Basique** (Issue #42)

* ⏳ Export données utilisateur (Article 15 GDPR)
* ⏳ Droit à l'oubli (Article 17 GDPR)
* ⏳ Privacy policy v1.0
* ⏳ Tests GDPR automatisés

⏳ **Authentification Forte** (Issue #48)

* ⏳ Inscription itsme® (délai 2-4 semaines)
* ⏳ Intégration API itsme®
* ✅ Fallback email/password (déjà implémenté)
* ⏳ Tests auth E2E

**Effort restant estimé** : 2-4 semaines (selon force de travail)

Modules Fonctionnels Déjà Implémentés
======================================

Multi-Owner Support ✅
----------------------

**Issue** : Implémenté (multi-tenancy refactor)

* Junction table `unit_owners` (N-N)
* Pourcentages de propriété (validation ≤ 100%)
* Historique temporel (date début/fin)
* Contact principal unique
* Transfert de propriété
* API endpoints : 8 endpoints

**Frontend** : Components Svelte (UnitOwners.svelte, OwnerList.svelte, modals)

**Documentation** : :doc:`../MULTI_OWNER_SUPPORT`

Multi-Role Support ✅
---------------------

**Issue** : Implémenté

* Table `user_roles` (user_id, organization_id, role)
* Rôles : syndic, copropriétaire, comptable, administrateur
* Rôle actif sélectionnable
* Middleware AuthenticatedUser expose `role_id`
* Endpoints : `/auth/login`, `/auth/switch-role`, `/auth/me`

**Frontend** : Sélecteur multi-rôle (Navigation.svelte)

**Tests** : E2E scénario multi-rôles + BDD

**Documentation** : :doc:`../MULTI_ROLE_SUPPORT`

Comptabilité Belge (PCMN) ✅
-----------------------------

**Issue** : #79 (COMPLÉTÉ)

* Plan Comptable Minimum Normalisé (AR 12/07/2012)
* ~90 comptes pré-seedés (8 classes)
* Hiérarchie complète (classes, sous-classes, groupes)
* Validation codes comptables
* Domain entity : `Account`
* Use cases : Create, Read, Update, Delete, Seed
* Repository PostgreSQL
* API endpoints : 7 endpoints
* Financial reports : Bilan & Compte de résultats

**Tests** : 100% couverture domain + integration PostgreSQL

**Documentation** : :doc:`../BELGIAN_ACCOUNTING_PCMN`

Invoice Workflow ✅
-------------------

**Issue** : #73 (COMPLÉTÉ)

* Workflow : Draft → PendingApproval → Approved/Rejected
* Gestion TVA belge (6%, 12%, 21%)
* Multi-lignes (InvoiceLineItem)
* Validation métier (empêche modification après approbation)
* Domain entities : `Expense`, `InvoiceLineItem`
* Endpoints : `/expenses/:id/submit-for-approval`, `/approve`, `/reject`

**Tests** : Scénarios BDD + E2E workflow

**Documentation** : :doc:`../INVOICE_WORKFLOW`

Payment Recovery Workflow ✅
----------------------------

**Issue** : #83 (COMPLÉTÉ)

* Workflow automatisé de recouvrement
* 4 niveaux : Gentle (J+15) → Formal (J+30) → FinalNotice (J+45) → LegalAction (J+60)
* Calcul pénalités retard (taux légal belge 8% annuel)
* Traçabilité (sent_date, tracking_number, notes)
* Domain entity : `PaymentReminder`
* Use cases : Create, Escalate, MarkSent, Stats
* Endpoints : 8 endpoints

**Tests** : Scénarios d'escalade + calcul pénalités

**Documentation** : :doc:`../PAYMENT_RECOVERY_WORKFLOW`

Statistiques Globales (État Actuel)
====================================

**Architecture & Code**

* **73 endpoints REST API** ✅
* **11 entités du domaine** ✅
* **Architecture hexagonale** ✅
* **100% open-source** (AGPL-3.0) ✅

**Tests & Qualité**

* **45+ scénarios E2E** (Playwright) ✅
* **100% couverture domain** ✅
* **Load tests** (287 req/s, 99,74% uptime) ✅
* **Benchmarks** (Criterion) ✅

**Performance**

* **287 req/s** soutenus ✅
* **752ms** latence P99 ✅
* **0,12g CO₂/requête** ✅
* **128MB RAM** utilisée ✅

**Infrastructure**

* **VPS production** (OVH GRA11) ✅
* **LUKS encryption** ✅
* **Backups GPG + S3** ✅
* **Monitoring/Alerting** ✅
* **IDS/WAF** (Suricata + CrowdSec) ✅

**Documentation**

* **50+ documents RST** ✅
* **Sphinx documentation** ✅
* **Tutoriels YouTube** ✅
* **RFC/ADR** ✅

Conclusion
==========

**KoproGo est déjà opérationnel et prêt pour les early adopters.**

Les fondations techniques sont **solides**, l'architecture est **mature**, et la performance est **validée en production**.

**Prochaine étape** : Compléter Jalon 1 (GDPR + Auth forte) pour débloquer la **beta publique** (50-100 copropriétés).

----

**Voir Aussi**

* :doc:`jalons-a-venir` - Ce qui vient ensuite
* :doc:`roadmap-2025-2030` - Roadmap complète 2025-2030
* :doc:`../PERFORMANCE_REPORT` - Rapport de performance détaillé

----

*Jalons Atteints - Documentation KoproGo ASBL*

*Dernière mise à jour : 2025-01-19*