Mise à jour du narratif FRCore (index.md, bonnes_pratiques.md et known_problems.md)

input/pagecontent/bonnes_pratiques.md

@@ -11,6 +11,10 @@ En FHIR, il y a plusieurs types d'identifiants :
 
 Il est conseillé de favoriser l'usage des identifiants métiers pour faciliter l'identification de la ressource en dehors du serveur.
 
+#### Les syntaxes retenues
+
+Parmi les trois syntaxes disponibles pour implémenter FHIR, les syntaxes retenues sont les syntaxes XML et JSON.
+
 ### Les bonnes pratiques de rédaction des guides d'implémentation
 
 #### Profilage de nouvelles ressources

input/pagecontent/index.md

@@ -1,9 +1,9 @@
 <p style="padding: 5px; border-radius: 5px; border: 2px solid maroon; background: #ffffe6; width: 65%">
 <b>
-Profils, extensions, jeux de valeurs, et guides de mise en œuvre normalisant l'échange de données administratives sur les patients, les professionnels de santé et les organisations, et les rencontres avec les patients (programmées ou effectives), ainsi que les signes vitaux en France.
+Profils, extensions, jeux de valeurs, et guides de mise en œuvre normalisant l'échange de données de santé : données administratives sur les patients, les professionnels de santé et les organisations, et les rencontres avec les patients (programmées ou effectives), ainsi que les signes vitaux en France.
 </b><br>
 
-Profiles, extensions, value sets, code systems and implementation guides standardizing the exchange of administrative data about patients, health professionals and organization, and patient encounters (scheduled or effective), and vital sign in France
+Profiles, extensions, value sets, code systems and implementation guides standardizing the exchange of health data : administrative data about patients, health professionals and organization, and patient encounters (scheduled or effective), and vital sign in France
 
 </p>
 
@@ -21,22 +21,30 @@ Profiles, extensions, value sets, code systems and implementation guides standar
 <div style="width: 65%">
 <blockquote class="stu-note">
 <p>
-  <b>Attention !</b> Cette version du guide d'implémentation est en concertation pour validation. La version officielle est accessible à l'adresse http://hl7.fr/ig/fhir/core</b>
+  <b>Attention !</b> Cette version du guide d'implémentation est en concertation. La version officielle est accessible à l'adresse http://hl7.fr/ig/fhir/core</b>
 </p>
 </blockquote>
 </div>
 {% endif %}
 
+Ce guide d'implémentation est fourni comme **fondation pour l'utilisation de FHIR® en France**. Il permet de définir les profils, les extensions et les jeux de valeurs normalisant **l'échange de données administratives sur les patients, les professionnels de santé et les organisations, et les rencontres avec les patients (programmées ou effectives), les signes vitaux ainsi que les structures des établissements de soins**.
 
-Ce guide de mise en œuvre est fourni pour **soutenir l'utilisation de FHIR® en France**. Il permet de définir les profils, les extensions et les jeux de valeurs normalisant **l'échange de données administratives sur les patients, les professionnels de santé et les organisations, et les rencontres avec les patients (programmées ou effectives), ainsi que les signes vitaux**.
+### Le rôle du guide d'implémentation FHIR FR Core
 
-Les profils FHIR de ce guide d'implémentation sont volontairement très peu contraignants et ne répondent pas à des cas d'usages spécifiques, l'objectif de ce guide d'implémentation est de proposer un socle commun pour l'ensemble des échanges de données utilisant le standard FHIR en France.
-Par exemple, ce guide indique comment modéliser un patient FHIR en France (contenant l'identifiant national de santé (INS)), le professionnel de santé (contenant l'identifiant national de professionnel de santé (IDNatPS)), ...
+L'objectif du guide d'implémentation FR Core est de garantir une base commune pour permettre une utilisation homogène du standard pour l'ensemble des implémentations FHIR en France (version de FHIR, extensions, identifiants, etc.).
+Pour cela, ce guide va par exemple indiquer comment modéliser un [patient FHIR en France](./StructureDefinition-fr-core-patient-ins.html) (contenant l'identifiant national de santé (INS)), [un professionnel de santé](./StructureDefinition-fr-core-practitioner.html) (contenant l'identifiant national de professionnel de santé (IDNatPS)), ...
 
-Ainsi, on y retrouve :
+Afin de garantir l'uniformité d'usage de FHIR en France, l'ensemble des implémentations FHIR et des guides d'implémentation doit se baser sur FR Core, comme c'est le cas pour les guides d'implémentation de l'Agence du Numérique en Santé (ANS) et d'InteropSanté (IS).
 
-* Les ressources essentielles profilées pour la France
-* Les extensions nécessaires à l'utilisation locale en France.
+Dans les prochaines versions, FR Core sera également garant de la compatibilité européenne en héritant directement des profils HL7 Base Europe. Ces profils FR Core vont permettre de valider la conformité des instances FHIR sur les espaces de tests.
+
+### Principes de modélisation et d'utilisation de FHIR FR Core
+
+Les profils FHIR de ce guide d'implémentation sont volontairement peu contraignants afin de couvrir le plus grand nombre de cas d'usage et ainsi faciliter son adoption. Par conséquent, ce guide ne traite pas de cas d'usage spécifiques : il est donc recommandé de vérifier dans l'écosystème des guides d'implémentation si des guides plus spécialisés correspondant à votre cas d'usage existent.
+
+Le guide d'implémentation FR Core, et FHIR de manière générale, offrent un large éventail de ressources, d'attributs et de paramètres de recherche. Toutefois, FHIR et FR Core n'imposent pas l'implémentation complète de toutes ces fonctionnalités. Il convient donc pour chaque cas d'usage d'identifier précisément les ressources, profils et les fonctionnalités d'API nécessaires.
+
+Par exemple, l'API FHIR Annuaire Santé, une API ouverte basée sur FR Core, illustre une mise en œuvre concrète de ce guide. Sa [documentation](https://ansforge.github.io/annuaire-sante-fhir-documentation/) et son [guide d'implémentation](https://interop.esante.gouv.fr/ig/fhir/annuaire/) peuvent servir de référence.
 
 ### Champ d'application
 
@@ -50,42 +58,44 @@ Les activités de profilage donnent la priorité aux ressources ayant un niveau
 
 ### Choix de la version du standard FHIR
 
-Le Guide d'implémentation FR Core est **basé sur la version Release 4 de HL7 FHIR** et définit l'ensemble minimum de contraintes sur les ressources FHIR pour créer les profils FR Core. Elles font référence à un certain nombre de ressources du standard ainsi qu’aux spécifications de l’API REST FHIR, basées sur le protocole HTTP. Les syntaxes retenues sont la syntaxe XML et JSON.
-
-En établissant la "base" des normes pour promouvoir l'interopérabilité et l'adoption par le biais d'une mise en œuvre commune, il permet une évolution ultérieure de l'élaboration des normes pour des cas d'utilisation spécifiques.
+Pour garantir l'interopérabilité à l'échelle nationale, **l'utilisation de FHIR R4 est recommandée pour l'ensemble des projets en France**. Ainsi, ce guide d'implémentation FR Core est **basé sur FHIR R4**.
 
 La stratégie sur le choix des versions FHIR a été définie au sein d'un groupe de travail organisé entre Interop'Santé et l'ANS en 2023/2024, validée via une [concertation](https://participez.esante.gouv.fr/project/fhir-r5-ou-r4/presentation/presentation) de l'ANS.
 
-#### Nouveaux cas d’usages FHIR adressés par Interop’Santé et l’ANS : privilégier FHIR R4 et anticiper la transition vers R6
+#### Nouveaux cas d’usages FHIR : privilégier FHIR R4 et anticiper la transition vers R6
 
-Pour garantir la cohérence au sein de l'écosystème français, éviter tout problème de compatibilité ainsi que les travaux divergents, il est nécessaire d'utiliser une même version du standard FHIR à l'échelle nationale. Le choix a été fait de conserver FHIR R4 car il y a un existant conséquent en France et cela permet d'éviter une double transition R4 vers R5 et R5 vers R6 qui aurait un coût non négligeable. Ce choix est conforté car la release 6 se veut être la version finale stable de FHIR, une transition vers R6 se voudra de toute manière nécessaire. Pour anticiper cette transition, il est jugé important d’être proactif sur les travaux internationaux de développement de R6 et d’anticiper les impacts pour l’écosystème français.
-Il est également à noter que le choix national de la version FHIR utilisée devra être en accord avec le règlement de l'EEDS qui se dessine progressivement et qui pour l'heure semble se diriger vers R4.
+Pour garantir la cohérence au sein de l'écosystème français et éviter tout problème de compatibilité dû à des travaux divergents, il est nécessaire d'utiliser une même version du standard FHIR à l'échelle nationale. Le choix a été fait de conserver FHIR R4 car il y a un existant conséquent en France et cela permet d'éviter des transitions entre version qui complexifierait l'écosystème
 
-#### Ne pas créer de guide d'implémentation (IG) se basant sur R5 sans analyse des normes et standards et des impacts
+La version R6 de FHIR se veut être la version finale stable de FHIR. La décision d'une transition vers R6 dépendra du règlement de l'EEDS qui se dessine progressivement et qui pour l'heure semble se diriger vers R4.
+
+Pour anticiper cette transition, il est jugé important d’être proactif sur les travaux internationaux de développement de R6 et d’anticiper les impacts pour l’écosystème français.
+
+#### Ne pas créer de guide d'implémentation (IG) se basant sur une version différente de R4 sans analyse des normes et standards et des impacts
 
 La priorité actuelle est de faire monter l’écosystème en compétences et de gagner en maturité sur les spécifications existantes. Créer des IGs R5 engendreraient une fragmentation de l’écosystème et un ralentissement de la mise en qualité de l’existant qui finirait par freiner l’adoption de FHIR.
 
 Généralement, rajouter quelques [extensions qui miment les attributs R5](https://hl7.org/fhir/R5/versions.html#extensions) s'avère suffisant pour éviter de créer tout un guide en R5. Dans certains cas, une autre version de FHIR peut être justifiée, par exemple si le cas d'usage concerne des échanges internationaux ou si le cas d'usage est significativement mieux couvert par une autre version. Le cas échéant, l’usage d’une autre version devra être validé par une étude des normes et standards publiée et validée par l’écosystème.
 
 Dans certains cas non identifiés à ce jour, il pourrait également être nécessaire de maintenir des guides d’implémentation sous plusieurs versions. Après validation par l’écosystème de ce besoin, cela donnerait l’opportunité d'estimer des travaux de maintenance d’Implementation Guide (IG) sous plusieurs versions ainsi qu’un mapping associé pour gagner en expérience.
 
-#### Priorité FHIR France en 2025+ - améliorer la qualité de l’existant
+#### Priorité FHIR France en 2026+ - accompagner la croissance des usages de FHIR 
+
+Entre 2023 et 2025 des travaux structurants de mise en qualité des spécifications FHIR sous forme de guide d'implémentation ont eu lieu.
 
-De nombreux travaux ont été menés en 2023 pour mettre en qualité les spécifications FHIR et encourager leur déploiement, tel que le passage au format IG et la mise à jour des tests et validateurs gazelle.
+En 2026, FHIR change d'échelle avec l'arrivée de l'espace européen des données de santé (EEDS), les travaux d'HL7 Europe, et les groupes de travail français qui portent les standards historiques en FHIR (PN-13, PAM, ...).
 
-Les priorités des prochaines années sont de continuer dans cette direction :
+Cette multiplication des usages de FHIR ne vient pas sans risques : il faut s'assurer de la cohérence globale de l'écosystème FHIR national.
+
+En parallèle, ces tâches de fond restent valables :
 
 <div>
     <ul>
         <li>La montée en compétences et l’acculturation des développeurs et des chefs de projets aux bonnes pratiques d’usages de FHIR, notamment en organisant des évènements par l'ANS et InteropSanté : projectathon, webinaires, formations, ...</li>
-        <li>S’assurer de la faisabilité d’implémentation des IGs existants (amélioration du contenu narratif pour expliquer comment utiliser les ressources, s’assurer de la facilité d’accès au contenu, s'assurer que les IGs soient bien connus …).</li>
-        <li>Prise en main des outils de mapping tel que le FHIR Mapping Language afin d'assurer une transition maîtrisée vers une autre version de FHIR.</li>
-        <li>Anticiper les prochaines évolutions internationales : passage au FHIR Document dans le cadre du règlement européen, anticiper la transition vers FHIR R6, ...</li>
+        <li>Amélioration continue des guides d’implémentation existants pour assurer la faisabilité d'implémentation (amélioration du contenu narratif pour expliquer comment utiliser les ressources, s’assurer de la facilité d’accès au contenu, s'assurer que les IGs soient bien connus …).</li>
+        <li>Prise en main des outils de mapping tel que le FHIR Mapping Language afin d'assurer une transition maîtrisée entre standards.</li>
     </ul>
 </div>
 
-Il est également nécessaire de rester à l’écoute des tendances internationales en interopérabilité et de se garder la possibilité de réitérer l’analyse si le besoin ou le contexte international évolue, en particulier l'EEDS.
-
 ### Gouvernance
 
 Le guide d'implémentation FR Core est géré par HL7 France et IHE France au sein du comité technique FHIR de HL7 France.

input/pagecontent/known_problems.md

@@ -3,9 +3,4 @@ Les problématiques connues nécessitent le retour de l'écosystème, n'hésitez
 * Le guide contient un grand nombre d'extensions, il est probable qu'un certain nombre d'entre elles puissent être supprimées pour être remplacées par : d'autres ressources, des attributs ajoutés dans R5/R6, d'autres champs natifs ...
 * Relicats historiques d'OID qui doivent être remplacés par des URL cannoniques
 * Certains profils et extensions n'ont pas d'exemples associés
-* Les artifacts terminologiques ne sont pas uniformisés parmi tous les standards d'InteropSanté
-
-### Les travaux à venir
-
-* Des profils européens sont en création, l'héritage vers les profils européens est à prévoir. Ces profils ne semblant pas contraignants, les changements auront des impacts mineurs.
-* Une migration vers FHIR R6 dont la sortie est prévue en 2026 est à prévoir en fonction des décisions européennes
+* Les artifacts terminologiques ne sont pas uniformisés parmi tous les standards d'InteropSanté

sushi-config.yaml

@@ -1,7 +1,7 @@
 id: hl7.fhir.fr.core
 canonical: https://hl7.fr/ig/fhir/core
-name: FrCore
-title: Guide d'implémentation Fr Core
+name: FRCore
+title: Guide d'implémentation FR Core
 publisher:
   name: Interop'Santé
   url: http://interopsante.org/
@@ -25,9 +25,20 @@ dependencies:
 parameters: 
   shownav: 'true'
   path-expansion-params: '../../expansion-params.json' # for using French SNOMED CT Extension
-  pin-canonicals: pin-all
-
-
+  i18n-default-lang: fr-FR # Default language
+  pin-canonicals: pin-all # Avoid raising many warnings when there are no version for URLs. "pin-multiples": pinning the canonical reference will only happen if there is multiple versions found in the package dependencies
+  path-pages:
+    - input/pagecontent
+    - input/intro-notes
+  apply-contact: true
+  apply-jurisdiction: true
+  logging:
+    - tx #tx: Messages describing the use of the terminology server (for debugging)
+    - html #html: Log when validating an html page (troubleshooting only - leave off)
+    - generate #generate: Log when producing an individual resource (troubleshooting only - leave off)
+    - init #init: Messages describing the start up process (for debugging)
+    - progress #progress: Overall progress messages
+
 pages:
     index.md:
       title: Accueil