Menu

Bibliothèque de référence · catalogues, portails et livrets numériques

Guides My DOHM : comprendre, concevoir et maintenir un portail d’applications fiable

Une bibliothèque indépendante de l’application pour documenter les catalogues numériques, les liens profonds, la PWA, l’accessibilité, la confidentialité, les formats et la gouvernance éditoriale.

Ce que couvre cette bibliothèque

Un portail d’applications ne se résume pas à une grille de logos. Il doit expliquer ce qui est référencé, distinguer site, démonstration, application, installation et compte, puis maintenir chaque destination pendant les changements de version ou de domaine. Cette bibliothèque réunit les méthodes nécessaires pour le faire sans transformer le portail en autorité métier.

Les dossiers sont organisés par intentions de travail : définir les rôles, structurer l’information, publier un registre, protéger les liens, vérifier les destinations, gérer les changements et documenter les limites d’une PWA. Ils peuvent être utilisés séparément et ne supposent pas l’usage de My DOHM.

Comprendre le domaine

L’histoire et le glossaire expliquent comment annuaire, catalogue, portail, lanceur et livret se distinguent. Le dossier sur les acteurs attribue ensuite les décisions : le produit prouve sa capacité, le catalogue publie le statut, l’hébergeur sert la ressource et le lecteur choisit l’action.

Cette séparation évite deux erreurs fréquentes : présenter un lien comme une preuve fonctionnelle et laisser croire qu’un catalogue détient les comptes ou les données des services qu’il référence.

Lire l’histoire des catalogues

Concevoir une navigation réellement utilisable

Une taxonomie utile part des besoins, pas de l’organigramme de l’éditeur. La navigation doit rester prévisible au clavier, sur écran étroit et avec un lecteur d’écran. Les états indisponible, démonstration ou compte requis sont portés par du texte, pas uniquement par une couleur ou une icône.

Le dossier consacré à la taxonomie explique comment gouverner catégories, synonymes et facettes sans profiler les visiteurs. Le dossier d’accessibilité fournit ensuite une procédure de classement, des tests de compréhension et des exemples de libellés.

Construire la taxonomie du catalogue

Décrire les produits et leurs destinations

Le registre de produits décrit des faits versionnés : identifiant, nom public, promesse bornée, statut et destinations typées. JSON structure l’échange ; HTTP porte les réponses, la fraîcheur et les erreurs ; les liens conservent une relation explicite. Aucun format ne remplace la validation humaine d’une promesse.

Le cycle de vie explique comment une fiche naît, devient publiable, expire, change de domaine ou revient à une version précédente. Les exemples restent génériques et n’inventent aucune capacité applicative.

Structurer un registre versionné

Protéger les parcours entre sites et applications

Un lien profond peut transporter une intention publique, mais pas une donnée de foyer, de séjour, de santé ou d’identité. Le dossier consacré aux liens profonds distingue paramètres publics, jetons opaques, confirmation, expiration et repli. Il traite aussi les risques de redirection ouverte, de journalisation et de partage involontaire par le Referer.

L’interopérabilité est abordée séparément : partager une identité facultative ou une intention bornée ne signifie ni fusionner les comptes, ni déplacer les données métier, ni étendre les droits.

Sécuriser les liens profonds

Maintenir, corriger et revenir en arrière

Une destination publique vieillit. La maintenance doit donc vérifier la réponse, le contenu attendu, le profil autorisé et la date de preuve, puis masquer le CTA si l’état devient inconnu. Une migration conserve une origine de retour et évite deux versions indexables concurrentes.

La politique de correction documente la source, la décision éditoriale, le changement et la date. Le lecteur peut signaler une erreur sans transmettre le contenu privé auquel une fiche pourrait conduire.

Vérifier et maintenir les fiches

Comment utiliser les dossiers

Commencez par le guide correspondant à votre décision immédiate, appliquez sa checklist, puis conservez le résultat vérifiable : URL, type de destination, date, statut et source. Pour une refonte de catalogue, l’ordre recommandé est rôles, taxonomie, registre, liens, accessibilité, maintenance puis procédure de rollback.

Les sources sont consultées le 9 septembre 2026. Les normes citées décrivent des mécanismes techniques ; elles ne certifient ni un produit particulier, ni une conformité juridique individuelle. Une évolution d’un standard ou d’une recommandation déclenche une révision éditoriale avant modification du contenu publié.

Sources

Éditeur : DOHM — Digital Operations Hub & Modules · informations revues le . Signaler une correction.