01Pourquoi ce vocabulaire change les décisions
Un mot imprécis peut transformer une capacité limitée en promesse trompeuse. Dire qu’un service est « disponible » ne précise pas s’il s’agit d’une page éditoriale, d’une démonstration fictive, d’une application ouverte ou d’un parcours avec compte. Dire qu’une page est « privée » ne précise pas si elle est simplement absente des moteurs ou réellement protégée par un contrôle d’accès.
Ce glossaire définit les termes dans le contexte d’un catalogue d’applications et de livrets numériques. Chaque définition indique aussi ce que le terme ne prouve pas. Les standards cités donnent un sens technique commun ; l’état fonctionnel d’une application reste établi par sa preuve publique propre.
02Découverte et organisation des ressources
| Terme | Définition pratique | À ne pas confondre avec |
|---|
| Répertoire | Liste structurée de références, parfois limitée à un groupe ou à un support | Une validation continue de chaque destination |
| Annuaire Web | Répertoire public dont chaque entrée peut disposer d’une page descriptive et d’un lien | Un compte ou un espace de travail personnalisé |
| Catalogue | Ensemble gouverné de fiches partageant des champs, des statuts et des règles de mise à jour | Une place de marché ou un magasin d’applications |
| Portail | Point d’entrée qui oriente vers plusieurs ressources ou services selon un parcours | Le moteur métier de toutes les destinations |
| Hub | Terme générique pour un point de rassemblement ou de navigation | Une architecture ou une garantie d’interopérabilité précise |
| Favori | URL enregistrée par une personne ou un navigateur pour la retrouver | Une fiche maintenue avec preuve, limite et date |
| Taxonomie | Règles de classement par thèmes, publics, états ou capacités | Une liste de mots-clés ajoutés pour les moteurs |
| Fiche produit | Description factuelle d’une solution, de son public, de ses capacités, limites et destinations | Une promesse que toute fonction décrite est ouverte au public |
03Pages, adresses et continuité Web
| Terme | Définition pratique | Limite ou contrôle associé |
|---|
| URL | Adresse qui identifie une ressource sur le Web | Éviter d’y encoder une donnée privée ou un secret |
| Origine | Combinaison du schéma, de l’hôte et du port utilisée par le modèle de sécurité Web | Deux sous-domaines ne partagent pas automatiquement les mêmes droits |
| Domaine canonique | Hôte public choisi comme référence éditoriale d’un produit | Les anciennes origines doivent être traitées par redirection ou noindex |
| Canonical | Lien HTML indiquant l’URL de référence d’un contenu indexable | Ce n’est ni une redirection ni un contrôle d’accès |
| Redirection | Réponse HTTP invitant le client à demander une autre URL | La cible doit préserver le sens et, si possible, la route profonde |
| Lien profond | Lien vers une fonction ou un contenu précis plutôt que vers l’accueil | Il exige un fallback si la destination ou l’application n’est pas disponible |
| Fallback | Parcours de repli explicite lorsque l’ouverture principale échoue | Il ne doit pas inventer l’état d’installation ou de connexion |
| Rollback | Version précédente conservée pour revenir rapidement après un défaut critique | Ce n’est pas une seconde origine destinée à être indexée |
04Application Web, installation et hors-ligne
| Terme | Définition pratique | Ce que le terme ne garantit pas |
|---|
| Application Web | Service interactif utilisé dans un navigateur | Installation, compte, hors-ligne ou persistance |
| PWA | Application Web pouvant associer manifest, service worker et comportements d’installation | Disponibilité uniforme sur tous les navigateurs |
| Web App Manifest | Document décrivant notamment nom, icônes, démarrage et mode d’affichage | Un fonctionnement hors ligne ou une publication Store |
| Service worker | Script pouvant intercepter des requêtes et gérer des caches dans le périmètre autorisé | La fraîcheur ou l’intégrité du contenu mis en cache |
| Installation Web | Ajout de l’application à un lanceur ou écran d’accueil lorsque le navigateur le permet | Un paquet natif ou une présence dans un Store |
| Shell applicatif | Structure minimale nécessaire pour afficher et lancer l’interface | Les données métier utiles hors connexion |
| Mode hors ligne | Parcours qui reste utilisable sans réseau selon un périmètre testé | Toutes les fonctions, sources ou synchronisations disponibles |
| Mise à jour atomique | Activation cohérente d’une même version des fichiers liés | L’absence de migration ou de rollback |
05Compte, identité et accès
| Terme | Définition pratique | Question à vérifier |
|---|
| Consultation sans compte | Lecture d’un contenu sans création préalable d’une identité applicative | Le contenu est-il public ou accessible par un lien borné ? |
| Compte | Espace durable rattaché à une identité et à des moyens de reconnexion | Inscription, récupération, suppression et portabilité sont-elles ouvertes ? |
| Session | État temporaire reliant des requêtes à un contexte d’usage | Sa durée, sa révocation et son stockage sont-ils définis ? |
| Authentification | Vérification de l’identité déclarée | Quel fournisseur, quelle preuve et quel comportement d’échec ? |
| Autorisation | Décision sur les actions permises à une identité ou un rôle | Est-elle contrôlée côté service, pas seulement masquée dans l’interface ? |
| Rôle | Ensemble nommé de responsabilités et droits | Le rôle public correspond-il à un parcours réellement qualifié ? |
| Référence opaque | Valeur qui ne révèle pas directement le contenu ou l’identité qu’elle désigne | Expiration, révocation et contrôle côté service restent nécessaires |
| Consentement | Choix spécifique, informé et démontrable lorsqu’il constitue la base attendue | Une simple ouverture ou une case précochée ne vaut pas toujours accord |
06Livret, conservation et données de séjour
| Terme | Définition pratique | Frontière utile |
|---|
| Livret numérique | Ensemble d’informations destiné à accompagner une situation ou un séjour | Le guide public explique le concept sans héberger le contenu privé |
| Émetteur | Acteur qui choisit le contenu, son public et sa mise à jour | Il doit rester identifiable par le lecteur |
| Lecteur autorisé | Personne ou contexte auquel le service peut délivrer le contenu | La possession d’une URL ne suffit pas nécessairement |
| Conservation facultative | Action distincte pour garder une référence ou une information au-delà de la consultation | Elle ne doit pas être déduite de l’ouverture du livret |
| Expiration | Fin programmée de la validité d’un accès ou d’une référence | Le service doit la vérifier au moment pertinent |
| Révocation | Invalidation anticipée d’un accès encore théoriquement valide | Les caches et actifs associés doivent suivre la décision |
| Donnée de séjour | Information rattachable à un hébergement, une période, une réservation ou un lecteur | Elle reste hors du site-guide, de ses URLs et de son analytics |
| Minimisation | Limiter les données aux éléments adéquats, pertinents et nécessaires à la finalité | Une donnée pseudonymisée peut toujours rester personnelle |
07Publication, recherche et cache
| Terme | Définition pratique | Erreur fréquente |
|---|
| Indexable | Page éditoriale autorisée à apparaître dans les moteurs selon sa qualité et sa politique robots | Croire qu’indexable signifie exact ou à jour |
| noindex | Directive demandant aux moteurs de ne pas indexer une réponse | L’utiliser comme substitut à un contrôle d’accès |
| robots.txt | Fichier exprimant des règles d’exploration pour les robots coopératifs | Y lister des chemins sensibles en pensant les cacher |
| Sitemap | Liste structurée des URLs publiques à découvrir | Y inclure une démo, une erreur ou un contenu privé |
| Cache public | Réponse réutilisable par un cache partagé selon ses directives | Y placer une réponse personnalisée |
| Cache privé | Réponse réutilisable seulement dans le contexte privé prévu | Oublier la déconnexion, la révocation ou le changement de profil |
| ETag | Validateur permettant de demander si une représentation a changé | Le confondre avec un hash d’intégrité ou une version métier |
| Fraîcheur | Période durant laquelle une information reste utilisable sans nouvelle validation | Appliquer le même TTL aux actifs immuables et aux statuts changeants |
08Preuve, statut et langage honnête
| Terme | Sens dans le réseau DOHM | Ce qui est requis |
|---|
| Destination vérifiée | URL réelle contrôlée pour le parcours annoncé | Date, réponse publique et nature exacte des données |
| Démo publique | Parcours accessible utilisant des données fictives ou isolées | Mention visible et absence de confusion avec un compte réel |
| Capacité publique | Fonction utilisable par le profil prévu sur la cible canonique | Preuve distante fraîche du Codex propriétaire |
| Validée localement | Fonction vérifiée dans un candidat non encore ouvert au public | Ne pas la présenter comme disponible |
| Vision | Direction ou capacité future explicitement séparée de l’existant | Aucun CTA actif ni promesse au présent |
| Source canonique | Référentiel désigné pour un fait, une URL ou une promesse | Version, date et propriétaire identifiables |
| Date de révision | Date à laquelle le contenu et ses sources ont été relus | Elle ne remplace pas la date propre d’une donnée instable |
| Correction éditoriale | Modification traçable d’un contenu devenu faux, ambigu ou obsolète | Propagation aux pages transverses utilisant le même fait |
09Cinq confusions à résoudre en pratique
- Si une page est annoncée privée, vérifier d’abord le contrôle d’accès ; noindex et robots ne viennent qu’en complément.
- Si une PWA est annoncée installable, vérifier le manifest et le parcours du navigateur ; ne pas en déduire un paquet Store.
- Si un lien ouvre une démo, nommer les données fictives et ne pas afficher un CTA d’inscription sans compte réel.
- Si un livret est consultable sans compte, séparer cette lecture d’une conservation facultative future.
- Si un produit change de nom ou de domaine, choisir un canonical unique, rediriger les anciennes routes et conserver un rollback.
10Comment lire une fiche My DOHM
Commencer par la promesse et le public, puis lire l’état et la limite avant de suivre un bouton. Le site-guide est la destination éditoriale ; un bouton « tester » doit viser une démonstration qualifiée, un bouton « ouvrir » une application publique et un bouton « installer » une PWA réellement installable. L’absence d’un bouton signifie qu’aucune destination correspondante n’est actuellement prouvée.
Le catalogue My DOHM n’unifie pas les données des applications. Une fiche transversale résume un produit à partir du registre commun mais ne remplace pas le guide spécialisé ni la preuve applicative. En cas de divergence, la correction doit partir du référentiel canonique et se propager sans créer deux versions indexables du même contenu.