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

# Interventions

> Suivre les interventions techniques sur les équipements médicaux des patients.

# Interventions

Le module **Interventions** centralise l'historique complet de toutes les interventions réalisées sur les équipements des patients. Une intervention peut être une installation, une reprise, un échange ou un service après-vente.

## Accéder au module

Cliquez sur **Interventions** dans le menu latéral. Un badge rouge indique le nombre d'interventions avec le statut **En attente** (visibles pour admin/commercial uniquement).

## La liste des interventions

### Colonnes du tableau

| Colonne    | Description                                     | Ordre    |
| ---------- | ----------------------------------------------- | -------- |
| Date       | Date de l'intervention                          | 1        |
| Type       | Installation, Reprise, Échange, SAV             | 2        |
| Statut     | En attente ou Terminée                          | 3        |
| Patient    | Nom du patient (lien cliquable)                 | 4        |
| Technicien | Nom de la personne ayant réalisé l'intervention | 5        |
| Actions    | Menu d'actions                                  | Dernière |

Les lignes alternent entre deux couleurs pour meilleure lisibilité et sont animées à l'apparition.

## Types d'interventions

Chaque intervention est classée par type.

### Installation

Mise en place d'un nouvel équipement chez un patient. C'est généralement la première intervention pour un équipement donné.

**Caractéristiques** :

* Intervient lors de la livraison initiale
* Marque le début du cycle de vie de l'équipement
* Peut être créée automatiquement lors de la mise en service
* Requiert signature du technicien et validation de livraison

### Reprise

Récupération d'un équipement chez un patient. Marque la fin du cycle de vie pour cet équipement.

**Caractéristiques** :

* Intervient lors du retour de l'équipement
* Marque la fin d'une location ou d'une vente
* Requiert documentation de l'état de l'équipement

### Échange

Remplacement d'un équipement par un autre, généralement en raison d'une panne, usure ou évolution des besoins.

**Caractéristiques** :

* Intervient sans interruption de service
* L'équipement ancien est retiré et remplacé
* Génère une intervention de reprise et une installation simultanément

### SAV (Service après-vente)

Maintenance, réparation ou diagnostic d'un équipement défaillant.

**Caractéristiques** :

* N'affecte pas la possession de l'équipement
* Peut être planifiée ou d'urgence
* Peut être effectuée chez le patient ou au centre technique

## Statuts des interventions

### En attente

L'intervention est planifiée mais pas encore réalisée.

**Caractéristiques** :

* Visible dans le badge de notification (admin/commercial)
* Permet de tracker les interventions à venir
* Peut rester longtemps en cet état pour interventions planifiées

### Terminée

L'intervention a été effectuée avec succès.

**Caractéristiques** :

* État par défaut lors de la création (les interventions sont souvent créées rétroactivement)
* Requiert signature du technicien et validation
* Les documents d'intervention configurés doivent être signés

## Filtres et recherche

### Filtres disponibles

| Filtre     | Type                     | Disponible pour  | Description                         |
| ---------- | ------------------------ | ---------------- | ----------------------------------- |
| Patient    | Dropdown                 | Tous             | Filtrer par patient                 |
| Technicien | Dropdown                 | Admin/Commercial | Filtrer par intervenant             |
| Type       | Dropdown multi-sélection | Tous             | Installation, Reprise, Échange, SAV |
| Du         | Date                     | Tous             | Date de début                       |
| Au         | Date                     | Tous             | Date de fin                         |

### Utiliser les filtres

Les filtres s'affichent dans un encart avec bordure au-dessus du tableau. Ils s'appliquent immédiatement et se combinent (tous doivent être vrais).

Exemple : "Patient = Jean Dupont" ET "Type = Installation" ET "Période = Décembre 2024"

### Pagination

Le tableau affiche **15 interventions par page** avec pagination basée sur l'URL.

* **Mobile** : Affiche "X / Y"
* **Desktop** : Affiche numéros de page avec ellipsis

## Actions disponibles

### Pour tous les utilisateurs

| Action             | Disponibilité | Description                                         |
| ------------------ | ------------- | --------------------------------------------------- |
| **Voir le détail** | Toujours      | Cliquer sur la ligne pour voir les détails complets |

### Pour administrateurs et commerciaux

| Action              | Condition                                             | Description                             |
| ------------------- | ----------------------------------------------------- | --------------------------------------- |
| **Voir PDF**        | Si PDF existe OU intervention terminée avec signature | Ouvrir/télécharger le compte-rendu      |
| **Télécharger PDF** | Identique                                             | Télécharger le document pour impression |
| **Supprimer**       | Toujours                                              | Supprimer l'intervention définitivement |

### Pour clients/prescripteurs

Les clients et prescripteurs peuvent :

* Consulter les interventions associées à leurs patients
* Voir les détails et télécharger les PDF (si autorisé)
* **Remarque** : Ils ne peuvent pas créer ni modifier les interventions

## Générer un PDF d'intervention

### Conditions préalables

Un PDF peut être généré si :

* Un PDF a déjà été généré précédemment, OU
* L'intervention est terminée ET une signature technique existe

### Processus

<Steps>
  <Step title="Accéder à la fiche de l'intervention">
    Cliquez sur la ligne d'une intervention pour ouvrir ses détails.
  </Step>

  <Step title="Localiser l'action Voir PDF">
    Dans le menu d'actions (sticky à droite), cherchez l'icône de PDF.
  </Step>

  <Step title="Cliquer sur Voir PDF">
    Ouvre le document dans un nouvel onglet pour consultation.
  </Step>

  <Step title="Télécharger si nécessaire">
    Cliquez sur **Télécharger PDF** pour sauvegarder le document.
  </Step>
</Steps>

### Contenu du PDF

Le document inclut toutes les informations de l'intervention :

#### Informations du patient

* Nom et prénom
* Adresse
* Code postal et ville
* Contact

#### Informations techniques

* Technicien : Nom et prénom
* Aidant assigné : Si applicable
* Prescripteur assigné : Si applicable
* Nom de l'équipement installé
* Numéro de série de l'équipement
* Référence interne

#### Contenu du rapport

* Documents d'intervention configurés
* Signatures numériques du technicien (si collectées)
* Horodatage de génération

## Documents d'intervention

Les documents d'intervention sont des modèles configurables qui s'affichent lors de la finalisation d'une intervention.

### Configuration des documents

Consultez **Configuration > Documents d'intervention** pour :

* Ajouter/modifier des modèles
* Définir les types
* Configurer les règles d'inclusion

### Règles d'inclusion

Chaque document peut s'afficher selon :

* **Always** : Inclus dans toutes les interventions
* **Sale\_only** : Inclus seulement pour les ventes
* **Lease\_only** : Inclus seulement pour les locations

### Types de documents

| Type       | Signature requise | Description                         |
| ---------- | ----------------- | ----------------------------------- |
| Regulatory | Oui               | Procédures officielles obligatoires |
| Notice     | Non               | Documents informatifs optionnels    |

## Lien avec les équipements

Les interventions sont fortement liées au cycle de vie des équipements.

### Création automatique d'installation

Lors de la mise en service d'un équipement :

1. Une intervention de type **Installation** est créée automatiquement
2. Le statut est défini à **En attente** par défaut
3. L'équipement et le patient sont auto-remplis

### Validation de livraison

<Steps>
  <Step title="Technicien visite le patient">
    Pour livrer et installer l'équipement.
  </Step>

  <Step title="Valider la livraison">
    Via l'app mobile ou le formulaire web.
  </Step>

  <Step title="Signature du technicien">
    Capture de signature numérique.
  </Step>

  <Step title="Intervention marquée terminée">
    Automatiquement mise à jour avec la date et signature.
  </Step>

  <Step title="PDF généré automatiquement">
    Document incluant tous les détails et signatures.
  </Step>
</Steps>

### Intervention de reprise

À la fin du cycle de vie, une intervention de type **Reprise** marque le retour de l'équipement.

## Accès et permissions

### Administrateurs et commerciaux

* Voir toutes les interventions de leur entreprise
* Créer, modifier et supprimer des interventions
* Générer des PDF et télécharger les documents
* Voir le filtre Technicien (pour assigner les interventions)

### Clients

* Voir les interventions concernant leurs patients
* Consulter les détails et télécharger les PDF
* **Remarque** : Lecture seule

### Prescripteurs et aidants

* Voir les interventions de leurs patients assignés
* Consulter les détails
* Télécharger les documents si autorisés

## Badge de notification

Un badge rouge dans le menu latéral indique le nombre d'interventions avec le statut **En attente**.

Ce badge est visible uniquement pour les administrateurs et commerciaux.

Cliquez sur le badge pour filtrer automatiquement et afficher uniquement les interventions en attente.

## Workflows courants

### Installation d'équipement neuf

```
1. Création automatique lors de la mise en service
2. Technicien visite le patient
3. Validation de livraison (mobile/web)
4. Statut → Terminée
5. Signature et PDF générés
```

### Intervention SAV planifiée

```
1. Admin crée une intervention SAV en statut "En attente"
2. Technicien se rend chez le patient
3. Diagnostic et réparation
4. Changement du statut à "Terminée"
5. PDF généré et envoyé au client
```

### Échange d'équipement

```
1. Ancien équipement : intervention Reprise
2. Nouvel équipement : intervention Installation
3. Deux entrées distinctes dans l'historique
4. Deux PDF générés
```

## Conseils pratiques

<AccordionGroup>
  <Accordion title="Organiser les interventions par technicien">
    Utilisez le filtre **Technicien** pour voir toutes les interventions assignées à une personne. Cela aide à planifier les déplacements.
  </Accordion>

  <Accordion title="Générer des rapports d'intervention">
    Téléchargez les PDF pour constituer un dossier papier du patient. Les signatures numériques garantissent l'authenticité.
  </Accordion>

  <Accordion title="Marquer les interventions comme terminées">
    N'oubliez pas de passer le statut de "En attente" à "Terminée" une fois l'intervention effectuée. Cela permet une bonne traçabilité.
  </Accordion>

  <Accordion title="Signatures numériques">
    Utilisez les formulaires mobiles pour collecter les signatures du technicien. Elles sont automatiquement intégrées au PDF.
  </Accordion>
</AccordionGroup>

## Limitations et considérations

<Warning>
  Les interventions supprimées ne peuvent pas être récupérées. Assurez-vous avant de supprimer un enregistrement important.
</Warning>

<Note>
  Les interventions très anciennes peuvent être archivées. Consultez votre administrateur pour connaître la politique d'archivage.
</Note>

<Note>
  Le PDF est généré à la demande si le statut est "Terminée" et une signature existe. Pour les anciennes interventions sans PDF, régénérez le document depuis l'interface.
</Note>
