45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# Kanban — source de vérité
|
|
|
|
`DOCS/kanban.html` est **généré**. Ne pas l'éditer à la main.
|
|
|
|
```
|
|
kanban/
|
|
board.json colonnes, bandeau d'intro, horodatage
|
|
cards/<n>-<col>/ un chantier ouvert = un fichier .md
|
|
done/ un chantier clos = un fichier .md
|
|
```
|
|
|
|
Après toute modification :
|
|
|
|
```
|
|
python3 DOCS/tools/build_kanban.py
|
|
```
|
|
|
|
Les compteurs de colonne et le bandeau de chiffres clés sont **calculés** à partir du
|
|
nombre de fichiers. Il n'y a plus rien à compter ni à vérifier à la main.
|
|
|
|
## Gestes courants
|
|
|
|
| Geste | Action |
|
|
|---|---|
|
|
| Ajouter un chantier | créer un `.md` dans `cards/<colonne>/` |
|
|
| Déplacer de colonne | déplacer le fichier vers l'autre dossier |
|
|
| Clore un chantier | déplacer vers `done/`, ne garder que `title` dans le frontmatter |
|
|
| Réordonner | changer le préfixe numérique du nom de fichier (pas de 10) |
|
|
|
|
## Frontmatter d'une carte
|
|
|
|
```
|
|
---
|
|
title: Titre du chantier (requis, HTML inline autorisé)
|
|
area: manager (requis — cible des filtres de domaine)
|
|
horizon: v1 (optionnel — v1 | v2)
|
|
tags: manager-app, infra (affichés en puces monospace)
|
|
flag: warn | code mort depuis C3 (optionnel — critical | warn | good)
|
|
src: todo-features.md — Quota stockage (requis — d'où vient l'info)
|
|
---
|
|
<p>Corps de la carte, en HTML.</p>
|
|
```
|
|
|
|
Le build échoue en nommant le fichier si `title`, `area` ou `src` manque.
|