Documentation Miroir Complète - KoproGo

Cette documentation miroir du projet KoproGo couvre l’intégralité du code source :

  • ✅ Backend (Rust + Actix-web) - 321 fichiers

  • ✅ Frontend (Astro + Svelte + TypeScript)

  • ✅ Infrastructure (Ansible, Docker, Scripts)

Principe : Chaque fichier source a un fichier .rst correspondant avec explication en français de son rôle.

Architecture

Le projet suit une architecture hexagonale (Ports & Adapters) avec Domain-Driven Design (DDD).

Documentation par Composant

Couches Backend

  1. Domain (Métier) - Entités de domaine avec validation métier - Services de domaine (logique complexe) - Aucune dépendance externe

  2. Application (Use Cases) - Use Cases (orchestration) - Ports (interfaces/traits) - DTOs (contrats API)

  3. Infrastructure (Adaptateurs) - Repositories PostgreSQL - Handlers HTTP (Actix-web) - Clients API externes (Stripe, Linky)

Frontend

  • Astro : SSG (Static Site Generation)

  • Svelte : Composants interactifs (Islands)

  • TypeScript : Type-safety

Infrastructure

  • Ansible : Déploiement VPS automatisé

  • Docker : Conteneurisation services

  • GitHub Actions : CI/CD pipelines

Liens Rapides