mirror of
https://github.com/MaksTinyWorkshop/_Assistant_Lead_Tech
synced 2026-04-06 13:31:43 +02:00
feat: compléter la couverture knowledge base et nettoyer les stubs
- Nouveaux fichiers : 10_product_patterns_valides.md, 10_conventions_redaction.md - Templates n8n déplacés vers 70_templates/ (workflow + intégration) - Contenu 10_n8n_README.md absorbé dans les fichiers dédiés patterns/risques - Suppression des stubs 10_n8n_README.md, 20_worklows_README.md, 30_integrations_README.md - Index, _AI_INSTRUCTIONS, 95_a_capitaliser et post-bmad-install.sh mis à jour Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
36
70_templates/n8n_integration.md
Normal file
36
70_templates/n8n_integration.md
Normal file
@@ -0,0 +1,36 @@
|
||||
# Template — Documentation d'une intégration externe (n8n)
|
||||
|
||||
Un fichier par service externe. À créer dans le dossier de documentation du projet concerné.
|
||||
|
||||
---
|
||||
|
||||
## Intégration : <Nom du service>
|
||||
|
||||
- **Type** : API REST | Webhook | OAuth | SDK
|
||||
- **Utilisé dans** : (nom du workflow ou projet)
|
||||
|
||||
### Auth
|
||||
|
||||
- Méthode : (API Key / OAuth2 / Basic)
|
||||
- Où stocker les credentials : (n8n Credentials / secret vault)
|
||||
- Expiration / rotation : …
|
||||
|
||||
### Limites et quotas
|
||||
|
||||
- Rate limit : …
|
||||
- Quotas : …
|
||||
- Pagination : …
|
||||
|
||||
### Pièges connus
|
||||
|
||||
- …
|
||||
|
||||
### Endpoints utiles
|
||||
|
||||
| Endpoint | Méthode | Usage |
|
||||
|----------|---------|-------|
|
||||
| `/example` | GET | … |
|
||||
|
||||
### Liens
|
||||
|
||||
- Doc officielle : …
|
||||
40
70_templates/n8n_workflow.md
Normal file
40
70_templates/n8n_workflow.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# Template — Documentation d'un workflow n8n
|
||||
|
||||
Un fichier = un workflow. À créer dans le dossier de documentation du projet concerné.
|
||||
|
||||
---
|
||||
|
||||
## Workflow : <Nom du workflow>
|
||||
|
||||
- **Objectif** : …
|
||||
- **Trigger(s)** : (webhook / cron / manuel / event)
|
||||
- **État** : En test | En prod | Deprecated
|
||||
|
||||
### Entrées / Sorties
|
||||
|
||||
(schéma léger : champs clés attendus en entrée, structure de sortie)
|
||||
|
||||
### Logique (étapes)
|
||||
|
||||
1. …
|
||||
2. …
|
||||
|
||||
### Points sensibles
|
||||
|
||||
- Rate limits / pagination : …
|
||||
- Idempotence : …
|
||||
- Timeouts : …
|
||||
|
||||
### Stratégie d'erreurs
|
||||
|
||||
- Retries : …
|
||||
- Dead letter / notification : …
|
||||
|
||||
### Liens
|
||||
|
||||
- API docs : …
|
||||
- Tickets / contexte : …
|
||||
|
||||
### Export JSON n8n
|
||||
|
||||
_(optionnel — coller le JSON exporté ou lien vers fichier)_
|
||||
@@ -309,7 +309,7 @@ En pratique :
|
||||
DATE — PROJET
|
||||
|
||||
FILE_UPDATE_PROPOSAL
|
||||
Fichier cible : <10_backend_patterns_valides.md | 10_frontend_patterns_valides.md | 10_ux_patterns_valides.md | 10_backend_risques_et_vigilance.md | 10_frontend_risques_et_vigilance.md | 10_ux_risques_et_vigilance.md | 40_decisions_et_archi.md | 90_debug_et_postmortem.md>
|
||||
Fichier cible : <10_backend_patterns_valides.md | 10_frontend_patterns_valides.md | 10_ux_patterns_valides.md | 10_product_patterns_valides.md | 10_n8n_patterns_valides.md | 10_backend_risques_et_vigilance.md | 10_frontend_risques_et_vigilance.md | 10_ux_risques_et_vigilance.md | 10_n8n_nodes_a_risques.md | 10_conventions_redaction.md | 40_decisions_et_archi.md | 90_debug_et_postmortem.md>
|
||||
|
||||
Pourquoi :
|
||||
<raison en 1-2 phrases>
|
||||
|
||||
Reference in New Issue
Block a user