Files
_Assistant_Lead_Tech/knowledge/backend/patterns/README.md
MaksTinyWorkshop b3417ad77b capitalisation: intégration ~60 entrées RL799_V2 (triage 2026-05-02)
Triage du 95_a_capitaliser.md (~75 propositions) :
- 60 entrées intégrées dans knowledge/ (backend, frontend, workflow)
- 4 nouveaux fichiers : backend/patterns/tests.md, backend/risques/tests.md,
  frontend/patterns/general.md, workflow/patterns/general.md
- 6 doublons rejetés
- Mise à jour des READMEs index pour refléter les nouvelles entrées
- 95_a_capitaliser.md restauré à sa structure initiale
- 40_decisions_et_archi.md : décision mono-tenant déployable vs SaaS multi-tenant
- 90_debug_et_postmortem.md : sub-agents Write indisponible, effet iceberg CI,
  prisma migrate diffs cosmétiques

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 22:12:44 +02:00

2.4 KiB

Backend — Patterns validés — Index

Patterns backend testés et validés en conditions réelles.

Avant toute proposition backend, identifie le fichier dont le nom et la description matchent le domaine traité, puis lis-le.


Fichier Domaine Entrées clés
auth.md Auth, sessions, tokens, erreurs API, corrélation Format erreur standardisé, middleware requestId, anti-énumération, token usage unique, autorisation interne, opérations atomiques
contracts.md Contrats API, Zod, error codes, HTTP sémantique Contracts-First/Zod-Infer/No-DTO, error codes comme contrat, HTTP 200 payload métier
prisma.md Prisma, DB, migrations, pagination Soft delete, pagination cursor, idempotency key, P2002 unique, Decimal sérialisation, migration manuelle P3014, filtrage métier dans service
stripe.md Stripe, paiements, webhooks entrants, subscriptions Provider-Strategy, metadata subscription_data, parsing webhook unique, restauration achats, Trial vs Paid
nestjs.md NestJS, guards, Redis, quotas Guard global APP_GUARD, RedisHealthService cache court, quota INCR+EXPIREAT atomique
multi-tenant.md Multi-tenant, isolation, feature flags 403 vs 404, repository tenant-aware, tenantId dans updates, helper tenant partagé, feature flag tenant, EN enforcement
nextjs.md Next.js App Router, Server Actions, isolation Runtime-only logique pure, server-only isolation, utilitaires purs sans server-only, réutiliser champ V1, validation URL externe
async.md Jobs async, webhooks sortants, queues Exécution asynchrone outbox light, webhooks sortants HMAC + retries idempotents, hooks fire-and-forget après création DB, fanout notification avec filtre grade, auto-purge fenêtre temporelle SQL
general.md Architecture générale, helpers, RBAC Helper auth centralisé enrichissable, ordre canonique des gates HTTP, délégation agrégat → endpoint agrégé, anti-énumération DELETE 204, lazy init memoizé, cap LRU par-user, convention dot-notation audit, whitelist explicite audit, singleton DB config, invalidation cache avant mutation, pipeline CI/CD GitHub Actions → VPS
tests.md Tests d'intégration DB, isolation, atomicité cleanup.track() LIFO, globalSetup purge, template database Postgres, helper waitForX() polling-borné, test d'atomicité transaction, convention describe() 2 niveaux, refactor itératif d'un fichier monolithe