template-webapp/backend/CONTEXT.md

Contexte backend

Ce document décrit le rôle du backend, ses responsabilités et ses choix techniques. Tout ce qui est indiqué ici est la référence pour les agents backend.

---

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é backend.

---

Objectif du backend

• Problème métier couvert : <A REMPLIR - PROJET> (exemple: suivi manuel sur tableur — a supprimer)
• Responsabilités principales :
• Hors périmètre : <A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)

Interfaces

• API publique (API = Interface de Programmation) :
• Authentification/autorisation :
• Intégrations externes : <A REMPLIR - PROJET> (exemple: ERP existant — a supprimer)

Données

• Base(s) utilisée(s) :
• Modèle de données clé :
• Stratégie de migration :

Architecture interne

• Style (monolithe modulaire, hexagonal, etc.) :
• Modules principaux :
• Couche d’accès aux données :

Qualité & exploitation

• Observabilité (logs/metrics/traces = journaux/mesures/traces) :
• Tests (unitaires/intégration) :
• Performance attendue : <A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)

Conventions

• Organisation du code :
• Nommage :
• Gestion erreurs :

---

Exemple (a supprimer)

• Style : monolithe modulaire avec modules users, billing, catalog.
• API : REST /api/v1 + JWT (Jeton d’authentification).
• DB : PostgreSQL, migrations via outils natifs.