Quickstart : validation du checkout/réconciliation

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# Quickstart : validation du checkout/réconciliation

Ce guide valide les 6 user stories de `spec.md` via `regine checkout`/`regine reconcile` (cf. `contracts/cli-checkout-reconcile.md`). À exécuter une fois `regine_core.integrity`, `regine_core.archive` et `regine_cli.archive_cmd` implémentés.

## Prérequis

- `regine-core`/`regine-cli` installés, `exiftool` disponible.
- Un dossier de test déjà « archivé » (simple répertoire local simulant le NAS pour ce test) contenant quelques RAW, JPEG, et un DNG.

## Scénario 1 — Checkout et verrouillage (User Story 1, P1)

```bash
regine checkout ./fixtures/archive/2026/2026-08-15_Sortie-parc
regine checkout ./fixtures/archive/2026/2026-08-15_Sortie-parc   # second essai, doit échouer
```

**Résultat attendu** : le premier checkout copie tout le contenu et affiche le chemin local ; le second échoue explicitement (« dossier déjà en cours d'édition »), code non-zéro (US1 + US5).

## Scénario 2 — Réconciliation normale (User Story 2, P2)

```bash
# Modifier uniquement un sidecar XMP dans la copie de travail locale, puis :
regine reconcile ./fixtures/archive/2026/2026-08-15_Sortie-parc
```

**Résultat attendu** : le changement est classé « normal », le point avant archive s'affiche, aucune écriture sans confirmation ; après confirmation, le verrou est levé et un nouveau checkout redevient possible.

## Scénario 3 — Anomalie sur un fichier maître (User Story 3, P3)

```bash
# Modifier le contenu pixel d'un RAW dans la copie de travail (pas seulement ses métadonnées), puis :
regine reconcile ./fixtures/archive/2026/2026-08-15_Sortie-parc
```

**Résultat attendu** : le fichier est signalé comme anomalie, jamais réarchivé sans décision explicite. Un test complémentaire modifie uniquement les métadonnées d'un DNG (réglages non destructifs) et vérifie qu'aucune anomalie n'est signalée (hash image-only inchangé).

## Scénario 4 — Renommage/déplacement détecté par contenu (User Story 4, P4)

```bash
# Renommer un fichier dans la copie de travail (contenu inchangé), puis :
regine reconcile ./fixtures/archive/2026/2026-08-15_Sortie-parc
```

**Résultat attendu** : classé « déplacement », jamais suppression + nouveau fichier. Un second test déplace tout le dossier de travail de `2026/` vers `mariage/` (simulant une recatégorisation, `specs/004-categorisation-dossiers`) et vérifie la même détection au niveau du dossier entier.

## Scénario 5 — Checkout partiel (User Story 6, P6)

```bash
regine checkout ./fixtures/archive/2026/2026-08-15_Sortie-parc --formats jpeg
regine reconcile ./fixtures/archive/2026/2026-08-15_Sortie-parc
```

**Résultat attendu** : seuls les JPEG et la racine sont copiés localement ; la réconciliation qui suit ne signale aucun RAW comme supprimé ou anormal.

## Critères de sortie

Les 5 scénarios doivent passer sans accès réseau réel (fixtures locales). Le verrouillage (research.md § 3) reste une protection de bonne foi entre instances de Régine — ce guide ne teste pas la résistance à une modification externe concurrente hors de Régine, explicitement hors périmètre.