Ouch, Understand, Chart, Heal
maxauvy.github.io/OUCH · Licence CeCILL v2.1 · Français et anglais · Changelog · English version
OUCH est un carnet de douleur pour la fibromyalgie et les autres douleurs chroniques. On y note sa journée en moins d'une minute, tout reste sur son téléphone, et c'est toujours soi qui décide de ce qu'on partage, et avec qui.
Les carnets de suivi existants (Pain Diary, MyPainDiary…) sont fermés, ou pénibles à utiliser les jours où l'on n'en peut plus. OUCH fait le choix inverse : de gros boutons, presque rien à remplir, et aucune donnée qui quitte l'appareil sans que la personne l'ait décidé.
Suivre, en moins d'une minute. Seule la douleur suffit pour qu'une journée compte ; le reste (sommeil, zones douloureuses, traitements, météo) est facultatif, et les jours les plus durs l'écran s'allège. Installée sur l'écran d'accueil, l'app s'ouvre en un geste et marche sans réseau. Pas de compte : le journal reste sur le téléphone.
Comprendre, sans rien promettre. Les notes finissent par raconter des choses : ce qui précède une poussée, ce qui revient les bons jours. OUCH montre des rapprochements, jamais des causes : la personne garde ce qui lui parle et écarte le reste. Elle arrive en consultation avec un rapport qui dit ce qui s'est passé, au lieu de chercher dans sa mémoire.
Soulager, par les gestes qui vont bien. On note ce qui a aidé (une marche courte, un bain chaud, des étirements…). On peut essayer une de ces actions pendant une semaine et mettre côte à côte les jours avec et sans. Quand une poussée se termine, l'app dit en combien de jours la douleur est revenue à son niveau habituel. Un écran « Un moment pour souffler » propose, hors ligne, une respiration lente et deux courts exercices de détente, sans rien noter ni compter. La liste « Pour toi » peut aussi rappeler, sans jugement, des prises oubliées sur un traitement de fond, et ce que disent des études sur l’exercice pour la maladie suivie, avec leurs sources (Réglages › Sources scientifiques). Tout cela vit dans l’onglet « Soulager », avec « Mon plan des jours difficiles » (quelques lignes que tu écris à l’avance) et « Mes gestes » (tes aides avec un minuteur dont tu choisis la durée). Pas de score, pas de série, rien à perdre.
OUCH est libre et gratuit, et c'est un carnet, pas un avis médical : il ne pose pas de diagnostic et ne recommande aucun traitement.
Seule la douleur, de 0 à 10, suffit pour qu'une journée compte. On peut y ajouter la fatigue, le sommeil, le stress, le brouillard mental, l'humeur, l'activité, les zones douloureuses, la météo du jour (par géolocalisation ou à la main) et, si on le souhaite, le cycle. On note aussi ce qui a aidé : une marche courte, un bain chaud, de la méditation… Tout ce dont on ne se sert pas peut être désactivé dans les réglages.
« Où as-tu mal ? » se saisit sur une silhouette, de face et de dos : on touche une grande région, puis on précise la partie et le côté, gauche ou droite (25 zones, dont les 19 régions que le médecin connaît).
À la première ouverture, un assistant propose de préparer le suivi : maladies suivies, prénom, traitements, rappel quotidien. Selon les maladies indiquées, il range les indicateurs en trois niveaux (recommandés, utiles aussi, tous les autres) ; quatorze indicateurs plus récents s'y ajoutent (raideur au réveil, réveils à cause de la douleur, gêne dans les gestes, articulations, règles, mal de tête, jambe, spasmes…). Relus rapidement en octobre 2026 par un kinésithérapeute, une psychologue spécialisée dans la douleur et une médecin généraliste, ils restent des échelles ou des réponses simples non validées, sans score ni seuil. Tout est facultatif, on peut passer à tout moment et le relancer depuis les réglages.
Les jours de poussée, l'écran s'allège et l'app ne propose rien : seulement un mot bienveillant. Ce qui attend la personne les autres jours (une piste, un essai en cours, un bilan, hier à noter) tient en une ligne discrète, « 2 petites choses pour toi », qui ouvre une feuille.
Quand une période est plus difficile, on peut la noter soi-même, sous la douleur du jour : quand elle a commencé, ce qui a pu y contribuer, un mot. L'écran s'allège alors, comme pour une poussée repérée, mais les deux restent à part : OUCH ne mélange pas ce qu'on vit et ce que montrent les niveaux de douleur.
On déclare ses traitements une fois : de fond ou pris au besoin, la dose, les changements de posologie, les arrêts. Ensuite, les traitements de fond sont cochés d'office chaque jour. Pour ceux pris au besoin, on note le nombre de prises, le soulagement obtenu et les éventuels effets indésirables. Les changements de dose apparaissent directement sur la courbe de douleur.
Les mesures du jour se résument en une image, du ciel dégagé à l'orage, avec la douleur, la fatigue et l'humeur. On peut y ajouter un petit mot, puis l'envoyer soi-même à ses proches. Rien n'est envoyé automatiquement.
Le journal est un calendrier du mois, coloré selon la météo de chaque jour. On peut revenir corriger n'importe quelle journée.
Tendances commence par un bloc « Pour ma consultation » (douleur moyenne, poussées, zone la plus signalée, dernier changement de traitement). Viennent ensuite la courbe de douleur sur 7, 30 ou 90 jours, ou depuis le début, avec sa moyenne sur 7 jours et des calques (poussées, traitements, essais), une frise « Ce qui s'est passé », des cartes sur les zones douloureuses (où, pendant les poussées, semaine par semaine) et un bilan calme du mois qui vient de finir. On y voit aussi les jours de la semaine où ça va le mieux ou le moins bien, ce que ses notes laissent voir (« ce que tes notes racontent » : le sommeil, le stress, l'activité de la veille et ce qui a aidé, une piste à la fois, avec les deux moyennes et le nombre de jours), et l'usage des traitements. Ce sont des associations relevées dans ses propres données, pas des preuves : l'app le dit. La personne peut garder une piste pour sa consultation, l'écarter, ou essayer pendant une semaine une action qu'elle a elle-même notée ; l'app peut aussi lui amener une piste sur la page du jour, la résumer le dimanche en une phrase, ou le faire discrètement par un point sur l'onglet (tout cela se coupe d'un seul réglage, « Suggestions », et rien n'apparaît pendant une poussée). Quand un essai ou une poussée se termine, l'app le reconnaît en une phrase douce.
Deux cartes de plus : « Comparer deux périodes » met les mêmes mesures côte à côte (les 30 derniers jours, depuis la dernière consultation, ou deux périodes au choix) et lit l'écart de douleur à côté de ce qui est habituel pour la personne ; « Après tes jours actifs » regarde, à partir de 30 jours notés avec l'activité, si les lendemains des jours les plus actifs ont été plus difficiles que d'habitude, et le met à côté de ce que le hasard donnerait. Ni l'une ni l'autre ne dit pourquoi : ce sont des descriptions, pas des preuves. Le lendemain d'un jour où l'on a beaucoup donné, un mot discret propose d'y aller par petites étapes, jamais pendant une période difficile. Si on l'a activé (éteint par défaut, avec la météo automatique), une ligne de « Pour toi » dit aussi quand la pression doit baisser demain et que, dans son carnet, les jours de baisse ont été plus difficiles que le hasard ne le donne ; sinon, rien.
On note la date de son rendez-vous, ses questions et ce dont on veut parler en priorité ; une carte douce de la page du jour le rappelle quinze jours avant. Après le rendez-vous, on écrit ce que le médecin a dit, et, si une ordonnance a été remise, sa durée : OUCH prévient une semaine avant la fin (ou deux, au choix), sans rien calculer à partir des prises. La feuille rappelle aussi ce qui s'est passé depuis la dernière consultation. Tout reste sur l'appareil.
Pour les urgences ou un nouveau médecin, l'onglet Consultation fabrique une page à montrer ou à imprimer : les maladies suivies et leur statut, les traitements en cours, les effets indésirables que l'on a notés, la douleur habituelle des trois derniers mois, les zones les plus signalées et ce qui soulage. On y ajoute soi-même ses allergies, des personnes à joindre et un mot libre ; rien n'est deviné. Elle se lit en français ou en anglais et se fabrique sur l'appareil.
Depuis l'onglet Consultation, on génère un rapport à imprimer ou à enregistrer en PDF. Il couvre la période depuis la dernière consultation et la compare à la même durée juste avant. Il existe en deux versions : une synthèse de 3 à 5 pages pour le médecin traitant, et un rapport détaillé de 6 à 10 pages, en parties numérotées, pour un centre douleur (CETD), avec la consommation d'antalgiques et les facteurs associés. Il se lit en français ou en anglais, mentionne les maladies déclarées et reprend, dans « Ce que le patient a remarqué », les pistes gardées et les essais d'une semaine du patient.
Le rapport décrit les données sans les interpréter, et ses seuils citent leurs sources (IMMPACT, HAS, et d'autres travaux publiés), résumées dans Réglages → À propos → Sources scientifiques. Il est fabriqué sur l'appareil ; le nom qu'on y saisit n'est pas enregistré, mais la date de naissance et la date de la dernière consultation restent sur l'appareil pour ne pas les retaper.
Le rapport reprend la préparation : les questions et la priorité du patient en tête de page, sa note après la dernière consultation (qu'on peut laisser de côté), les périodes difficiles qu'il a notées (à part des poussées repérées) et une comparaison de deux périodes, par défaut la période du rapport et celle d'avant, ou deux périodes au choix.
L'onglet Enfants est fait pour être montré à un enfant. Il raconte la météo du jour avec des mots simples (« aujourd'hui, le ciel de maman est un peu voilé »), propose des idées pour aider, et explique la maladie (fibromyalgie, polyarthrite rhumatoïde, spondyloarthrite, rhumatisme psoriasique, endométriose, migraine, lombalgie, sclérose en plaques, douleur myofasciale) pour trois âges : 4–7, 8–12 et 13–17 ans. On choisit maman ou papa.
-
Français et anglais, au choix à la première ouverture, modifiable à tout moment.
-
Une apparence lumineuse (que l'on peut couper dans Réglages) et un mode sombre.
-
Un verrou par code à quatre chiffres, facultatif, qui cache l'écran.
-
L'app s'installe sur l'écran d'accueil (mobile ou ordinateur) et marche hors connexion après la première ouverture. Le texte suit la taille de police réglée sur le téléphone.
-
Les données restent dans le navigateur (IndexedDB). Pour sauvegarder ou changer d'appareil, on exporte un fichier chiffré avec un mot de passe de son choix (AES-256-GCM, dans le navigateur), qu'on réimporte ensuite ; un export CSV (deux fichiers en clair : le journal et les prises) sert à l'analyse, pas à la restauration. L'app rappelle de faire une sauvegarde quand il y a quelque chose à perdre, et demande au navigateur de ne pas effacer les données. En accès anticipé, une sauvegarde automatique envoie ce même fichier chiffré vers un Dropbox.
-
Sur téléphone, « Enregistrer dans Fichiers » ouvre la feuille de partage pour ranger la sauvegarde chiffrée dans iCloud Drive ou ailleurs, au lieu d'un téléchargement à déplacer à la main.
Le plus simple : le mode démo de l'app. Ouvre-la avec ?demo à la fin de l'adresse, ou choisis « Découvrir avec un exemple » dans l'assistant ou dans Réglages. Un historique fictif de 90 jours s'installe dans une base séparée de ton journal, avec une visite guidée ; « Quitter » dans la pastille l'efface. Le script ci-dessous sert à importer le même historique comme une vraie sauvegarde.
Pour voir l'app remplie sans saisir 90 jours Ă la main :
node scripts/generate-demo-history.mjsLe script crée ouch-demo-90j.json, un historique fictif de 90 jours : deux poussées, un changement de traitement, une amélioration, puis une nouvelle poussée qui s'achève la veille, de quoi voir le mot de l'écran « Aujourd'hui », les poussées dans le rapport et les traitements avec leurs effets indésirables. Il s'importe depuis les réglages, dans la partie sauvegarde, avec le mot de passe demo. Trois variables permettent de l'adapter : DEMO_LANG=en met les étiquettes, les notes, les médicaments et l'interface en anglais (l'import change la langue de l'app pour qu'elle suive celle des données), DEMO_TODAY=empty laisse la journée du jour sans saisie, et DEMO_ILLNESSES=fibromyalgie,migraine suit plusieurs maladies.
Les vidéos de démonstration se génèrent aussi par script : scripts/record-demo-video.mjs pour un parcours simple, scripts/promo/record.mjs pour une vidéo de présentation d'une minute, en français ou en anglais, au format vertical ou horizontal, scripts/promo/record-0.2.mjs et record-0.3.mjs pour les vidéos des nouveautés de la 0.2.0 et de la 0.3.0 (PROMO_LANG=en pour la version anglaise), et scripts/promo/record-tour.mjs pour la visite complète d'OUCH en quatorze scènes (en français pour l'instant). Les installations nécessaires (Playwright, ffmpeg) sont décrites en tête de chaque fichier.
npm install
npm run dev # développement, http://localhost:5173
npm test # tests
npm run lint
npm run build # version de production dans dist/
npm run preview # servir cette version en localChaque pull request passe par le lint, les tests et le build (GitHub Actions). Le site est redéployé sur GitHub Pages à chaque fusion dans main.
npm run build produit un dossier dist/ entièrement statique : pas de serveur ni de base de données à héberger. Il se dépose tel quel sur Vercel, Netlify, GitHub Pages, Cloudflare Pages, ou n'importe quel serveur de fichiers (nginx, Caddy…). Il faut seulement du HTTPS, que l'app installable et la géolocalisation exigent.
Comme tout reste dans le navigateur, le choix de l'hébergeur ne change rien à la confidentialité : ce qui compte, c'est l'appareil de la personne, pas le serveur.
src/
db/ schéma Dexie (IndexedDB) et types
i18n/ traductions FR/EN et outils de langue
lib/ logique sans interface : météo de la douleur, chiffrement,
sauvegarde et import, tendances, rapport, traitements
hooks/ hooks React (entrées, réglages, thème)
components/ l'interface, rangée par domaine (entry, weather, journal,
trends, report, kids, settings, setup, ui)
pages/ les quatre onglets (Aujourd'hui, Journal, Tendances,
Consultation), les Réglages, la page Enfants, le rapport
pour le médecin et la fiche pour un soignant
scripts/ historique de démo, icônes, vidéos
tests/ tests des sauvegardes, des tendances, du rapport et de la météo
- Aucune donnée du journal ne quitte l'appareil sans action explicite : un export, ou le partage de sa météo du jour.
- Les données du journal sont stockées en clair dans le navigateur. Quiconque a accès à l'appareil déverrouillé, ou au profil du navigateur, peut les lire. Un verrou par code facultatif cache l'écran (il ne chiffre rien). Seuls les fichiers de sauvegarde exportés sont chiffrés (AES-GCM 256, clé dérivée du mot de passe par PBKDF2). Sans le mot de passe, une sauvegarde est perdue.
- Un navigateur peut effacer de lui-même les données d'un site quand l'appareil manque de place, et Safari le fait aussi après une semaine sans utilisation pour un site non installé. OUCH demande donc au navigateur de garder les données dès la première journée enregistrée, et les réglages montrent s'il a accepté. Il reste libre de refuser : seule une sauvegarde exportée met vraiment les données à l'abri.
- Tout en bas de Réglages, après 15 jours de journal, la carte « Soutenir OUCH » est un simple lien vers la page de dons du développeur : rien n'est chargé depuis ce site ni envoyé tant que tu ne touches pas le lien, et rien n'est débloqué en échange.
- La météo automatique appelle Open-Meteo directement depuis le navigateur, sans clé ni compte. À chaque récupération, Open-Meteo reçoit les coordonnées de l'appareil (latitude et longitude) et voit forcément son adresse IP. Pour afficher le nom de la ville, l'app interroge aussi Nominatim (OpenStreetMap), uniquement quand tu mets à jour ta position : il ne reçoit qu'une position arrondie à environ 1 km et voit lui aussi l'adresse IP, et les données de lieux sont © les contributeurs d'OpenStreetMap. Ces deux appels n'ont lieu que si la météo automatique est activée. S'y ajoute, une fois par semaine, un signal anonyme « actif cette semaine » vers GoatCounter (une mesure d'audience sans identifiant, sans cookie ni donnée de santé, que la case de Réglages coupe ; elle ne part pas non plus si le navigateur envoie Do Not Track ou Global Privacy Control : voir
docs/mesure-audience.md). S'y ajoute encore, en accès anticipé et désactivée par défaut, la sauvegarde automatique chez Dropbox (un fichier déjà chiffré, dans un dossier réservé à OUCH : voirPRIVACY.md). Une politique de sécurité de contenu (CSP) limite d'ailleurs les appels sortants de la version de production à ces services. - Le rappel quotidien peut être un événement d'agenda : l'app fabrique sur l'appareil un petit fichier
.ics(un événement qui revient chaque jour, titre neutre, alarme à l'heure) que le téléphone ajoute à son agenda. C'est l'agenda du téléphone qui sonne, appli fermée, sans serveur et sans rien envoyer. L'autre rappel utilise l'API de notification du navigateur : il n'y a volontairement pas de serveur d'envoi, il arrive quand l'app est ouverte ou a servi récemment, pas quand elle est totalement fermée.
La version détaillée, avec ce que chaque service extérieur reçoit, est dans PRIVACY.md. Pour signaler une faille de sécurité, voir SECURITY.md.
OUCH n'est pas un dispositif médical : il décrit ce que la personne note, sans poser de diagnostic ni recommander de traitement, et ne remplace pas un avis médical.
Une plaquette de deux pages (PDF), une note méthodologique qui détaille chaque calcul, seuil et source (PDF), et un formulaire de retour clinique sont rassemblés dans docs/soignants/.
Les contributions sont bienvenues, de soignants et de patients comme de développeurs : voir CONTRIBUTING.md.
- Une relecture plus approfondie des nouveaux indicateurs par des cliniciens (libellés, tranches), après la revue rapide d'octobre 2026.
- Un vrai rappel push (il demanderait un petit serveur) : l'événement d'agenda en tient lieu sans serveur.
- Plusieurs profils sur le mĂŞme appareil.
- Des widgets iOS et Android (il faudrait passer Ă une app native ou Ă Capacitor).
OUCH est distribué sous licence CeCILL v2.1 (SPDX CECILL-2.1). C'est une licence libre à copyleft fort, écrite par le CEA, le CNRS et l'INRIA pour être valide en droit français, et compatible avec la GPL dans les deux sens.
On peut utiliser, étudier, modifier et redistribuer OUCH librement. Quiconque diffuse une version modifiée, y compris en la mettant simplement à disposition sur un site ou un service en ligne, doit en fournir le code source sous CeCILL (ou sous une licence GPL compatible), sans restriction supplémentaire. Le but est qu'OUCH et ses dérivés restent libres, pour la communauté fibromyalgie comme pour tout le monde.
Le texte complet est dans LICENSE, Ă la racine du projet.