L'outil rapport-word.spekty.fr automatise la production des rapports d'inspection CEE :

1. L'inspecteur saisit la mission dans Kizeo (formulaire mobile + Word Kizeo exporté).
2. Dans l'outil, l'utilisateur lance la génération en saisissant la référence de mission.
3. L'outil récupère les données Kizeo (API + Word exporté) et le contenu SharePoint (fichier commande, statut, photos).
4. Les balises de la trame Word de la fiche CEE sont remplies via leur mapping (Kizeo, formule, saisie manuelle, etc.).
5. Le rapport est édité (Word Online ou local), signé (signature image + inspecteur N2), converti en PDF, puis diffusé via Power Automate.

L'historique propose deux toggles indépendants, dont le choix est mémorisé en cookie (1 an) :

• « Mes rapports » / « Les rapports de tout le monde » — filtre par demandeur (l'utilisateur connecté ou tous).
• « Voir tous les rapports » / « Voir uniquement les rapports en cours » — affiche ou masque les rapports signés.

Un champ recherche filtre par référence de mission (insensible à la casse).

Pour un rapport en Saisies manuelles ou en édition, le bouton Ouvrir est visible. Pour un rapport en édition ou en erreur, le propriétaire peut l'annuler (croix rouge). Les admins peuvent supprimer n'importe quel rapport (icône poubelle, confirmation par référence de mission).

Chaque fiche CEE (BAT-TH-XXX, BAR-TH-YYY, etc.) regroupe :

• Un ou plusieurs formulaires Kizeo associés (recherche par ID décroissant).
• Un éventuel export Kizeo Word (formulaire dont le rendu Word est consulté pendant l'édition).
• Un attribut Sous accréditation Cofrac.
• Un attribut Désactivée : si coché, la fiche est masquée aux utilisateurs (fond rouge pâle côté admin) et la génération renvoie une erreur. Utile pendant un paramétrage en cours.
• Une ou plusieurs versions de trames Word, chacune avec une date de validité (« Valable à partir de »). Voir section dédiée.

Création / mise à jour d'une trame

Uploader un fichier .docx. L'outil scanne automatiquement les balises et propose un mapping vide pour chacune. Le numéro de version est auto-détecté depuis le nom de fichier (dernière occurrence vN, fallback v1).

Une fiche peut avoir plusieurs trames en vigueur selon la date d'engagement de l'opération (lue dans le fichier de commande, colonne nommée exactement Date d'engagement).

Paramétrage admin

Chaque trame de la fiche peut recevoir une date de validité (Valable à partir de), modifiable directement dans la liste des trames :

• Trames avec date → en vigueur, candidates à la sélection automatique.
• Trames sans date → brouillon / orphelines (badge orange), jamais sélectionnées automatiquement, utiles pendant un paramétrage WIP.

Affichage trié : trames en vigueur d'abord (valid_from desc), puis brouillons en dessous.

Sélection à la génération

L'outil applique ces règles :

Modale de sélection

• Bandeau vert : une trame est présélectionnée (date d'engagement couverte), l'utilisateur valide.
• Bandeau jaune : pas de présélection (date absente ou aucune trame ne couvre la date), l'utilisateur sélectionne manuellement.

Trois types de balises peuvent être placées dans la trame :

Conventions de nommage

• Caractères autorisés : lettres latines (incluant accents), chiffres, espaces, _.
• Les noms sont sensibles à la casse.
• Préférer le snake_case en minuscules : {{adresse_chantier}}, {{{conformite_isolation}}}, [[photo_facade]].
• Un même nom de balise peut apparaître plusieurs fois : toutes les occurrences seront remplies par la même valeur.

Pour les balises {{{...}}}, l'outil détecte automatiquement les valeurs autorisées juste après la balise. Trois règles, par ordre de priorité :

1. Slash sur la même ligne ou le 1^er paragraphe suivant : ex. Oui / Non / Non vérifiable. STOP au passage à la ligne (les paragraphes suivants ne sont plus considérés).
2. Cases à cocher Word : si le 1^er paragraphe contient une checkbox, on prend uniquement les paragraphes contenant une case.
3. Lignes séparées : sinon, chaque paragraphe d'option (en bleu, surligné, numéroté 1 –, etc.) est un choix.

Préservation des couleurs

Pour une option en couleur (ex. Non en rouge), placez la balise sur sa propre ligne et l'option sur la ligne suivante. Lors de la résolution, le run de couleur d'origine est conservé (la balise est supprimée, et seul le run du choix retenu reste).

Limite de longueur

Une ligne d'options slash-séparées est détectée jusqu'à 600 caractères. Au-delà, considérer une mise en forme sur plusieurs lignes.

Trois balises sont réservées et traitées spécifiquement par l'outil. Elles restent inchangées à la génération et sont remplies au moment de la signature (étape word_signed du pipeline).

À placer dans la trame

• Ces balises se mettent directement dans la trame Word — aucun mapping n'est nécessaire.
• Elles ne sont pas listées dans l'éditeur de mapping (filtrées automatiquement).
• Lors d'une révision, les valeurs précédentes sont effacées et les balises restaurées dans la cellule pour être ré-remplies à la nouvelle signature.

Détection des cellules

Pour la restauration en révision, l'outil reconnaît les cellules par leur libellé voisin :

• « Signature de l'inspecteur validant le rapport » → cellule voisine = {{signature}}
• « Inspecteur (étude documentaire et validation du rapport) » → cellule voisine = {{inspecteur_n2}}
• « Date du rapport » → cellule voisine = {{date_rapport}}

À ne pas confondre avec les balises réservées ci-dessus, ces fonctions s'utilisent dans une formule de mapping pour produire des valeurs calculées :

Exemple : un mapping de type formula avec source_value UTILISATEUR() remplit automatiquement le nom de l'inspecteur à la signature.

Un tag est marqué non résolu dans les cas suivants :

• la source ne renvoie rien (None ou ""),
• la formule échoue ou retourne une chaîne vide,
• la validation value_list rejette la valeur,
• la validation number/integer rejette la valeur.

Dans ce cas, le surlignage jaune est conservé pour signaler la balise à compléter manuellement avant signature. La balise {{...}} est retirée du document mais la cellule/ligne reste surlignée.

Pour chaque balise détectée dans la trame, on définit comment la valeur est obtenue :

validation_type

• value_list : la valeur doit appartenir à la liste fournie en validation_param (une valeur par ligne). Si non, le tag reste non résolu.
• number : la valeur doit être un nombre. La virgule décimale française est convertie automatiquement en point pour les calculs ($TAG.x dans une formule).
• integer : nombre entier uniquement.

use_label

Pour les balises de type choice mappées sur Kizeo : cocher use_label indique d'utiliser le libellé de l'option Kizeo plutôt que sa valeur.

Depuis l'éditeur de mapping d'une trame, le bouton Importer permet de copier la configuration d'une autre trame.

• Les trames de la même fiche CEE sont placées en haut et surlignées en jaune dans la modale de sélection.
• Pour chaque trame source : nombre de tags, mappés, et patterns Kizeo Word disponibles.

Comportement

• Pour les balises ayant le même nom dans les deux trames : le mapping est copié.
• Les Patterns Kizeo Word référencés par les mappings importés sont également importés (s'ils n'existent pas déjà).
• Cas même fiche : les balises présentes dans la source mais pas dans la cible sont également créées dans la cible avec leur mapping (pratique pour migrer une nouvelle version de trame).

Le Word exporté par Kizeo est parsé pour extraire des valeurs autour de patterns texte. Chaque Pattern a 3 attributs :

• pattern_text : texte recherché dans le Word (insensible à la casse, espaces normalisés).
• label : nom utilisé pour référencer la valeur dans les mappings ($KIZW.label, ou source_value = label pour un mapping kizeo_word).
• value_position : position de la valeur par rapport au pattern.
  • right : cellule à droite (tableau).
  • below : cellule en dessous.
  • exists : booléen — renvoie "true" si le pattern est présent quelque part, "false" sinon.

Règle « première ligne »

Si la cellule de valeur contient plusieurs lignes (ex. Oui suivi de Commentaire : XXX), seule la 1^ère ligne non vide est conservée. Si la valeur attendue n'est pas sur la 1^ère ligne, le tag reste non résolu.

Lorsqu'au moins une balise est mappée sur manual_input, une modale obligatoire est affichée juste avant l'édition du rapport :

• À gauche : aperçu du Word Kizeo (référence visuelle pour les saisies).
• À droite : les champs à saisir.
• Les saisies sont collectées avant la génération, donc utilisables dans des formules $TAG. d'autres balises.
• Si l'utilisateur ferme la modale avec la croix, le rapport reste en statut Saisies manuelles. Cliquer sur Ouvrir dans la liste ré-affiche la modale.

Types de saisie

• text (par défaut) : zone de texte libre.
• number / integer : champ numérique. La virgule est convertie en point dans les formules.
• choice : liste déroulante uniquement disponible pour les balises de type choice. Les options sont les valeurs détectées dans la trame.

Révision d'un rapport déjà fait dans l'outil

La modale n'est pas ré-affichée : les saisies de la version précédente sont reprises automatiquement. À l'inverse, pour la révision d'un rapport hors-outil, la modale est affichée comme pour une 1^ère génération.

Les références sont remplacées avant évaluation. Une chaîne "true"/"false" est convertie en 1/0 pour les conditions IF.

Résolution topologique : les balises avec dépendances $TAG. sont évaluées dans le bon ordre. Les cycles sont détectés et abandonnés.

Logique

IF(cond, vrai, faux), IFS(c1, v1, c2, v2, ...), AND, OR, NOT, ISNUMBER, ISBLANK.

Texte

CONCAT, COALESCE, UPPER, LOWER, TRIM, LEFT, RIGHT, MID, LEN, SEARCH, REPLACE, CHAR, TEXT.

Nombre

ABS, INT, MOD, MIN, MAX, ROUND.

IF($KIZW.Photo_horodatee, "Photos en annexe", "Connexion insuffisante : aucune photo fiable")

IFS($TAG.surface < 50, "Petit",
    $TAG.surface < 200, "Moyen",
    $TAG.surface >= 200, "Grand")

CONCAT($CMD.adresse, " — ", $CMD.code_postal, " ", $CMD.ville)

ROUND($TAG.surface_isolee / $TAG.surface_totale * 100, 1)

CONCAT("Rev. ", REVISION(), " du ", DATE_RAPPORT())

IF(ISNUMBER($KIZW.note), $KIZW.note / 10, "non noté")

1. Pré-checks : rapport déjà en cours ? révision ? statut SharePoint ? nombre de missions Kizeo réalisables ?
2. Sélection de trame (multi-trames) : modale si plusieurs trames en vigueur, ou date d'engagement < valid_from d'une trame unique. Voir section dédiée.
3. Récupération des données Kizeo, Kizeo Word et SharePoint.
4. Saisies manuelles (modale obligatoire si applicable).
5. Résolution topologique des mappings (gère les dépendances $TAG. entre balises, détecte les cycles).
6. Remplissage des balises dans le Word :
   • Texte / Choix : remplacement avec préservation du formatage des runs adjacents.
   • Photos : insertion d'images redimensionnées (cellule ou largeur de page).
   • Cases à cocher : la case correspondant à la valeur est cochée (croix Word ☒).
7. Upload sur SharePoint, le rapport passe en statut En édition.

• Word Online : édition collaborative dans le navigateur. L'iframe est détruite avant la signature pour libérer le verrou SharePoint.
• Local : télécharger / modifier / re-uploader. Verrouillage exclusif pendant la modification.
• Transfert : un rapport peut être transféré à un autre utilisateur (propriétaire ou admin uniquement).
• Annulation / suppression : le propriétaire peut annuler un rapport en édition (croix rouge). Les admins peuvent supprimer (icône poubelle, confirmation par référence de mission).

Verrou SharePoint au moment de la signature

Si Word Online a encore un verrou actif au moment de l'upload signé (cas fréquent juste après fermeture de l'éditeur), l'outil retry automatiquement 4 fois avec des délais croissants (3 s, 8 s, 15 s, 25 s) en tentant un déverrouillage à chaque essai. Si tout échoue, le rapport reste en statut signing avec bouton Reprendre la diffusion.

Le panneau de droite affiche les photos Kizeo (groupées par ligne de tableau du Word Kizeo) et les images uploadées manuellement.

• Copier : copie l'image au presse-papier (PNG), avec lien vers l'originale pour les photos uploadées.
• Pivoter (icône ↻) : tourne l'image de 90° dans le panneau. La rotation est visuelle uniquement — appliquée à la copie clipboard, mais non persistée. Fermer/rouvrir le rapport remet à 0°.
• Recherche : filtre les groupes par texte de contexte.

Les fichiers Excel commande peuvent contenir des caractères de contrôle invisibles (ex: 0x19 apparaissant comme un rectangle dans Excel). Sans nettoyage, ils sont sérialisés sous forme _x0019_ dans le Word généré.

L'outil supprime automatiquement :

• Les vrais octets de contrôle XML interdits (0x00-0x08, 0x0B, 0x0C, 0x0E-0x1F, 0x7F).
• Les séquences littérales _xNNNN_ renvoyées par openpyxl lors du parsing Excel.

Strip appliqué à 3 niveaux (mapping_engine, word_engine pour {{tag}} et {{{tag}}}) pour une couverture totale.

La signature est resumable : en cas d'interruption, le rapport reste en statut signing avec sign_error tracé. Tout utilisateur peut reprendre.

1. word_signed — signature image + inspecteur N2 insérés dans le Word.
2. sp_uploaded — Word signé re-uploadé sur SharePoint Drafts.
3. pdf_done — conversion en PDF via Graph API.
4. pj_done — Word + PDF déposés via le webhook Power Automate.
5. fields_done — champs SharePoint mis à jour (Date 1^ère lecture, Suivi révision, Conclusion, etc.).

Avant signature, l'outil affiche les balises non résolues et les surlignages restants ; à traiter manuellement :

• Retirer : enlève uniquement le surlignage, le texte demeure tel quel.
• Modifier le rapport : retourne en édition pour ajuster le contenu.

Cette étape garantit qu'aucune balise non remplie ne traîne dans le rapport signé.

Un rapport signé peut être révisé : l'outil incrémente revision et repart :

• Rapport initial fait dans l'outil : repart du Word précédent. La trame n'est pas re-sélectionnée (continuité). Pas de modale de saisies manuelles ni de sélection de trame.
• Rapport initial hors-outil (mission au statut Terminé sur SharePoint) : repart d'une trame vierge. Le numéro de révision part de la valeur Revision lue sur SharePoint + 1 (et non pas hardcodé à 1). Les modales sélection de trame / saisies manuelles s'affichent normalement.

La fonction REVISION_PRECEDENTE() est utile pour produire un suivi des modifications dans la trame.

• Authentification : SSO Microsoft Entra ID (cookie JWT).
• Rôles : admin (toutes pages, gestion fiches/users) ou user (génération + édition).
• Signature personnelle : chaque utilisateur charge son image (PNG/JPEG, validée par magic bytes). Indicateur ✓/✗ dans le bandeau supérieur.
• Transfert de rapport : permet de changer le propriétaire d'un rapport (et déverrouille si nécessaire).