Documentation utilisateur de Noviscan — index

Pour qui : la personne qui cherche par où entrer dans la documentation de Noviscan — futur utilisateur, utilisateur en place, ou personne qui l'exploite pour d'autres. Suppose acquis : rien.

English version: en/README.md

Ceci n'est pas de la documentation interne. Ces pages s'adressent à qui utilise Noviscan, jamais à qui le développe : le reste de docs/ parle aux agents et aux développeurs, ce répertoire parle au client. Les deux publics ne se mélangent pas dans un même arbre, c'est la seule raison pour laquelle ce répertoire existe plutôt que docs/fr/ et docs/en/.

Ce que « conforme » exige, et les trois familles : elles vivent dans DEV-Documentation/createurs/documenter-son-application.md, sections « Ce que le contrat appelle "Documentation" » et « Ce que "conforme" veut dire ». Elles ne se recopient pas ici.

L'ordre de rédaction et ce qui existe déjà : ../USER_DOC_PLAN.md.

J'écris le Markdown ; Sites web publie. L'emplacement public, la navigation et le rendu PDF leur appartiennent — ce répertoire est la source, pas la surface.

Se repérer dans l'interface

Les pages qui suivent nomment des écrans. Voici où ils se trouvent, rassemblés en un seul endroit.

⚠️ Cette page n'est plus la SEULE à le dire, et c'est délibéré depuis le 2026-09-03. Une lecture tierce a montré qu'un lecteur pris au milieu d'un geste ne remonte pas à l'index : il lui faut l'emplacement là où il agit. Les pages situent donc les écrans qu'elles font ouvrir. Les deux endroits doivent bouger ensemble — c'est la même répétition assumée que les durées de rétention, et elle a la même dette : le jour où la barre latérale change, ce tableau ne suffit pas.

Les emplacements, une fois pour toutes :

La barre de gauche, toujours visible : Tableau de bord · Révision · Alertes · Personnes · Groupes · Sources · Paramètres.

La page Sources est intitulée Sources et maintenance : c'est le même écran.

Les onglets de Paramètres : Général et Sécurité pour tout le monde ; Utilisateurs, Licence, Journaux, Activité, Sauvegarde et Avancé pour les comptes administrateur seulement ; Mentions légales pour tout le monde. Un onglet qui n'apparaît pas chez vous n'est pas caché par erreur : votre compte n'a pas le rôle.

En haut à droite, hors de la barre de gauche : le bouton Assistance, lui aussi réservé aux comptes administrateur.

Votre version — chaque page dit à partir de quelle version elle vaut ; la vôtre se lit dans Paramètres → Général, section À propos, ligne « Version : ».

État des trois familles

Passe de défauts du 2026-08-30 (Produit). Les six pages ont été lues par un lecteur qui ne connaissait pas le produit, sur cinq classes de défaut (savoir présupposé, trou d'enchaînement, commande incollable, divergence fr/en, affirmation invérifiable) ; ce qui en est sorti a été tranché contre le code, jamais contre un souvenir. Deux classes entières sont closes : les écrans nommés sans dire où ils sont, et les gestes sans critère de réussite. ⚠️ Ce n'est PAS la relecture par un tiers que la colonne « État » réclame : un lecteur mandaté par l'auteur reste l'auteur. Et aucun parcours n'avait alors été refait sur une machine — ni l'installation sur VM vierge, ni la page téléphone sur un appareil réel. ⚠️ Le premier membre est TOMBÉ le 2026-09-03 : l'installation Windows a été jouée sur banc, et ce qu'elle a trouvé est plus bas, avec sa portée déclarée. La page téléphone, elle, n'a toujours pas été refaite sur un appareil réel.

Plateformes sans document — déclaration

Les trois familles ci-dessus ne couvrent que Windows. Pour les autres plateformes, voici ce que le dépôt permet d'établir — aucune date, aucun engagement :

Établi en lisant : packaging/ (ne contient que windows/), .github/workflows/build-desktop-windows.yml (runs-on: windows-latest, sans matrice d'OS), scripts/ (aucun build-linux ni build-macos), mobile/PISTE_PLAY.json et mobile/eas.json (submit.production vide). Les pipelines correspondants relèvent de la conception, pas du présent : ../RELEASE_PLAN.md.

✅ Les trois familles existent désormais — c'est le point 1 du maître, et lui seul.

✅ RELECTURE DE CONFORMITÉ RENDUE le 2026-08-17 par le périmètre Documentation, propriétaire du maître : sept points conformes, un écart, plus deux réserves. Verdict point par point, avec son mode de preuve : %LOCALAPPDATA%\Secufor\coordination\VERDICT-CONFORMITE-DOC-NOVISCAN-2026-08-17.md. Sept des huit points ne s'auto-attestent pas — ils sont écrits pour être vérifiés par quelqu'un qui ne connaît pas le produit, ce qui exclut l'auteur des pages, et c'est pourquoi ce constat vient d'ailleurs.

• L'écart (point 2) est CORRIGÉ par le présent commit : le bloc « Pour qui / Suppose acquis » manquait aux deux index, alors qu'il figure en tête des six pages de contenu. Le point dit « chaque page », et l'index est la première page lue.
• Réserve 1 — le point 4 est conforme par VACUITÉ : il n'y a aucune capture d'écran, donc aucune ne peut fuir. Vert sincère et vide, à savoir avant de publier.
• ✅ Réserve 2 — CORRIGÉE le 2026-08-30 (Produit). Le point 6 était conforme à la lettre et faux à l'envers : la page d'installation portait « À VENIR » et parlait du fichier au FUTUR (« s'appellera », « sera publiée ») alors que le canal existe. Elle sépare désormais ce qui n'est pas ouvert — l'annonce — de ce qui l'est : le canal. La décision D-058 n'est pas touchée : la page ne donne toujours aucun lien. Ce qui existe ne se décrit pas au futur ; c'est la même règle que le point 6, prise dans l'autre sens.

⚠️ Et l'installation Windows pose un manque d'une AUTRE nature, qui ne se comble pas en écrivant :

• ~~Elle n'a jamais été suivie par personne.~~ Jouée le 2026-09-03 — verdict, mesures et portée ci-dessous. Le banc fige l'ordre d'arrivée, et une étape qui manque ne se voit qu'en la suivant — celle qui manquait était une CASE.
• Sa section « Obtenir l'installeur » ne contient aucune étape à suivre : le téléchargement Windows n'est pas ANNONCÉ (D-058). Elle porte donc une marque « pas encore annoncé » plutôt qu'un lien — une fonction annoncée se marque comme telle, ou ne figure pas.

⚠️ Ces deux points se lisaient ensemble — « on ne peut pas éprouver la page tant que le fichier n'est pas téléchargeable ; l'épreuve n'attend pas un créneau, elle attend un canal ». Le second membre est TOMBÉ (mesuré le 2026-08-16 : la release desktop-0.1.1-… est publiée sur Secufor/noviscan, dépôt public, et ses trois assets sont servis sans authentification ; l'empreinte de l'installeur servi a été recalculée et concorde ; trois versions publiées au 2026-08-30, énumérées à la source — leurs numéros ne se recopient pas ici, ils se lisent aux releases du dépôt public). Le canal existe. Ce qui reste, c'est de ne pas l'ANNONCER, ce qui est une décision (D-058) et non une impossibilité.

Conséquence pour ce corpus : l'épreuve sur VM vierge n'est plus bloquée par le canal — elle attend un banc allumé, ce qui est un tout autre obstacle. Une attente justifiée par un fait faux se prolonge indéfiniment, parce que le fait ne change jamais.

✅ L'ÉPREUVE SUR BANC EST JOUÉE, le 2026-09-03 — et la page était fausse sur le point le plus lourd de sa section « Installer ». Elle annonçait trois cases à cocher : l'installeur en offre quatre, et la quatrième est « Autoriser Noviscan à accéder à Internet (mises à jour, licence en ligne) ». Décochée par défaut comme les trois autres — donc un lecteur suivant la page à la lettre installait un produit hors ligne sans jamais lire qu'il venait de le décider. La case existe bien dans la version décrite : vérifié dans packaging/windows/noviscan.iss au commit de la release publiée (30d789a), pas seulement sur main. Corrigé le jour même, fr et en, avec les libellés EXACTS de l'assistant plutôt que des paraphrases.

Ce que l'épreuve a mesuré, sur la release publiée du 2026-08-23 (30d789a) téléchargée du dépôt public, installée sur le banc Windows 11 (build 26200) après table rase :

⚠️ Portée déclarée, et elle n'est pas mince :

• Le banc n'est pas une machine VIERGE, c'est une machine remise à plat. La VM est chiffrée et son instantané ne se restaure pas sans mot de passe : la table rase (désinstallation, effacement de %LOCALAPPDATA%\Noviscan et des restes) approche l'état neuf, elle ne l'établit pas.
• Conséquence directe : « l'installeur pose WebView2 s'il manque » n'est pas mesuré — le banc le porte déjà, et install-report.json l'écrit lui-même (webview2: deja-present).
• Le téléchargement n'a pas été joué depuis le banc : la VM n'a pas de résolution DNS. L'installeur y a été copié depuis le poste, après avoir été tiré du dépôt public. La section « Obtenir l'installeur » reste donc non éprouvée, ce qui est cohérent : elle ne donne aucun lien (D-058).
• L'assistant n'a pas été piloté à l'écran ce jour-là (cette épreuve est venue le lendemain, plus bas) : les quatre cases sont mesurées par leur effet en installation silencieuse, qui applique les mêmes défauts. Ce que le lecteur VOIT restait à constater ; ce que l'installeur FAIT quand on ne coche rien est établi.
• ✅ Le premier lancement A été joué — et il a ÉCHOUÉ, c'est ainsi qu'un défaut bloquant a été trouvé. Ce qui est ÉTABLI : la fenêtre d'emplacement des données s'ouvre bien avant l'assistant, comme la page l'annonce, et son texte est celui qui est décrit (relevé à l'écran, dialogue répondu par BM_CLICK). Ce qui a ÉCHOUÉ : après « Oui », aucune fenêtre ne s'ouvrait — le processus mourait en tentant de télécharger ses modèles de reconnaissance sur une machine sans réseau. Corrigé le jour même dans le produit ; le défaut n'appartenait pas à la page, mais seule la page suivie à la lettre pouvait le rencontrer.
• ✅ Le correctif est ÉPROUVÉ SUR L'ARTEFACT, le 2026-09-04 — pas sur les sources : le défaut a été mesuré sur le binaire livré, sa correction devait l'être aussi. Build signé 96a8941 installé sur le même banc hors ligne, mêmes conditions : dialogue d'emplacement à t+12 s, « Oui », fenêtre ouverte à t+18 s (1180×820, processus vivant, API prête) là où la release publiée ne rendait rien. Les deux gardes se lisent au journal de l'application : le refus de sortie au démarrage, puis celui du moteur — deux sites, deux traces.
• ✅ Et l'assistant S'AFFICHE : sa première étape est à l'écran, en français, et la case porte exactement le libellé que la page annonce — « J'ai lu et j'accepte le contrat de licence utilisateur. », décochée, avec ses boutons « Télécharger le texte » et « Copier le texte ». La fenêtre ne déborde pas de l'écran.
• ✅ Les trois premiers écrans de l'assistant sont ÉPROUVÉS, pilotés à l'écran et non regardés (2026-09-04). La page est exacte sur tout ce qui a pu être mesuré :
  • 1. Conditions d'utilisation — le bouton « Continuer » rend IsEnabled = False avant la coche et True après : la prétention la plus fragile de la page, celle qu'elle donne pour le seul signe, est la seule qu'une capture ne pouvait pas trancher — une image montre un bouton, elle ne dit pas s'il répond. Le clic fait bien apparaître Emplacements.
  • 2. Emplacements — le champ Données porte à l'écran « non modifiable ici », les deux autres sont saisissables, comme la page l'annonce.
  • 3. Comment utiliser cet appareil — les trois voies existent avec les libellés exacts du tableau de la page, et l'avertissement d'exclusivité est affiché dans l'application, pas seulement dans la doc.
• ⛔ Le parcours s'ARRÊTE là, et c'est une borne, pas un oubli : l'étape suivante crée un compte et demande un mot de passe. Créer un compte et saisir un mot de passe n'est pas de mon ressort. Restent donc non éprouvés : le compte propriétaire (§4), l'amélioration du produit (§5, la case décochée par défaut), le Terminer, et les deux voies d'appairage. Une personne peut les jouer en dix minutes sur ce banc — une lacune déclarée est un livrable, un blocage n'en est pas un.
• ⚠️ Et une chose que ce banc ne pourra jamais établir : que le texte reste en français « quelle que soit la langue de votre Windows ». Ce Windows-là est en français. Un contrôle dont l'entrée vaut déjà la sortie attendue ne mesure rien.

La règle qui décide du contenu de chaque page

On documente la version PUBLIÉE, jamais main. Chaque page porte « Vaut à partir de la version », et ce numéro est celui de la dernière release publiée au dépôt public — pas celui du dépôt de travail. Le maître interdit de décrire au présent ce qui n'existe pas encore, et ce qu'un utilisateur exécute est l'installeur publié, jamais une branche fusionnée.

Conséquence assumée : ces pages décrivent moins que ce que le dépôt sait faire, et elles se mettent à jour à chaque release, pas à chaque fusion.