gilles/template-webapp

Template

Files

Gilles Soulier 9f44605ed2 maj 1

2026-01-27 20:37:55 +01:00

2.6 KiB

Raw Blame History

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 :
Qualités prioritaires (performance, sécurité, scalabilité) : <A REMPLIR - PROJET> (exemple: sécurité et performance — a supprimer)

3. Architecture logique

Modules principaux :
Responsabilités par module :
Frontend/Backend séparation :

4. Architecture technique

Langages & frameworks :
Base de données :
Stockage fichiers :
Infra cible (cloud/self-hosted) : <A REMPLIR - PROJET> (exemple: self-hosted — a supprimer)

5. Flux de données

Flux principaux (lecture/écriture) :
Intégrations externes : <A REMPLIR - PROJET> (exemple: ERP existant — a supprimer)
Gestion des événements/asynchronisme :

6. Sécurité

Authentification/autorisation :
Données sensibles : <A REMPLIR - PROJET> (exemple: emails + historiques de paiement — a supprimer)
Traçabilité/audit :

7. Observabilité

Logs (journaux) :
Metrics (mesures) :
Alerting (alertes) :

8. Conventions de code

Organisation des dossiers :
Standards de code :
Tests obligatoires :

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).