Qual é o fluxo completo de atendimento de um visitante na portaria?

Quando um visitante chega fisicamente agora e é atendido por quem trabalha na portaria (funcionário, porteiro ou síndico/administrador), o aplicativo encadeia automaticamente quatro telas, uma levando direto para a próxima, sem precisar voltar ao menu principal entre uma etapa e outra: Cadastro do Visitante ➔ Registrar Visita ➔ Aprovação ➔ Registrar Saída.

Como funciona: ao salvar cada etapa, o app já abre a próxima tela com os dados preenchidos automaticamente (visitante pré-selecionado, visita em destaque etc.), pensado para o atendimento presencial contínuo do porteiro.

Passo 1 — Cadastro do Visitante

Tudo começa no cadastro de um visitante novo (não é edição de um já existente, nem um visitante marcado como frequente/recorrente). Ao tocar em [Salvar], o app leva automaticamente para a tela Registrar Visita, já com esse visitante selecionado.

Se o cadastro for de um visitante frequente/recorrente, o app não encadeia — ele salva a autorização e permanece na tela de cadastro.
Se você estiver apenas editando um visitante existente, também não há esse encadeamento automático.

Passo 2 — Registrar a Visita

Nesta tela você confirma os detalhes da entrada: pode ser um registro completo (escolhendo unidade e anfitrião) ou uma visita rápida, que pula o formulário completo e vai direto para o status pendente. Ao confirmar, o app avança automaticamente para a tela Visitas Pendentes, já com a visita recém-criada em destaque.

A visita nasce com status pendente (aguardando aprovação).
Exceção: se for marcada como visita administrativa, ela já nasce aprovada e pula a etapa de aprovação.

🔗 Pergunta relacionada: Como funciona a aprovação de uma visita?

Atenção — bloqueio de permissão: a tela Registrar Visita é exclusiva para quem tem a permissão "Registrar Visitas" ou papel privilegiado (síndico, administrador, gerente, proprietário-master). Se um morador comum acabou de cadastrar um visitante para si mesmo, o app tenta levá-lo para essa tela automaticamente, mas ela aparece bloqueada com a mensagem "Registro de visita é exclusivo para funcionários." Nesse caso, o encadeamento para aqui: o papel do morador é só cadastrar o visitante — quem tem a permissão (porteiro, funcionário ou administrador) é quem de fato registra a entrada depois.

Passo 3 — Aprovação

A tela Visitas Pendentes já abre com a visita recém-registrada em destaque. Quem tem permissão para aprovar toca em [Aprovar]: o status muda direto para liberado (entrou) — aprovar e liberar a entrada é a mesma ação, não existe um estado intermediário entre os dois.

Se essa aprovação aconteceu dentro do encadeamento automático (ou seja, veio direto do passo 2), o app já navega imediatamente para a tela Registrar Saída, com o visitante e a visita já pré-selecionados, prontos para quando ele for embora.

Para negar, toca-se em [Negar] e é preciso informar o motivo (obrigatório) — nesse caso o encadeamento não avança para a saída, já que o visitante não chegou a entrar.

Passo 4 — Registrar Saída

Tela final da cadeia. Lista as visitas com status liberado (entrou) dentro da organização. Quando o visitante for embora, quem tem a permissão registra a saída (com o horário atual ou um horário personalizado), o que muda o status para saiu e dispara uma notificação para o anfitrião/unidade.

Quem pode fazer isso

Quem pode fazer isso: o encadeamento completo, do cadastro até a saída, só é percorrido de ponta a ponta por quem tem a permissão "Registrar Visitas" ou papel privilegiado (síndico, administrador, gerente, proprietário-master) — normalmente o funcionário/porteiro da portaria. Um morador comum só participa de duas etapas: o Passo 1 (cadastro do visitante) e, quando aplicável, o Passo 3 (aprovar ou negar visitas endereçadas à própria unidade).

🔗 Pergunta relacionada: Onde aprovo ou nego uma visita?

Resumo visual da cadeia

Cadastro do Visitante ➔ Registrar Visita ➔ Visitas Pendentes (Aprovação) ➔ Registrar Saída

[Inserir aqui screenshot de: sequência das quatro telas do fluxo (cadastro, registrar visita, visitas pendentes com destaque na visita recém-criada, e registrar saída com o visitante pré-selecionado) — usar o botão "Inserir imagem" no editor, que faz upload automático pro bucket faq_images]