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
- Baixe CadUnico_Apoio_Tecnico_v0.1.1.zip.
- No Windows, clique com o botão direito no ZIP e escolha Extrair Tudo.
- 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.
- Abra a pasta
D:\CadUnico_Apoio_Tecnico. Nela devem aparecer index.html, config.js, este guia e as subpastas. - Dê dois cliques em index.html e escolha Chrome ou Edge, se o Windows perguntar. Também há o atalho ABRIR_PORTAL.bat.
- 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 pasta | Finalidade |
|---|---|
| index.html | Abre o portal. |
| config.js | Nome, descrição e localização do acervo. |
| pdfs/cadastro | 60 PDFs de Cadastro Único e PBF. |
| pdfs/administrativo | 5 PDFs de administração e documentos municipais. |
| pdfs/sei | 7 PDFs de SEI Cidades. |
| dados | Índice de pesquisa e identificação das fontes. |
| instrucoes | Textos das três áreas para compor os pedidos à I.A.. |
| historico | Documentos retirados da consulta, preservados para acesso manual. |
| ferramentas | Atualizador 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.
- Escolha uma área ou marque Buscar nas três áreas.
- Escreva a pergunta e clique em Pesquisar nos PDFs. Se necessário, tente termos mais curtos e sinônimos.
- 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.
- Marque até cinco trechos que ajudem a explicar sua dúvida.
- Clique em Levar a pergunta à I.A.. Escolha o tipo de pedido, complete o contexto e use Gerar texto para copiar.
- Copie o pedido, abra sua I.A. e cole em uma conversa. Revise as referências e, quando necessário, anexe o PDF completo.
- 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
- Relato: pedido para texto de até 2.000 caracteres, seguido de análise do original.
- Campo: Informações e Conclusões, cada uma com até 350 caracteres.
- Outros pedidos: orientação, Relatório Circunstanciado, ofícios, memorandos, DFD, ETP, TR e apoio ao SEI conforme a área.
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.
- Se Python já estiver instalado, prossiga para a atualização.
- 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.
- 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
- Feche outros atualizadores em execução e evite editar PDFs durante a atualização.
- Inclua PDFs novos em
pdfs\cadastro,pdfs\administrativooupdfs\sei. - 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.
- Para retirar um documento, mova-o para
historico, fora depdfs. Não se trata de decisão de eliminação documental. - Dê dois cliques em ATUALIZAR_INDICE.bat e aguarde a conclusão.
- Leia RELATORIO_ATUALIZACAO.txt. Os arquivos com falha não devem ser considerados cobertos pela pesquisa.
- 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
- Copie a pasta CadUnico_Apoio_Tecnico inteira para o compartilhamento definido pela equipe, por exemplo
Z:\CadUnico_Apoio_Tecnico. - Abra o index.html a partir da nova pasta e teste um PDF.
- Em Configurações, altere o campo de referência do local e, se quiser, o nome e a descrição do portal.
- Se os PDFs continuam na subpasta do portal, mantenha
pdfsno atualizador e./pdfs/no endereço do navegador. - 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.
- 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.
- 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ão | Limite |
|---|---|
| 72 PDFs / 3.460 páginas no acervo | O conteúdo foi copiado integralmente; as normas não foram validadas juridicamente. |
| Texto extraído de 3.284 páginas | 297 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 áreas | O usuário copia para sua I.A.. Não há execução de plugins dentro do portal. |
| Atualização incremental e configurações | A 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
- Abrir index.html no HD.
- Pesquisar “exclusão de integrante” e abrir um PDF na página indicada.
- Selecionar um trecho, gerar um pedido e conferir sua cópia.
- Colar um texto em Campos copiáveis e conferir a contagem.
- Confirmar se Configurações mostra a pasta esperada.
- 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
- Abriu dentro do ZIP: extraia tudo e abra o index.html da pasta extraída.
- Índice não carregado: confira se a pasta dados e o arquivo dados/indice.js estão presentes.
- PDF não abre: confirme a pasta, o nome, o caminho configurado e a permissão de leitura.
- Não copia pelo botão: selecione o texto e pressione Ctrl+C.
- Atualizador diz que já está em andamento: confirme que não há outra execução; se houve interrupção, remova apenas dados/.atualizando e tente novamente.
- Pesquisa não encontra um assunto: use termos mais específicos, veja outras áreas e confira as limitações de extração; se necessário, gere o pedido para pesquisar fontes oficiais.