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

docs/specs-pre-projet/07-prestations.md

@@ -0,0 +1,93 @@
+# 07 — Prestations
+
+> Cahier des charges — scope et expression du besoin macro.
+> La prestation est le **canevas / chapeau** des interventions : elle découpe les missions vendues et sert de modèle à toutes les interventions produites sur la durée du contrat.
+
+## 1. Objectif
+
+Découper les missions vendues du contrat en **prestations** cohérentes (regroupement par périodicité, domaine technique et lieu), paramétrer chaque prestation, puis générer les interventions associées. La prestation hérite du contrat et transmet aux interventions.
+
+## 2. Acteurs
+
+- **Admin / Administrative** — paramètre les prestations.
+- **Ordonnancement** — contribue au regroupement (coordination planification).
+- **CDP / Manager** — suivi.
+
+## 3. Déclencheur & sortie
+
+- **Déclencheur** : mise en production du contrat (fin du bloc Initialisation).
+- **Sortie** : prestations validées → génération automatique des interventions ; information de regroupement transmise à la planification.
+
+## 4. Étapes du sous-process
+
+### 4.1 Génération automatique depuis le contrat
+Les paramètres héritables du contrat redescendent automatiquement au niveau des prestations. Le découpage regroupe les missions de **même périodicité**, **même domaine technique** et **même lieu d'intervention**.
+
+### 4.2 Paramétrage des prestations
+Les champs hérités peuvent être modifiés : la valeur saisie au niveau prestation devient **prioritaire** (sauf si le paramètre est marqué **imposé** au contrat — voir [05 — RG-CTR-16](05-initialisation-contrat.md)). Paramétrage spécifique : destinataires de documents (certains obligatoires), rapports (format, façonnage), facturation au niveau prestation, FPV (type de sortie, lieu de vérification), consignes complémentaires (conservées au renouvellement).
+
+> 🟡 **Scinder / dispatcher (précision atelier).** On doit pouvoir **scinder** une prestation
+> en plusieurs (dispatch), tant que les prestations résultantes **respectent le contrat**
+> auquel elles appartiennent.
+
+### 4.3 Regroupement / dégroupement
+Possibilité de **regrouper** des prestations compatibles (même mois, même lieu, même compétence) ; cible : élargir aux sites proches. Possibilité de **dégrouper** en cas d'erreur ou de changement de besoin client. La compatibilité des **comptes payeurs** doit être vérifiée.
+
+> ⏸️ **Fonctionnalité en attente (décision atelier).** Le regroupement / dégroupement est
+> **mis en attente** : vérifier d'abord si **Plan'UP** le gère nativement — auquel cas cette
+> fonctionnalité deviendrait **caduque**. À défaut, elle sera traitée en **fin de phase projet**.
+
+### 4.4 Validation & génération des interventions
+À la validation de la prestation, les interventions sont générées automatiquement. Toute modification **post-validation** d'un élément héritable se propage aux interventions non encore produites.
+
+## 5. Règles de gestion
+
+- **RG-PRE-01** — Les prestations résultent d'un **découpage** des missions vendues regroupées par **périodicité + domaine technique + lieu d'intervention** identiques.
+- **RG-PRE-02** — Tous les paramètres héritables du contrat **redescendent** sur la prestation.
+- **RG-PRE-03** — Toute modification d'un élément hérité **depuis le contrat** modifie la prestation (propagation descendante).
+- **RG-PRE-04** — Toute modification d'un élément héritable **sur la prestation** modifie les interventions **non encore produites**.
+- **RG-PRE-05** — Une donnée saisie sur la prestation devient **prioritaire** : une modification ultérieure de la donnée héritée du contrat **ne l'écrase pas**.
+- **RG-PRE-06** — Certaines consignes (admin, production) peuvent avoir des **champs supplémentaires propres à la prestation**, pour préciser ou remplacer l'attendu contrat ; modifier la donnée héritée du contrat **ne change pas** ces champs propres.
+- **RG-PRE-07** — Le regroupement n'est autorisé que si **timing, lieu et compétence** sont compatibles ; la compatibilité des **comptes payeurs** doit être vérifiée.
+- **RG-PRE-08** — Une prestation peut être **modifiée**, **résiliée** (sur sélection d'un motif) ou **réactivée** après résiliation.
+- **RG-PRE-09** — Les consignes complémentaires de prestation sont **conservées au renouvellement** du contrat.
+- **RG-PRE-10** — La génération des interventions est **automatique à la validation** de la prestation.
+- **RG-PRE-11** — Une prestation peut être **scindée / dispatchée** en plusieurs prestations, à condition que chacune **respecte le contrat** d'appartenance.
+- **RG-PRE-12** — ⏸️ Le **regroupement / dégroupement** (RG-PRE-07) est **en attente** : à confirmer selon la prise en charge native par **Plan'UP** ; sinon traité en fin de phase projet.
+
+## 6. Données
+
+### 6.1 Données héritées (du contrat)
+Montants contractuels ; temps & durée prévue des interventions ; mois de programmation ; périodicité ; infos client (nom, adresse, téléphone, accès) ; missions, code matériel, qualifications.
+
+> Note : les **paramètres LI (L1 à L4)** ne sont **pas** hérités ici — ce sont 4 valeurs texte paramétrées **au niveau du client** uniquement (voir [02 — Glossaire](02-glossaire.md)).
+
+### 6.2 Données paramétrables dans SatPRO
+- Tous les champs hérités (la donnée sur la prestation devient **prioritaire**).
+- Destinataires de documents (certains obligatoires).
+- Paramétrage des rapports (format, façonnage).
+- Paramétrage de la facturation au niveau prestation.
+- FPV (type de sortie, lieu de vérification).
+- Consignes complémentaires (conservées au renouvellement).
+- **Regroupement** : par même mois / lieu / compétence ; cible sites proches ; vérification des comptes payeurs.
+
+### 6.3 Données envoyées
+| Destination | Données |
+|-------------|---------|
+| **SatPRO / Interventions** | Génération automatique à la validation ; propagation des modifications post-validation sur les ITV non produites |
+| **PlanUp / 7Opteam** | Information de regroupement pour la coordination de la planification |
+
+## 7. Cas particuliers
+
+- **Résiliation / réactivation** de prestation sur motif.
+- **Dégroupement** suite à erreur ou évolution du besoin client.
+- **Renouvellement** : les consignes complémentaires de prestation sont conservées.
+
+## 8. Points ouverts
+
+- 🔴 Degré d'**automatisation du découpage** initial : entièrement automatique, semi-automatique, ou manuel avec proposition ?
+- 🔴 Lister les **motifs de résiliation** de prestation.
+- 🟡 Préciser les règles de **regroupement « sites proches »** (critère de proximité, périmètre géographique).
+- 🟡 Comportement d'un **dégroupement** sur des interventions déjà générées / produites.
+- ⚪ Préciser la signification et l'usage du **FPV**. (Les **LI L1-L4** sont des valeurs client, hors héritage — voir glossaire.)
+- ⚪ Liste des **destinataires de documents obligatoires** au niveau prestation.