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

This commit is contained in:
2026-10-12 12:11:04 +02:00
commit 30608afd9e
77 changed files with 20581 additions and 0 deletions
@@ -0,0 +1,91 @@
# 01 — Vision & périmètre
## 1. Contexte
SatPRO est un outil **existant** de gestion de l'activité d'une entreprise de services de contrôle. Il orchestre le cycle de vie d'un contrat client : mise en place contractuelle, découpage en prestations, production des interventions, contrôle de conformité (RFI) et déclenchement de la facturation.
Le projet consiste à **réécrire** cet outil, pas à ajouter une fonction isolée. La réécriture poursuit trois intentions :
- **Moderniser l'interface** (aspect visuel).
- **Améliorer l'expérience utilisateur** des acteurs internes (commerce, administration, management, ordonnancement).
- **Capitaliser sur l'existant** : reprendre ce qui fonctionne, ajuster ou enrichir ce qui doit l'être, supprimer ce qui n'a plus lieu d'être. Ces arbitrages se font en atelier avec les opérationnels.
## 2. Objectifs de la phase « Specs pré-projet »
Cette phase produit **le besoin métier**, pas la solution technique. Concrètement, pour chaque étape du cycle de vie du contrat :
- suivre le **cycle de vie** d'un contrat dans SatPRO ;
- reprendre les **sous-process** de chaque étape ;
- reprendre, ajuster, enrichir, revoir ou supprimer **l'existant** ;
- définir les **données attendues** à chaque étape.
## 3. Périmètre fonctionnel (dans le scope)
Le périmètre couvert par SatPRO va de l'**initialisation du contrat** à la **préparation / déclenchement de la facturation**. Les blocs suivants sont dans le scope de la réécriture :
| Bloc | Objet |
|------|-------|
| Gestion des accords | Gestion des accords de référencement (BPU, règles d'indexation, périmètre autorisé) auxquels des contrats sont rattachés — **fonctionnalité existante de SatPRO** |
| Initialisation du contrat | Création du contrat depuis l'offre (ou une commande directe rattachée à un accord), paramétrage administratif, de production, de facturation et d'indexation, gestion des destinataires |
| Prestations | Découpage des missions vendues en prestations (canevas), héritage et propagation, regroupement / dégroupement |
| Interventions | Production concrète chez le client : affectation, planification, RDV, suivi des statuts |
| RFI | Revue de fin d'intervention : contrôle de conformité production vs contrat, gestion des écarts |
| Facturation | Préparation et déclenchement de la facture, cas particuliers, refacturation |
| Sous-traitance | Gestion STI (interne à la filiale), STE (externe) et sous-traitance intra-groupe |
| Fonctions transverses | Historisation, recherche, paramétrage par défaut, workflows de validation, mises à jour en masse |
| Pilotage | Suivi de l'activité (à définir) |
## 4. Hors périmètre (hors scope)
Les éléments suivants ne sont **pas** réalisés dans SatPRO ; SatPRO échange avec eux mais ne les remplace pas :
- Le bloc **Contact & opportunités** (amont commercial).
- Le bloc **Offre** (élaboration et validation du devis) — en amont, alimente SatPRO.
- L'outil de **production terrain** (saisie par le technicien sur le terrain) — en aval, renvoie les données de production à SatPRO.
- L'outil de **facturation** proprement dit — SatPRO prépare et transmet, la facture est émise par cet outil.
- La **planification maître** lorsque le dossier est géré hors SatPRO (voir systèmes externes).
> 🔴 **Fonctionnalités existantes à supprimer (décision atelier).**
> - **C2I** : la fonctionnalité existante C2I **n'est pas reconduite** dans la réécriture.
> Le besoin qu'elle couvrait (notamment la gestion du **déplacement infructueux** en « mode
> échec ») doit être **repensé** dans le nouvel outil (voir [10 — Facturation](10-facturation.md)).
### 4.1 Règle de création d'un contrat
> 🟢 **Décision atelier.** Un contrat ne peut être créé **que** :
> - à partir d'une **offre** (cas général, y compris offre d'avenant) ; **ou**
> - à partir d'une **commande directe rattachée à un accord** de référencement
> (création du contrat puis de ses prestations).
>
> Une **commande directe** rattachée à un **contrat existant** ne crée pas de contrat :
> elle **déclenche la part de prestation** déjà présente au contrat relative à cette commande
> (complément de prestation). Voir [05 — Initialisation du contrat](05-initialisation-contrat.md).
> Dans cette phase, aucune intégration technique n'est décrite. Les systèmes externes sont nommés uniquement pour identifier **les données échangées** avec SatPRO.
## 5. Systèmes externes en interface
| Système | Rôle vis-à-vis de SatPRO | Sens principal |
|---------|--------------------------|----------------|
| **Bingo Pro** | Offre / devis approuvé — source de création automatique du contrat | → vers SatPRO |
| **CRM** | Identité client (raison sociale, SIREN, adresse, GPS) redescendue automatiquement | → vers SatPRO |
| **PlanUp / 7Opteam** | Affectation et planification des techniciens ; peut être maître de la planification | ↔ |
| **Saisie Terrain** (outil de production) | Données de production remontées en fin d'intervention (temps réel, quantités, observations, photos, écarts, rapport) | → vers SatPRO |
| **DekraBill / DBill** | Outil de facturation : reçoit les paramètres et les lignes de facture préparés par SatPRO | ← depuis SatPRO |
| **Controlling** | Tarifs de sous-traitance par code matériel (mise à jour annuelle) | → vers SatPRO |
| **Cubes** | Restitution décisionnelle (CA facturé, coûts de sous-traitance, etc.) | ← depuis SatPRO |
> ⚪ **À confirmer** : la liste et le périmètre exact de chaque interface sont à valider en atelier. Les noms d'outils sont repris du support d'atelier.
> 🟢 **Précision atelier.** La **gestion des accords** (de référencement) n'est **pas** un système externe : c'est une **fonctionnalité existante de SatPRO**, intégrée au périmètre de la réécriture (voir §3 et la fiche [06 — Gestion des accords](06-accords.md)). Un contrat peut être rattaché à un accord et en hériter (BPU, indexation, périmètre autorisé).
## 6. Principes métier structurants
Ces principes traversent tout l'outil et doivent être tenus dans la réécriture :
- **Hiérarchie Contrat → Prestation → Intervention.** La prestation est le canevas ; l'intervention est la production concrète d'une part du contrat chez le client.
- **Héritage descendant.** Les prestations héritent du contrat ; les interventions héritent de la prestation.
- **Propagation vers le non-produit uniquement.** Toute évolution d'un paramètre héritable redescend sur les interventions **non encore produites**. Les interventions **déjà produites conservent** le paramétrage figé au moment de leur production (historique).
- **Priorité du niveau le plus bas.** Une donnée saisie au niveau prestation (ou intervention) devient « prioritaire » sur la valeur héritée.
- **Contrôle avant facturation.** Aucune facturation ne part tant que la conformité de la production n'est pas validée (RFI) : automatique si aucun écart, manuelle (acte administratif) en cas d'écart.
- **Traçabilité.** Les modifications sur contrat / prestation / intervention sont historisées (qui, quoi, quand, valeur d'origine).