# Produire un rapport de conformité

> Obtenez les indicateurs RGPD et NIS2 de votre espace HDS, générez des rapports sur une période et téléchargez-les en PDF.

Le module calcule des indicateurs de conformité à partir des données de l'espace et de son journal d'audit. Vous pouvez les lire à tout moment, produire un rapport daté sur une période, et en obtenir une version PDF à remettre à un auditeur.

## Avant de commencer

- Vous portez le rôle `HDS_ADMIN`.
- Vous avez choisi la période du rapport.

## Lire les indicateurs du moment

```bash
curl "https://api.wakastart.app/api/hds/compliance/rgpd" -H "Authorization: Bearer $USER_TOKEN"
curl "https://api.wakastart.app/api/hds/compliance/nis2" -H "Authorization: Bearer $USER_TOKEN"
```

Réponses attendues :

```json
{ "activeConsents": 412, "withdrawnConsents": 7, "totalPatientVaults": 430, "erasureRequests": 0 }
```

```json
{ "securityIncidents30d": 0, "deniedAccess30d": 3 }
```

| Indicateur | Signification |
|---|---|
| `activeConsents`, `withdrawnConsents` | Consentements actifs et retirés dans l'espace. |
| `totalPatientVaults` | Nombre total de coffres de l'espace. |
| `deniedAccess30d` | Opérations refusées (`DENIED`) au journal sur 30 jours. |
| `securityIncidents30d` | Événements de sécurité au journal sur 30 jours. |

## Générer un rapport sur une période

Deux types de rapport structuré sont disponibles : `RGPD_COMPLIANCE` et `NIS2_INCIDENTS`.

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl -X POST "https://api.wakastart.app/api/hds/compliance/reports" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "type": "NIS2_INCIDENTS", "periodFrom": "2026-07-01T00:00:00Z", "periodTo": "2026-09-30T23:59:59Z" }'
```
:::
:::tab{label="TypeScript"}
```typescript
const response = await fetch("https://api.wakastart.app/api/hds/compliance/reports", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.USER_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "NIS2_INCIDENTS",
    periodFrom: "2026-07-01T00:00:00Z",
    periodTo: "2026-09-30T23:59:59Z",
  }),
});
console.log(await response.json());
```
:::
::::

Réponse attendue (extrait) :

```json
{
  "reportId": "rpt_Za9Xs8Cd7Vf6",
  "type": "NIS2_INCIDENTS",
  "status": "COMPLETED",
  "periodFrom": "2026-07-01T00:00:00.000Z",
  "periodTo": "2026-09-30T23:59:59.000Z",
  "networkWid": "EXCLI1",
  "generatedBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
  "data": {
    "totalIncidents": 3,
    "deniedAccess": 3,
    "securityIncidents": 0,
    "incidentsList": [
      {
        "timestamp": "2026-09-14T16:02:11.000Z",
        "eventType": "SHARE_CREATED",
        "userId": "2c9d7e41-5a8b-4f60-9e3d-1b7a6c5d4e21",
        "result": "DENIED"
      }
    ],
    "period": { "from": "2026-07-01T00:00:00Z", "to": "2026-09-30T23:59:59Z" }
  }
}
```

Pour `RGPD_COMPLIANCE`, `data` contient `consentsCreated`, `consentsWithdrawn`, `deletionRequests` et `totalVaults` sur la période. Le rapport est produit immédiatement et conservé : retrouvez-le avec `GET /api/hds/compliance/reports` (filtre `type`) ou `GET /api/hds/compliance/reports/{reportId}`.

## Obtenir un rapport PDF

Le rapport PDF résume l'espace (coffres et documents actifs, événements du journal sur la période) et liste jusqu'à 50 événements critiques : accès d'urgence, refus, événements de gravité élevée. Le type (`hdsAudit`, `rgpd` ou `nis2`) fixe son titre.

1. Générez le PDF ; les paramètres passent dans l'URL :

```bash
curl -X POST "https://api.wakastart.app/api/hds/admin/compliance/reports?type=hdsAudit&from=2026-07-01T00:00:00Z&to=2026-09-30T23:59:59Z" \
  -H "Authorization: Bearer $USER_TOKEN"
```

La réponse contient `reportId` et `"status": "COMPLETED"`.

2. Demandez un lien de téléchargement :

```bash
curl "https://api.wakastart.app/api/hds/admin/compliance/reports/rpt_Qw1Er2Ty3Ui4/download" \
  -H "Authorization: Bearer $USER_TOKEN"
```

```json
{ "reportId": "rpt_Qw1Er2Ty3Ui4", "url": "https://…", "expiresInSeconds": 600 }
```

3. Téléchargez le fichier à l'adresse `url` dans les 10 minutes.

## Vérifier le résultat

- Le rapport apparaît dans `GET /api/hds/compliance/reports` avec le statut `COMPLETED`.
- Le journal d'audit contient `COMPLIANCE_REPORT_GENERATED` ou `COMPLIANCE_PDF_GENERATED`.

## Voir aussi

- [Consulter le journal d'audit et vérifier son intégrité](/v1.0/hds/consulter-le-journal-d-audit)
- [Référence : rapport de conformité](/v1.0/hds/reference#rapport-de-conformité)
