GUIA DE INSTALAÇÃO E USO · VERSÃO 0.1.1

Comece por aqui.

Seu portal reúne Cadastro Único e PBF, Oficial Administrativo e SEI Cidades. O portal foi preparado para a pasta D:\CadUnico_Apoio_Tecnico.

Você não precisa programar. O pacote já contém os 72 PDFs fornecidos, as instruções das três áreas e o índice inicial.

1. Abrir no HD externo

  1. Baixe CadUnico_Apoio_Tecnico_v0.1.1.zip.
  2. No Windows, clique com o botão direito no ZIP e escolha Extrair Tudo.
  3. Escolha D:\ como destino. O ZIP já contém a pasta CadUnico_Apoio_Tecnico; não crie outra pasta com esse mesmo nome dentro dela.
  4. Abra a pasta D:\CadUnico_Apoio_Tecnico. Nela devem aparecer index.html, config.js, este guia e as subpastas.
  5. Dê dois cliques em index.html e escolha Chrome ou Edge, se o Windows perguntar. Também há o atalho ABRIR_PORTAL.bat.
  6. Faça uma pesquisa e abra um dos PDFs. Depois, salve a página nos favoritos do navegador.

Para abrir e consultar, não é preciso instalar Python, plugins ou servidor. O índice já está pronto. A internet será necessária quando você abrir a I.A. ou consultar sites externos.

Se você já usa essa pasta para outros arquivos, mantenha-os. Extraia o pacote primeiro em uma pasta temporária e copie os novos arquivos, conferindo antes de substituir nomes já existentes.

O que cada parte faz

Arquivo ou pastaFinalidade
index.htmlAbre o portal.
config.jsNome, descrição e localização do acervo.
pdfs/cadastro60 PDFs de Cadastro Único e PBF.
pdfs/administrativo5 PDFs de administração e documentos municipais.
pdfs/sei7 PDFs de SEI Cidades.
dadosÍndice de pesquisa e identificação das fontes.
instrucoesTextos das três áreas para compor os pedidos à I.A..
historicoDocumentos retirados da consulta, preservados para acesso manual.
ferramentasAtualizador do índice e biblioteca de leitura de PDFs.

2. Consultar e preparar uma resposta

O portal abre em Preparar para I.A.. Escolha a área, escreva a pergunta e clique em Gerar texto para copiar. Depois da geração, o campo de entrada fica vazio e o pedido pronto continua disponível. Use Limpar pedido para esvaziar ambos os campos. Para pesquisar primeiro na biblioteca, use Consultar acervo no menu e siga os passos abaixo.

  1. Escolha uma área ou marque Buscar nas três áreas.
  2. Escreva a pergunta e clique em Pesquisar nos PDFs. Se necessário, tente termos mais curtos e sinônimos.
  3. Leia os trechos e use Abrir PDF para conferir o documento completo. O número é a página física do arquivo; ele pode diferir da numeração impressa. Se o leitor ignorar o atalho da página, navegue manualmente até ela.
  4. Marque até cinco trechos que ajudem a explicar sua dúvida.
  5. Clique em Levar a pergunta à I.A.. Escolha o tipo de pedido, complete o contexto e use Gerar texto para copiar.
  6. Copie o pedido, abra sua I.A. e cole em uma conversa. Revise as referências e, quando necessário, anexe o PDF completo.
  7. Para usar os textos produzidos, cole-os em Campos copiáveis, revise os limites e copie para o sistema institucional.

A busca é textual: encontra palavras e variantes, ordena os trechos e indica correspondências parciais. Não redige automaticamente uma resposta técnica, não decide a suficiência de uma fonte e não confirma vigência. Essa etapa de elaboração acontece na I.A. da própria pessoa, conforme as ferramentas e limites de sua conta.

As instruções de apoio orientam os pedidos, mas não instalam um plugin. A adaptação que acompanha o prompt permite analisar os trechos fornecidos e pede consulta a fontes oficiais quando necessário. Não existe integração autenticada com o SEI.

Não há envio automático de perguntas, sincronização com a I.A. ou registro de consultas. Os textos ficam na memória da página enquanto ela estiver aberta. Limpar sessão apaga os campos do portal; não apaga a área de transferência, arquivos baixados, histórico do navegador ou conversas que você fizer na I.A..

Relato, Campo e outros documentos

A contagem na tela usa caracteres Unicode; confira também o limite aceito pelo sistema de destino. O portal não corta o texto automaticamente.

3. Atualizar os PDFs e o índice

O acervo inicial contém uma cópia do Drive consultado em 2 de novembro de 2026. Alterações posteriores no Drive não chegam automaticamente ao portal. Copie o PDF atualizado para a subpasta correspondente antes de executar o atualizador.

Preparação única do computador de manutenção

O atualizador requer Python 3.12 ou superior no computador da pessoa responsável pela manutenção. A biblioteca de leitura de PDF já está incluída; não é necessário instalar pacotes adicionais para os PDFs comuns. Não é preciso instalar nada no servidor nem nos computadores que apenas consultam.

  1. Se Python já estiver instalado, prossiga para a atualização.
  2. Caso contrário, use a distribuição oficial disponível em python.org. Em um computador institucional, a equipe de TI pode fazer essa preparação.
  3. Como alternativa sem instalação, o atualizador procura ferramentas\python\python.exe. A TI pode colocar nessa pasta uma distribuição embutida oficial de Python para Windows compatível com o computador. Esse executável não acompanha o pacote.

Atualização normal

  1. Feche outros atualizadores em execução e evite editar PDFs durante a atualização.
  2. Inclua PDFs novos em pdfs\cadastro, pdfs\administrativo ou pdfs\sei.
  3. Para substituir uma versão, mantenha o nome quando possível e substitua o PDF. Se houver cópias antigas com outro nome, retire-as da pasta pesquisável.
  4. Para retirar um documento, mova-o para historico, fora de pdfs. Não se trata de decisão de eliminação documental.
  5. Dê dois cliques em ATUALIZAR_INDICE.bat e aguarde a conclusão.
  6. Leia RELATORIO_ATUALIZACAO.txt. Os arquivos com falha não devem ser considerados cobertos pela pesquisa.
  7. Feche e abra o portal novamente para carregar o índice atualizado.

O atualizador compara o conteúdo dos arquivos por SHA-256, extrai de novo somente os novos ou alterados e retira os trechos de arquivos removidos. A leitura para comparar os arquivos acontece em cada execução. O tempo depende do HD, rede, volume e complexidade dos PDFs; não há garantia de atualização instantânea.

Se uma nova versão falhar na leitura, seus trechos antigos não permanecem como se fossem atuais. Se a pasta de PDFs não for encontrada, a atualização para e preserva o índice anterior.

Atualizar as instruções das áreas

Substitua o texto em instrucoes\cadastro.txt, administrativo.txt ou sei.txt, preservando o nome e usando UTF-8. Execute o mesmo atualizador para refletir as novas instruções nos prompts.

Documentos retirados e informações de vigência

Por padrão, todos os documentos ficam com vigência a verificar. A manutenção avançada permite registrar exceções em dados\regras_acervo.json, usando o caminho relativo do PDF como chave e campos como excluded, status, verified_at, official_url e title. O status historico ou excluded: true retira o arquivo da consulta na atualização seguinte. Só registre vigência depois de conferência humana competente.

4. Levar o portal para a pasta de rede

  1. Copie a pasta CadUnico_Apoio_Tecnico inteira para o compartilhamento definido pela equipe, por exemplo Z:\CadUnico_Apoio_Tecnico.
  2. Abra o index.html a partir da nova pasta e teste um PDF.
  3. Em Configurações, altere o campo de referência do local e, se quiser, o nome e a descrição do portal.
  4. Se os PDFs continuam na subpasta do portal, mantenha pdfs no atualizador e ./pdfs/ no endereço do navegador.
  5. Clique em Baixar config.js atualizado e substitua o config.js da pasta da rede. Se o navegador salvar como config (1).js, renomeie para config.js ao substituir.
  6. Se os PDFs forem movidos para outro lugar, preencha tanto o caminho acessível ao atualizador quanto o endereço acessível aos leitores; depois atualize o índice e teste no computador de outro usuário.
  7. Oriente cada pessoa a abrir esse index.html e salvá-lo nos favoritos.

A tela gera um arquivo para download porque uma página aberta pelo disco não tem permissão automática para sobrescrever arquivos do Windows. Os caminhos relativos são a opção mais simples para que a pasta continue portátil.

Este portal não possui login próprio. O acesso depende das permissões da pasta no Windows. Os leitores precisam de leitura e o responsável pela manutenção precisa de escrita. O funcionamento em rede e eventuais políticas do navegador devem ser testados no ambiente da Prefeitura; não foram verificados daqui.

5. O que foi entregue e o que exige atenção

Disponível nesta versãoLimite
72 PDFs / 3.460 páginas no acervoO conteúdo foi copiado integralmente; as normas não foram validadas juridicamente.
Texto extraído de 3.284 páginas297 páginas têm pouco texto, inclusive capas e imagens; 37 documentos apresentam essa condição em alguma página.
Pesquisa local com página e versãoÉ busca textual, sem interpretação automática por IA.
Prompts das três áreasO usuário copia para sua I.A.. Não há execução de plugins dentro do portal.
Atualização incremental e configuraçõesA manutenção requer Python no computador responsável e a aplicação manual do arquivo de configuração.

Quatro PDFs não produziram texto pesquisável na extração inicial: Decreto Municipal 7056/2025, Decreto Municipal 7057/2025, Portaria MDS 1133/2025 e Portaria MDS 1145/2025. Estão disponíveis para abrir e ler. Para pesquisá-los integralmente, obtenha uma versão com texto selecionável ou faça OCR, confira o resultado e atualize o índice.

Alguns outros PDFs têm páginas digitalizadas ou texto apenas em parte do arquivo. A biblioteca e o relatório indicam as páginas detectadas. O atualizador incluído não faz OCR. Para entender essa limitação técnica, consulte a documentação do extrator pypdf.

Primeiro teste do portal

  1. Abrir index.html no HD.
  2. Pesquisar “exclusão de integrante” e abrir um PDF na página indicada.
  3. Selecionar um trecho, gerar um pedido e conferir sua cópia.
  4. Colar um texto em Campos copiáveis e conferir a contagem.
  5. Confirmar se Configurações mostra a pasta esperada.
  6. Depois, testar uma atualização com o responsável pela manutenção.

Quando falar com Sofia, informe qual etapa funcionou ou a mensagem exata que apareceu. Para a próxima etapa, basta relatar o resultado desse primeiro teste no seu computador.

Se algo não funcionar