docs/DEMO_SCRIPT.md

# Script de démonstration — GuichetOI Orange

Durée cible : **3–5 minutes**. Tous les échantillons s'affichent **instantanément** (résultats précalculés).

## 0. Préparation (avant de lancer l'enregistrement)

```powershell
# Démarrer le démo
streamlit run streamlit_demo.py
```

- Attendre que la page charge (≈30 s, modèle LayoutLMv3).
- Mettre la fenêtre en plein écran.
- Désactiver les notifications système.

---

## 1. Ouverture (15 sec)

> *« Ceci est l'outil de vérification automatique des demandes de localisation
> PAR pour le Guichet Accueil Infrastructures d'Orange. Il identifie les
> documents fournis par les bureaux d'études, vérifie la complétude de chaque
> demande selon les consignes AGILIS, puis génère le brouillon d'accusé de
> réception ainsi qu'un fichier CMS pré-rempli prêt à être déposé dans Banbou. »*

Pointer la barre latérale gauche pour montrer les 5 étapes du pipeline.

---

## 2. Échantillon 1 — Demande complète (60 sec)

Cliquer sur **✅ Demande complète — PIM résidentiel**.

> *« Premier cas : une demande d'un seul logement résidentiel. Le moteur a
> analysé 6 documents en parallèle. »*

**Pointer**:
- Le bandeau vert **DEMANDE COMPLÈTE — sous réserve de vérification manuelle**.
- Composition de la demande : ✓ Fiche, ✓ Autorisation, ✓ Plan masse, ✓ Plan situation.
- Synthèse de la fiche : Référence d'urbanisme, DLPI, cabinet conseil, nb logements.
- Mentionner les drapeaux de vérification manuelle (mandat OUI/NON illisible
  sur le formulaire — le consultant tranche).

> *« Et la valeur ajoutée principale : le fichier CMS IMMO 9 BANBOU est
> pré-rempli automatiquement à partir des champs extraits. »*

Faire défiler jusqu'à la section CMS, montrer les **12 métriques dérivées**
(Type Site, Détection, Pré-équipé…), cliquer sur **Télécharger le CMS pré-rempli**.

Ouvrir l'xlsx dans Excel pour montrer la ligne pré-remplie sur l'onglet
*création IMB* (TypeSite, adresse, ref urbanisme, DLPI ajustée, détection, …).

---

## 3. Échantillon 2 — Noms de fichiers atypiques (45 sec)

Cliquer sur **✅ Demande complète — noms de fichiers atypiques**.

> *« Cas réel reçu par le Guichet : les noms de fichiers ne suivent pas la
> convention "Plan-de-masse_*", ils sont en majuscules sans préfixe PF —
> "ARRETE PC.jpg", "CERTIFICAT ADRESSAGE.jpg". »*

**Pointer** les drapeaux par document :
- `class_overridden_by_filename:PlanSituation->Autorisation` sur ARRETE PC
- `class_overridden_by_filename:PlanSituation->Certificat` sur CERTIFICAT ADRESSAGE

> *« Le modèle a d'abord classé ces fichiers comme plan de situation — à
> raison vu leur apparence visuelle. Le moteur de règles a ensuite corrigé
> la classification à partir du nom de fichier, et la demande est validée
> complète. »*

---

## 4. Échantillon 3 — Demande incomplète (45 sec)

Cliquer sur **⚠️ Demande incomplète — collectif, champ manquant**.

> *« Projet collectif de 14 logements. Tous les documents sont là, mais le
> champ "nombre total de logements" sur la fiche n'a pas pu être lu
> automatiquement. »*

**Pointer**:
- Bandeau rouge **DEMANDE INCOMPLÈTE**.
- Section "Documents incomplets" : la raison précise.
- Section "Vérification manuelle requise" : plan de situation à vérifier.
- Le **brouillon d'accusé de réception** en bas — déjà rédigé avec les bonnes
  raisons, prêt à être collé dans MSURVEY.

> *« Et même quand la demande est incomplète, le consultant peut générer un
> CMS partiel pour le compléter manuellement — le système liste précisément
> les champs à remplir. »*

Faire défiler jusqu'à la section CMS, montrer les "champs attendus non extraits"
(numéro de voie, etc.).

---

## 5. Échantillon 4 — Hors-périmètre (30 sec)

Cliquer sur **🔁 Hors-périmètre — dossier de récolement**.

> *« Quatrième cas : le déposant a envoyé un dossier de récolement —
> tranchées, points d'adduction, certificat de conformité — au lieu d'une
> demande de localisation initiale. »*

**Pointer**:
- Bandeau orange **HORS PÉRIMÈTRE — routage manuel requis**.
- Le mail d'accusé de réception adapté : "Les pièces correspondent à un
  dossier de récolement, votre dossier va être ré-orienté."

> *« Le système détecte ces cas automatiquement à partir des noms de fichiers
> et évite que le consultant traite une demande qui n'est pas la sienne. »*

---

## 6. Conclusion (30 sec)

Revenir à la page d'accueil (effacer l'échantillon).

> *« Pour résumer : sur les 11 demandes de référence testées, le système a
> traité automatiquement les 7 demandes complètes, identifié précisément
> 3 incomplètes avec les raisons exactes, et détecté le dossier hors-périmètre.
> Chaque verdict génère le mail d'accusé et, quand c'est pertinent, un CMS
> pré-rempli. »*
>
> *« Il reste évidemment des champs métier qui nécessitent un coup d'œil
> humain — coordonnées Géoréso, n° SIRET, identifiant Mondofi — et le
> système les liste explicitement pour que rien ne soit oublié. Merci. »*

---

## Notes utiles pendant le tournage

| Situation | Action |
|---|---|
| Si vous voulez montrer une **analyse en direct** | Téléverser un ZIP de votre choix — comptez ≈30 s à 2 min sur CPU. |
| Si vous voulez **revenir à l'accueil** | Cliquer sur **✖ Effacer l'échantillon**. |
| Si une **erreur d'import** survient au démarrage | Vérifier que `streamlit`, `openpyxl`, `python-pptx`, `PyMuPDF` sont installés dans le `.venv` (déjà fait). |
| Si vous voulez **fermer puis rouvrir** | `Ctrl-C` dans le terminal, puis `streamlit run streamlit_demo.py`. |