Documentação do Sistema de Processamento de Planilhas

Visão Geral

Este sistema permite o processamento automatizado de planilhas, realizando extração, padronização e correção de dados, com foco em qualidade e integridade das informações.

Guia de Uso do Sistema

1. Acesse o painel do sistema pelo navegador. Utilize o menu lateral para navegar entre as funções.
2. Upload de Planilhas:
   • Vá até Upload de Planilhas.
   • Selecione apenas arquivos oficiais do sistema (nomes exatos das planilhas).
   • Clique em Enviar. O sistema só aceita arquivos com nomes válidos.
3. Visualizar e Gerenciar Planilhas Recebidas:
   • Acesse Planilhas Recebidas para ver os arquivos enviados.
   • Você pode baixar, editar (em modal) ou excluir arquivos.
4. Processar Planilhas:
   • Vá até Processar Planilhas.
   • Cada planilha tem um cartão visual. Clique em Processar para abrir o popup moderno.
   • No popup, selecione a planilha (se houver mais de uma) e clique em Processar.
   • O sistema realiza extração, padronização e salva o resultado automaticamente.
5. Visualizar Dados Extraídos e Corrigidos:
   • Use Ver Plan Recebidas para visualizar os dados extraídos (JSON).
   • Use Ver Plan Corrigidas para visualizar os dados finais corrigidos.
   • Selecione a planilha pelo nome (não pelo caminho da pasta) e depois o arquivo desejado.
6. Baixar ou Excluir Arquivos Corrigidos:
   • Em Planilhas Corrigidas, você pode baixar ou excluir os arquivos finais.

Dicas:

• Os nomes das planilhas devem ser exatamente os oficiais do sistema.
• O sistema não permite uploads de arquivos com nomes diferentes.
• Os popups de processamento são modernos, responsivos e mostram apenas o nome da planilha (sem .csv).
• Em caso de dúvidas, consulte o administrador ou esta documentação.

Importante: Cada planilha possui um processamento específico, pois cada uma contém tipos de dados e regras próprias. Por exemplo:

• Contatos de seguradoras: valida e padroniza nomes, e-mails, telefones e CNPJ.
• Dados dos segurados ODONTO/SAUDE/VIDA: trata CPF, datas de nascimento, carteirinha, parentesco, sexo, entre outros campos sensíveis.
• Datas e controles: foca em datas, condições contratuais e CNPJ por razão social.
• Valores de plano e reembolso: converte valores para o padrão "R$ X,XX" e valida faixas etárias.

O sistema aplica padrões e validações adequados para cada tipo de planilha, garantindo a integridade dos dados conforme o contexto de cada arquivo.

Principais Funcionalidades

• Padronização automática de dados (nomes, documentos, datas, etc).
• Correção de problemas comuns de formatação e codificação.
• Conversão inteligente de datas, inclusive datas em formato numérico do Excel.
• Interface amigável para seleção e processamento de arquivos.
• Registro de operações para auditoria e suporte.

Erros Corrigidos e Melhorias Recentes

• Colunas sem cabeçalho e sem dados não geram mais a palavra "falta".
• Conversão robusta de datas, inclusive valores numéricos do Excel (ex: 24484 ou 24484,00).
• Tratamento de datas por extenso (ex: "28 de setembro de 1958").
• Correção de caracteres especiais e encoding.
• Registro detalhado de conversões de datas para suporte e auditoria.

Suporte

Em caso de dúvidas ou problemas, entre em contato com o responsável pelo sistema.

Alerta de Segurança: Vírus em Arquivos CSV

Nunca faça upload de arquivos CSV infectados por vírus ou malwares!

Responsabilidade: O envio de arquivos para o sistema é de responsabilidade exclusiva do usuário. Caso um arquivo infectado seja identificado pelo servidor, o responsável pelo upload poderá ser responsabilizado conforme as políticas internas e legislação vigente.

Riscos: Planilhas podem ser infectadas por vírus do tipo macro, scripts maliciosos, links ocultos, ou até mesmo códigos que exploram vulnerabilidades em softwares de planilha.

Dicas de Prevenção:

• Sempre utilize um antivírus atualizado e faça uma varredura nos arquivos antes de subir.
• Evite abrir ou manipular planilhas em computadores inseguros ou públicos.
• Não baixe planilhas de fontes desconhecidas ou suspeitas.
• Desconfie de arquivos CSV que pedem para habilitar macros ou executar scripts.
• Prefira salvar/exportar planilhas diretamente do sistema de origem confiável.
• Se receber alertas do antivírus, não faça upload e comunique o responsável pelo sistema.

Tipos comuns de ameaças em planilhas:

• Macros maliciosas (especialmente em arquivos convertidos de XLS/XLSX para CSV).
• Links para sites de phishing ou download de malware.
• Scripts embutidos em campos de texto (pouco comum em CSV, mas possível).

Exemplos de campos suspeitos:

• =cmd|'/C calc'!A0 (campo que tenta executar comandos no Windows)
• =HYPERLINK("http://site-malicioso.com") (link oculto para phishing)
• =MALICIOUS_MACRO() (macro suspeita)

Exemplo visual de campo perigoso:
Exemplo de boas práticas:

• Antes de subir, abra o CSV em um editor de texto simples (ex: Notepad) e procure por fórmulas, links ou comandos estranhos.
• Garanta que o arquivo foi exportado de um sistema confiável e não foi editado manualmente por terceiros.

Em caso de dúvida, consulte o suporte antes de subir qualquer arquivo.

Atenção ao Usuário

Este sistema foi projetado para processar planilhas dentro de padrões e formatos previstos. Não realize testes com dados aleatórios, formatos incompatíveis ou informações fora do escopo do sistema.

O sistema não "adivinha" dados ausentes, não corrige erros graves de origem e não substitui a análise humana. Utilize arquivos reais e siga as orientações do administrador para garantir resultados corretos.

Testes inadequados podem gerar resultados inesperados ou incompletos.