91 lines
4.8 KiB
Markdown
91 lines
4.8 KiB
Markdown
<!-- Type: explanation (Diataxis). Style: discursif, retour d'experience, redige par documenter a l'etape 13. -->
|
|
|
|
# Analyse workflow — gitea-dashboard v1.1.0
|
|
|
|
**Projet** : gitea-dashboard
|
|
**Version** : v1.1.0
|
|
**Track** : minor
|
|
**Date** : 2026-03-11
|
|
**Duree** : 1 session
|
|
|
|
---
|
|
|
|
## Metriques
|
|
|
|
| Metrique | Valeur |
|
|
|----------|--------|
|
|
| Fichiers source | 6 (inchange) |
|
|
| Lignes source | 385 |
|
|
| Tests | 53 |
|
|
| Couverture | non mesuree (pytest-cov toujours absent) |
|
|
| Score audit initial | 94/100 |
|
|
| Score audit final | 100/100 |
|
|
| Rounds audit | 2 |
|
|
| Findings corriges | 2 |
|
|
| Commits | 12 (total depuis v1.0.0) |
|
|
| Etapes effectuees | 7 etapes (sur 13) |
|
|
| Etapes skippees | 1 (step 6 fusionné), step 10 fusionné dans step 11, step 12 (deploy local) |
|
|
| Agents utilises | architect, builder, reviewer, guardian, fixer, documenter |
|
|
|
|
---
|
|
|
|
## Comparaison v1.0.0 vs v1.1.0
|
|
|
|
| Metrique | v1.0.0 | v1.1.0 | Delta |
|
|
|----------|--------|--------|-------|
|
|
| Fichiers source | 6 modules | 6 modules | = |
|
|
| Lignes source | ~320 | 385 | +65 (+20 %) |
|
|
| Tests | 37 | 53 | +16 (+43 %) |
|
|
| Lignes de test | ~550 | 802 | +252 (+46 %) |
|
|
| Couverture | N/A | N/A | = |
|
|
| Score audit initial | 81/100 | 94/100 | +13 pts |
|
|
| Score audit final | 97/100 | 100/100 | +3 pts |
|
|
| Rounds audit | 2 | 2 | = |
|
|
| Findings corriges | 5 | 2 | -3 |
|
|
| Dependances runtime | 2 | 2 | = |
|
|
|
|
La version 1.1.0 est un minor propre : nouvelle fonctionnalite (filtrage par label), zero nouvelle dependance, retrocompatibilite parfaite. L'amelioration du score audit initial (81 → 94) confirme que les lecons de v1.0.0 ont ete assimilees.
|
|
|
|
---
|
|
|
|
## Ce qui a bien fonctionne
|
|
|
|
- **Plan architect clair et precis** : l'architect a produit un plan avec ADR-004 et ADR-005 explicites, ce qui a permis au builder de suivre sans aucune deviation ni ambiguite.
|
|
- **Score audit initial en nette progression** : 94/100 au premier passage (vs 81 en v1.0.0), signe que la qualite du code produit par le builder a progresse. Seulement 2 findings a corriger.
|
|
- **Score final 100/100** : objectif atteint, pas de finding residuel.
|
|
- **Smoke test 3/3 du premier coup** : les trois scenarios (sans filtre, avec filtre valide, avec filtre invalide) ont passe sans intervention corrective.
|
|
- **Fusion step 10+11 fluide** : le mode lightweight de la track minor a permis de fusionner la documentation et la release en une seule etape sans perdre de qualite.
|
|
- **Zero nouvelle dependance** : argparse est fourni par la stdlib Python, le choix de ne pas introduire Click ou typer est justifie et tenu.
|
|
- **Retrocompatibilite parfaite** : aucun utilisateur existant n'est impacte, l'option `--label` est additive.
|
|
|
|
---
|
|
|
|
## Ce qui a mal fonctionne
|
|
|
|
Rien de bloquant durant cette version. Un seul point de friction mineur :
|
|
|
|
- **GITEA_TOKEN absent du shell au moment du smoke test** : la variable d'environnement n'etait pas exportee, ce qui a necessite un rappel avant d'executer les commandes. Incident mineur, resolu en une ligne.
|
|
|
|
---
|
|
|
|
## Friction workflow
|
|
|
|
- **Transition step 7 geree par le builder** : le builder a marque lui-meme le step 7 comme termine dans `workflow-progress.md`, ce qui sort du perimetre de responsabilite de l'agent (normalement gere par le workflow skill ou le documenter). Comportement a corriger pour eviter des transitions non tracees.
|
|
- **Fusion 10+11 sans verification automatique** : la decision de fusionner les etapes repose sur une appreciation manuelle des conditions (pas de criteres objectifs programmes). Le risque est de sauter de la documentation utile sous pression de temps.
|
|
- **pytest-cov toujours absent** : identifie comme lecon en v1.0.0, non corrige en v1.1.0. La couverture reste non mesuree.
|
|
|
|
---
|
|
|
|
## Suggestions d'amelioration
|
|
|
|
- **[projet]** Ajouter pytest-cov dans les deps dev (`pyproject.toml [project.optional-dependencies]`) et configurer un seuil minimal dans `pyproject.toml [tool.pytest.ini_options]`.
|
|
- **[projet]** Documenter la procedure d'export de GITEA_TOKEN dans le README (section Development) pour eviter la friction au smoke test.
|
|
- **[generique]** Definir un critere objectif pour la fusion 10+11 (ex. : moins de N nouvelles features, pas de changement de schema) afin que la decision soit tracable et non dependante du jugement du moment.
|
|
- **[generique]** Le builder ne devrait pas modifier `workflow-progress.md` directement ; ce fichier devrait etre en ecriture reservee au workflow skill.
|
|
|
|
---
|
|
|
|
## Contexte projet
|
|
|
|
Version 1.1.0 introduit le filtrage des repos par label Gitea (`--label`), implementee via argparse (stdlib). L'architecture en 4 modules (client, collector, display, cli) a absorbe le changement sans restructuration. Le choix de passer le filtre de cli vers collector via le dataclass `GiteaConfig` (ADR-005) est propre et testable. La track minor s'est avere bien calibree pour ce type de changement : assez de rigueur pour garantir la qualite, assez legere pour ne pas surcharger la session.
|