Revisão de Projetos de Construção (drawing-review)
Transfere para você o fluxo de revisão: "Arraste o desenho → Análise automática → Verificação por lista → Resultado rastreável ao original → Confirmação manual". O resultado é uma lista de problemas candidatos para verificação dos projetistas, não uma opinião formal de revisão nem uma conclusão de conformidade.
Regras Inderrogáveis
- Selos e informações de identidade não são revisados nem divulgados. Selos (identificação de projeto, verificação, aprovação, etc., unidade projetista, contratante, nome do empreendimento, datas, carimbos, números de registro, telefones) são dados desidentificados e não fazem parte do escopo de revisão. Não relate problemas como "assinatura faltando", "grafia do nome da empresa" ou "data do selo".
- Não abra os desenhos originais diretamente. Leia apenas os arquivos gerados pelo
extract:review_input.md,blocks.jsonlecoverage.json. Em modo imagem, visualize apenas as imagens listadas emimages.json, que já foram mascaradas no computador local. O arquivomapping.local.jsoncontém a correspondência com o original; nunca leia, referencie ou faça upload dele. Mantenha substituições (ex: [Unidade1]) no relatório, não tente restaurá-las. - Relate apenas problemas comprováveis pelo texto do desenho original. Cada problema deve ter pelo menos uma citação textual contínua de um bloco (ex:
F1-P3-B12). Não reporte problemas que não possam ser comprovados pelo texto fornecido; não considere "textos adjacentes" devido à ordem de extração do PDF como pertencentes ao mesmo componente. - A correspondência entre objetos deve ser comprovável. Antes de comparar textos de duas localizações, confirme que se referem ao mesmo componente/seção/parte/caso (mesmo número e área de andar clara, referência explícita de detalhe, contexto da mesma cláusula). Comparações entre páginas ou arquivos devem incluir
object_match: "explicit"e justificar o fundamento embasis. Se apenas inferido, escrevainferred, e o script rebaixará para "necessita condição complementar". - Conclusões normativas devem ter fundamento verificável. Não afirme de memória que "a norma exige o valor X" nem invente números de artigos. Apenas as regras verificadas em
references/verified-rules.mdpodem dar conclusões do tipo "inferior ao mínimo normativo"; para outras questões normativas, escreva apenas "artigo relacionado pendente de verificação" ouneeds_context. Verifique a vigência das normas online em fontes oficiais; se não encontrar, escreva "não verificado". - Deixe os cálculos para o script. Ao verificar fórmulas de cálculo, áreas de aço, taxas de armadura, use o comando
calcou escrevacalculationnos achados; não faça cálculos mentais. Se faltarem parâmetros, escrevaneeds_context; não complete parâmetros por conta própria. - A leitura de imagens é apenas auxiliar. Dimensões ou armaduras lidas visualmente que não possam ser corroboradas no texto devem ser marcadas como "necessita condição complementar", indicando a necessidade de verificação no desenho original. Não invente diâmetros, espaçamentos ou quantidades ilegíveis.
- Menos é mais. O valor está em ser conciso e preciso; problemas iguais em várias localizações devem ser consolidados em um único item, listando todas as posições. "Nenhum problema encontrado" significa apenas que não houve correspondência nos itens verificados e no escopo legível; não escreva "aprovado/conforme a norma".
Fluxo
Passo 0: Confirmar escopo e modo (uma ou duas frases, não faça o usuário preencher formulários)
- Se o usuário forneceu foco de revisão (ex: "apenas impermeabilização", "verificar armadura de vigas", "se determinada seção corresponde ao cálculo"), siga-o; caso contrário, use todos os itens de
references/review-checklist.md. - Se a especialidade não estiver clara, não adivinhe; marque "especialidade desconhecida" e faça apenas verificações genéricas. Para normas regionais, peça ao usuário que informe o estado/província; o nome do empreendimento já foi desidentificado, não inferir de placeholders.
- Selecione o modo:
- Modo texto (padrão, qualquer modelo): Leia apenas a camada de texto, use coordenadas de bloco e
nearpara determinar a qual componente uma anotação pertence. - Modo imagem (opcional): Apenas se você puder realmente visualizar imagens e o usuário concordar explicitamente em enviar as imagens mascaradas para o modelo atual. Após o Passo 1, se houver páginas "predominantemente gráficas" ou o usuário quiser verificar armadura/dimensões, pergunte com uma frase: "Estas páginas são predominantemente gráficas. Gostaria que eu mostrasse as imagens das páginas com selos e informações sensíveis mascarados para auxiliar na identificação das anotações?" Se não puder visualizar, não pergunte; use o modo texto.
- Modo texto (padrão, qualquer modelo): Leia apenas a camada de texto, use coordenadas de bloco e
Passo 1: Extração local e desidentificação
pip install pdfplumber # Primeira vez; na China, adicione -i https://pypi.tuna.tsinghua.edu.cn/simple
python scripts/drawing_review.py extract <desenho1.pdf> [cálculo.pdf relatório_geotécnico.pdf ...] --out review_pack [--extra-terms arquivo_palavras_sensiveis.txt]
- Suporta apenas PDF (com camada de texto; PDF vetorial exportado diretamente do CAD é melhor). Se o usuário fornecer DWG/DXF, peça para exportar do CAD para PDF. Páginas digitalizadas ou com fontes ilegíveis são marcadas como "não revisadas"; não faça OCR ou adivinhe o conteúdo.
- Vários arquivos são extraídos juntos; os blocos são numerados com o número do arquivo (F1, F2…), evitando confusão em comparações entre arquivos.
coverage.jsoncontém o SHA-256 de cada arquivo e o tipo inferido (desenho/cálculo/relatório geotécnico). --extra-terms: Palavras sensíveis adicionais especificadas pelo usuário (abreviações do projeto, nomes de lugares, nomes de pessoas), uma por linha.- Informe ao usuário: total de páginas, quantas revisadas / predominantemente gráficas (pouco texto) / não revisadas, quantos blocos de selo foram removidos, quantas informações sensíveis foram substituídas; mencione se houve "dica de reconhecimento de selo" ou "possível resquício de nome".
Passo 2: Ler materiais de revisão e verificar por lista
Leia review_pack/review_input.md (se muito longo, leia por página) e references/review-checklist.md, se necessário leia references/verified-rules.md.
- Percorra a lista item por item; cada lote de páginas geralmente rende 0–2 problemas realmente confirmados.
- Páginas de notas de projeto: Verifique itens C1–C9. Extraia parâmetros-chave (objeto + parâmetro + valor + citação) para comparação entre páginas e arquivos (C8, C12, C13).
- Páginas de desenhos (armadura, seções, plantas): Anotações curtas vêm com coordenadas
@x,y. Para determinar a qual componente uma anotação pertence, execute:python scripts/drawing_review.py near --pack review_pack --block F1-P3-B12(lista o texto ao redor, direção, distância), ounear --page F1-P3 --region x0,y0,x1,y1para listar o texto em uma região. Proximidade não implica relação; se a atribuição não estiver clara, não faça a comparação. - Cálculos: Verifique fórmulas e resultados com
python scripts/drawing_review.py calc "expressão"(suportaAs(d,n),As_s(d,s),rho(As,b,h0),sqrt,sind, etc.). Relate apenas erros de transcrição, substituição ou operação (C14); não avalie a escolha do modelo de cálculo. - Modo imagem (com consentimento no Passo 0):
- Execute
python scripts/drawing_review.py render <mesmos PDFs ...> --pack review_pack [--pages F1-P3,F1-P5]e visualize as páginas completas listadas emimages.json(retângulos pretos são máscaras, números azuis na grade são coordenadas da página). - Para detalhes, execute
python scripts/drawing_review.py zoom <PDF> --pack review_pack --page F1-P3 --region x0,y0,x1,y1(coordenadas lidas da grade). A saída lista os blocos de texto na região para referência. - Use a imagem para determinar a correspondência entre anotações, marcas de corte, índices e componentes; a conclusão ainda deve citar blocos de texto. Evidências visuais vão em
visual_evidence(página, coordenadas da região, texto lido). - Páginas digitalizadas ou com fontes corrompidas não são renderizadas por padrão; não adicione
--allow-unmasked-pages, a menos que o usuário concorde explicitamente e saiba que essas páginas tiveram apenas máscara conservadora nas bordas.
- Execute
- Cada candidato é escrito na estrutura JSON definida em
references/report-format.md, salvo emreview_pack/findings.json(incluindocheck_method,object,object_match; cálculos incluemcalculation).
Passo 3: Auto-refutação (obrigatório)
Para cada candidato, faça o papel de um revisor rigoroso e tente refutá-lo: é um desalinhamento devido à ordem de extração? É de partes/condições/fases de construção diferentes por natureza? Os dois locais podem ser confirmados como o mesmo objeto? É uma notação usual da indústria? Depende de conhecimento externo para ser válido? A verificação utilizou parâmetros não presentes nos desenhos? Em caso de dúvida, delete ou rebaixe para needs_context. Escreva no JSON basis (fundamento do julgamento) e uncertainties (condições não confirmadas).
Passo 4: Verificar e gerar relatório
python scripts/drawing_review.py verify --pack review_pack --findings review_pack/findings.json
python scripts/drawing_review.py evidence <mesmos PDFs ...> --pack review_pack # Opcional: gera recortes das imagens mascaradas para cada problema
python scripts/drawing_review.py report --pack review_pack --title "XX Relatório de Revisão (Auto-verificação Assistida por IA)"
verifyclassifica a evidência de cada problema: E1 A citação aparece textualmente no bloco indicado (ou blocos subsequentes contínuos)? E2 A comparação entre páginas/arquivos declarou a correspondência do objeto? E3 O recálculo confirma a inconsistência numérica? Se a citação for encontrada apenas em outra página/arquivo, não conta como localizada (relocated_candidate), e o problema é rebaixado para "pista a investigar"; se a correspondência do objeto não for confirmada ou apenas por leitura visual, rebaixado para "necessita condição complementar"; se o recálculo for consistente com o arquivo, rebaixado para pista.- Se muitos problemas forem rebaixados, volte ao Passo 2, verifique citações, números de bloco e correspondência de objetos, corrija e execute novamente; não reescreva ou invente citações para passar na verificação.
evidencegera recortes apenas no computador local, com retângulo vermelho para a evidência e preto para a máscara; não é necessário visualizar essas imagens no modo texto.reportgerareview_pack/review-report.md. Para exportar para Word/PDF, converta a partir deste; não adicione ou remova conclusões.
Passo 5: Relatar ao usuário
Em 3–6 linhas: número de problemas suspeitos (liste os 1–3 mais importantes com título e localização), quantos necessitam condição complementar, quais páginas/conteúdo não foram revisados, se o modo imagem foi usado, caminho do arquivo de relatório. Lembre que os problemas no relatório devem ser confirmados manualmente um a um. Após o usuário confirmar ou descartar um problema, mantenha a decisão do usuário (review_status) em revisões subsequentes, não sobrescreva.
Revisão (nova análise após modificação)
Ao receber uma nova versão dos desenhos: execute novamente extract em um novo diretório (SHA-256 diferente indica nova versão). Após a revisão, compare com o verified.json da versão anterior. Problemas que existiam na versão anterior e não na atual devem ser marcados como "não reapareceu nesta versão" (pode ter sido corrigido ou pode não ter sido detectado devido a diferenças de reconhecimento); não diga "corrigido". Problemas já descartados pelo usuário na versão anterior devem permanecer descartados.
Arquivos de Referência
references/review-checklist.md: Itens de verificação (C1–C15, incluindo geometria dos desenhos, armadura, correspondência entre cálculos e parâmetros geotécnicos, verificação de fórmulas, fases de construção), pontos de atenção por especialidade, conteúdo que não deve ser relatado.references/verified-rules.md: Regras normativas verificadas e executáveis (resistência mínima do concreto, etc.) e substituições de normas confirmadas.references/desensitization.md: Escopo da desidentificação, significado dos placeholders, método e limitações do reconhecimento de selos e da máscara de imagens.references/report-format.md: Campos defindings.json, classificação de conclusões, classificação de evidências, estrutura do relatório.