55 lines
3.2 KiB
Markdown
55 lines
3.2 KiB
Markdown
<!-- file: docs/validation/001-VALIDATION_MATRIX.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Matrice de validation PGR
|
|
|
|
## Rôle
|
|
|
|
Cette matrice décrit les validations canoniques du dépôt PGR. Elle évoluera avec le projet et ne doit pas inventer des scripts uniquement pour remplir une case.
|
|
|
|
`0.0.1-alpha.1` est une tranche documentaire de bootstrap sans toolchain applicative. Les premiers contrôles sont donc volontairement simples.
|
|
|
|
## Commandes initiales
|
|
|
|
| ID | Catégorie | Commande / contrôle | Trigger | Phase |
|
|
|-------------------------|-----------|------------------------------------------------------------------------------------------|--------------------------------------------|----------------------|
|
|
| `PGR-GIT-001` | CHECK | `git diff --check` | toute modification suivie par Git | alpha/beta/RC/stable |
|
|
| `PGR-GIT-BOOTSTRAP-001` | CHECK | `git add .` puis `git diff --cached --check` | bootstrap ou fichiers entièrement nouveaux | alpha.1/bootstrap |
|
|
| `PGR-VERSION-001` | CHECK | `test "$(cat VERSION)" = "0.0.1-alpha.1"` | tranche `0.0.1-alpha.1` | alpha.1 |
|
|
| `PGR-LAYOUT-001` | REVIEW | `find . -type f -not -path './.git/*' -print` puis comparaison au scope du delta | ajout/suppression/déplacement de fichiers | alpha/beta/RC/stable |
|
|
| `PGR-DOC-001` | REVIEW | vérifier headers `file/version`, chemins, liens et responsabilités des documents touchés | modification documentaire | alpha/beta/RC/stable |
|
|
| `PGR-STATUS-001` | CHECK | `git status --short` | avant fermeture d'une tranche | alpha/beta/RC/stable |
|
|
|
|
## Gate `0.0.1-alpha.1`
|
|
|
|
Après application du delta :
|
|
|
|
```bash
|
|
git status --short
|
|
|
|
test "$(cat VERSION)" = "0.0.1-alpha.1"
|
|
|
|
find . -type f -not -path './.git/*' -print
|
|
|
|
git add .
|
|
git diff --cached --check
|
|
|
|
git status --short
|
|
```
|
|
|
|
L'opérateur vérifie également que :
|
|
|
|
- `.project`, `.classpath` et `.settings/` Eclipse restent locaux/ignorés ;
|
|
- aucun répertoire vide n'a été ajouté uniquement pour anticiper le futur ;
|
|
- les fichiers listés par le delta sont les seuls fichiers PGR introduits par la tranche ;
|
|
- les headers `file/version` correspondent aux chemins réels ;
|
|
- `VERSION` contient exactement une ligne `0.0.1-alpha.1` ;
|
|
- les liens Markdown de navigation principaux sont cohérents ;
|
|
- aucun secret, chemin machine absolu ou artefact local n'est introduit.
|
|
|
|
## Autorité de validation
|
|
|
|
Une validation n'est `PASS` qu'après exécution réelle du gate opérateur. La génération du delta ou une prévalidation par l'IA ne constitue pas le résultat opérateur.
|
|
|
|
Après `PASS`, la tranche suivante doit enregistrer `history/0.0.1/alpha.1.md` séparément avant le commit de l'état validé et fournir le delta suivant conformément au workflow PGR retenu.
|