backendlisted
Install: claude install-skill vendeesign/codebloom
# Fullstack Patterns — Architecture backend solide
Patterns éprouvés pour tout projet backend ou fullstack. Se charge automatiquement quand du code touche des routes, controllers, services, base de données, auth ou API.
## Architecture 3 couches
```
Controller (HTTP) → Service (Business) → Repository (Data Access)
```
| Couche | Fait | Jamais |
|--------|------|--------|
| **Controller** | Parse request, valide input, appelle service, formate réponse | Business logic, requêtes DB |
| **Service** | Règles métier, orchestration, transactions | Types HTTP, accès DB direct |
| **Repository** | Requêtes DB, appels API externes | Business logic, types HTTP |
> Organiser par feature, pas par couche technique. `orders/` contient controller + service + repository + tests, pas `controllers/`, `services/`, `repositories/`.
## 7 règles de fer
1. **Controllers minces** — délèguent aux services, jamais de logique métier
2. **Services isolés du HTTP** — jamais d'import de types Request/Response
3. **Config par variables d'env** — validées au démarrage, fail fast
4. **Erreurs typées** — chaque erreur a un type, un log, un format de réponse cohérent
5. **Validation aux frontières** — tout input validé à l'entrée (Zod, Joi, Pydantic)
6. **Logging structuré JSON** — avec request ID propagé par middleware
7. **Injection de dépendances** — constructeur, jamais d'instanciation dans les services
## Ordre des middlewares
```
RequestID → Logging → CORS → RateLimit → BodyParse → Auth → Authz