# Gabarit de doc d'asset

Copier ce gabarit pour chaque artefact créé par/pour CHLOVA (workflow n8n, stack
Portainer, outil, image). Un asset **non documenté est incomplet**.
Fichier suggéré : `docs/assets/<type>-<slug>.md`.

---

## <Nom de l'asset>

- **Type** : `workflow-n8n` | `stack-portainer` | `tool` | `image` | `service`
- **Version** : `vX.Y.Z`
- **Palier de risque** : `reversible` | `privileged`  (voir `risk-tiers.md`)
- **Statut (need-review)** : `provisoire` | `approuvé` | `refusé` | `bloqué` | `n/a`
- **Lien commit** : `<sha ou URL>`
- **Créé le** : `YYYY-MM-DD`  · **Expire le** : `YYYY-MM-DD` (si provisoire)

### Rôle
Ce que fait l'asset, en une à trois phrases. Pourquoi il existe.

### Entrées / sorties
- **Entrées** : paramètres, déclencheurs, données consommées.
- **Sorties** : effets, données produites, notifications émises.

### Dépendances
- Services (Ollama, n8n, Portainer…), autres assets, variables d'env (par
  **référence**, jamais de valeur), réseau.

### Sécurité
- Secrets manipulés (par référence) ; pourquoi le palier de risque est celui-ci ;
  surface d'exposition (doit rester interne).

### Rollback
- **Comment annuler** : commande/étapes précises pour revenir à l'état antérieur
  (ex. redeploy de la version N-1, désactivation du workflow, `git revert <sha>`).
- Effets de bord à nettoyer.

### Tests / vérification
- Comment vérifier que l'asset fonctionne et reste read-only si applicable.