# Données de santé (HDS)

> Stockez des documents de santé chiffrés dans des coffres, un espace par client, partagez-les et tracez chaque accès dans un journal d'audit chaîné.

Le module HDS (hébergement de données de santé) donne à votre [wakapp](/v1.0/glossaire#wakapp) un espace de stockage dédié aux données de santé de ses utilisateurs. Les documents y sont rangés dans des [coffres](/v1.0/glossaire#coffre), chiffrés un par un, et chaque opération est inscrite dans un [journal d'audit](/v1.0/glossaire#journal-daudit) chaîné qui permet de détecter une modification.

Votre application appelle le module par l'API publique, avec le jeton de l'utilisateur connecté. Ce que l'utilisateur peut faire dépend de ses [rôles HDS](/v1.0/glossaire#rôle-hds) : patient, professionnel de santé, administrateur.

## Comment ça marche

```mermaid
flowchart TB
  subgraph APP["Votre wakapp"]
    F["Front"] --> S["Serveur"]
  end
  S -- "Authorization: Bearer jeton de l'utilisateur" --> API["API publique<br/>/api/hds/*"]
  API -- "rôles HDS, client" --> HDS["Module HDS"]
  subgraph T["Espace HDS d'un client"]
    V["Coffres"] --> D["Documents chiffrés<br/>AES-256-GCM"]
    V --> P["Partages · consentements<br/>accès d'urgence"]
    J["Journal d'audit chaîné"]
  end
  HDS --> V
  HDS --> J
```

1. Wakastart active le module pour votre application. Chaque [client](/v1.0/glossaire#client) de l'application reçoit son propre espace HDS, séparé logiquement de ceux des autres clients.
2. Vous attribuez des rôles HDS à vos utilisateurs.
3. Le serveur de votre wakapp appelle `/api/hds/*` avec le jeton d'accès de l'utilisateur. L'API vérifie qu'il porte au moins un rôle HDS, puis le module applique le détail des permissions.
4. Un professionnel de santé crée le coffre d'un patient et y dépose des documents ; le module les chiffre et les rattache au coffre.
5. Toute opération, réussie ou non, est inscrite au journal d'audit de l'espace, chaîné par HMAC.

## Commencer

::::cards{cols=3}
:::card{title="Démarrage rapide" href="/v1.0/hds/demarrage-rapide" icon="Rocket"}
Créer un coffre patient et y déposer un document.
:::
:::card{title="Activer le module" href="/v1.0/hds/activer-le-module" icon="Power"}
Ouvrir HDS pour votre application et vérifier l'espace de vos clients.
:::
:::card{title="Attribuer les rôles" href="/v1.0/hds/attribuer-les-roles" icon="UserCog"}
Donner à chaque utilisateur le rôle qui correspond à sa fonction.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Coffres" href="/v1.0/hds/gerer-les-coffres" icon="Archive"}
Patient, structure, recherche ou temporaire : un conteneur par usage.
:::
:::card{title="Documents chiffrés" href="/v1.0/hds/deposer-un-document" icon="FileLock2"}
Chiffrement par fichier, contrôle antivirus et déduplication au dépôt.
:::
:::card{title="Partages" href="/v1.0/hds/partager-un-coffre" icon="Share2"}
Ouvrir un coffre à un soignant ou au patient lui-même.
:::
:::card{title="Consentements" href="/v1.0/hds/recueillir-un-consentement" icon="ClipboardCheck"}
Consigner le consentement du patient, sa finalité et son mode de recueil.
:::
:::card{title="Accès d'urgence" href="/v1.0/hds/activer-un-acces-d-urgence" icon="Siren"}
Ouvrir un coffre en urgence vitale, avec justification et alerte.
:::
:::card{title="Journal d'audit" href="/v1.0/hds/consulter-le-journal-d-audit" icon="ScrollText"}
Lire chaque opération et vérifier que la chaîne n'a pas été altérée.
:::
:::card{title="Rapports" href="/v1.0/hds/produire-un-rapport-de-conformite" icon="FileBarChart"}
Indicateurs et rapports RGPD, HDS et NIS2.
:::
:::card{title="Revues d'accès" href="/v1.0/hds/mener-une-revue-des-acces" icon="UserCheck"}
Passer les partages en revue et révoquer ceux qui n'ont plus lieu d'être.
:::
:::card{title="Portabilité" href="/v1.0/hds/exporter-un-coffre" icon="Download"}
Exporter les données d'un coffre au format structuré (RGPD, article 20).
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Utilisateurs et équipes" href="/v1.0/utilisateurs" icon="Users"}
Gérer les comptes qui recevront des rôles HDS.
:::
:::card{title="Antivirus" href="/v1.0/antivirus" icon="ShieldAlert"}
Le moteur qui contrôle chaque document déposé.
:::
:::card{title="Documents légaux" href="/v1.0/documents-legaux" icon="FileText"}
Publier le DPA HDS de votre application.
:::
::::

## Ressources

- [Référence du module HDS](/v1.0/hds/reference) : objets, statuts, opérations, erreurs, limites.
- [Référence API — HDS](/v1.0/reference-api/hds) : endpoints détaillés.
- [Responsabilités du client](/v1.0/hds/responsabilites-du-client) : ce qui vous revient.
- [Résoudre les problèmes HDS](/v1.0/hds/depannage).
