Clientes - Área do Cliente (Portal Minha Conta)

O que é

O portal "Minha Conta" é a área pessoal do cliente final dentro do sistema da agência. Ele acessa em /minha-conta com e-mail e senha (ou login social via Google/Apple) e encontra um painel próprio com tudo que diz respeito às viagens que comprou: pedidos, parcelas, contratos, assentos, embarque, documentos, dependentes, vouchers de experiências, ingressos e programa de fidelidade.

Esse portal é separado do painel administrativo. O cliente nunca vê dados de outros clientes, nem rotinas operacionais da agência. cada empresa tem sua própria instância, com a marca (logo, cores, nome) aplicada via identidade visual. Você entra aqui quando quer entender o que o comprador enxerga antes de ativar uma funcionalidade nova, validar um bug reportado ou conferir como uma compra aparece para quem viaja. Para ver na prática como cliente, use a ação Acessar como Cliente na listagem de clientes do admin.

Como usar

O portal tem um menu lateral (sidebar) à esquerda com as seções, um cabeçalho no topo com o nome do cliente e um conteúdo central que muda de acordo com a página.

1. O cliente entra em /minha-conta e, se não estiver logado, é levado para a tela de Login. O acesso é guardado pelo guard cliente separado do guard web do admin.
2. Após o login, abre o Dashboard com cards coloridos resumindo a conta. No modo padrão são 4 cards: Excursões Confirmadas, Reservas Pendentes, Dependentes e Saldo Pendente. Quando você ativa o "modo exclusivo Experiências", aparecem 3 cards focados em passeios (Confirmadas, Pedidos Pendentes e Saldo).
3. O menu lateral mostra os itens conforme o que está ativado:
   • Dashboard - resumo da conta.
   • Minhas Excursões (rótulo dinâmico, pode ser "Minhas Viagens", "Meus Eventos" etc. conforme o termo configurado por você).
   • Minhas Reservas - pré-reservas e pedidos ainda não confirmados.
   • Vagas Pendentes - convites de passageiros enviados pelo titular que aguardam preenchimento de CPF/dados; aparece com badge numérico laranja.
   • Dependentes - cadastro de filhos, cônjuge e acompanhantes.
   • Ficha Médica - formulário do titular e de cada dependente.
   • Documentos - upload de RG/CPF/passaporte; mostra badge âmbar com o número de documentos faltando.
   • Financeiro - parcelas, link de pagamento e upload de comprovante; badge vermelho "!" quando há saldo pendente.
   • Fidelidade - pontos, tier (Bronze/Prata/Ouro), recompensas e indicações (só se o módulo fidelidade estiver ativo e o programa publicado).
   • Meus Ingressos - vendas avulsas (módulo ingressos).
   • Minhas Experiências - passeios e gift cards (módulo passeios-experiencias).
   • Atendimento - canal de suporte da sua empresa.
4. O menu secundário (parte de baixo) tem Meu Perfil (dados pessoais, alterar senha, endereço) e Configurações (preferências e LGPD).
5. Em telas pequenas o sidebar vira menu hamburguer e aparece também uma bottom-nav fixa com os atalhos principais.

Casos especiais

Alertas no topo do conteúdo

Acima de qualquer página o cliente vê um grid de alertas compactos quando há pendências, na seguinte ordem de prioridade: Saldo pendente (vermelho), Contratos não assinados (laranja), Documentos pendentes (âmbar), Cadastros personalizados pendentes, Vagas pendentes (convites) (ciano), Assentos sem selecionar (índigo), Ingressos pendentes, Pagamento de passeios pendente e Participantes de passeio sem preencher. O grid some sozinho quando tudo é resolvido.

Modo exclusivo de Experiências

empresas que vendem só passeios (sem excursões) podem ativar o flag passeios_modo_exclusivo. Nesse modo o portal esconde Excursões, Reservas e Dependentes, e o Dashboard mostra cards focados em Experiências. O item Minhas Experiências sobe para logo abaixo do Dashboard.

Convites de passageiro (Vagas Pendentes)

Quando o titular convida alguém para ocupar uma vaga (via link enviado por WhatsApp/e-mail), e o convidado já tem cadastro de cliente no empresa, o convite vira um item em Vagas Pendentes. O cliente pode: preencher os próprios dados, vincular um dependente já cadastrado, estender o prazo ou reenviar o link para outra pessoa.

Cadastros personalizados no Minha Conta

Se você criou um esquema de Cadastro Personalizado com a flag aparece_minha_conta ativada e vinculado à entidade cliente, o formulário correspondente aparece como um item próprio no menu lateral (ícone de prancheta). O cliente preenche/edita os campos definidos pelo admin.

Documentos opcionais ocultos

Quando o admin configura Documentos como opcional e marca "ocultar quando opcional" na Jornada do Cliente, o item desaparece do menu lateral. Para reexibir basta tornar o documento obrigatório de novo ou desmarcar a opção de ocultar.

Impersonação ativa

Se um admin estiver "acessando como" esse cliente, um banner roxo fixo aparece no topo de todas as telas do portal com a frase "Visualizando como Cliente: Nome", o selo Somente Leitura, o nome do admin entre parênteses e o botão Voltar ao Painel à direita. Todas as telas do portal ficam em modo somente leitura, que bloqueia ações destrutivas (alterar senha, excluir conta, excluir dependente) durante a sessão impersonada.

LGPD - exportar e excluir conta

Em Configurações o cliente acessa:

• Exportar meus dados (JSON) - baixa um JSON com tudo que a agência guarda sobre ele.
• Exportar meus dados (PDF) - mesma exportação em PDF para arquivo.
• Excluir minha conta - abre solicitação de exclusão (registrada para o admin tratar manualmente).

Erros comuns e como resolver

• "Cliente não consegue logar com a senha antiga" - Causa: a agência importou o cliente do legado sem senha; o sistema só guarda hash de senha após o primeiro reset. Solução: o cliente clica em Esqueci a senha na tela de login e segue o e-mail de redefinição.
• "Onde meu cliente vê o boleto/PIX?" - A página é Financeiro (/minha-conta/financeiro). Cada parcela tem botão de copiar PIX ou abrir boleto. Pix com comprovante manual: o cliente clica em Enviar comprovante e o admin aprova no painel.
• "Cliente não acha o contrato para assinar" - A assinatura aparece como alerta laranja no topo do portal e dentro do detalhe da excursão em Minhas Excursões. Se o contrato já foi assinado, some.
• "Sumiu o menu Dependentes do portal" - Causa: na Jornada do Cliente o flag permitir_dependentes está desligado (ou está em modo exclusivo de Experiências). Solução: reativar em Configurações > Jornada do Cliente.
• "Não aparece Vagas Pendentes mesmo com convite enviado" - Causa: o flag permitir_convite_link está desligado para você. Solução: reativar na Jornada do Cliente ou orientar o titular a cadastrar a pessoa como dependente antes de inscrever.

Onde encontrar

• URL: /minha-conta (raiz redireciona para login ou dashboard conforme estado da sessão)
• Caminho no menu admin: o portal não fica no admin - para entrar como cliente, use Cadastros > Clientes > (linha do cliente) > Acessar como Cliente
• Permissão necessária: nenhuma do lado do cliente (basta ter login no guard cliente); do lado do admin, editar os clientes para impersonar
• Módulo necessário: nenhum para o portal base; itens específicos dependem de módulos (Fidelidade, Ingressos, Experiências)

Veja também

• Clientes - Acessar como Cliente
• Clientes - Listagem
• Dependentes do Cliente
• Documentos do Cliente
• Perfil do Cliente