> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e4-bizz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prescripteurs, aidants et PharmaMAD

> Gestion complète des prescripteurs, aidants et pharmacies dans PEPSiMAD MAD.

# Prescripteurs, aidants et PharmaMAD

Ce module gère les trois types d'intervenants externes : les **prescripteurs** (médecins/professionnels de santé), les **aidants** (auxiliaires de vie, infirmiers) et les **pharmacies** (via PharmaMAD). Chacun peut être assigné à des patients et avoir accès à la plateforme.

<Note>
  La gestion des prescripteurs, aidants et pharmacies est réservée aux **administrateurs et commerciaux**.
</Note>

***

## Prescripteurs

Les prescripteurs sont les professionnels de santé (médecins, kinés, etc.) autorisés à prescrire des équipements médicaux pour vos patients.

### Accéder à la liste

Cliquez sur **Prescripteurs** dans le menu latéral pour afficher la liste complète.

### La liste des prescripteurs

#### Colonnes affichées

| Colonne               | Description                                   |
| --------------------- | --------------------------------------------- |
| **Prénom**            | Prénom du prescripteur                        |
| **Nom**               | Nom de famille                                |
| **Email**             | Adresse email de contact                      |
| **Identifiant**       | Identifiant unique (ex: "dr-martin-acme")     |
| **Libellé**           | Type/fonction (ex: Médecin, Kinésithérapeute) |
| **Type de compte**    | Personne physique ou Structure                |
| **Patients assignés** | Nombre de patients liés                       |
| **Actions**           | Menu déroulant                                |

#### Filtres et recherche

* **Recherche par texte** : Filtre sur nom, prénom, email, identifiant
* **Filtre par libellé** : Dropdown pour filtrer par type/fonction
* **Pagination** : 15 prescripteurs par page

### Créer un prescripteur

<Steps>
  <Step title="Cliquer sur Ajouter un prescripteur">
    Bouton en haut à droite de la liste.
  </Step>

  <Step title="Remplir les informations obligatoires">
    * **Prénom** : Prénom du prescripteur
    * **Nom** : Nom de famille
    * **Email**\* : Adresse email valide
    * **Nom d'utilisateur**\* : Identifiant unique (3-20 caractères, minuscules uniquement)
  </Step>

  <Step title="Remplir les informations complémentaires">
    * \**Libellé* : Combobox avec liste prédéfinie (Médecin, Kinésithérapeute, Infirmier, etc.). Vous pouvez créer un nouveau type en tapant
    * **Type de compte** : "Personne physique" ou "Structure" (cabinet, hôpital)
    * **Adresse** : Adresse postale
    * **Complément d'adresse** : Numéro d'appartement, etc.
    * **N° d'agrément** : Numéro professionnel si applicable
    * **Code postal** : 5 chiffres
    * **Ville** : Commune
    * **Téléphone** : Numéro fixe
    * **Mobile** : Numéro portable
  </Step>

  <Step title="Sélectionner le catalogue (optionnel mais recommandé)">
    Dropdown affichant les catalogues actifs. Cette sélection détermine quels produits ce prescripteur peut voir et commander.
  </Step>

  <Step title="Cliquer sur Enregistrer">
    Le prescripteur est créé et reçoit un email avec ses identifiants de connexion.
  </Step>
</Steps>

<Warning>
  L'email doit être unique dans le système. Si vous recevez un message d'erreur, vérifiez que cet email n'existe pas déjà.
</Warning>

### Importer des prescripteurs depuis Must G5

**Disponible si le CRM Must G5 est activé pour votre entreprise.**

Le bouton **Importer depuis Must G5** (en haut de la liste, à droite des filtres) ouvre un assistant permettant d'importer en masse vos clients Must G5 vers Peps Digital.

<Steps>
  <Step title="Rechercher dans Must G5">
    Saisissez un filtre (nom, code postal, code type Must) puis cliquez sur **Rechercher**. Vous pouvez aussi laisser tous les filtres vides pour parcourir l'intégralité de vos clients Must — les résultats sont alors paginés (50 clients par page, boutons **Précédent / Suivant** sous le tableau).
  </Step>

  <Step title="Naviguer entre les pages">
    Les sélections (cases cochées) sont **conservées entre les pages**. Vous pouvez donc sélectionner des clients sur la page 1, passer à la page 2, en sélectionner d'autres, puis tout importer en une fois.
  </Step>

  <Step title="Choisir le type Peps">
    Avant l'import, sélectionnez :

    * **Importer comme** : Prescripteur ou Aidant (l'option **Pharmacie** n'apparaît que si la fonctionnalité PharmaMAD est activée pour votre entreprise)
    * **Libellé** (optionnel) : applique le même libellé à tous les clients importés
  </Step>

  <Step title="Sélectionner les clients">
    Cochez les lignes à importer. Les clients déjà liés à Must G5 (badge **Déjà importé**) sont désactivés pour éviter les doublons.
  </Step>

  <Step title="Lancer l'import">
    Cliquez sur **Importer (N)**. Un toast confirme le nombre de clients créés.
  </Step>
</Steps>

<Note>
  **Aucun mail n'est envoyé** à l'import, qu'un email Must soit présent ou pas. Les clients importés sont créés en base avec un mot de passe aléatoire inutilisable — ils ne peuvent pas se connecter tant que l'admin n'a pas activé leur compte (voir ci-dessous).
</Note>

### Activer le compte d'un client importé

Tous les clients importés depuis Must G5 affichent dans le bloc **Connexion** le bouton **Créer un compte client**, même si Must remontait déjà leur email. L'admin reste seul à décider quand activer un accès :

<Steps>
  <Step title="Cliquer sur Créer un compte client">
    Une dialog s'ouvre.
  </Step>

  <Step title="Saisir l'email et le nom d'utilisateur">
    L'email sera pré-rempli si Must G5 en fournissait un.
  </Step>

  <Step title="Envoyer l'invitation">
    Le client reçoit un mail d'invitation pour définir lui-même son mot de passe (flux **Mot de passe oublié** standard).
  </Step>
</Steps>

### Se connecter en tant que ce client

Dans le bloc **Connexion** de la fiche client, un bouton **Se connecter en tant que ce client** permet de passer des commandes en son nom.

**Qui peut utiliser cette fonction ?**

* **Administrateur** : sur n'importe quel client de son entreprise
* **Commercial** : uniquement sur ses propres clients assignés

Le bouton est masqué si le compte n'a pas encore été activé (impossible de se connecter sans mot de passe défini).

<Steps>
  <Step title="Cliquer sur Se connecter en tant que ce client">
    Vous êtes immédiatement basculé sur la session du client.
  </Step>

  <Step title="Travailler en son nom">
    Un **bandeau orange** reste visible en haut de l'écran : *"Vous êtes connecté en tant que \[client]"*. Vous voyez ses produits, son panier, ses commandes — exactement comme s'il était connecté.
  </Step>

  <Step title="Revenir à votre compte">
    Cliquez sur **Revenir à mon compte** dans le bandeau. Votre session commercial/admin est restaurée.
  </Step>
</Steps>

<Note>
  **Audit** : toute commande passée en mode impersonation est marquée du nom du commercial/admin qui l'a effectivement passée. Dans la liste des commandes (vue admin), un badge **« Passée par \[nom] »** apparaît sous le nom du client.
</Note>

### Modifier un prescripteur

Cliquez sur le bouton **Modifier** (crayon) pour éditer :

* Les informations personnelles (nom, prénom, email, etc.)
* Le type/libellé
* Le catalogue assigné
* Les coordonnées et détails professionnels

Les modifications sont immédiatement effectives.

### Voir les patients assignés

Cliquez sur le bouton **Voir les patients** pour afficher la liste des patients liés à ce prescripteur :

* Liste avec nom, prénom, adresse
* Nombre de commandes actives
* Bouton pour rediriger vers la fiche patient

### Supprimer un prescripteur

Cliquez sur le bouton **Supprimer** (poubelle). Confirmation requise.

* Le prescripteur ne pourra plus se connecter
* Les liens avec les patients sont conservés (traçabilité historique)
* Les commandes existantes restent visibles

***

## Aidants

Les aidants sont des auxiliaires de vie, infirmiers, ou autres professionnels d'aide à la personne assignés aux patients.

### Accéder à la liste

Cliquez sur **Aidants** dans le menu latéral.

### La liste des aidants

#### Colonnes affichées

| Colonne               | Description             |
| --------------------- | ----------------------- |
| **Prénom**            | Prénom de l'aidant      |
| **Nom**               | Nom de famille          |
| **Email**             | Adresse email           |
| **Identifiant**       | Identifiant unique      |
| **Libellé**           | Type/fonction           |
| **Type de compte**    | Personne ou Structure   |
| **Patients assignés** | Nombre de patients liés |
| **Actions**           | Menu déroulant          |

#### Filtres et recherche

Identiques aux prescripteurs :

* Recherche par texte (nom, prénom, email, identifiant)
* Filtre par libellé/fonction
* Pagination : 15 aidants par page

### Créer un aidant

<Steps>
  <Step title="Cliquer sur Ajouter un aidant">
    Bouton en haut à droite.
  </Step>

  <Step title="Remplir les informations">
    * \**Prénom*, \**Nom*, \**Email*, \**Nom d'utilisateur* : Identiques aux prescripteurs
    * \**Libellé* : Combobox (Auxiliaire de vie, Infirmier, Aide-soignant, etc.). Vous pouvez créer un nouveau type
    * **Type de compte** : Personne physique ou Structure
    * Coordonnées complètes (adresse, code postal, ville, téléphone, mobile)
    * **Catalogue (optionnel)** : Accès au catalogue produits si applicable
  </Step>

  <Step title="Enregistrer">
    Email envoyé avec identifiants de connexion.
  </Step>
</Steps>

### Modifier, voir patients, supprimer

Mêmes actions que pour les prescripteurs.

### Importer des aidants depuis Must G5

**Disponible si le CRM Must G5 est activé.** Le bouton **Importer depuis Must G5** ouvre l'assistant d'import — fonctionnement identique à celui des [prescripteurs](#importer-des-prescripteurs-depuis-must-g5). Sélectionnez **Importer comme : Aidant** dans le wizard.

***

## PharmaMAD (Pharmacies)

Les pharmacies sont des entités de type entreprise pouvant créer des patients et réaliser des audits. Elles ont des permissions plus étendues que les prescripteurs/aidants.

### Accéder à la liste

Cliquez sur **PharmaMAD** dans le menu latéral pour afficher la liste des pharmacies.

### La liste des pharmacies

#### Colonnes affichées

| Colonne               | Description                             |
| --------------------- | --------------------------------------- |
| **Prénom**            | Nom ou prénom principal de la pharmacie |
| **Nom**               | Complément du nom                       |
| **Email**             | Email administrateur                    |
| **Identifiant**       | Identifiant unique                      |
| **Libellé**           | Toujours "Pharmacie"                    |
| **Type de compte**    | Toujours "Structure"                    |
| **Patients assignés** | Nombre de patients gérés                |
| **Actions**           | Menu déroulant                          |

#### Filtres et recherche

* Recherche par texte (nom, email, identifiant)
* Pagination : 15 pharmacies par page

### Créer une pharmacie

<Steps>
  <Step title="Cliquer sur Ajouter une pharmacie">
    Bouton en haut à droite.
  </Step>

  <Step title="Remplir les informations de base">
    * \**Prénom* : Numéro FINESS ou identifiant pharmacie
    * \**Nom* : Nom commercial de la pharmacie
    * \**Email* : Email administrateur
    * **Nom d'utilisateur**\* : 3-20 caractères minuscules
  </Step>

  <Step title="Remplir les détails">
    * **Libellé** : Pharmacie (pré-rempli)
    * **Type de compte** : Structure (pré-rempli)
    * Coordonnées complètes (adresse, code postal, ville, téléphone, mobile)
    * **N° d'agrément** : Numéro ANSM si applicable
    * **Catalogue (optionnel)** : Catalogue de produits accessible
  </Step>

  <Step title="Enregistrer">
    Email envoyé avec identifiants. La pharmacie peut se connecter et gérer ses propres patients.
  </Step>
</Steps>

### Permissions des pharmacies

Les pharmacies créées dans PEPSiMAD ont des capacités étendues :

| Action                                   | Permis |
| ---------------------------------------- | :----: |
| Voir les patients qui leur sont assignés |    ✓   |
| Créer de nouveaux patients               |    ✓   |
| Éditer les patients qu'elles gèrent      |    ✓   |
| Réaliser des audits (interventions)      |    ✓   |
| Passer des commandes                     |    ✓   |
| Voir toutes les commandes                |    ✗   |
| Accéder à Configuration                  |    ✗   |
| Gérer les collaborateurs                 |    ✗   |

### Transférer des prescripteurs entre pharmacies

Les pharmacies peuvent se transférer des prescripteurs les uns aux autres en masse.

#### Accéder au transfert

Bouton **Transférer des prescripteurs** en haut à droite de la page PharmaMAD (visible uniquement si au moins une pharmacie existe).

#### Processus de transfert

<Steps>
  <Step title="Ouvrir le dialogue de transfert">
    Bouton "Transférer des prescripteurs".
  </Step>

  <Step title="Sélectionner la pharmacie destination">
    Dropdown affichant toutes les pharmacies.
  </Step>

  <Step title="Filtrer les prescripteurs">
    * Filtre par label/type (Médecin, Kinésithérapeute, etc.)
    * Recherche par nom
  </Step>

  <Step title="Sélectionner les prescripteurs à transférer">
    Checkboxes pour chaque prescripteur :

    * Checkbox individuelle par prescripteur
    * Case "Sélectionner tout" pour cocher tous les prescripteurs filtrés
    * Compteur affichant le nombre sélectionné
  </Step>

  <Step title="Cliquer sur Transférer">
    Indicateur de chargement pendant l'opération.
  </Step>

  <Step title="Confirmation">
    Message de succès : "X prescripteur(s) transféré(s) avec succès."
  </Step>
</Steps>

#### Comportement du transfert

* Les prescripteurs conservent leurs informations (nom, email, identifiant)
* Les patients assignés au prescripteur RESTENT assignés à son ancienne pharmacie
* Le prescripteur peut dorénavant créer des patients via la nouvelle pharmacie
* L'ancienne pharmacie ne verra plus ce prescripteur dans sa liste

<Note>
  Si vous souhaitez transférer aussi les patients d'un prescripteur, vous devez le faire en deux étapes : d'abord transférer le prescripteur, puis réassigner les patients dans la fiche patient individuellement.
</Note>

### Modifier une pharmacie

Cliquez sur **Modifier** pour éditer :

* Nom et coordonnées
* Email et identifiants
* Catalogue assigné

### Voir les patients assignés

Cliquez sur **Voir les patients** pour afficher la liste des patients gérés par cette pharmacie.

### Supprimer une pharmacie

Cliquez sur **Supprimer**. Confirmation requise.

<Warning>
  Avant de supprimer une pharmacie, assurez-vous que ses patients sont réassignés à une autre pharmacie.
</Warning>

***

## Champs communs à tous les intervenants

### Nom d'utilisateur

* Format : identifiant unique (ex: "marie-david")
* Contraintes :
  * 3-20 caractères
  * Minuscules uniquement
  * Uniquement caractères alphanumériques et tirets
  * Unicité requise

### Libellé / Type de fonction

Combobox avec liste prédéfinie :

**Prescripteurs** :

* Médecin généraliste
* Cardiologue
* Pneumologue
* Kinésithérapeute
* Infirmier
* (autres à créer)

**Aidants** :

* Auxiliaire de vie
* Infirmier à domicile
* Aide-soignant
* Ambulancier
* (autres à créer)

**Création de nouveau type** :

* Tapez un nouveau type dans le champ combobox
* Un bouton "Créer \[nouveau type]" apparaît
* Cliquez pour créer et utiliser immédiatement

### Catalogue

Dropdown optionnel affichant les catalogues actifs :

* Si sélectionné : l'intervenant accède à ce catalogue pour passer des commandes
* Si non sélectionné : l'intervenant voit ses patients assignés mais pas d'accès direct au catalogue
* Peut être modifié à tout moment

### Type de compte

Dropdown avec 2 options :

* **Personne physique** : Médecin indépendant, aidant individuel
* **Structure** : Cabinet médical, hôpital, pharmacie, cabinet de groupe

***

## Import en masse

Actuellement, l'import en masse n'est pas disponible pour les prescripteurs/aidants/pharmacies. Chaque entrée doit être créée individuellement. Une fonctionnalité d'import Excel est en cours de développement.

***

## Cas d'usage courants

### Créer un réseau de prescripteurs pour un patient

<Steps>
  <Step title="Créer le prescripteur principal">
    * Médecin du patient avec tous ses détails
    * Assigner le catalogue
  </Step>

  <Step title="Créer les aidants complémentaires">
    * Infirmier à domicile, auxiliaire de vie, kiné
    * Même catalogue
  </Step>

  <Step title="Assigner au patient">
    * Aller dans le dossier patient
    * Assigner les prescripteurs et aidants créés
  </Step>

  <Step title="Tester l'accès">
    * Se connecter avec les comptes créés
    * Vérifier que chacun voit ses patients et peut passer commande
  </Step>
</Steps>

### Transférer des patients d'une pharmacie à une autre

<Steps>
  <Step title="Accéder aux patients de la source">
    * PharmaMAD → Voir patients de Pharmacie A
  </Step>

  <Step title="Éditer chaque patient">
    * Ouvrir la fiche patient
    * Modifier la pharmacie assignée
    * Sélectionner Pharmacie B
  </Step>

  <Step title="Enregistrer">
    * Les patients sont maintenant gérés par Pharmacie B
    * Pharmacie A ne les voit plus
  </Step>
</Steps>

### Créer une nouvelle fonction de prescripteur

<Steps>
  <Step title="Aller à Prescripteurs">
    * Créer un prescripteur
  </Step>

  <Step title="Dans le champ Libellé">
    * Taper "Cardiologue pédiatrique" (par exemple)
  </Step>

  <Step title="Un bouton apparaît">
    * "Créer Cardiologue pédiatrique"
  </Step>

  <Step title="Cliquer pour créer">
    * Le type est créé et assigné immédiatement
    * Il sera ensuite disponible pour tous les futurs prescripteurs
  </Step>
</Steps>

***

## Messages courants

### Succès

* "Prescripteur créé avec succès. Un email a été envoyé à \[email]."
* "Modifications enregistrées."
* "Prescripteurs transférés avec succès. 5 prescripteur(s) affecté(s) à la nouvelle pharmacie."
* "Pharmacie supprimée."

### Erreurs

| Erreur                                       | Cause                             | Solution                                                             |
| -------------------------------------------- | --------------------------------- | -------------------------------------------------------------------- |
| "Email déjà utilisé"                         | Email existe dans le système      | Utilisez une adresse email unique                                    |
| "Nom d'utilisateur déjà utilisé"             | Identifiant en doublon            | Choisissez un autre identifiant                                      |
| "Format d'email invalide"                    | Email mal formaté                 | Vérifiez le format (ex: [user@example.com](mailto:user@example.com)) |
| "Le champ \[nom] est obligatoire"            | Champ obligatoire vide            | Remplissez le champ avant d'enregistrer                              |
| "Aucun prescripteur à transférer"            | Pas de prescripteur correspondant | Modifiez les filtres ou créez des prescripteurs                      |
| "Impossible d'assigner un catalogue inactif" | Catalogue non actif               | Activez le catalogue dans Configuration                              |

***

## Bonnes pratiques

<Tip>
  **Catalogue par intervenant** : Assignez un catalogue à chaque prescripteur/aidant pour qu'ils puissent passer commande.
</Tip>

<Tip>
  **Email unique** : Utilisez des emails uniques et valides. Évitez les adresses génériques.
</Tip>

<Tip>
  **Type de compte** : Utilisez "Structure" pour les cabinets/hôpitaux, "Personne" pour les indépendants.
</Tip>

<Tip>
  **Suppression** : Avant de supprimer un intervenant, vérifiez qu'il n'a pas de patients critiques assignés.
</Tip>

<Tip>
  **Transfert pharmacie** : Le transfert concerne le prescripteur seul. Les patients restent à l'ancienne pharmacie. Transférez-les manuellement si nécessaire.
</Tip>