Portal do proprietário

Disponível a partir do plano Pro (e durante o teste grátis). No plano Growth, o link do portal mostra "Portal indisponível" ao proprietário — sem erro e sem dados.

O portal é um site de autoatendimento que você libera pro proprietário. Ele acessa por link único (sem senha) e vê:

• Resumo — KPIs do mês (faturamento, ocupação, noites vendidas)
• Calendário — ocupação por unidade
• Relatórios — PDFs mensais pra baixar
• Despesas — aprovadas + lançar nova (com IA)
• Pagamentos — histórico de repasses
• Meus dados (LGPD) — baixar JSON completo + solicitar exclusão + opt-out de IA

Gerar o acesso

Opção A — Admin envia direto

1. Proprietários → clique no proprietário
2. Botão Gerar portal token (ou aba Portal)
3. Sistema gera link único + envia por email pro proprietário
4. Proprietário clica no email → acessa

Opção B — Proprietário solicita sozinho

1. Proprietário acessa https://seu-dominio.com/portal
2. Digita o email cadastrado
3. Clica "Enviar link de acesso"
4. Recebe email com link mágico (se o email bater com algum cadastrado)

Validade do link

• O link vale 90 dias e renova sozinho: cada vez que o proprietário usa o portal, e cada vez que o link vai para o e-mail dele (relatório do mês ou "Esqueci meu link"), a validade volta para 90 dias. Quem usa não perde o acesso.
• Link vencido não abre nenhuma tela do portal. O proprietário vê "Link vencido" e um botão para receber um link novo no e-mail cadastrado.
• Gerar um link novo em Proprietários invalida o anterior.

Segurança

• Código por e-mail em aparelho novo. O link sozinho não abre o portal num celular ou computador que ainda não foi confirmado: o portal pede um código de 6 números, que vai para o e-mail cadastrado do proprietário (vale 10 minutos). Confirmado, aquele aparelho fica liberado por 90 dias, renovados enquanto ele usar. Assim, link encaminhado ou visto num print não dá acesso.
• O e-mail precisa estar cadastrado em Proprietários (o e-mail provisório da importação do Stays não recebe código). Sem e-mail, o portal pede ao proprietário que fale com você.
• Gerar um link novo exige confirmar o aparelho de novo.
• Link longo e aleatório (praticamente impossível de adivinhar)
• Token dá acesso APENAS aos dados desse proprietário específico (isolamento por tenant + owner_id)
• Cada acesso é logado em lgpd_data_access_log
• Proprietário que pedir exclusão → token revoga automaticamente

Funcionalidades do portal

1. Resumo (padrão)

KPIs do mês, faturamento por canal, anual.

2. Calendário

Mapa de ocupação por unidade. Clica na unidade pra ver noites vendidas.

3. Relatórios

PDFs mensais que você enviou. Proprietário baixa quando quiser.

4. Despesas

• Ve despesas aprovadas do período
• Botão Lançar Despesa — mesmo fluxo de upload com IA do admin (ver Importar despesas com IA)
• Lançamentos do proprietário entram como draft e aparecem pra você aprovar em /expenses

5. Pagamentos

Histórico de repasses. Mostra dia, valor, período.

6. Meus dados (LGPD)

• Baixar meus dados (JSON) — export completo com todos os dados do proprietário, decifrados. Útil pra auditoria ou portabilidade.
• Opt-out de IA — se marcar, o portal dele não usa IA pra extrair despesas
• Solicitar exclusão — abre pedido formal de remoção (você aprova em Deletion Requests)

Estas funcionalidades são obrigatórias pela LGPD (Art. 18).

Revogar o acesso

Se proprietário pedir revogação ou você precisar por outro motivo:

1. Proprietários → Editar
2. Campo Portal Token → Revogar
3. Sistema limpa o token — qualquer link antigo para de funcionar imediatamente

Problemas comuns

"Proprietário não recebe o email do link"

• Conferir se o email cadastrado está correto
• Confere spam
• Confira Configurações → Integrações → E-mail — veja E-mails para proprietários

"Link do portal diz token inválido"

• Link foi revogado ou regenerado
• URL foi copiada errada (faltou caractere)

Solução: gerar novo link e enviar. Se a tela diz "Link vencido", o próprio proprietário resolve: botão "Receber um link novo" → e-mail cadastrado.

"Proprietário não recebe o código"

• O código vai para o e-mail cadastrado em Proprietários — confira se está certo
• Confira o spam; o assunto começa com os 6 números do código
• Pode pedir outro código na mesma tela (até 5 por hora)

"Proprietário quer senha em vez de link"

O portal não tem senha para decorar: o link é a entrada e, num aparelho novo, o código no e-mail confirma que é ele. Depois de confirmado, o aparelho fica liberado por 90 dias.

Próximo: Exportar dados LGPD