> ## 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.

# Locations d'équipements

> Gérer les demandes et locations d'équipements médicaux, suivre les statuts et les dates de livraison.

# Locations d'équipements

Le module **Locations** gère l'ensemble du processus de location d'équipements médicaux, depuis la demande initiale jusqu'à la fin de location.

<Note>
  Ce module est accessible aux administrateurs, commerciaux et clients (prescripteurs, aidants). Chaque rôle a une vue adaptée.
</Note>

## Accéder au module

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

* **Administrateurs et commerciaux** : accès complet avec gestion des locations
* **Clients (prescripteurs, aidants)** : accès au catalogue de location et suivi de leurs demandes

## Vue administrateur et commercial

### Liste des locations

La liste affiche toutes les locations avec les informations essentielles :

| Colonne                   | Contenu                              |
| ------------------------- | ------------------------------------ |
| **Référence**             | Numéro unique de la location         |
| **Prescripteur / Aidant** | Nom du client qui a demandé          |
| **Patient**               | Nom du bénéficiaire                  |
| **Équipement**            | Produit loué                         |
| **Date début**            | Première date de location            |
| **Date fin**              | Dernière date de location            |
| **Prix/jour**             | Coût quotidien                       |
| **Prix période**          | Coût total pour le mois/année filtré |
| **Statut**                | État actuel (badge coloré)           |

### Calcul du prix période

Le **Prix période** correspond au nombre de jours de location **dans le mois/année sélectionné** × prix journalier.

**Exemple :**

* Location du 10 au 25 janvier
* Prix/jour : 50 € HT
* Filtre janvier : Prix période = 16 jours × 50 € = 800 € HT

### Filtrer les locations

Un encart avec filtres en haut du tableau propose :

| Filtre           | Type           | Description                                              |
| ---------------- | -------------- | -------------------------------------------------------- |
| **Recherche**    | Texte libre    | Chercher par référence, nom du patient, équipement, etc. |
| **Mois**         | Menu déroulant | Choisir le mois (1 à 12)                                 |
| **Année**        | Menu déroulant | Année courante et 5 années passées                       |
| **Statut**       | Menu déroulant | Filtrer par état de location                             |
| **Prescripteur** | Menu déroulant | Voir les locations d'un client spécifique                |
| **Patient**      | Menu déroulant | Voir les locations d'un patient spécifique               |

### Actions disponibles

Pour chaque location, un menu propose :

| Action                  | Description                         |
| ----------------------- | ----------------------------------- |
| **Voir le détail**      | Ouvre la fiche complète             |
| **Modifier dates**      | Change la date de début et/ou fin   |
| **Modifier prix/jour**  | Ajuste le tarif journalier          |
| **Assigner équipement** | Sélectionne un équipement du parc   |
| **Changer le statut**   | Passe à l'état suivant              |
| **Supprimer**           | Supprime définitivement la location |

### Fiche de détail

La fiche complète affiche :

**Informations principales :**

* Référence, dates, statut, quantité
* Patient bénéficiaire (nom, contact)
* Équipement loué
* Équipement assigné du parc
* Client demandeur

**Actions possibles :**

* Modifier les dates
* Modifier le prix journalier
* Assigner un équipement
* Changer le statut
* Supprimer

## Statuts des locations

Il existe 7 statuts possibles, chacun avec une couleur et une signification :

| Statut           | Couleur      | Signification                                      |
| ---------------- | ------------ | -------------------------------------------------- |
| **Nouvelle**     | Rouge        | Demande reçue, en attente de traitement            |
| **Préparation**  | Bleu         | Équipement en préparation, pas encore assigné      |
| **En livraison** | Violet       | Équipement assigné, prêt à être livré              |
| **Actif**        | Vert         | Équipement livré et en location                    |
| **Fin demandée** | Orange       | Client a demandé la fin (en attente de validation) |
| **Terminée**     | Gris         | Location finalisée, équipement retourné            |
| **Fin dépassée** | Orange foncé | Date de fin passée, non marquée comme terminée     |

## Workflow complet de location

### 1. Le client crée une demande

Le client effectue une demande depuis le **catalogue location** :

1. Sélectionne un équipement
2. Remplit les informations (patient, dates, quantité)
3. Soumet la demande

**État initial** : Nouvelle (Rouge)

### 2. L'administrateur examine et traite

**Étapes de traitement :**

<Steps>
  <Step title="Examiner la demande">
    Consultez la fiche pour valider les informations.
  </Step>

  <Step title="Passer à Préparation">
    Le statut devient **Préparation** (Bleu). L'équipement est maintenant en préparation.
  </Step>

  <Step title="Assigner un équipement">
    Sélectionnez un équipement du parc disponible.
  </Step>

  <Step title="Passer à En livraison">
    Le statut devient **En livraison** (Violet).

    **Option** : Une dialog propose de créer automatiquement une intervention Installation.
  </Step>
</Steps>

### 3. Livraison et signature

La livraison peut être effectuée par :

* **Web** : Signature numérique dans l'application
* **Tablette/Mobile** : Signature du client sur place

**Après signature** : Statut passe à **Actif** (Vert)

### 4. Demande de fin par le client

Le client peut demander la fin de location depuis son interface :

* Statut passe à **Fin demandée** (Orange)
* Une notification alerté l'administrateur
* Le client ne peut pas changer le statut lui-même

### 5. Finalisation par l'administrateur

L'administrateur valide la fin :

* Statut : **Fin demandée** → **Terminée** (Gris)
* L'équipement est marqué comme retourné au parc

### 6. Dépassement automatique

**Si la date actuelle > date de fin :**

* Le système change automatiquement le statut en **Fin dépassée** (Orange foncé)
* L'administrateur reçoit une notification
* Vous devez contacter le client pour récupérer l'équipement

## Location de plusieurs unités

Si le client demande une **quantité > 1**, plusieurs **locations indépendantes** sont créées :

**Exemple :**

* Demande : 3 fauteuils roulants
* Résultat : 3 locations séparées
* Chacune peut être assignée à un équipement différent
* Chacune a son propre statut

## Vue client

### Onglet 1 : Catalogue de location

Parcourez les équipements disponibles à la location :

1. **Familles de location** : Sélectionnez la catégorie (mobilité, respiratoire, etc.)
2. **Sélectionner une famille** → affiche les produits
3. **Créer une demande** : Remplissez les dates, le patient, la quantité
4. **Soumettre** : Demande créée avec le statut "Nouvelle"

<Note>
  Les produits affichés dans le catalogue de location proviennent des mercuriales. Pour rendre un produit disponible à la location, ajoutez le mot-clé **location** dans la colonne **FAMILLE** lors de l'import de la mercuriale. Le **PRIX U. HT** d'une famille de location correspond au prix journalier HT.
</Note>

### Onglet 2 : Mes demandes de location

Affiche toutes vos demandes personnelles :

| Colonne        | Contenu                    |
| -------------- | -------------------------- |
| **Référence**  | Numéro de votre demande    |
| **Équipement** | Produit demandé            |
| **Patient**    | Bénéficiaire               |
| **Dates**      | Période de location        |
| **Statut**     | État actuel (badge coloré) |

### Actions pour les clients

| Action              | Disponible si...  |
| ------------------- | ----------------- |
| **Voir le détail**  | Toujours          |
| **Demander la fin** | Statut = Actif    |
| **Annuler**         | Statut = Nouvelle |

## Badge de notification

Un **badge dans le menu latéral** indique le nombre de demandes "Nouvelle" en attente de traitement. Cliquez sur le badge pour les filtrer automatiquement.

## Créer une intervention Installation

Quand vous passez au statut **En livraison**, une **dialog** propose de créer automatiquement une **intervention Installation** :

* Type : Installation
* Patient : celui de la location
* Date : date de début de location
* Statut : En attente

Vous pouvez :

* Créer l'intervention immédiatement
* Continuer sans créer

## Conseils pratiques

<AccordionGroup>
  <Accordion title="Comment assigner un équipement du parc ?">
    Depuis la fiche de location, cliquez sur **Assigner équipement**. Sélectionnez un équipement disponible dans la liste du parc.
  </Accordion>

  <Accordion title="Que se passe-t-il si je demande 3 équipements ?">
    Trois locations indépendantes seront créées. Assignez un équipement différent à chacune si possible.
  </Accordion>

  <Accordion title="Comment créer une intervention de livraison ?">
    Lors du passage au statut **En livraison**, une dialog propose de créer automatiquement une intervention Installation.
  </Accordion>

  <Accordion title="Différence entre Fin demandée et Terminée ?">
    **Fin demandée** : le client a demandé l'arrêt mais vous ne l'avez pas confirmé. **Terminée** : vous avez validé et l'équipement est retourné.
  </Accordion>

  <Accordion title="Que faire si une location est Fin dépassée ?">
    Le statut change automatiquement si la date de fin est passée. Contactez le client pour récupérer l'équipement. Puis validez la fin dans l'application.
  </Accordion>
</AccordionGroup>

## Pages suivantes

<CardGroup cols={2}>
  <Card title="Patients" href="/mad/patients/overview">
    Consulter et gérer les dossiers patients.
  </Card>

  <Card title="Interventions" href="/mad/interventions">
    Gérer les interventions techniques liées aux locations.
  </Card>
</CardGroup>