generated from gilles/template-webapp
65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
# 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).
|