docs(app): U1 owner trial, plan and tests pointers

U1 demo and known limits in the owner trial guide, tooling moved to U6 in
the plan and tests, TODO lots A-H, AC19 and AC20 evidence.
This commit is contained in:
bchanot committed 2026-11-08 21:42:27 +01:00
1 parent 606f7ba268
commit 81fba4631a
5 files changed
+86 -34

No files matched your search

+62 -15
View File
@@ -110,8 +110,8 @@ Chaque étape donne l'action et le résultat attendu. Notez tout écart avec la
1. Administration, « Nouvelle fiche ». Choisissez une espèce autre que le cheval (une espèce inactive est
acceptée), renseignez « Nom (français) », « Nom (anglais) » et l'identifiant (slug, par exemple `essai-chien`),
« Créer la fiche ».
2. Attendu : la création ouvre directement le brouillon vide dans l'éditeur, sans page intermédiaire (onglets Général, Vues et
illustrations, Annotations, Constats, Références, Vertèbres, Vérification). Une fiche neuve et vide s'ouvre
2. Attendu : la création ouvre directement le brouillon vide dans l'éditeur, sans page intermédiaire, avec
quatre onglets (Général, Annotations, Constats, Vérification). Une fiche neuve et vide s'ouvre
sur l'onglet « Général ».
3. Dans « Général », tapez des espaces autour d'un nom (par exemple ` Essai `) et validez. Attendu : les espaces
du début et de la fin sont retirés des noms et des libellés courts de l'éditeur ; les descriptions, notes,
@@ -133,8 +133,9 @@ cat > ~/essai-svg/hostile.svg <<'SVG'
SVG
```
1. Onglet « Vues et illustrations », vue principale, « Choisir une illustration », fichier `valide.svg`.
Attendu : « L'illustration est ajoutée à la vue. » et le dessin s'affiche.
1. Onglet « Annotations », carte « Vues », « Gérer les vues » (section « Vues », avec « Retour au dessin » en
tête), vue principale, « Choisir une illustration », fichier `valide.svg`.
Attendu : « L'illustration est ajoutée à la vue. » et le dessin s'affiche (visible après « Retour au dessin »).
2. Même geste avec `nettoyable.svg`. Attendu : la boîte « Nettoyer cette illustration ? » avec l'aperçu du dessin
nettoyé et la mention que l'élément `<style>` est retiré. « Nettoyer et utiliser cette version » applique,
« Annuler » n'ajoute rien.
@@ -142,30 +143,34 @@ SVG
aucune boîte de nettoyage, aucune illustration ajoutée.
### 4.3 Créer des annotations
1. Onglet « Général », bloc « Nouvelle catégorie » : renseignez les noms, puis « Ajouter la catégorie ». Sans
catégorie, l'onglet Annotations le signale quand vous y passez : « Créez d'abord une catégorie d'annotation
(onglet Général). »
1. Onglet « Annotations », carte « Catégories », « Modifier les catégories » (section « Catégories »), bloc
« Nouvelle catégorie » : renseignez les noms, puis « Ajouter la catégorie », puis « Retour au dessin ». Sans
catégorie, la création d'une annotation le signale : « Créez d'abord une catégorie d'annotation (Annotations,
section Catégories). »
2. Onglet « Annotations », outil « Point » : cliquez dans le dessin, renseignez les noms FR et EN, la catégorie, la
latéralité, « Créer ». Attendu : le point apparaît dans la liste et sur le dessin.
3. Outil « Zone » : posez au moins trois sommets, Entrée ou « Fermer le tracé ». Attendu : la zone est créée.
4. Ajoutez une vue de détail (onglet « Vues et illustrations », formulaire « Nouvelle vue de détail », bouton
« Ajouter la vue » ; le recadrage est facultatif), puis l'outil « Accès à
4. Ajoutez une vue de détail (onglet « Annotations », « Gérer les vues », formulaire « Nouvelle vue de détail »,
bouton « Ajouter la vue » ; le recadrage est facultatif ; puis « Retour au dessin »), puis l'outil « Accès à
une vue détaillée » : tracez un contour et choisissez la « Vue ouverte ». Attendu : l'accès est créé.
5. « Annuler » et « Rétablir » (barre d'outils de l'onglet Annotations) défont et refont chaque création. Ne les confondez pas avec
« Annuler les modifications » (en-tête), qui abandonne tout ce qui n'est pas enregistré.
5. « Annuler » et « Rétablir » (à droite de la rangée d'onglets, sur chaque onglet ; nom accessible « Annuler la
dernière modification ») défont et refont chaque création. Ne les confondez pas avec « Abandonner les
modifications » (en-tête), qui abandonne tout ce qui n'est pas enregistré et reprend la dernière révision
du serveur, après confirmation.
### 4.3 bis Utiliser l'illustration de la vue parente
Cette étape suppose une vue de détail qui a un recadrage (quatre valeurs) et sa propre illustration : ajoutez-la
dans « Vues et illustrations » avec un recadrage, puis « Choisir une illustration » avec `valide.svg`. Placez
une annotation sur cette vue (onglet Annotations).
1. Retour dans « Vues et illustrations », sur cette vue : « Utiliser l'illustration de la vue parente ».
dans « Gérer les vues » (onglet Annotations) avec un recadrage, puis « Choisir une illustration » avec
`valide.svg`. Placez une annotation sur cette vue (« Retour au dessin »).
1. Retour dans « Gérer les vues », sur cette vue : « Utiliser l'illustration de la vue parente ».
Attendu : la boîte « Utiliser l'illustration de la vue parente ? » qui précise que la vue affichera
l'illustration de la vue parente à travers son recadrage, que son propre fichier reste enregistré, que le
changement s'annule, et que ses annotations repassent « à confirmer ». Boutons « Annuler » et « Utiliser
l'illustration parente ».
2. « Annuler » ne change rien. Recommencez et confirmez. Attendu : « Utilise l'illustration de la vue parente. »
et l'annotation de la vue marquée « À confirmer ».
3. Dans l'onglet Annotations, « Annuler » (barre d'outils) restaure l'illustration propre de la vue.
3. « Annuler » (à droite de la rangée d'onglets), depuis n'importe quel onglet, restaure l'illustration propre de
la vue.
### 4.3 ter Catégories de constats
1. Onglet « Constats » : « Ajouter une zone », renseignez les noms, « Créer ».
@@ -228,6 +233,29 @@ une annotation sur cette vue (onglet Annotations).
si un autre compte se connecte dans l'onglet, les copies des autres comptes sont supprimées sans lui être
montrées.
### 4.9 Démonstration U1 : la nouvelle coque de l'éditeur
À dérouler sur la fiche non équine de 4.1, après les étapes 4.2 et 4.3 (il faut au moins une annotation et un
constat avec une référence). La fiche de démonstration n'est pas créée par la commande d'essai : c'est celle que
vous avez créée dans l'interface.
1. Les quatre onglets : « Général », « Annotations », « Constats », « Vérification ». Passez de l'un à l'autre à
la souris, puis au clavier (flèches gauche et droite dans la rangée d'onglets). Revenez sur un onglet : ce que
vous y aviez saisi et sélectionné est resté.
2. Dans « Général », modifiez un nom sans enregistrer. Passez sur « Annotations » et cliquez « Annuler » à droite
de la rangée d'onglets. Attendu : le nom d'origine revient dans « Général » ; « Rétablir » le remet. Un champ en
cours de saisie est validé avant l'annulation, donc sa saisie est la dernière modification annulée.
3. Références : le bouton « Références » de l'en-tête ouvre un panneau latéral (non modal) avec un filtre par nom.
Dans « Constats », sélectionnez un constat qui cite une référence : le bouton « n référence(s) » ouvre le même
panneau limité à « Citées par « … » (n) », avec « Tout afficher (n) » pour revenir à la liste entière.
« Fermer les références » ou Échap ferme le panneau et rend le focus au bouton qui l'a ouvert.
4. Dans « Annotations », la carte « Vues » propose « Gérer les vues », la carte « Catégories » « Modifier les
catégories », et une entrée « Régions vertébrales (n régions) » est toujours là. Chacun ouvre sa section pleine largeur avec
« Retour au dessin » en tête. Une saisie commencée dans une section reste là quand vous revenez au dessin puis
rouvrez la section.
5. Redimensionnez la fenêtre à 1 180 px de large. Attendu : le menu latéral de l'application disparaît dans
l'éditeur (il revient dès 1 280 px) et s'ouvre en un geste par « Ouvrir le menu » ; le dessin gagne la place
libérée. Sous 1 024 px l'éditeur passe en lecture seule (voir les limites) ; en dessous de 640 px, deux
onglets restent visibles et « Plus » ouvre les deux autres.
## 5. Limites à connaître
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention `aal2` du jeton, pas la session vivante.
Un jeton émis à `aal2` reste accepté après la suppression du facteur, jusqu'à son expiration (une heure).
@@ -247,6 +275,25 @@ une annotation sur cette vue (onglet Annotations).
(proposée, pas développée). Ce cas ne s'obtient pas depuis une
fiche construite avec ce guide : il n'a pas d'étape et n'est couvert que par les tests automatiques.
### Limites connues de U1
- Une décision en attente sur une vue (nettoyage de l'illustration, réparation des annotations, retour à
l'illustration parente) n'est pas perdue par un simple changement d'onglet, de section ou l'ouverture du panneau
des références : elle est retenue, signalée par une ligne « … attend votre décision » avec « Reprendre », et ne
se rouvre que par ce bouton. Elle est perdue quand sa vue disparaît (annulation, abandon des modifications,
rechargement, suppression de la vue), et « Rétablir » ne la ramène pas.
- Une décision en attente au moment d'une soumission reste affichée comme ligne en attente, sans bouton d'action,
tant que le brouillon est gelé.
- Une offre de copie locale peut devenir en attente en cours de session (après une soumission suivie d'une
relecture, ou un changement de droits puis d'édition). Les parties d'édition déjà ouvertes restent montées et
masquées : rien n'est perdu, vous choisissez « Restaurer la copie » ou « Ignorer la copie », et les brouillons
conservés restent après l'un ou l'autre.
- Sous 1 024 px de large, l'éditeur est en lecture seule : les valeurs saisies sont conservées et l'édition revient
quand la fenêtre s'élargit de nouveau.
- Tant que le panneau des références est ouvert, le contenu des onglets n'est pas atteignable au clavier (il est
inerte sous le voile) : on parcourt d'abord le panneau, le contenu après sa fermeture.
- « Gérer les vues », « Modifier les catégories » et « Régions vertébrales » ouvrent les éditeurs existants en
section pleine largeur ; U3, U4 et U6 les remplacent.
## Repli facultatif : tunnel SSH
Le réseau local suffit normalement. Hors de ce réseau, ou si l'essai tourne en `FAUNOSTEO_TRIAL_HOST=127.0.0.1`,
ouvrez un tunnel depuis l'autre ordinateur :