Examen de plans d'exécution (drawing-review)
Confiez à l'agent le processus suivant : "glisser les plans → analyse automatique → vérification selon une grille → résultats traçables dans le dessin original → confirmation humaine". Le résultat est une liste de problèmes potentiels à vérifier par les concepteurs, et non un avis d'examen formel ou une conclusion de conformité.
Règles impératives
- Ne pas examiner ni divulguer les cartouches et informations d'identité. Les cartouches (signatures de conception, vérification, approbation, etc., noms des entreprises, nom du projet, dates, tampons, numéros de certificat, téléphones) sont des données anonymisées et ne font pas partie de l'examen. Ne signalez pas de problèmes comme "signature manquante", "écriture du nom de l'entreprise", "date du cartouche", etc.
- N'ouvrez jamais les plans originaux directement. Lisez uniquement les fichiers générés par
extract:review_input.md,blocks.jsonl,coverage.json. En mode image, ne regardez que les images listées dansimages.json, déjà masquées localement.mapping.local.jsoncontient la correspondance avec le texte original, ne le lisez, ne le référencez et ne le téléchargez jamais. Conservez les espaces réservés (ex. [Unité1]) dans le rapport, ne tentez pas de les rétablir. - Ne signalez que les problèmes prouvables par le texte original du plan. Chaque problème doit comporter au moins une citation textuelle + un identifiant de bloc (ex.
F1-P3-B12). Ne signalez pas ce qui ne peut pas être prouvé par le texte donné. L'ordre d'extraction du PDF ne doit pas faire considérer des textes adjacents comme faisant partie du même élément. - La correspondance entre objets doit être prouvée. Avant de comparer deux textes, confirmez qu'ils se réfèrent au même élément/coupe/zone/condition de charge (même numérotation avec une zone d'étage claire, renvoi explicite à un détail, même clause dans le contexte). Les comparaisons entre pages et entre fichiers doivent comporter
object_match: "explicit"et expliquer le fondement dansbasis. Si ce n'est qu'une déduction, écrivezinferred; le script rétrogradera l'élément en "condition supplémentaire nécessaire". - Les conclusions normatives doivent être étayées par des sources vérifiables. N'affirmez pas de mémoire que "la norme exige telle valeur", n'inventez pas de numéros d'articles. Seules les règles vérifiées dans
references/verified-rules.mdpeuvent conclure à une "valeur inférieure à la norme". Pour les autres normes, écrivez "article correspondant à vérifier" ouneeds_context. Vérifiez en ligne si une norme est en vigueur ; si impossible, écrivez "non vérifié". - Laissez les scripts effectuer les calculs numériques. Pour vérifier les formules des notes de calcul, les surfaces d'acier, les taux d'armature, utilisez la commande
calcou écrivezcalculationdans les constats. Ne faites pas de calcul mental. Si un paramètre manque, écrivezneeds_context, ne complétez jamais les paramètres vous-même. - L'interprétation d'images est uniquement un support. Les dimensions ou armatures lues sur l'image mais non corroborées par la couche texte ne peuvent être que des "conditions supplémentaires à vérifier" et doivent préciser "à vérifier sur le plan original". N'inventez pas de diamètres, espacements ou nombres de barres illisibles.
- Mieux vaut peu que beaucoup. La valeur réside dans un faible nombre de constats précis. Les mêmes problèmes apparaissant à plusieurs endroits doivent être fusionnés en un seul constat listant toutes les positions. "Aucun problème trouvé" signifie seulement qu'aucun problème n'a été détecté dans le cadre de cette vérification et dans la plage lisible, n'écrivez jamais "conforme/examen réussi".
Procédure
Étape 0 : Définir le périmètre et le mode (une ou deux phrases, ne faites pas remplir de formulaire à l'utilisateur)
- Si l'utilisateur a donné des points de vérification précis (ex. "uniquement l'étanchéité", "vérifier en priorité les armatures des poutres", "cette coupe correspond-elle aux notes de calcul"), suivez-les. Sinon, utilisez tous les points de la grille
references/review-checklist.md. - Si la spécialité technique n'est pas claire, ne devinez pas ; indiquez "spécialité inconnue" et effectuez uniquement les vérifications génériques. Pour les normes locales, demandez à l'utilisateur la province concernée. Le nom du projet étant anonymisé, ne déduisez rien des espaces réservés.
- Choisir le mode :
- Mode texte (par défaut, utilisable par tout modèle) : lisez uniquement la couche texte, utilisez les coordonnées des blocs et la commande
nearpour déterminer l'appartenance des annotations. - Mode image (optionnel) : uniquement si vous pouvez effectivement voir les images et que l'utilisateur a explicitement accepté de transmettre les pages masquées localement au modèle actuel. Après l'étape 1, s'il y a des pages "principalement graphiques" ou si l'utilisateur souhaite vérifier des armatures/dimensions, demandez en une phrase : "Ces pages sont principalement graphiques. Voulez-vous que je vous montre les pages avec les cartouches et informations sensibles masqués pour m'aider à attribuer les annotations ?". Si vous ne pouvez pas voir les images, ne demandez pas et utilisez le mode texte.
- Mode texte (par défaut, utilisable par tout modèle) : lisez uniquement la couche texte, utilisez les coordonnées des blocs et la commande
Étape 1 : Extraction locale et anonymisation
pip install pdfplumber # Première utilisation ; en Chine, ajoutez -i https://pypi.tuna.tsinghua.edu.cn/simple
python scripts/drawing_review.py extract <plan1.pdf> [notes_de_calcul.pdf rapport_géotechnique.pdf ...] --out review_pack [--extra-terms mots_sensibles.txt]
- Uniquement PDF (doit contenir une couche texte ; les PDF vectoriels directement exportés depuis la CAO sont les meilleurs). Si l'utilisateur fournit des DWG/DXF, demandez-lui d'exporter en PDF depuis la CAO. Les pages scannées ou dont les polices ne sont pas décodables sont marquées "non examinées". Ne faites pas d'OCR et ne devinez pas le contenu.
- Plusieurs fichiers sont extraits ensemble ; les identifiants de bloc incluent automatiquement le numéro de fichier (F1, F2…), ce qui évite les confusions lors des comparaisons entre fichiers.
coverage.jsoncontient le SHA-256 et le type présumé de chaque fichier (plan/note de calcul/rapport géotechnique). --extra-terms: mots sensibles supplémentaires spécifiés par l'utilisateur (abréviations de projet, noms de lieux, noms de personnes), un par ligne.- Informez d'abord l'utilisateur : nombre total de pages, nombre de pages examinées / principalement graphiques (peu de texte) / non examinées, nombre de textes de cartouches supprimés, nombre d'informations sensibles remplacées. Si des "alertes de reconnaissance de cartouche" ou de "possibles résidus de noms" sont détectées, mentionnez-le également.
Étape 2 : Lecture des documents d'examen et vérification selon la grille
Lisez review_pack/review_input.md (divisez page par page si trop long) et references/review-checklist.md. Si nécessaire, lisez references/verified-rules.md.
- Parcourez chaque point de la grille. Pour chaque lot de pages, il y a généralement 0 à 2 problèmes réellement certains.
- Pages de notes de conception : vérifiez selon les points C1 à C9. Extrayez simultanément les paramètres clés (objet + paramètre + valeur + citation) pour les comparaisons entre pages et entre fichiers (C8, C12, C13).
- Pages de plans (plans d'armatures, coupes, vues en plan) : les courtes annotations sont accompagnées de coordonnées
@x,y. Pour déterminer à quel élément une annotation appartient, exécutezpython scripts/drawing_review.py near --pack review_pack --block F1-P3-B12(liste les textes environnants, direction, distance) ounear --page F1-P3 --region x0,y0,x1,y1(liste les textes dans une région). La proximité n'implique pas de relation ; si l'appartenance n'est pas claire, ne comparez pas. - Notes de calcul : vérifiez les formules et résultats avec
python scripts/drawing_review.py calc "expression"(prend en chargeAs(d,n),As_s(d,s),rho(As,b,h0),sqrt,sind, etc.). Signalez uniquement les erreurs de recopie, de substitution et de calcul (C14), n'évaluez pas le choix du modèle de calcul. - Mode image (si l'étape 0 a obtenu l'accord) :
python scripts/drawing_review.py render <mêmes PDF...> --pack review_pack [--pages F1-P3,F1-P5]. Consultez les pages entières listées dansimages.json(les cadres noirs sont des zones masquées, les nombres en grille bleue sont les coordonnées de la page).- Pour les détails :
python scripts/drawing_review.py zoom <PDF> --pack review_pack --page F1-P3 --region x0,y0,x1,y1(les coordonnées sont lues sur les nombres de la grille). La sortie liste les blocs de texte dans cette région, facilitant les références. - L'image est utilisée pour déterminer la correspondance entre annotations, hachures de coupe, renvois et éléments. Les conclusions doivent toujours citer des blocs de texte. Les preuves visuelles sont écrites dans
visual_evidence(page, coordonnées de la région, texte lu). - Les pages scannées ou avec des polices illisibles ne sont pas rendues par défaut. N'ajoutez pas
--allow-unmasked-pages, sauf si l'utilisateur accepte explicitement et sait que ces pages n'ont subi qu'un masquage conservateur sur les bords.
- Chaque constat potentiel est écrit dans la structure JSON définie par
references/report-format.mdet enregistré dansreview_pack/findings.json(incluezcheck_method,object,object_match, etcalculationpour les vérifications de calcul).
Étape 3 : Contre-argumentation et vérification personnelle (obligatoire)
Pour chaque constat potentiel, jouez le rôle d'un vérificateur strict et tentez de le réfuter : s'agit-il d'un décalage dû à l'ordre d'extraction ? Est-ce que différentes zones/conditions de charge/étapes de construction sont naturellement différentes ? Les deux textes peuvent-ils être confirmés comme appartenant au même objet ? La formulation est-elle une convention courante dans le secteur ? La conclusion repose-t-elle sur des connaissances externes ? Le recalcul a-t-il utilisé des paramètres absents du plan ? En cas de doute, supprimez le constat ou rétrogradez-le en needs_context. Dans le JSON, écrivez clairement basis (fondement du jugement) et uncertainties (conditions non confirmées).
Étape 4 : Vérification et génération du rapport
python scripts/drawing_review.py verify --pack review_pack --findings review_pack/findings.json
python scripts/drawing_review.py evidence <mêmes PDF...> --pack review_pack # Optionnel : génère des captures d'écran masquées du plan original pour chaque problème
python scripts/drawing_review.py report --pack review_pack --title "Rapport d'examen XX (Auto-assistance IA)"
verifyattribue à chaque problème un niveau de preuve : E1 la citation apparaît-elle textuellement dans le bloc indiqué (ou dans les blocs suivants contigus) ; E2 la comparaison entre pages/fichiers déclare-t-elle et explique-t-elle la correspondance des objets ; E3 le recalcul confirme-t-il une incohérence numérique. Si la citation n'est trouvée que dans une autre page/fichier, elle n'est pas considérée comme localisée (relocated_candidate) et le problème est rétrogradé en "indice à vérifier" ; si la correspondance des objets n'est pas confirmée ou repose uniquement sur une lecture visuelle, le problème est rétrogradé en "condition supplémentaire nécessaire" ; si le recalcul est cohérent avec le fichier, le problème de calcul est rétrogradé en indice.- Si le nombre de rétrogradations est élevé, revenez à l'étape 2 pour vérifier les citations, les identifiants de bloc et les correspondances d'objets, puis corrigez et relancez. Ne modifiez ni n'inventez de citations pour passer la vérification.
evidencegénère uniquement les captures localement, avec des cadres rouges pour localiser les preuves et des cadres noirs pour le masquage. En mode texte, il n'est pas nécessaire de visualiser ces images.reportgénèrereview_pack/rapport_d_examen.md. Pour obtenir un Word/PDF, convertissez à partir de ce fichier sans ajouter ni supprimer de conclusions.
Étape 5 : Présentation à l'utilisateur
En 3 à 6 lignes, résumez : nombre de problèmes suspects (listez les 1 à 3 plus importants avec titre et position), nombre de conditions supplémentaires nécessaires, pages/contenu non examinés, utilisation éventuelle du mode image, chemin du fichier de rapport. Rappelez que les problèmes du rapport doivent être confirmés manuellement un par un. Lorsque l'utilisateur confirme ou exclut un problème, conservez sa décision (review_status) dans les examens ultérieurs, sans qu'elle soit écrasée par une nouvelle vérification.
Réexamen (après modification)
Lorsque l'utilisateur fournit une nouvelle version des plans : réexécutez extract dans un nouveau répertoire (SHA-256 différent = nouvelle version). Après l'examen, comparez avec la version précédente verified.json. Les problèmes présents dans la version précédente mais absents de la nouvelle sont écrits comme "n'est plus apparu cette fois" (peut être modifié ou non détecté en raison de différences de reconnaissance). Ne dites pas "corrigé". Les problèmes exclus par l'utilisateur dans la version précédente restent exclus.
Fichiers de référence
references/review-checklist.md: Grille des points de vérification (C1 à C15, incluant géométrie des plans, armatures, correspondance avec les notes de calcul et les paramètres géotechniques, recalcul des formules, étapes de construction), points d'attention par spécialité technique, contenu à ne pas signaler.references/verified-rules.md: Règles normatives vérifiées et applicables (ex. classe de résistance minimale du béton) et substitutions de normes vérifiées.references/desensitization.md: Périmètre d'anonymisation, signification des espaces réservés, méthodes et limites de la reconnaissance des cartouches et du masquage d'images.references/report-format.md: Champs defindings.json, classification des conclusions, classification des preuves, structure du rapport.