Modèle de données HDS
Espace HDS d'un client, coffres, documents, dossiers, partages, consentements et accès d'urgence, et la façon dont ils s'articulent.
Le module HDS organise les données de santé en coffres, rangés dans l'espace de chaque client. Tout ce que vous créez (document, dossier, partage, consentement) est rattaché à un coffre, et tout accès à un coffre passe par sa propriété ou par un partage.
Définition
L'espace HDS est l'ensemble des données de santé d'un client de votre application. Chaque client a le sien, avec ses propres collections, son propre stockage de fichiers et son propre journal d'audit. Un utilisateur ne voit jamais l'espace d'un autre client : l'espace est déterminé par le client de son compte, pas par un paramètre de requête.
Un coffre est le conteneur de base. Il appartient à l'utilisateur qui l'a créé et regroupe des documents, des dossiers, des partages et des consentements.
Pourquoi ce modèle
Un dossier médical a un propriétaire clair et une liste de personnes autorisées. Le coffre matérialise cette frontière : on n'accède pas « aux documents », on accède à un coffre, et le journal d'audit enregistre qui l'a fait. Le cloisonnement par client garantit qu'un établissement ne voit jamais les patients d'un autre, même au sein de la même application.
Comment ça marche
Les types de coffre
| Type | Usage | Règle à la création |
|---|---|---|
PATIENT | Dossier d'un patient identifié. | Identité du patient obligatoire : externalId, firstName, lastName, birthDate ; ins (identifiant national de santé) facultatif. |
STRUCTURAL | Documents d'une équipe ou d'un service (protocoles, procédures). | ownerTeamId obligatoire. |
RESEARCH | Données d'une étude. | Identité directe du patient interdite : utilisez des références pseudonymisées dans metadata. |
TEMPORARY | Coffre ouvert pour une durée courte. | expiresAt obligatoire, entre 24 heures et 90 jours après la création. |
Un coffre a un statut : ACTIVE, ARCHIVED, SUSPENDED ou DELETED. On ne dépose des documents que dans un coffre ACTIVE.
Les documents
Un document est un fichier déposé dans un coffre, éventuellement dans un dossier. Le module calcule son empreinte SHA-256, le soumet à l'antivirus, le chiffre et conserve l'historique de ses versions (currentVersion, versions). Déposer deux fois le même contenu dans le même coffre ne crée pas de doublon : le module renvoie le document existant avec "deduplicated": true.
La suppression d'un document est d'abord logique (statut DELETED) ; le fichier est purgé définitivement 30 jours plus tard.
Les dossiers
Les dossiers organisent les documents d'un coffre en arborescence (parentFolderId). Un dossier ne se supprime que vide : sans sous-dossier ni document.
Les partages
Un partage ouvre un coffre à un utilisateur désigné par son identifiant Keycloak (targetUserId). Le titulaire d'un partage actif voit le coffre dans sa liste et y fait ce que ses rôles HDS permettent : lire les documents, en déposer, exporter le coffre. Le partage reste actif jusqu'à sa révocation.
Les consentements
Un consentement consigne l'accord d'un patient pour une finalité (purpose), un périmètre (scope) et un mode de recueil (collectionMethod). Il est rattaché à un coffre et porte un statut ACTIVE, WITHDRAWN ou EXPIRED.
Les accès d'urgence
Un accès d'urgence (bris de glace) permet à un professionnel de santé d'ouvrir un coffre qui ne lui est pas partagé, en cas d'urgence vitale. Il exige une justification, crée un partage en lecture au nom du demandeur et apparaît dans les alertes de l'administrateur HDS tant qu'il reste actif.
Les identifiants
| Préfixe | Objet |
|---|---|
vlt_ | coffre |
doc_ | document |
fld_ | dossier |
shr_ | partage |
cst_ | consentement |
bg_ | accès d'urgence |
aud_ | entrée du journal d'audit |
rev_ | revue d'accès |
rpt_ | rapport de conformité |
Les utilisateurs (propriétaire, destinataire d'un partage, auteur d'une action) sont désignés par leur identifiant Keycloak, le sub de leur jeton.
Exemples
- Un centre de santé crée un coffre
PATIENTpar patient, avec les dossiers « Comptes rendus », « Imagerie » et « Ordonnances », puis le partage avec le médecin traitant. - Un laboratoire de recherche crée un coffre
RESEARCHpar étude, où chaque document est référencé par un code de participant, sans nom ni date de naissance. - Une équipe de soins à domicile range ses protocoles dans un coffre
STRUCTURALrattaché à son identifiant d'équipe.