Initial commit — specs pré-projet SatPRO + site de présentation (viewer, annotations, gestion des accès)

docs/specs-pre-projet/08-interventions.md

@@ -0,0 +1,91 @@
+# 08 — Interventions
+
+> Cahier des charges — scope et expression du besoin macro.
+> L'intervention (ITV) est la **production concrète** d'une part du contrat chez le client. Elle hérite de la prestation et peut porter des informations propres.
+
+## 1. Objectif
+
+Générer et gérer les interventions issues des prestations, les affecter et les planifier (via PlanUp / 7Opteam), transmettre les éléments de production au technicien, puis suivre leur avancement (codes état et facturation) jusqu'à la fin d'intervention qui alimente la RFI.
+
+## 2. Acteurs
+
+- **Ordonnancement** — affectation et planification.
+- **Admin / Administrative** — suivi, documents joints, consignes complémentaires, gestion des statuts.
+- **Technicien** — reçoit les éléments de production, réalise l'intervention (production hors SatPRO).
+- **Client** — reçoit l'avis de passage ; peut demander une suspension.
+
+## 3. Déclencheur & sortie
+
+- **Déclencheur** : validation d'une prestation (génération automatique des ITV).
+- **Sortie** : fin d'intervention — les données de production remontent de la Saisie Terrain et alimentent la RFI.
+
+## 4. Étapes du sous-process
+
+### 4.1 Génération automatique depuis les prestations
+À la validation des prestations, les interventions sont générées. Elles héritent des paramètres de la prestation **et des visites précédentes** (rapports, FPV, consignes de la chaîne accord → contrat → prestation). Une intervention peut comporter **plusieurs RDV de service**. Tous les éléments de planification sont transmis automatiquement au bloc Affectation & planification.
+
+> 🟢 **Horizon de génération (décision atelier).** Les interventions sont générées sur un
+> horizon de **24 mois glissants** (et non sur toute la durée du contrat d'un coup).
+
+### 4.2 Affectation & planification
+Transmission des infos d'intervention pour affectation. Réception de l'affectation du technicien et du créneau horaire. Si le dossier est **« Lié PlanUp »**, l'affectation est **bloquée côté SatPRO** : **7Opteam est maître** de la planification.
+
+### 4.3 Envoi au technicien
+Envoi des éléments de production au technicien (Saisie Terrain) : client, missions, durée, rapports précédents, NP, matériels à contrôler. Envoi au **client** d'un avis de passage automatique (ex. J-14, paramétrable).
+
+### 4.4 Fin d'intervention & suivi
+Réception des données de production (temps réel, observations, photos, écarts déclarés, rapport PDF + pièces jointes). Suivi des **codes état** (suspension / annulée / reprise / terminée) et des **codes facturation**, deux statuts **indépendants** ajustés automatiquement selon les règles définies.
+
+Précisions atelier :
+
+- **Suspendue ≠ résiliée** : distinguer une intervention **suspendue** (interruption temporaire, à reprendre) d'une intervention **résiliée** du fait de la **résiliation de la prestation** (fin définitive). Ce sont deux états distincts à ne pas confondre.
+- **Annulation par le client** : mieux suivre l'annulation client, qui peut **déclencher une facturation** sans pour autant **empêcher la replanification**. Y compris quand le rendez-vous n'a pu être honoré (ex. **intervenant malade**) : il faut **alerter sur la nécessité de replanifier** l'intervention.
+
+## 5. Règles de gestion
+
+- **RG-ITV-01** — Les interventions sont générées **automatiquement** à la validation de la prestation.
+- **RG-ITV-02** — Une intervention hérite des paramètres de la prestation **et des visites précédentes**.
+- **RG-ITV-03** — Une intervention peut comporter **plusieurs RDV de service**.
+- **RG-ITV-04** — Toute modification post-validation d'un élément héritable de la prestation se propage aux interventions **non encore produites** ; les interventions **produites restent figées**.
+- **RG-ITV-05** — Les **codes état** et **codes facturation** sont **indépendants** et ajustés automatiquement selon des règles définies.
+- **RG-ITV-06** — Une intervention peut être **suspendue** (sur demande client ou Dekra). Une intervention **suspendue doit être reprise** ; à défaut, elle est considérée **terminée**.
+- **RG-ITV-07** — Si le dossier est **« Lié PlanUp »**, l'affectation est **bloquée** dans SatPRO (7Opteam maître).
+- **RG-ITV-08** — Un **avis de passage** est envoyé automatiquement au client (ex. J-14, paramétrable).
+- **RG-ITV-09** — Une intervention **annulée** est suivie (date, motif, élément déclencheur) et **facturée** selon les paramètres de facturation prédéfinis.
+- **RG-ITV-10** — Les interventions sont générées sur un horizon de **24 mois glissants**.
+- **RG-ITV-11** — Une intervention **suspendue** (temporaire, à reprendre) est **distincte** d'une intervention **résiliée** suite à la **résiliation de la prestation** (définitif).
+- **RG-ITV-12** — Une **annulation client** peut **déclencher une facturation** sans **bloquer la replanification**. Lorsqu'un RDV ne peut être honoré (ex. intervenant indisponible), le système **alerte** sur la **replanification** à effectuer.
+
+## 6. Données
+
+### 6.1 Données héritées (de la prestation)
+Paramètres (montants, temps, missions, qualifications) ; visite précédente, rapports, FPV ; consignes héritées (accord → contrat → prestation).
+
+### 6.2 Données paramétrables dans SatPRO
+- Documents joints (NP, BDC, annexes).
+- Consignes complémentaires propres à l'intervention.
+- Code état : suspension / annulée / reprise.
+
+### 6.3 Données échangées
+| Sens | Système | Données |
+|------|---------|---------|
+| Envoyées | **PlanUp / 7Opteam** | Transmission des infos ITV pour affectation |
+| Reçues | **PlanUp / 7Opteam** | Affectation technicien & créneau horaire (si « Lié PlanUp » → affectation bloquée côté SatPRO, 7Opteam maître) |
+| Envoyées | **Saisie Terrain** | Client, missions, durée, rapports précédents, NP, matériels à contrôler |
+| Envoyées | **Client** | Avis de passage automatique (J-14 paramétrable) |
+| Reçues | **Saisie Terrain** | Temps réel, observations, photos, écarts déclarés, rapport (PDF + PJ) |
+
+## 7. Cas particuliers
+
+- **Suspension / reprise** : une suspension non reprise équivaut à une fin d'intervention (voir RG-ITV-06).
+- **Annulation** : suivie et facturée selon les paramètres (voir RG-ITV-09).
+- **Dossier « Lié PlanUp »** : planification pilotée par 7Opteam.
+- **Interventions à RDV multiples** : plusieurs rendez-vous de service pour une même intervention.
+
+## 8. Points ouverts
+
+- 🔴 Lister les **codes état** et **codes facturation**, leurs valeurs et leurs **règles de transition automatiques**.
+- 🔴 Définir les **motifs d'annulation** et les règles de facturation associées (ex. annulation à 48h / jour même).
+- 🟡 Préciser les règles de reprise d'une intervention suspendue (délai au-delà duquel elle est terminée).
+- ⚪ Confirmer la frontière d'affectation **SatPRO ↔ PlanUp / 7Opteam** (quand chacun est maître).
+- ⚪ Confirmer le délai paramétrable de l'**avis de passage** (J-14 par défaut ?).