Guia de testes — Compartilhar localização e Seguro

Este guia é para quem vai validar as últimas atualizações nos ambientes de homologação:

• Painel do cliente: business-staging.missionbrasil.com.br
• Painel interno: admin-staging.missionbrasil.com.br

Use uma missão de teste já configurada com essas funções ativas. Se precisar ativar, veja a seção “Antes de começar” (somente no painel interno).

Antes de começar (painel interno)

Algumas funções só podem ser ligadas no painel interno, dentro da configuração da subcategoria da missão.

Exemplo: você quer testar uma missão de promotor em loja.

1. Acesse Categorias no menu lateral.
2. Abra a categoria da missão de teste (ex.: Trade Marketing).
3. Entre na subcategoria usada na missão (ex.: Promotor de loja).
4. Vá na aba Configurações.
5. Para localização:
   • Ative Compartilhar localização.
   • Informe o intervalo em segundos (ex.: 30 — mínimo 5).
   • Salve.
6. Para seguro:
   • Ative Habilitar seguro.
   • Salve.

Depois disso, crie ou use uma missão dessa subcategoria com um usuário que aceite compartilhar a localização pelo aplicativo.

1. Compartilhar localização

O que é

Durante a missão, o aplicativo do usuário envia a posição em intervalos regulares. Nos painéis, você vê se a pessoa esteve no local, no turno, quanto tempo ficou, a distância percorrida e o trajeto no mapa.

Onde ver — missão em andamento (painel interno)

Exemplo: acompanhar o promotor João enquanto a missão ainda está Iniciada.

1. Acesse Missões no menu lateral.
2. Abra a missão de teste.
3. Na lista de participantes, clique nos três pontinhos ao lado do nome.
4. Escolha Progresso.
5. Abra a aba Localização.

O que conferir:

• Cartões com Presença no local ou Presença no turno, Tempo da atividade, Distância da missão, Distância percorrida e Pontos registrados.
• Mapa com o trajeto, a posição atual (quando houver) e a área da missão.
• Situação Em andamento ou Finalizada.
• Se ainda não houver dados: mensagem “Nenhuma localização foi compartilhada ainda”.

Onde monitorar — Staff on Demand, no dia (painel interno)

Exemplo: ver a localização de quem está escalado hoje no quadro de staff.

1. Acesse Staff on Demand → Visão geral (ou o quadro do dia).
2. Localize o card do usuário na data de hoje.
3. Clique nos três pontinhos do card.
4. Escolha Localização.

Essa opção aparece apenas no painel interno, para missões de hoje, com compartilhamento de localização ativo e usuário já vinculado à missão.

Onde ver — missão já finalizada (painel interno e painel do cliente)

Exemplo: revisar o registro da missão da Maria depois que ela finalizou.

1. Acesse Missões → área de registros finalizados (lista de missões concluídas pelos usuários).
2. Clique na linha do registro desejado.
3. Na aba Info, em Requerimentos, veja o item Localização (ex.: Presente no turno).
4. Abra a aba Localização para ver os mesmos indicadores e o mapa do trajeto completo.

Dica na lista: registros com presença confirmada no turno podem exibir a etiqueta Turno ao lado do código da missão.

Checklist rápido — localização

2. Seguro (gestão de tickets)

O que é

Missões com seguro ativo na subcategoria geram um ticket de seguro que precisa ser encerrado quando a jornada do usuário termina. O painel interno mostra missões que vencem nas próximas 24 horas e ainda não tiveram o ticket encerrado.

Esta gestão existe apenas no painel interno. O painel do cliente não exibe essa tela.

Onde ativar

Siga Antes de começar → ative Habilitar seguro na subcategoria da missão.

Onde monitorar — atalho na lista de missões

Exemplo: a operação quer saber se há pendências de seguro antes do fim do dia.

1. Acesse Missões no painel interno.
2. No topo da lista, abra o menu Ações (botão com três pontinhos).
3. Clique em Gestão de Seguros.

Abre um painel lateral com a lista de pendências. Se houver mais de um caso, um número aparece ao lado do nome do menu.

O que conferir:

• Colunas: código da missão, código do usuário na missão, nome, e-mail, nome da missão, subcategoria e data de expiração.
• Botão Atualizar para recarregar a lista.
• Se não houver pendências: “Não existem missões com seguro expirando nas próximas 24 horas sem ticket encerrado.”

Onde monitorar — página dedicada

Exemplo: a equipe de operações precisa analisar a lista com calma e paginar os resultados.

1. No painel interno, acesse diretamente:
   Missões → menu ou link para missões expirando sem ticket de seguro encerrado
   (caminho: /missions/insurance-expiring).
2. Use a tabela para navegar entre as páginas de resultados.

É a mesma informação do painel lateral Gestão de Seguros, em tela cheia.

Fluxo sugerido de teste — seguro

Exemplo completo:

1. Confirme que a subcategoria da missão de teste tem seguro habilitado.
2. Vincule um usuário à missão e deixe a jornada próxima do vencimento (ou use um caso já existente em homologação).
3. Sem encerrar o ticket de seguro no processo operacional habitual, abra Gestão de Seguros em Missões.
4. Verifique se a missão aparece na lista com nome, e-mail e data de expiração corretos.
5. Encerre o ticket pelo fluxo normal da operação.
6. Clique em Atualizar e confirme que o registro sumiu da lista.

Checklist rápido — seguro

Problemas comuns

Localização vazia
O usuário precisa estar com a missão iniciada no aplicativo e com permissão de localização concedida. Aguarde pelo menos um intervalo de envio (ex.: 30 segundos) e atualize a tela.

Opção Localização não aparece no Staff on Demand
Só no painel interno, só no dia da escala, só com compartilhamento ativo na subcategoria.

Gestão de Seguros não aparece no painel do cliente
Comportamento esperado — use o painel interno.

Lista de seguro vazia
Pode não haver missões vencendo em 24 h sem ticket pendente. Teste com um caso preparado em homologação ou valide a mensagem de lista vazia.

Resumo

Documento para homologação em staging. Atualizado em junho de 2026.