TEST

1. Contexte

Deux systèmes distincts coexistent :

• Haya : plateforme de gestion complète d'hôpital (SIH), déployée localement, par hôpital (on-premise). Gère consultations, dossiers patients, antécédents, prescriptions, etc.
• DocLink : plateforme de télé-expertise médicale, hébergée sur internet, mutualisée entre tous les hôpitaux. Connecte médecins généralistes et spécialistes à distance (chat, appels vidéo, IA médicale, paiement Mobile Money).

2. Périmètre

Dans le périmètre :

• Création d'un compte DocLink depuis l'interface Haya, sans validation KYC pour les médecins Haya (déjà certifiés).
• Authentification classique (email/mot de passe) pour les accès suivants.
• Transmission d'un cas médical de Haya vers DocLink avec anonymisation de l'identité du patient.
• Identifiant pivot permettant de relier le cas anonymisé côté DocLink au dossier réel côté Haya.
• Retour du résultat de la télé-expertise vers Haya.

3. Parcours médecin Haya — création et connexion au compte DocLink

Point clé validé : un médecin s'authentifie déjà sur son instance Haya locale. DocLink étant un service unique sur internet (pas une instance par hôpital), un compte DocLink créé depuis n'importe quelle instance Haya fonctionne ensuite depuis n'importe quelle autre instance Haya — aucune fédération d'identité n'est nécessaire.

```mermaid flowchart TD M[Médecin connecté sur Haya] --> D{Premier besoin de télé-expertise ?} D -- "Oui (1ère fois)" --> F["Formulaire création compte DocLink<br/>email + mot de passe, affiché dans Haya"] F --> P["Haya envoie une preuve de certification<br/>signée à DocLink"] P --> CU["DocLink crée le User<br/>originSource = HAYA, KYC exempté"] D -- "Non (compte existant)" --> L["Écran de connexion DocLink<br/>email + mot de passe"] L --> AU[Authentification classique] CU --> PL["Profil chargé /<br/>interface DocLink affichée dans Haya"] AU --> PL PL --> N["Fonctionne depuis n'importe quelle instance Haya<br/>(DocLink = service unique)"] ```

4 Étapes détaillées

1. Le médecin, déjà connecté à Haya, clique sur l'option « télé-expertise ».
2. Première fois : un formulaire de création de compte DocLink (email + mot de passe) s'affiche dans l'interface Haya.
3. À la soumission, Haya transmet à DocLink une preuve signée de certification du médecin.
4. DocLink crée le compte (`User`) avec un statut KYC « exempté » (le médecin est réputé certifié).
5. Fois suivantes : le médecin accède à l'interface DocLink intégrée à Haya via un écran de connexion classique (email/mot de passe déjà utilisés à la création).
6. DocLink authentifie normalement et charge le profil du médecin.

5. Parcours médecin externe (hors Haya)

Un médecin qui s'inscrit directement sur DocLink (sans passer par Haya) suit le parcours KYC classique déjà implémenté :

1. Inscription (`POST /auth/register`).
2. Démarrage de la vérification KYC (`POST /kyc/start`).
3. Upload des documents d'identité (`POST /kyc/:id/documents`), OCR bilingue (fr/en).
4. Capture d'un selfie via QR code (flux `kyc-qr`).
5. Soumission pour revue (`POST /kyc/:id/verify`).
6. Validation manuelle par un administrateur DocLink (`PUT /admin/kyc/:id/review`).

Aucune modification n'est requise sur ce parcours : il existe déjà intégralement dans DocLink.

6. Interface de transmission de cas et anonymisation de l'identité du patient

6.1 Une interface de transmission, pas un formulaire de création

Haya n'a pas besoin d'une page de création de cas depuis zéro : le dossier médical du patient (antécédents, symptômes, analyses) existe déjà dans Haya. L'interface à développer est donc un écran de revue et de transmission, pas un formulaire CRUD complet.

```mermaid flowchart TD DS[Dossier patient existant dans Haya] --> RV["Écran de revue<br/>pré-rempli automatiquement"] RV --> AN["Le système retire/masque<br/>toute info identifiante"] AN --> PAY{Paiement requis pour valider} PAY -- "payé" --> CR["Création du cas<br/>POST /cases côté DocLink"] CR --> REF["Génération de l'ID pivot<br/>externalRef"] ```

Étapes :

1. Le médecin ouvre le dossier du patient dans Haya et déclenche « Envoyer en télé-expertise ».
2. L'écran de revue pré-remplit automatiquement la description, les antécédents, les symptômes et les analyses depuis le dossier Haya.
3. Le systeme valide/retire tout élément identifiant (nom, adresse, numéro de dossier, images sensibles) — c'est le point de contrôle naturel de l'anonymisation, puisque Haya est le seul système à connaître l'identité réelle.
4. Paiement obligatoire avant validation finale — sans paiement, le cas n'est pas transmis.
5. Une fois payé, Haya appelle `POST /cases` côté DocLink avec le contenu anonymisé et génère l'ID pivot (`externalRef`).

6.2 Paiement requis pour valider la création du cas

DocLink dispose déjà d'un mécanisme de paiement préalable à la création d'un cas : un brouillon (`PendingCaseDraft`) suit un cycle de vie `AWAITING_PAYMENT → CONVERTED/EXPIRED`, avec paiement Mobile Money via FedaPay (`POST /payments/initiate`, webhook de confirmation). Pour un cas transmis depuis Haya, ce même mécanisme doit être réutilisé :

• L'écran de revue Haya déclenche l'initiation du paiement (FedaPay) avant la transmission finale.
• Le cas n'est réellement créé côté DocLink (conversion du brouillon en `MedicalCase`) qu'une fois le paiement confirmé (webhook `transaction.approved`).
• Reste à trancher : qui paie pour un cas initié depuis Haya — le médecin individuellement (comme dans le parcours DocLink classique), ou l'hôpital via un forfait/contrat ?

7. Identifiant pivot (ID pivot / `externalRef`)

Pour que le médecin Haya retrouve son patient une fois la réponse de l'expert reçue, sans que DocLink connaisse jamais l'identité réelle :

• Haya génère un jeton opaque (UUID) au moment de la création du cas, qui sert de clé de correspondance.
• Ce jeton est stocké uniquement côté Haya, associé au dossier patient réel.
• Côté DocLink, le cas médical (`MedicalCase`) porte ce même jeton dans un nouveau champ `externalRef`, sans aucune autre donnée d'identité.
• Le mapping (jeton ↔ patient réel) ne doit jamais exister côté DocLink.

8. Autre interface

En complément de l'écran de revue/transmission (§6), deux interfaces DocLink supplémentaires sont à intégrer dans Haya :

• Page IA : accès à l'assistant IA médicale de DocLink depuis Haya.
• Page chat : accès au chat de télé-expertise (échanges médecin généraliste ↔ spécialiste) depuis Haya.