Revisión de planos de construcción (drawing-review)
Te encomendamos el flujo de revisión de planos: "arrastrar planos → análisis automático → revisión según lista → resultados trazables al plano original → confirmación manual". El resultado es una lista de problemas candidateados para que el diseñador verifique, no un dictamen formal de revisión ni una conclusión de cumplimiento.
Reglas inviolables
- No se revisan ni divulgan sellos ni información de identidad. Los sellos (firmas de diseño/revisión/aprobación/especificación, unidad de diseño, unidad constructora, nombre del proyecto, fecha, sello de emisión, sello de registro, número de certificado, teléfono) son datos desensibilizados y no forman parte del alcance de la revisión. No informes sobre "falta de firma", "redacción del nombre de la unidad" o "fecha del sello".
- No abras los planos originales directamente. Solo lee
review_input.md/blocks.jsonl/coverage.jsongenerado porextract. En modo imagen solo mira las imágenes listadas enimages.jsonque ya han sido ocultadas localmente.mapping.local.jsoncontiene la correspondencia con el original, nunca lo leas, cites ni subas. Mantén los marcadores de posición (ej. [Unidad1]) sin intentar restaurarlos. - Solo informa problemas que puedan probarse con texto textual del plano. Cada problema debe tener al menos una cita textual + número de bloque (ej.
F1-P3-B12). No informes problemas que no puedan demostrarse con el texto dado; las "letras adyacentes" causadas por el orden de extracción del PDF no se consideran del mismo elemento. - La correspondencia de objetos debe poder probarse. Antes de comparar dos textos, confirma que son del mismo elemento/sección/ubicación/condición de trabajo (mismo número con área de piso clara, referencia explícita a detalles, contexto de la misma cláusula). Las comparaciones entre páginas o archivos deben escribir
object_match: "explicit"y explicar la base enbasis; si solo es inferido, escribeinferredy el script lo degradará a "necesita condiciones complementarias". - Las conclusiones normativas deben tener una base verificable. No afirmes de memoria "la norma debería exigir tal valor" ni inventes números de cláusulas. Solo las reglas verificadas en
references/verified-rules.mdpueden dar conclusiones del tipo "por debajo de la norma"; otras referencias normativas solo pueden escribir "cláusula relacionada pendiente de verificación" oneeds_context. Verifica la vigencia de las normas en fuentes oficiales en línea; si no se encuentra, escribe "no verificado". - Deja que el script calcule los valores. Al recalcular ecuaciones de libros de cálculo, áreas de acero, tasas de refuerzo, usa el comando
calco escribecalculationenfindings. No hagas cálculos mentales; si faltan parámetros, escribeneeds_context; no completes parámetros por tu cuenta. - La lectura de imágenes solo es auxiliar. Las dimensiones y refuerzos leídos de la imagen, si no se encuentran en la capa de texto, solo pueden ser "necesita condiciones complementarias" y deben indicar que se requiere verificación en el plano original; no inventes diámetros, espaciamientos o cantidades que no se vean claramente.
- Menos es mejor. El valor está en ser pocos y precisos; si el mismo problema aparece en varios lugares, combínalos en una sola entrada listando todas las ubicaciones. "No se encontraron problemas" solo indica que no se detectaron dentro de los ítems de revisión y el alcance legible; no escribas "revisión aprobada/cumple con la norma".
Flujo
Paso 0: Confirmar alcance y modo (una o dos frases, no hagas que el usuario llene formularios)
- Si el usuario dio un enfoque de revisión (ej. "solo impermeabilización", "enfócate en refuerzo de vigas", "si tal sección corresponde con el libro de cálculo"), síguelo; si no, usa todos los ítems de
references/review-checklist.md. - Si la especialidad no está clara, no adivines; indica "especialidad desconocida" y solo haz ítems de revisión generales. Pide al usuario que indique directamente la provincia para estándares locales; el nombre del proyecto ya está desensibilizado, no infieras a partir de marcadores.
- Selecciona modo:
- Modo texto (por defecto, funciona con cualquier modelo): solo lee la capa de texto, usa coordenadas de bloque y
nearpara determinar la pertenencia de anotaciones. - Modo imagen (opcional): solo si realmente puedes ver imágenes y el usuario acepta explícitamente que se muestren al modelo actual las páginas con datos sensibles ocultos localmente. Después del paso 1, si hay páginas "principalmente gráficas" o el usuario quiere verificar refuerzo/dimensiones, puedes preguntar una frase: "Estas páginas son principalmente gráficas, ¿quieres que te muestre las páginas con sellos e información sensible ocultos para ayudar a determinar la pertenencia de las anotaciones?". Si no puedes ver imágenes, no preguntes; usa modo texto directamente.
- Modo texto (por defecto, funciona con cualquier modelo): solo lee la capa de texto, usa coordenadas de bloque y
Paso 1: Extracción y desensibilización local
pip install pdfplumber # Primera vez; en China añade -i https://pypi.tuna.tsinghua.edu.cn/simple
python scripts/drawing_review.py extract <plano1.pdf> [libro_de_cálculo.pdf informe_de_prospección.pdf ...] --out review_pack [--extra-terms palabras_sensibles.txt]
- Solo admite PDF (debe tener capa de texto; los PDF vectoriales exportados directamente desde CAD son los mejores). Si el usuario da DWG/DXF, pídele que lo exporte desde CAD a PDF. Las páginas escaneadas o con fuentes no descifrables se marcan como "no revisadas", no hagas OCR ni adivines el contenido.
- Varios archivos se extraen juntos; los bloques tienen números de archivo (F1, F2…) para que las comparaciones entre archivos no se mezclen;
coverage.jsontiene el SHA-256 de cada archivo y el tipo inferido (plano/libro de cálculo/informe de prospección). --extra-terms: palabras sensibles adicionales especificadas por el usuario (abreviaturas de proyecto, nombres de lugares, nombres de personas), una por línea.- Primero dile al usuario: total de páginas, cuántas revisadas/principalmente gráficas (solo texto mínimo)/no revisadas, cuánto texto de sellos eliminado, cuánta información sensible reemplazada; si hay "sugerencias de identificación de sellos" o "posibles restos de nombres de personas", menciónalo.
Paso 2: Leer materiales de revisión y revisar según la lista
Lee review_pack/review_input.md (si es muy largo, léelo por páginas) y references/review-checklist.md; si es necesario, lee references/verified-rules.md.
- Revisa ítem por ítem; generalmente 0–2 problemas realmente seguros por lote de páginas.
- Páginas de especificaciones de diseño: revisa según C1–C9. Al mismo tiempo, extrae parámetros clave (objeto + parámetro + valor + cita) para comparaciones entre páginas y archivos (C8, C12, C13).
- Páginas de planos (refuerzo, secciones, plantas): anotaciones cortas con coordenadas
@x,y. Para determinar a qué elemento pertenece una anotación, ejecuta:python scripts/drawing_review.py near --pack review_pack --block F1-P3-B12(lista texto circundante, dirección, distancia), onear --page F1-P3 --region x0,y0,x1,y1para listar texto en una región. Cerca no significa relacionado; si la pertenencia no está clara, no compares. - Libros de cálculo: recalcula ecuaciones y resultados con
python scripts/drawing_review.py calc "expresión"(admiteAs(d,n),As_s(d,s),rho(As,b,h0),sqrt,sind, etc.). Solo reporta errores de transcripción, sustitución o cálculo (C14); no evalúes la selección del modelo de cálculo. - Modo imagen (si se obtuvo acuerdo en el paso 0):
python scripts/drawing_review.py render <mismos PDFs ...> --pack review_pack [--pages F1-P3,F1-P5], visualiza las páginas completas listadas enimages.json(cuadros negros son ocultaciones, números de cuadrícula azul son coordenadas de página).- Cuando necesites detalles:
python scripts/drawing_review.py zoom <PDF> --pack review_pack --page F1-P3 --region x0,y0,x1,y1(las coordenadas se leen de los números de cuadrícula). La salida listará los bloques de texto dentro de la región para facilitar la referencia. - Las imágenes se usan para determinar la pertenencia de anotaciones, marcas de corte, índices a elementos; las conclusiones aún deben citar bloques de texto. La evidencia visual se escribe en
visual_evidence(página, coordenadas de región, texto leído). - Las páginas escaneadas o con caracteres ilegibles no se renderizan por defecto; no añadas
--allow-unmasked-pagesa menos que el usuario acepte explícitamente y sepa que estas páginas solo tienen ocultación conservadora alrededor del perímetro.
- Cada hallazgo candidateado se escribe en la estructura JSON especificada en
references/report-format.md, guardado comoreview_pack/findings.json(incluyecheck_method,object,object_match; si hay recálculo, escribecalculation).
Paso 3: Autorefutación y revisión (obligatorio)
Para cada hallazgo candidateado, actúa como un revisor estricto e intenta refutarlo: ¿puede ser un error de orden de extracción? ¿Son diferentes partes/condiciones de trabajo/fases de construcción? ¿Se puede confirmar que los dos lugares son el mismo objeto? ¿Es una redacción habitual en la industria? ¿Depende de conocimiento externo? ¿El recálculo usó parámetros que no están en el plano? Si hay duda, elimínalo o degrada a needs_context. En el JSON, escribe basis (base del juicio) y uncertainties (condiciones no confirmadas).
Paso 4: Verificar y generar informe
python scripts/drawing_review.py verify --pack review_pack --findings review_pack/findings.json
python scripts/drawing_review.py evidence <mismos PDFs ...> --pack review_pack # Opcional: generar capturas de pantalla con ocultación para cada problema
python scripts/drawing_review.py report --pack review_pack --title "XX Informe de revisión (autocontrol asistido por IA)"
verifyclasifica la evidencia de cada problema: E1 ¿la cita aparece textualmente en el bloque escrito (o en bloques consecutivos)?; E2 ¿las comparaciones entre páginas/archivos declaran y explican la correspondencia de objetos?; E3 ¿el recálculo confirma la inconsistencia numérica? Si la cita solo se encuentra en otra página/archivo, no se considera localizada (relocated_candidate) y el problema se degrada a "pista pendiente"; si la correspondencia de objetos no está confirmada y solo hay lectura visual, se degrada a "necesita condiciones complementarias"; si el recálculo coincide con el archivo, los problemas de cálculo se degradan a pistas.- Si hay muchas degradaciones, vuelve al paso 2 para verificar citas, números de bloque y correspondencia de objetos; corrige y vuelve a ejecutar; no modifiques ni inventes citas para pasar la verificación.
evidencesolo genera capturas de pantalla localmente, con recuadros rojos para la ubicación de la evidencia y recuadros negros para ocultaciones; en modo texto no es necesario ver estas imágenes.reportgenerareview_pack/informe_revision.md. Para Word/PDF, conviértelo a partir de esto; no añadas ni elimines conclusiones.
Paso 5: Informar al usuario
En 3–6 líneas: cuántos problemas sospechosos (lista los 1–3 más importantes con título y ubicación), cuántos necesitan condiciones complementarias, qué páginas/contenido no se revisaron, si se usó modo imagen, ruta del archivo del informe. Recuerda que los problemas en el informe deben ser verificados uno por uno por humanos. Cuando el usuario confirme o descarte un problema, en revisiones posteriores mantén la decisión del usuario (review_status), no la sobrescribas con una nueva revisión.
Revisión posterior (volver a revisar después de modificaciones)
Cuando el usuario proporcione una nueva versión de los planos: vuelve a ejecutar extract en un nuevo directorio (SHA-256 diferente significa nueva versión); tras la revisión, compara con el verified.json de la versión anterior. Los problemas que estaban en la versión anterior y no aparecen en la actual se escriben como "no reapareció en esta revisión" (puede que se haya corregido o que no se haya detectado por diferencias de reconocimiento), no digas "corregido"; los problemas que el usuario descartó en la versión anterior se mantienen descartados.
Archivos de referencia
references/review-checklist.md: ítems de revisión (C1–C15, que incluyen geometría de planos, refuerzo, correspondencia de parámetros con libro de cálculo e informe de prospección, recálculo de ecuaciones, fase de construcción), puntos de atención por especialidad, contenido que no debe informarse.references/verified-rules.md: reglas normativas verificadas y ejecutables (resistencia mínima del concreto, etc.) y sustituciones de estándares verificados.references/desensitization.md: alcance de la desensibilización, significado de marcadores de posición, métodos y limitaciones de identificación de sellos y ocultación de imágenes.references/report-format.md: campos defindings.json, clasificación de conclusiones, clasificación de evidencia, estructura del informe.