Refonte Structure

knowledge/backend/risques/general.md

@@ -0,0 +1,72 @@
+# Backend — Risques & vigilance : Général
+
+> Extrait de la base de connaissance Lead_tech. Voir `knowledge/backend/risques/README.md` pour l'index complet.
+
+---
+
+<a id="risque-observabilite-insuffisante"></a>
+## Observabilité insuffisante (logs non structurés, pas de corrélation)
+
+### Risques
+
+- MTTR très élevé : on devine
+- Incapacité à mesurer l'impact utilisateur
+
+### Symptômes
+
+- Logs "ça a crash" sans contexte
+- Impossible de relier une requête à une erreur
+- Latence qui dérive sans alerte
+
+### Bonnes pratiques / mitigations
+
+- Logs structurés + requestId/traceId
+- Métriques de base (latence, erreurs, throughput)
+- Alertes simples sur 5xx/latence
+
+---
+
+<a id="risque-migrations-risquees"></a>
+## Migrations risquées / non reproductibles
+
+### Risques
+
+- Downtime
+- Perte de données
+- Incohérence entre environnements
+
+### Symptômes
+
+- "Ça marche en local" mais pas en prod
+- Migration qui échoue à mi-chemin
+- Rollback impossible
+
+### Bonnes pratiques / mitigations
+
+- Migrations versionnées + tests staging
+- Stratégie expand/contract si besoin
+- Plan de rollback/mitigation
+
+---
+
+<a id="risque-upsert-n-plus-un-provider"></a>
+## Boucle `upsert` N+1 sur synchronisation provider
+
+### Risques
+
+- Latence multipliée par le nombre d'items
+- Charge DB inutile
+- Timeouts ou contention sur gros volumes
+
+### Symptômes
+
+- Une boucle applicative exécute un `upsert` par item
+- Temps de traitement qui explose avec le volume
+- Logs SQL répétitifs et séquentiels
+
+### Bonnes pratiques / mitigations
+
+- Batcher quand c'est possible
+- Précharger les données nécessaires avant boucle
+- Mesurer explicitement le coût d'un `upsert` unitaire dans les flux de sync
+- Contexte technique : Prisma / synchronisation provider — 10-03-2026