POCUSNote

Aide à la rédaction de rapports d’échographie ciblée (POCUS) et abdominale, pensée pour la pratique de l’échographie ciblée en médecine interne générale (médecine de famille, médecine interne, urgences). Outil indépendant, sans lien avec une société savante.

Principes : aucune donnée patient n’est stockée ni transmise (tout se passe dans le navigateur, effacé à la fermeture ou au bouton Réinitialiser) ; un seul fichier HTML sans dépendance externe ; fonctionne en local, hors ligne, ou hébergé sur n’importe quel serveur statique. Interface en français, allemand, anglais et italien.

Fonctions principales

• Modules combinables : FAST/eFAST, plèvre & poumon, cœur (FoCUS), VCI, aorte, vésicule & voies biliaires, reins, vessie, TVP, abdomen (organes pleins), thyroïde (schéma interactif + EU-TIRADS / ACR TI-RADS, ganglions), vaisseaux du cou, artères des membres inférieurs, œil / nerf optique (ONSD), parties molles/MSK. Protocoles rapides (Urgence, Dyspnée, Choc/RUSH, Abdomen, Colique néphrétique, Cou…).
• Saisie tri-état Normal / Anormal / Non évalué, boutons « Tout normal » par région et « Tout l’examen normal », « Modèle vierge », recherche de modules.
• Sondes pré-sélectionnées par protocole rapide (convexe, sectorielle, linéaire selon les modules ; sonde unique si l’appareil est portable) — à désélectionner si non pertinentes.
• Conclusion automatique (FAST/eFAST, négatifs clés, anomalies), calculs (volume vésical & thyroïdien, collapsibilité VCI, seuils aorte, ONSD, scores TI-RADS), alertes de cohérence.
• Schéma thyroïdien interactif : nodules posés au toucher, déplaçables, dessin libre ; inséré dans le PDF et le Word.
• Iconographie : import d’images (traitées localement, jamais téléversées) jointes au PDF/Word.
• Exports sans dépendance : copier (texte brut), e-mail (mailto), PDF, DOCX, impression — paramétrables (en-tête institution, identité, format compact, valeurs de référence, police).
• Logbook local optionnel : compte type d’examen + date sur l’appareil (jamais de données patient), export CSV.
• Partage de configuration par lien (modules + options, sans aucune donnée patient).
• Thème jour/nuit/auto, responsive, installable (PWA, hors ligne).
• Avis / suggestion : bouton global et icône ✎ sur chaque structure qui préparent un e-mail à l’adresse de contact du projet (contact [at] pocusnote.ch) (contexte technique sans aucune donnée patient, formulation actuelle citée, champ « formulation proposée ») ; l’utilisateur relit et envoie lui-même. Grille de relecture terminologique quadrilingue : node tools/extract_terms.js (extraction JSON) — voir dossier relecture.

Utilisation

• En ligne : https://pocusnote.ch (hébergement suisse, aucune donnée transmise).
• Fichier unique : ouvrez dist/pocusnote.html (ordinateur, tablette, smartphone). Copiable sur clé USB ou intranet ; identique à la version en ligne.
• Hébergement : publiez docs/ sur un hébergeur statique. Voir DEPLOIEMENT.md (Cloudflare Pages, Netlify, GitHub Pages, hébergeur suisse, intranet, impressum).
• Installation webapp : Safari iOS → Partager → « Sur l’écran d’accueil » ; Chrome/Edge → « Installer l’application ».

Développement

python3 tools/build.py         # construit dist/ et docs/ à partir de src/
python3 tools/test.py          # tests de bout en bout (modules de base)
python3 tools/test_thy.py      # tests du module thyroïde (schéma, TI-RADS, exports image)

• src/data.fr.js — contenu clinique : modules, protocoles, structures, formulations, base d’appareils. Point d’extension pour de nouvelles structures.
• src/thyroid.js — module thyroïde (schéma interactif, scores).
• src/i18n.js — traductions de l’interface (FR/DE/EN/IT) + mentions légales par langue.
• src/app.js — logique d’interface et génération du rapport.
• src/export.js — presse-papiers, e-mail, PDF et DOCX (avec images) générés sans bibliothèque externe.
• src/style.css — thème jour/nuit/auto, responsive, impression.

Le contenu clinique du rapport est disponible dans les quatre langues (src/data.fr.js, data.de.js, data.en.js, data.it.js) : le formulaire ET le rapport suivent la langue choisie. Toutes les terminologies doivent être relues par des expert·e·s natifs (bandeau « version d'évaluation » actif jusque-là).

Bandeau « version d’évaluation »

Tant que la relecture experte des formulations médicales et des traductions n’a pas été effectuée, un bandeau informatif discret s’affiche dans les quatre langues. Pour le désactiver une fois la relecture faite : dans src/app.js, passer const REVIEW_PENDING = true; à false, puis reconstruire (python3 tools/build.py).

Avertissement

Outil d’aide à la rédaction : tout rapport doit être relu, corrigé et validé par le médecin signataire. Les valeurs de référence et classifications (EU-TIRADS, ACR TI-RADS, ONSD, volumes…) sont indicatives et doivent être vérifiées par un·e utilisateur·rice expert·e avant usage clinique.

Contribuer

Retours, corrections de formulations (FR/DE/EN/IT) et propositions de modules sont bienvenus : voir CONTRIBUTING.md (tickets GitHub ou e-mail). Journal des versions : CHANGELOG.md. Signalement d’un problème de sécurité : SECURITY.md.

Licence

Code : MIT. Contenus : CC BY 4.0. © 2026 Jean-Baptiste Kern. Voir LICENSE et les conditions d’utilisation intégrées à l’application.