mirror of
https://github.com/MaksTinyWorkshop/_Assistant_Lead_Tech
synced 2026-04-27 23:08:16 +02:00
capitalisation: intégration 33 propositions RL799_V2 (triage 2026-04-07)
Backend: 21 entrées (general, prisma, contracts, auth, patterns) Frontend: 9 entrées (navigation, tests, general, performance, patterns) Workflow: 5 entrées (story-tracking) Nouveau fichier: backend/patterns/general.md 95_a_capitaliser.md purgé. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -5,8 +5,8 @@ bucket: patterns
|
||||
tags: [contracts, zod, api, error-codes, monorepo]
|
||||
applies_to: [analysis, implementation, review, architecture]
|
||||
severity: high
|
||||
validated_on: 2026-03-20
|
||||
source_projects: [app-alexandrie]
|
||||
validated_on: 2026-04-07
|
||||
source_projects: [app-alexandrie, RL799_V2]
|
||||
---
|
||||
|
||||
# Backend — Patterns : Contracts
|
||||
@@ -147,3 +147,23 @@ return res.status(200).json({
|
||||
|
||||
- **4xx** = erreur technique ou de sécurité (401 non authentifié, 403 accès interdit, 404 introuvable)
|
||||
- **200 + flag métier** = état métier normal que le client doit interpréter pour le rendu
|
||||
|
||||
---
|
||||
|
||||
<a id="pattern-coherence-result-repository"></a>
|
||||
## Pattern : Cohérence du pattern Result dans un repository
|
||||
|
||||
- Objectif : garantir une sémantique uniforme du retour d'erreur dans un même fichier repository.
|
||||
- Contexte : repository utilisant le pattern `{ ok: true; data } | { ok: false }` pour certaines fonctions.
|
||||
- Quand l'utiliser : dès qu'un repository a au moins une fonction utilisant le pattern Result.
|
||||
- Risque si ignoré : retourner `null` sur erreur dans une fonction alors que les voisines retournent `{ ok: false }` crée une ambiguïté sémantique (null = pas trouvé vs null = erreur) et empêche le service d'adapter sa réponse HTTP (404 vs 500).
|
||||
- Validé le : 03-04-2026
|
||||
- Contexte technique : TypeScript / Prisma — RL799_V2 story 6A.5
|
||||
|
||||
### Règle
|
||||
|
||||
Quand un repository utilise le pattern `{ ok: true; data } | { ok: false }` pour certaines fonctions, **toutes** les fonctions du même fichier doivent utiliser le même pattern.
|
||||
|
||||
### Signal review
|
||||
|
||||
- `catch { return null }` dans un repository qui utilise `{ ok: false }` ailleurs
|
||||
|
||||
Reference in New Issue
Block a user