Aller au contenu principal
CliniOutils

Méthodologie

Un outil médical n'a de valeur que si l'on sait d'où viennent sa formule, ses seuils et son interprétation. Cette page décrit la façon dont chaque outil est construit, vérifié et publié.

Aucun calcul n'est confié à un modèle statistique

Tous les scores sont produits par des fonctions pures et déterministes, écrites une fois, versionnées avec le code et couvertes par des tests unitaires. Aucun modèle de langage n’intervient dans un calcul au moment de l’exécution. Les mêmes entrées produisent toujours exactement le même résultat.

Les cas de référence issus des publications d’origine sont conservés sous forme de tests de non-régression : toute modification involontaire d’une formule ou d’un seuil fait échouer l’intégration continue et bloque la mise en production.

Une source pour chaque formule et chaque seuil

Chaque outil cite la publication d’origine et, lorsqu’elles existent, les études de validation externe et les recommandations qui fixent les seuils. Les références sont accessibles par leur DOI ou leur identifiant PubMed.

Rien n’est inventé. Lorsqu’une donnée manque — une formule dont l’unité d’entrée est ambiguë, un seuil dont la source ne peut être établie, une traduction française non vérifiée — l’outil est marqué comme nécessitant une validation et n’est pas référencé par les moteurs de recherche.

Statuts de publication

Chaque outil porte un statut explicite :

  • DRAFTen cours de rédaction, non accessible publiquement.
  • VALIDATION_REQUIREDfonctionnel, mais un élément de contenu (libellé, seuil, traduction) doit être validé.
  • LICENSE_REVIEWfonctionnel, mais le statut de diffusion du contenu doit être confirmé auprès de l’ayant droit.
  • READYvérifié, en attente de publication.
  • PUBLISHEDvérifié et publié ; seul ce statut est indexable.
  • ARCHIVEDretiré car obsolète ou remplacé ; conservé pour la relecture de dossiers anciens.

Seuls les outils en statut PUBLISHED sont indexables. Les autres restent accessibles et utilisables, mais la page indique clairement ce qui reste à vérifier.

Licences et droits de reproduction

Le texte intégral d’un questionnaire n’est jamais ajouté tant que les droits de reproduction ne sont pas établis. Chaque outil porte un statut de licence :

  • PUBLIC_DOMAINdomaine public ou mis à disposition sans restriction par ses auteurs.
  • OPEN_LICENSEdiffusé sous une licence ouverte permettant la reproduction.
  • PERMISSION_GRANTEDautorisation de reproduction obtenue auprès de l’ayant droit.
  • PROPRIETARYpropriétaire : le contenu n’est pas reproduit, seule une description est fournie.
  • VERIFY_REQUIREDstatut à vérifier : la page reste accessible mais n’est pas indexable tant que la vérification n’a pas eu lieu.

Unités et arrondis

Les conversions d’unités sont centralisées dans un moteur unique : aucune formule ne refait une conversion à la main. Les valeurs sont converties en unité canonique avant tout calcul, ce qui évite les erreurs de facteur entre µmol/L, mg/L’et mg/dL.

L’arrondi est défini outil par outil, conformément à l’usage de la publication d’origine. Aucun arrondi global n’est appliqué : arrondir une clairance rénale et un score de Glasgow de la même façon n’aurait aucun sens.

Valeurs impossibles et valeurs improbables

Deux niveaux de contrôle sont distingués. Une valeur impossible — une taille négative, une créatininémie nulle — bloque le calcul et affiche une erreur. Une valeur improbable mais physiologiquement concevable déclenche un avertissement invitant à vérifier la saisie et l’unité, sans empêcher le calcul.

Signaler une erreur

Chaque page d’outil comporte un bouton de signalement. Les corrections portant sur une formule, un seuil ou une référence sont traitées en priorité. Voir la liste des sources.