Changelog SGRDV — release 1.1.1

Date de publication : 3 juillet 2026

Légende : 🔴 = rupture sur contrat de production (experimental = false) · 🟠 = rupture sur contrat en validation (experimental = true) · 🟢 = ajout rétrocompatible

1. Versionnement et statut

1.1 Bump 1.1.0 → 1.1.1

Cette release correspond à un bump PATCH. Tous les artefacts modifiés portent experimental = true. Les ruptures individuelles justifient le symbole 🟠 mais n'imposent qu'un bump PATCH conformément à la politique de versionnement §4.1.

Résumé des changements :

• §2 — $book surface source : renommage du profil SGRDVSourceBookNotificationParameters → SGRDVSourceBookRequestParameters. 🟠
• §3 — Audit : deux nouvelles extensions obligatoires (correlationId, discussionId 1..1 MS) sur SGRDVAuditEvent ; id et identifier.type (#DiscussionId) rendus obligatoires sur SGRDVAuditBundle. 🟠
• §4 — $book commun : slicing ouvert et invariant ajoutés sur SGRDVBaseBookSourceDevice pour l'identifiant de portail. 🟠
• §5 — $find / $aggregate : parameter[appointmentType] rendu optionnel (1..1 → 0..1). 🟢
• §6 — Location.address : correction de l'exemple et définition de address.text (correctif documentaire).

Tous les artefacts versionnés (config IG, OperationDefinition, CapabilityStatement) sont alignés sur la version 1.1.1.

2. $book surface source — Renommage du profil des paramètres d'entrée 🟠

2.1 Renommage 🟠

Le profil des paramètres d'entrée de l'opération $book côté surface source (api-source) portait à tort le terme « Notification », sans rapport avec la réservation de rendez-vous. Il est renommé pour aligner sur la sémantique réelle de l'opération et la convention de nommage des artefacts SGRDV.

La structure du profil est identique — seul le nom et l'Id canonique changent.

⚠️ Action requise : Mettre à jour toute référence au profil SGRDVSourceBookNotificationParameters ou à son Id sgrdv-source-book-notification-parameters dans vos implémentations, validateurs et exemples.

2.2 Artefacts mis à jour

3. Audit — Prise en charge du Discussion-Id 🟠

3.1 Nouvelles extensions obligatoires sur SGRDVAuditEvent 🟠

Deux extensions sont désormais obligatoires (1..1 MS) sur SGRDVAuditEvent :

3.2 Nouvelles contraintes sur SGRDVAuditBundle 🟠

Le Discussion-Id est désormais porté par Bundle.identifier.type = #DiscussionId pour regrouper les Bundles d'un même fil de discussion. Le Bundle.id devient obligatoire.

3.3 Nouveau code #DiscussionId dans SGRDVIdentifierTypeCS 🟢

⚠️ Action requise : Les implémentations qui produisent ou consomment des Bundles d'audit (SGRDVAuditBundle) doivent :

1. Renseigner extension[correlationId] (valeur du header X-Correlation-Id) sur chaque AuditEvent.
2. Renseigner extension[discussionId] (valeur du header X-Discussion-Id) sur chaque AuditEvent.
3. Renseigner Bundle.id (identifiant unique du Bundle).
4. Renseigner Bundle.identifier.type.coding.code = #DiscussionId et Bundle.identifier.type.coding.system correspondant.

3.4 Artefacts mis à jour

4. $book — Identifiant de portail sur SGRDVBaseBookSourceDevice 🟠

4.1 Nouveau slicing et invariant 🟠

Un slicing ouvert est ajouté sur identifier du Device source d'une demande $book, avec un invariant d'erreur garantissant la présence d'au moins un identifiant émis par le portail RVSQ Réo ou par Votre santé.

⚠️ Action requise : Vérifier que le Device source inclus dans le payload $book porte un identifiant avec system = "http://sante.quebec/fhir/NamingSystem/RVSQREO" ou system = "http://sante.quebec/fhir/NamingSystem/VOTRESANTE".

4.2 Artefacts mis à jour

5. $find / $aggregate — appointmentType rendu optionnel 🟢

5.1 Changement de cardinalité 🟢

Le type de rendez-vous n'est pas requis pour les plages REO et GAP. La validation métier (obligatoire si timeslotCategory = populationnel) est assurée côté service, hors contrainte FSH.

5.2 Impact partenaires 🟢

• Portails (surface api-sgrdv) : appointment-type n'est plus requis dans le payload $find. Les implémentations qui l'omettaient pour des plages REO ou GAP sont désormais conformes au profil.
• SGRDV (propagation vers api-source) : même assouplissement côté surface source.

5.3 Artefacts mis à jour

6. Location.address — Correctif documentaire

Correction de l'exemple d'instance et des métadonnées du champ address.text dans le profil SGRDVBaseFindResponseLocation. Aucun impact sur les payloads valides.

7. Recommandations de migration pour les partenaires

Si vous intégrez $book (surface api-source)

1. Mettre à jour toute référence au profil SGRDVSourceBookNotificationParameters (Id sgrdv-source-book-notification-parameters) vers SGRDVSourceBookRequestParameters (Id sgrdv-source-book-request-parameters).
2. Vérifier que le Device source du $book porte un identifiant system = "$ns-rvsqreo" ou system = "$ns-votresante".

Si vous produisez ou consommez des Bundles d'audit

1. Renseigner extension[correlationId] (X-Correlation-Id) et extension[discussionId] (X-Discussion-Id) sur chaque AuditEvent.
2. Renseigner Bundle.id et Bundle.identifier.type.coding.code = #DiscussionId sur chaque SGRDVAuditBundle.
3. Revalider vos payloads d'audit contre la version 1.1.1.

Si vous intégrez $find ou $aggregate

1. Le paramètre appointment-type est désormais optionnel — aucune action requise si vous le renseigniez déjà. Les implémentations qui l'omettaient pour des plages REO ou GAP sont maintenant conformes.

Toutes intégrations confondues

1. Revalidez vos payloads contre la version 1.1.1 du paquet IG.
2. Traitez les §2, §3 et §4 comme des ruptures sur contrats expérimentaux — des mises à jour sont requises avant la prochaine validation partenaire.