maj 1

docs/ARCHITECTURE.md

@@ -0,0 +1,64 @@
+# Architecture du projet
+
+Ce document formalise l’architecture cible. Il doit être maintenu à jour.
+Il sert de base aux décisions techniques, aux ADR et au découpage des tâches.
+
+---
+
+## Légende des zones
+- `<A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)` : à compléter par toi selon le projet.
+- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé architecture.
+
+---
+
+## 1. Vue d’ensemble
+- Objectif produit : <A REMPLIR - PROJET> (exemple: améliorer la traçabilité — a supprimer)
+- Type d’app (web, mobile, API) : <A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)
+- Contraintes fortes : <A REMPLIR - PROJET> (exemple: déploiement on-premise — a supprimer)
+
+## 2. Principes d’architecture
+- Principes non négociables : <A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)
+- Principes d’évolution : <A COMPLETER PAR AGENT>
+- Qualités prioritaires (performance, sécurité, scalabilité) : <A REMPLIR - PROJET> (exemple: sécurité et performance — a supprimer)
+
+## 3. Architecture logique
+- Modules principaux : <A COMPLETER PAR AGENT>
+- Responsabilités par module : <A COMPLETER PAR AGENT>
+- Frontend/Backend séparation : <A COMPLETER PAR AGENT>
+
+## 4. Architecture technique
+- Langages & frameworks : <A COMPLETER PAR AGENT>
+- Base de données : <A COMPLETER PAR AGENT>
+- Stockage fichiers : <A COMPLETER PAR AGENT>
+- Infra cible (cloud/self-hosted) : <A REMPLIR - PROJET> (exemple: self-hosted — a supprimer)
+
+## 5. Flux de données
+- Flux principaux (lecture/écriture) : <A COMPLETER PAR AGENT>
+- Intégrations externes : <A REMPLIR - PROJET> (exemple: ERP existant — a supprimer)
+- Gestion des événements/asynchronisme : <A COMPLETER PAR AGENT>
+
+## 6. Sécurité
+- Authentification/autorisation : <A COMPLETER PAR AGENT>
+- Données sensibles : <A REMPLIR - PROJET> (exemple: emails + historiques de paiement — a supprimer)
+- Traçabilité/audit : <A COMPLETER PAR AGENT>
+
+## 7. Observabilité
+- Logs (journaux) : <A COMPLETER PAR AGENT>
+- Metrics (mesures) : <A COMPLETER PAR AGENT>
+- Alerting (alertes) : <A COMPLETER PAR AGENT>
+
+## 8. Conventions de code
+- Organisation des dossiers : <A COMPLETER PAR AGENT>
+- Standards de code : <A COMPLETER PAR AGENT>
+- Tests obligatoires : <A COMPLETER PAR AGENT>
+
+## 9. Évolution & dette
+- Zones à risque : <A REMPLIR - PROJET> (exemple: montée en charge — a supprimer)
+- Améliorations prévues : <A REMPLIR - PROJET> (exemple: reporting avancé — a supprimer)
+
+---
+
+## Exemple (a supprimer)
+- Modules : `auth`, `users`, `billing`, `catalog`.
+- DB : PostgreSQL + migrations.
+- Auth : JWT (jeton) + RBAC (contrôle d’accès par rôle).