feat: Adiciona documentacao completa do Agente CBMGO - NT-01/2025

README.md

@@ -1,3 +1,161 @@
----
-license: apache-2.0
----
+---
+license: apache-2.0
+language:
+- pt
+tags:
+- cbmgo
+- bombeiros
+- incendio
+- prevencao
+- rag
+- llm
+- agente
+pipeline_tag: text-generation
+---
+
+# Agente CBMGO - Sistema Inteligente de Prevencao de Incendio
+
+Agente completo para apoio a Responsaveis Tecnicos (RT) no processo de elaboracao, revisao e protocolo de projetos de prevencao e combate a incendio conforme NT-01/2025 do CBMGO.
+
+---
+
+## Visao Geral
+
+O Agente CBMGO e uma suite de modulos integrados 100% dentro do ecossistema Hugging Face, cobrindo consulta as Normas Tecnicas (RAG normativo), classificacao de ocupacao e grupo/divisao, calculo de exigencias (extintores, hidrantes, SPDA), geracao de memorial descritivo, auditoria de projetos (memorial x prancha), assistente CAD (scripts AutoCAD/Revit) e preparacao e validacao de pacote SIAPI.
+
+---
+
+## Arquitetura dos Modulos
+
+| Modulo | Produto HF | Repositorio |
+|---|---|---|
+| Normas e regras | Dataset | cbmgo/normas-nt01 |
+| Classificador de Ocupacao | Model | cbmgo/llama3-8b-ocupacao |
+| RAG Normativo | Space | cbmgo/rag-normas |
+| Motor de Regras | Dataset | cbmgo/regras-declarativas |
+| Calculadora de Incendio | Space | cbmgo/calculadora-incendio |
+| Gerador de Memorial | Model | cbmgo/memorial-generator |
+| Auditor de Projetos | Space | cbmgo/auditor-projetos |
+| Assistente CAD/BIM | Space | cbmgo/cad-assistant |
+| Submissao SIAPI | Space | cbmgo/submissao-assistida |
+
+---
+
+## Fluxo Operativo (usuario RT)
+
+1. rag-normas - Consulta NT-01/2025 (artigo, paragrafo, Anexo)
+2. calculadora - Lotacao, extintores, hidrantes, SPDA
+3. classificador - Grupo, Divisao, exigencias legais
+4. memorial-generator - Gera texto estruturado + checklist
+5. auditor-projetos - Compara memorial x prancha, erros/alertas
+6. cad-assistant - Gera script .scr (AutoCAD) / Dynamo (Revit)
+7. submissao-assistida - Monta pacote, renomeia, valida para SIAPI
+8. Protocolo humano - RT protocola no SIAPI
+
+---
+
+## Estrutura do Repositorio
+
+CERCON/
+- README.md
+- app.py
+- requirements.txt
+- modules/ (rag_normas.py, classificador.py, calculadora.py, memorial_generator.py, auditor.py, cad_assistant.py, submissao.py)
+- data/ (chunks.jsonl, embeds.faiss, regras_declarativas.json)
+- scripts/ (build_chunks.py, build_embeddings.py, generate_synthetic.py)
+
+---
+
+## Inicio Rapido
+
+Instalacao: pip install -r requirements.txt
+Execucao local: python app.py
+
+---
+
+## Modulos - Detalhes
+
+### 1. RAG Normativo (modules/rag_normas.py)
+
+Usa sentence-transformers/all-mpnet-base-v2 para embeddings e FAISS para busca vetorial. Recebe query, busca os chunks mais relevantes da NT-01/2025 e retorna texto com referencia ao artigo/paragrafo.
+
+### 2. Classificador de Ocupacao (modules/classificador.py)
+
+Usa cbmgo/llama3-8b-ocupacao (fine-tune Llama-3.1 8B via LoRA). Recebe descricao da edificacao e retorna JSON com grupo, divisao e lista de exigencias conforme NT-01/2025 Tabela 1.
+
+### 3. Calculadora de Incendio (modules/calculadora.py)
+
+Calcula extintores (quantidade, capacidade, distancia maxima), hidrantes (sistema, vazao, reserva de incendio), SPDA e iluminacao de emergencia conforme Anexo B da NT-01/2025 usando pandas e sympy.
+
+### 4. Gerador de Memorial (modules/memorial_generator.py)
+
+Usa cbmgo/memorial-generator (fine-tune Mistral-7B-Instruct). Gera memorial descritivo completo + checklist a partir dos dados do projeto e exigencias classificadas.
+
+### 5. Auditor de Projetos (modules/auditor.py)
+
+Compara memorial com regras declarativas. Para cada regra satisfeita verifica presenca da exigencia no texto. Retorna lista de erros criticos, alertas e status apto/inapto para protocolo.
+
+### 6. Assistente CAD (modules/cad_assistant.py)
+
+Gera scripts .scr para AutoCAD e codigo Python para Dynamo/Revit API. Posiciona extintores, sinalizacao de saida de emergencia, rotas de fuga e pontos de hidrante conforme layout do projeto.
+
+### 7. Submissao SIAPI (modules/submissao.py)
+
+Monta pacote padrao CBMGO: renomeia arquivos conforme padrao do corpo de bombeiros, valida presenca dos documentos obrigatorios (memorial, planta baixa, formulario RT) e gera relatorio JSON de aptidao para protocolo no SIAPI.
+
+---
+
+## Dataset de Regras Declarativas
+
+Arquivo data/regras_declarativas.json com regras SE-ENTAO conformes NT-01/2025:
+- Regra 1: Ocupacao comercial com area maior que 750m2 exige extintores, hidrantes e sinalizacao de emergencia
+- Regra 2: Edificacao com altura maior que 12m exige iluminacao de emergencia
+- Regra 3: Edificacao com area maior que 1000m2 exige SPDA (Sistema de Protecao contra Descargas Atmosfericas)
+- Regra 4: Uso industrial com area maior que 2000m2 exige chuveiros automaticos e reservatorio de incendio
+
+---
+
+## Fine-Tune dos Modelos
+
+Classificador cbmgo/llama3-8b-ocupacao:
+- Base: meta-llama/Llama-3.1-8B-Instruct
+- Tecnica: LoRA 8-bit via trl/SFTTrainer
+- Dataset: cbmgo/dataset-sintetico (2000 exemplos) ou cbmgo/dataset-real (300-500 projetos)
+- Hardware: 1x A10 GPU (HF PRO), treino menor que 3 horas
+
+Memorial Generator cbmgo/memorial-generator:
+- Base: mistralai/Mistral-7B-Instruct-v0.3
+- Pares de treinamento: prompt com dados do projeto -> memorial descritivo completo
+- Hardware: 1x A10 GPU
+
+---
+
+## Roadmap
+
+| Semana | Entrega |
+|---|---|
+| 1 | Datasets normas-nt01 e regras-declarativas |
+| 2 | Spaces rag-normas e calculadora-incendio |
+| 3 | Fine-tune llama3-8b-ocupacao |
+| 4 | Space memorial-generator |
+| 5 | Spaces auditor-projetos e cad-assistant |
+| 6 | Space submissao-assistida e integracao final |
+
+---
+
+## Seguranca e Versionamento
+
+- git-lfs para arquivos grandes (modelos, indices FAISS)
+- Tags semanticas: v1.0, v1.1-norma-rev, etc.
+- Campo data_vigencia em cada dataset para controle de norma vigente
+- Auditoria: cada conclusao registra hash do modelo e commit da norma utilizada
+
+---
+
+## Licenca
+
+Apache 2.0 - Consulte o arquivo LICENSE.
+
+---
+
+Desenvolvido para apoio tecnico de Responsaveis Tecnicos (RT) em projetos de PSCIP conforme NT-01/2025 CBMGO.