Sumário

1. Apresentação

O Sistema CASACAP centraliza o cadastro de instituições, contatos, endereços, atendimentos, agendamentos, histórico de visitas, relatórios e controle de usuários. O sistema funciona pelo navegador em computador, Android, iPhone e iPad.

Principais recursos

• Cadastro completo de instituições e localização.
• Consulta, edição, inativação e exclusão controlada.
• Agendamentos com preenchimento automático dos dados cadastrados.
• Histórico de visitas, atendimentos diretos, indiretos e carga.
• Relatórios mensais e de endereços em Excel e PDF.
• Criação de rotas otimizadas para o Google Maps.
• Fluxo de aprovação e permissões por função.

2. Acesso ao sistema

Entrar

1. Abra o endereço oficial do sistema.
2. Informe o login ou e-mail.
3. Informe a senha.
4. Marque “lembrar de mim” somente em equipamento pessoal.
5. Selecione Entrar.

Criar uma conta

1. Na tela de login, abra a opção de cadastro.
2. Informe nome, e-mail e um login de 3 a 30 caracteres.
3. Crie uma senha com ao menos 8 caracteres, maiúscula, minúscula e número.
4. Confirme a senha e conclua.
5. Aguarde a aprovação do Admin Master.

Toda conta pública nasce como Visualizador pendente. Enquanto não for aprovada, não acessa os dados do sistema.

Recuperar senha

Na tela de login, utilize a recuperação por e-mail. Um administrador também pode redefinir a senha de usuários autorizados pela tela Usuários.

3. Permissões dos usuários

Resumo das funções

Visualizador

Perfil de consulta. Pode acompanhar indicadores, pesquisar dados, históricos e relatórios, mas não grava nem altera registros.

Editor

Perfil operacional. Cadastra e atualiza instituições, agendamentos e históricos, sem administrar usuários ou excluir instituições.

Admin

Perfil administrativo. Possui as funções operacionais, gerencia usuários aprovados dentro de seus limites e pode excluir registros do histórico. Não aprova pendentes nem altera o Admin Master.

Admin Master

Maior nível de autoridade. Aprova contas, define permissões, bloqueia, recusa, exclui cadastros permitidos, gerencia siglas e protege a estrutura administrativa.

4. Dashboard

O Dashboard apresenta a visão geral do sistema: instituições, status, visitas, atendimentos, gráficos, pendências e atalhos.

1. Use os cartões superiores para consultar totais.
2. Utilize os gráficos e filtros para analisar períodos e regiões.
3. Clique nos indicadores interativos para abrir detalhes.
4. Use os atalhos para Cadastro, Consulta, Histórico, Relatório Mensal, Relatório de Endereços e Usuários.

O Admin Master também recebe aviso de contas aguardando aprovação.

5. Cadastro de instituição

1. Acesse Cadastro.
2. Informe nome da instituição, contato, telefone e responsável legal.
3. Preencha bairro, perfil dos assistidos, necessidades e observações.
4. Selecione o tipo da instituição.
5. Informe atendimento direto e indireto.
6. Preencha CNPJ, endereço e CEP. O CEP pode completar endereço e bairro.
7. Use “Buscar pelo endereço” ou “Usar minha localização” para registrar latitude e longitude.
8. Informe site, fundação e status.
9. Selecione Salvar Cadastro.

Tipos e siglas

O Admin Master visualiza Gerenciar siglas. Pode acrescentar sigla e descrição, editar opções e ativar/desativar tipos. Ao renomear uma sigla, os cadastros relacionados são atualizados.

Coordenadas

Latitude e longitude melhoram a precisão no mapa e permitem organizar rotas por proximidade. Sempre confira se o endereço localizado corresponde à instituição.

6. Consulta de instituições

A tela Consulta permite localizar instituições pelo nome, contato, responsável, lista de igrejas e status.

1. Digite parte do nome ou utilize os filtros.
2. Confira o cartão encontrado.
3. Use Abrir no Maps quando houver coordenadas.
4. Selecione registros para imprimir ou exportar.
5. Usuários autorizados podem abrir Editar.
6. O Admin Master pode usar Excluir registro.

Ativo e inativo

Use INATIVO quando a instituição não estiver operando, mas possuir histórico. Instituições inativas continuam disponíveis para relatórios e auditoria.

Exclusão

O botão aparece somente ao Admin Master, exige duas confirmações e não permite excluir instituição com histórico vinculado. Nesse caso, altere o status para INATIVO.

7. Agendamento

1. Abra Agendamento / Histórico e permaneça na aba Agendamento.
2. Digite o nome da instituição.
3. Use ↑/↓ para navegar e Enter ou Tab para selecionar.
4. O sistema carrega contato, telefone, bairro, responsável, tipo e atendimentos cadastrados.
5. Informe data, hora, tipo da visita, números realizados, carga e observações.
6. Selecione Salvar Agendamento para manter o cadastro original.
7. Use Salvar + Atualizar Cadastro quando contato, telefone ou bairro também precisarem ser atualizados.

8. Histórico

A aba Histórico consulta visitas por instituição, responsável e período.

1. Abra a aba Histórico.
2. Escolha uma instituição ou deixe em branco para todas.
3. Informe responsável e intervalo de datas, se necessário.
4. Selecione Pesquisar.
5. Marque registros para impressão ou exportação.
6. Use Editar quando precisar corrigir um lançamento.

9. Relatório mensal

1. No Dashboard, acesse Relatório Mensal.
2. Informe data inicial e final.
3. Clique em Carregar relatório.
4. Confira instituições, contatos, telefones, bairros, atendimentos e visitas.
5. Marque ou desmarque as linhas desejadas.
6. Exporte para Excel ou PDF.

Os totais consideram os registros existentes no intervalo selecionado. Confira o período antes de encaminhar o documento.

10. Relatório de endereços e rotas

Este relatório apresenta somente instituição, endereço, bairro e CEP.

1. Acesse Relatório de Endereços.
2. Pesquise instituição, endereço, bairro ou CEP.
3. Filtre entre ativas, inativas ou todas.
4. Exporte a listagem para Excel ou PDF.

Criar rota otimizada

1. Marque as instituições desejadas.
2. Clique em Criar rota otimizada.
3. Autorize o navegador a acessar sua localização.
4. Confira a ordem sugerida.
5. Abra Rota 1, Rota 2 etc. no Google Maps.

O sistema utiliza coordenadas para escolher a próxima parada mais próxima. No celular, cria grupos de até quatro instituições; no computador, até dez. A rota seguinte parte do final da anterior.

11. Administração de usuários

Aprovar conta

1. Entre como Admin Master.
2. Abra Usuários.
3. Localize a pendência.
4. Selecione Aprovar. A conta inicia como Visualizador.
5. Edite a permissão somente se necessário.

Criar usuário internamente

Administradores autorizados podem usar Novo Usuário, informando nome, login, e-mail, senha forte e função.

Editar

Permite atualizar nome, login, e-mail, função e situação dentro dos limites do usuário atual. Admin comum não pode alterar Admin Master.

Redefinir senha

Abra Senha, informe e confirme a nova senha. Para a própria conta, o sistema solicita a senha atual. Para outra conta, a operação é validada pela função administrativa segura.

Bloquear, recusar e excluir

Bloquear impede acesso preservando o cadastro. Recusar e excluir remove uma solicitação pendente e libera login/e-mail para novo cadastro. Nunca exclua a conta principal do Admin Master.

12. Excel, PDF e impressão

• Excel: indicado para conferência, filtros, cálculos e tratamento posterior.
• PDF: indicado para arquivamento, assinatura e compartilhamento.
• Imprimir: abre a janela do navegador, permitindo impressora física ou “Salvar como PDF”.

Antes de exportar

1. Confira filtros e período.
2. Marque somente os registros necessários.
3. Revise nomes, endereços e totais.
4. Evite compartilhar documentos com dados pessoais em grupos públicos.

13. Uso em celular e tablet

O sistema possui layout responsivo para Android, iPhone e iPad. Use o botão ☰ para abrir o menu lateral. Na tela Usuários, cada registro aparece como cartão em dispositivos menores.

• Gire o tablet para paisagem quando visualizar relatórios extensos.
• Use Ctrl + F5 no computador para atualizar arquivos. No iOS, feche e reabra a aba ou limpe os dados do site quando houver cache antigo.
• Autorize localização apenas quando utilizar mapas e rotas.
• Mantenha navegador e sistema operacional atualizados.

14. Segurança e backups

• As tabelas utilizam RLS, limitando operações conforme a função aprovada.
• Funções administrativas validam sessão, aprovação e papel no servidor.
• Senhas devem ter no mínimo 8 caracteres, maiúscula, minúscula e número.
• Arquivos internos, backups, SQL e CSV não devem ser publicados no Cloudflare.
• Somente a pasta dist deve ser enviada ao Cloudflare Pages.

Backup

Mantenha backups periódicos do banco fora da pasta pública, em local protegido e com acesso restrito. Teste ocasionalmente se o backup pode ser restaurado.

Logs

Consulte os logs das Edge Functions no Supabase quando uma criação, exclusão ou redefinição de senha apresentar erro.

15. Solução de problemas

16. Rotina recomendada

Diariamente

• Verificar pendências e agendamentos.
• Registrar visitas e atendimentos no mesmo dia.
• Conferir dados antes de salvar.

Semanalmente

• Revisar instituições ativas/inativas.
• Corrigir endereços sem coordenadas.
• Conferir usuários e permissões.

Mensalmente

• Gerar e arquivar relatório mensal.
• Exportar relatório de endereços quando necessário.
• Realizar backup e verificar logs administrativos.