fonzarely/regine-photos-archiver · 04cb3c3

fonzarely/regine-photos-archiverpublic⑂ Fork 0

⑂ 04cb3c3

planche contact

Fabien Champigny committed 2026-09-18T12:16:45+02:00 Browse files

04cb3c3 parent: 3761475

modified docs/interface-cli-gui-architecture.md +21 -0 Viewed

@@ -22,6 +22,27 @@ La GUI n'est pas construite dans l'immédiat, mais deux modes d'usage ont été
22	22
23	23	2. Consultation en lecture seule de l'archive — parcourir l'archive sur le NAS sans passer par un checkout complet, typiquement pour retrouver et restaurer un fichier précis (ex. un RAW supprimé par erreur). Ce mode s'apparente à un navigateur/visualiseur au-dessus de l'archive, avec recherche (dossier, date, texte) et une action de restauration vers un emplacement local — plus léger qu'un aller-retour complet avec manifeste et réconciliation.
24	24
	25	+### 3. Planche-contact JPEG annotée — visualisation statique, indépendante de la GUI interactive
	26	+
	27	+Point de départ (2026-09-18). Besoin exprimé par Fabien : pouvoir visualiser rapidement le contenu d'un dossier — archivé, checké out, ou même un dossier quelconque hors structure Régine — sans lancer d'outil d'édition ni l'interface interactive. Régine génère un unique fichier JPEG représentant une planche-contact du dossier, avec des annotations visuelles superposées sur les vignettes.
	28	+
	29	+Contrairement aux deux modes GUI ci-dessus, cette fonctionnalité produit un fichier statique plutôt qu'une interface : elle n'a donc pas besoin d'attendre que la question GUI (PySide6 vs web) soit tranchée, et pourrait être exposée directement en CLI (ex. `regine contact-sheet <dossier>`), avant même que la GUI existe.
	30	+
	31	+Contenu de la planche : toutes les photos du dossier, de façon exhaustive et récursive — y compris celles qui restent dans leurs sous-dossiers de format (`raw/`, `jpeg/`, `tiff/`) sans être promues à la racine. Ouvrir un dossier dont les photos sélectionnées sont encore en sous-répertoire ne pose pas de problème : la planche-contact montre l'intégralité du dossier, sélection et non-sélection confondues, chaque photo dans son contexte.
	32	+
	33	+Annotations superposées sur chaque vignette :
	34	+- photo sélectionnée / promue à la racine (section 10 des notes d'archivage) → entourée d'un cadre visuel ;
	35	+- notation en étoiles, de 0 à 5 → nombre d'étoiles affiché sur la vignette concernée.
	36	+
	37	+Portée : un dossier simple, ou un dossier parent avec ses sous-dossiers (la planche couvre alors l'ensemble du voyage, pas seulement sa racine).
	38	+
	39	+Statut : fonctionnalité additionnelle, explicitement identifiée par Fabien comme optionnelle — pas forcément dans une première version de Régine. À traiter comme un chantier à part plutôt qu'un prérequis du cœur du produit (import/archivage/intégrité).
	40	+
	41	+Pistes techniques à creuser plus tard :
	42	+- Génération d'image : Pillow (déjà envisagé par ailleurs, cf. `archivage-photo-elements-cles.md`) permet de composer une grille de vignettes et de dessiner cadres/texte par-dessus.
	43	+- Lecture de la notation en étoiles : selon la convention que Régine retiendra pour stocker ce champ — XMP `Rating` est le standard le plus répandu (Lightroom, Bridge, digiKam l'utilisent tous) — à confirmer une fois le schéma de métadonnées de Régine posé (section 3 des notes d'archivage).
	44	+- Vignettes RAW : nécessite une extraction d'aperçu embarqué (rawpy, déjà cité comme dépendance possible plus haut dans ce doc) plutôt qu'un décodage RAW complet, pour rester rapide sur un dossier de plusieurs centaines de photos.
	45	+
25	46	### Options techniques discutées pour la GUI (non tranchées)
26	47
27	48	Le choix d'architecture "import direct en un seul processus" pèse sur l'option technique de la GUI :

 . **Consultation en lecture seule de l'archive** — parcourir l'archive sur le NAS sans passer par un checkout complet, typiquement pour retrouver et restaurer un fichier précis (ex. un RAW supprimé par erreur). Ce mode s'apparente à un navigateur/visualiseur au-dessus de l'archive, avec recherche (dossier, date, texte) et une action de restauration vers un emplacement local — plus léger qu'un aller-retour complet avec manifeste et réconciliation.
++### 3. Planche-contact JPEG annotée — visualisation statique, indépendante de la GUI interactive
++
++Point de départ (2026-09-18). Besoin exprimé par Fabien : pouvoir visualiser rapidement le contenu d'un dossier — archivé, checké out, ou même un dossier quelconque hors structure Régine — sans lancer d'outil d'édition ni l'interface interactive. Régine génère un unique fichier JPEG représentant une planche-contact du dossier, avec des annotations visuelles superposées sur les vignettes.
++
++Contrairement aux deux modes GUI ci-dessus, cette fonctionnalité produit un fichier statique plutôt qu'une interface : elle n'a donc pas besoin d'attendre que la question GUI (PySide6 vs web) soit tranchée, et pourrait être exposée directement en CLI (ex. `regine contact-sheet <dossier>`), avant même que la GUI existe.
++
++**Contenu de la planche** : toutes les photos du dossier, de façon exhaustive et récursive — y compris celles qui restent dans leurs sous-dossiers de format (`raw/`, `jpeg/`, `tiff/`) sans être promues à la racine. Ouvrir un dossier dont les photos sélectionnées sont encore en sous-répertoire ne pose pas de problème : la planche-contact montre l'intégralité du dossier, sélection et non-sélection confondues, chaque photo dans son contexte.
++
++**Annotations superposées sur chaque vignette** :
++- photo sélectionnée / promue à la racine (section 10 des notes d'archivage) → entourée d'un cadre visuel ;
++- notation en étoiles, de 0 à 5 → nombre d'étoiles affiché sur la vignette concernée.
++
++**Portée** : un dossier simple, ou un dossier parent avec ses sous-dossiers (la planche couvre alors l'ensemble du voyage, pas seulement sa racine).
++
++**Statut** : fonctionnalité additionnelle, explicitement identifiée par Fabien comme optionnelle — pas forcément dans une première version de Régine. À traiter comme un chantier à part plutôt qu'un prérequis du cœur du produit (import/archivage/intégrité).
++
++**Pistes techniques à creuser plus tard** :
++- Génération d'image : Pillow (déjà envisagé par ailleurs, cf. `archivage-photo-elements-cles.md`) permet de composer une grille de vignettes et de dessiner cadres/texte par-dessus.
++- Lecture de la notation en étoiles : selon la convention que Régine retiendra pour stocker ce champ — XMP `Rating` est le standard le plus répandu (Lightroom, Bridge, digiKam l'utilisent tous) — à confirmer une fois le schéma de métadonnées de Régine posé (section 3 des notes d'archivage).
++- Vignettes RAW : nécessite une extraction d'aperçu embarqué (rawpy, déjà cité comme dépendance possible plus haut dans ce doc) plutôt qu'un décodage RAW complet, pour rester rapide sur un dossier de plusieurs centaines de photos.
++
  ### Options techniques discutées pour la GUI (non tranchées)
  Le choix d'architecture "import direct en un seul processus" pèse sur l'option technique de la GUI :

modified docs/lexique.md +1 -0 Viewed

@@ -25,6 +25,7 @@ C'est la distinction la plus importante du lexique — deux familles de concepts
25	25	- racine — niveau (du dossier, du sous-dossier, ou du dossier parent) où vivent les fichiers sélectionnés/promus, prêt à être consulté directement sans outil.
26	26	- promotion — action de faire remonter un fichier vers une racine. En deux temps pour un dossier parent : racine du sous-dossier d'abord, puis racine du dossier parent (planche-contact globale).
27	27	- fiche de provenance — enregistrement créé au moment de la copie vers un projet : dossier source, identifiant pérenne du fichier, nom d'origine.
	28	+- planche-contact — terme à trois sens proches, pas encore unifiés en un seul mot (2026-09-18) : (1) niveau de la hiérarchie de sélection, brut → sélection/planche-contact → édition finale ; (2) racine d'un dossier parent, servant de vue d'ensemble sur tout le voyage ; (3) export JPEG généré à la demande, montrant toutes les photos d'un dossier avec cadres (sélection) et étoiles (notation) superposés — cf. `interface-cli-gui-architecture.md` § Planche-contact JPEG annotée.
28	29
29	30	## 3. Fichiers et intégrité
30	31

  - **racine** — niveau (du dossier, du sous-dossier, ou du dossier parent) où vivent les fichiers sélectionnés/promus, prêt à être consulté directement sans outil.
  - **promotion** — action de faire remonter un fichier vers une racine. En deux temps pour un dossier parent : racine du sous-dossier d'abord, puis racine du dossier parent (planche-contact globale).
  - **fiche de provenance** — enregistrement créé au moment de la copie vers un projet : dossier source, identifiant pérenne du fichier, nom d'origine.
++- **planche-contact** — terme à trois sens proches, pas encore unifiés en un seul mot (2026-09-18) : (1) niveau de la hiérarchie de sélection, brut → sélection/planche-contact → édition finale ; (2) racine d'un dossier parent, servant de vue d'ensemble sur tout le voyage ; (3) export JPEG généré à la demande, montrant toutes les photos d'un dossier avec cadres (sélection) et étoiles (notation) superposés — cf. `interface-cli-gui-architecture.md` § Planche-contact JPEG annotée.
  ## 3. Fichiers et intégrité