Ir para o conteúdo

Hóspedes

A tela de Hóspedes permite visualizar e gerenciar visitantes autorizados a permanecer temporariamente em unidades do condomínio. Nela você acompanha períodos de estadia, aprova fotos faciais e monitora hóspedes vinculados às unidades.

Objetivo desta tela

Gerenciar o cadastro consolidado de hóspedes, incluindo controle de períodos de estadia, aprovação de fotos faciais, vínculo com unidades e monitoramento de acessos.


Visão Geral da Tela

Ao acessar a tela de Hóspedes, você encontra:

  • Indicadores estatísticos: Apartamento com mais hóspedes, maior duração de estadia, estadias prolongadas e hóspedes monitorados
  • Cards de filtro rápido: Todos, Ativos Agora, Cadastros Recentes, Não aprovados e Sem Foto
  • Barra de ferramentas: Botões Novo Hóspede, Criar Múltiplos Hóspedes, Filtros, Exportar, Colunas, Busca, Relatório e Ajuda
  • Campo de busca: Localiza por nome, email, apartamento ou telefone
  • Tabela de hóspedes: Lista todos os registros com colunas configuráveis
  • Paginação: Controles para navegar entre páginas e definir quantidade de registros

Indicadores Estatísticos

No topo da página, quatro painéis exibem informações consolidadas sobre os hóspedes:

Indicador Descrição
Apartamento com Mais Hóspedes Código da unidade que possui o maior número de hóspedes vinculados
Maior Duração de Estadia Tempo da estadia mais longa registrada e nome do hóspede
Estadia Prolongada (+3 meses) Quantidade de hóspedes com permanência superior a três meses
Hóspedes Monitorados Total de hóspedes com monitoramento de acesso ativo

Cards de Filtro Rápido

Os cards funcionam como filtros visuais e exibem estatísticas em tempo real:

Card Descrição
Todos Exibe todos os hóspedes cadastrados
Ativos Agora Hóspedes com estadia em andamento na data atual
Cadastros Recentes Hóspedes cadastrados nos últimos 30 dias
Não aprovados Hóspedes aguardando aprovação facial
Sem Foto Hóspedes sem foto facial enviada

Dica

Clique em qualquer card para aplicar automaticamente o filtro correspondente na tabela. O card Ativos Agora é especialmente útil para a portaria verificar quem está autorizado a entrar no momento.


Cadastrar Novo Hóspede

Para adicionar um novo hóspede ao sistema:

  1. Clique no botão Novo Hóspede na barra de ferramentas
  2. Preencha os campos do formulário:

Campos Obrigatórios

Campo Descrição
Nome Completo Nome completo do hóspede (máximo 100 caracteres)
Email Endereço de email para contato (máximo 80 caracteres)
Apartamento Unidade vinculada à estadia (digite 2 caracteres para buscar)

Campos Opcionais

Campo Descrição
Telefone Número de contato no formato (11) 99999-9999
RG/CPF Documento de identificação (máximo 20 caracteres)
Autorizado Por Morador responsável pela autorização do hóspede
Período de Acesso Data inicial e final da estadia autorizada
Foto Capture via webcam para identificação visual

Observação

O campo Autorizado Por só fica habilitado após selecionar um apartamento. Ele indica o morador responsável pela autorização do hóspede na unidade.

  1. Clique em Criar para salvar o cadastro

Criar Múltiplos Hóspedes

Para cadastrar vários hóspedes de uma só vez:

  1. Clique no botão Criar Múltiplos Hóspedes na barra de ferramentas
  2. O sistema exibe um formulário para importação em lote

Formato dos Dados

Cole os dados no formato CSV (separado por vírgula) com a seguinte estrutura:

Posição Campo Obrigatório
1 Nome completo Sim
2 Email Não
3 Telefone (11) 99999-9999 Não
4 RG ou CPF Não
5 Data inicial DD/MM/AAAA Não
6 Data final DD/MM/AAAA Não
7 Apartamento Não (usa o padrão se não informado)

Exemplo de dados

Maria Silva, maria@exemplo.com, (11) 98888-7777, 123456, 01/09/2025, 10/09/2025, A101
  1. Opcionalmente, defina um Apartamento padrão para linhas sem unidade especificada
  2. Clique em Validar Dados para verificar os registros
  3. Clique em Criar em lote para finalizar

Atenção

  • Máximo de 10 linhas por operação
  • Use o botão Copiar Exemplo ou Baixar CSV de Exemplo para obter o modelo correto
  • Clique em Formato e exemplo de dados para visualizar instruções detalhadas

Busca e Filtros

Busca Rápida

O campo de busca permite localizar hóspedes por:

  • Nome completo ou parcial
  • Endereço de email
  • Número do apartamento
  • Telefone

Informação

A barra de busca pesquisa simultaneamente todos os campos mencionados, agilizando a localização de hóspedes.

Filtros Avançados

Para buscas mais específicas:

  1. Clique no botão Filtros na barra de ferramentas
  2. Configure os critérios desejados:
Filtro Descrição
Nome Filtrar por nome do hóspede
Email Filtrar por endereço de email
Telefone Filtrar por número de telefone
RG/CPF Filtrar por documento de identificação
Apartamento/Unidade Filtrar por código da unidade vinculada
Autorizado Por Filtrar pelo morador que autorizou
Status da Foto Filtrar por situação da foto (Todos, Pendente, Aprovada, Sem Foto)
Bloqueio de Alterações Filtrar por situação de bloqueio
Monitoramento de Acesso Filtrar por status de monitoramento
Período de Estadia Período de hospedagem (De/Até)
Data de Criação Período de cadastro (De/Até)
Data de Modificação Período de alteração (De/Até)
Observações Filtrar por texto nas observações
  1. Clique em Aplicar Filtros para visualizar os resultados
  2. Use Limpar Filtros para remover todos os critérios
  3. Clique em Salvar Filtro para reutilizar a combinação posteriormente

Informação

O botão Salvar Filtro só fica habilitado após preencher ao menos um critério de filtro.


Tabela de Hóspedes

A tabela exibe os registros com as seguintes informações padrão:

Coluna Descrição
Seleção Checkbox para seleção múltipla
Foto Miniatura da foto (clique para ampliar)
Nome Nome completo do hóspede
RG/CPF Documento de identificação
Apartamento Código da unidade vinculada
Email Endereço de email
Telefone Número de telefone
Status Foto Situação da foto facial (Pendente, Sem Foto)
Ações Menu de ações disponíveis

Ordenação

Clique nos cabeçalhos das colunas para ordenar:

  • Primeiro clique: ordem ascendente
  • Segundo clique: ordem descendente

Paginação

Na parte inferior da tabela:

  • Selecione a quantidade de registros por página (10, 25, 50, 100)
  • Navegue entre páginas usando os botões de navegação

Configuração de Colunas

Personalize as colunas visíveis na tabela:

  1. Clique no botão Colunas na barra de ferramentas
  2. Marque ou desmarque as colunas desejadas:

    • Seleção (obrigatória)
    • Foto
    • Nome (obrigatória)
    • RG/CPF
    • Apartamento (obrigatória)
    • Email
    • Telefone
    • Autorizado Por
    • Início da Estadia
    • Fim da Estadia
    • Duração
    • Observações
    • Bloqueio
    • Monitoramento
    • Data de Criação
    • Última Modificação
    • Status Foto
    • Ações (obrigatória)
  3. Clique em Aplicar Configuração para salvar

  4. Use Selecionar Todas para marcar todas as colunas
  5. Use Padrão do Sistema para restaurar a configuração original

Limite de colunas

O sistema permite no máximo 20 colunas visíveis simultaneamente.


Cada registro possui um menu de ações acessível pelo botão na última coluna:

Ação Descrição
Ver detalhes Exibe modal com informações completas do hóspede
Editar Abre formulário para atualização dos dados
Mover Hóspede Transfere o hóspede para outra unidade
Excluir Remove o cadastro do hóspede
Aprovar Facial Aprova a foto facial enviada (quando pendente)
Publicar Facial Envia a foto para as leitoras de acesso facial
Despublicar Facial Remove a foto das leitoras de acesso facial
Histórico de Auditoria Visualiza registro de alterações
Relatório de Acesso Gera relatório de acessos do hóspede

Observação

As opções Aprovar Facial e Publicar Facial ficam desabilitadas quando o hóspede não possui foto pendente ou já está com a foto publicada.


Detalhes do Hóspede

O modal de detalhes exibe informações organizadas nas seguintes seções:

Informações Pessoais

  • Email do hóspede (com link para envio)
  • Telefone de contato
  • RG/CPF
  • Data de Nascimento (quando informada)

Informações de Moradia

  • Apartamento vinculado
  • Morador Principal responsável

Bloqueio de Alterações

  • Indica se o hóspede está com edição liberada ou bloqueada

Monitoramento de Acesso

  • Status do monitoramento (Ativo ou Inativo)

A partir do modal de detalhes, você pode:

  • Clicar em Editar para atualizar os dados
  • Clicar em Fechar para retornar à listagem

Editar Hóspede

Para atualizar os dados de um hóspede:

  1. Acesse o menu Ações do hóspede desejado
  2. Clique em Editar
  3. Atualize os campos necessários:

    • Nome Completo
    • Email
    • Telefone
    • RG/CPF
    • Apartamento
    • Autorizado Por
    • Período de Acesso
    • Foto (via captura)
  4. Clique em Salvar para confirmar as alterações


Foto Facial

O sistema de foto facial segue um fluxo específico para controle de acesso:

Fluxo de Aprovação

  1. Captura: Administrador captura a foto do hóspede via webcam
  2. Aprovação: Administrador revisa e aprova a foto manualmente
  3. Publicação: Foto aprovada é enviada para as leitoras faciais

Status da Foto

Status Descrição
Aprovada Foto validada e pronta para publicação
Pendente Foto aguardando aprovação do administrador
Sem Foto Hóspede não possui foto cadastrada

Atenção

A presença de foto auxilia a identificação na portaria. Sem foto aprovada, não é possível publicar nas leitoras faciais.


Período de Estadia

O período de permanência define a janela de validade da hospedagem no condomínio.

Status da Estadia

Status Descrição
Ativo Período de estadia válido (data atual dentro do intervalo)
Expirado Período de estadia encerrado

Informação

Após o término do período, o hóspede deixa de constar como ativo. Use o filtro Ativos Agora para visualizar apenas hóspedes cuja data de estadia está em vigor no momento atual.


Exportação de Dados

Para exportar a lista de hóspedes:

  1. Clique no botão Exportar na barra de ferramentas
  2. Selecione o formato desejado:
Formato Descrição
PDF Documento formatado para impressão
CSV Planilha com valores separados por vírgula
XLSX Planilha do Microsoft Excel

Observação

A exportação respeita os filtros aplicados. Para exportar todos os registros, limpe os filtros antes.


Histórico de Auditoria

O histórico de auditoria mostra quando e por quem o cadastro foi criado ou alterado, auxiliando no controle interno e rastreabilidade.

Para acessar:

  1. Clique no menu Ações do hóspede desejado
  2. Selecione Histórico de Auditoria
  3. Visualize o registro de todas as alterações realizadas

Origem dos Dados

Cadastro de Hóspedes

Os dados de hóspedes normalmente são cadastrados pelo morador ou portaria via módulo de autorização de visitantes. Esta tela exibe um extrato consolidado dessas autorizações, permitindo ao administrador uma visão centralizada de todos os hóspedes do condomínio.


Dúvidas Frequentes (FAQ)

O que são Hóspedes?

Hóspedes são visitantes autorizados a permanecer temporariamente em uma unidade do condomínio por um período definido pelo morador responsável.

Como definir o período de estadia de um hóspede?

No formulário de cadastro ou edição, clique no campo Período de Acesso e selecione as datas inicial e final da hospedagem.

Posso cadastrar um hóspede sem vincular a uma unidade?

Não. Todo hóspede deve estar vinculado a uma unidade do condomínio.

Como renovar a estadia de um hóspede?

Acesse o menu Ações do hóspede, clique em Editar e atualize as datas no campo Período de Acesso.

Posso mover um hóspede para outra unidade?

Sim. Use a opção Mover Hóspede no menu de ações para transferir o hóspede para outra unidade mantendo todo o histórico.

Qual a diferença entre Aprovar e Publicar Facial?

Aprovar Facial valida a foto do hóspede no sistema. Publicar Facial envia a foto aprovada para as leitoras de reconhecimento facial, liberando o acesso físico.

O que significa 'Ativos Agora'?

O filtro Ativos Agora mostra apenas hóspedes cuja data de estadia está em vigor no momento atual. É muito útil para a portaria verificar quem está autorizado a entrar hoje.


Boas Práticas

Recomendações para gestão de hóspedes

  1. Defina períodos coerentes - Configure datas de estadia compatíveis com a duração real da hospedagem
  2. Monitore estadias prolongadas - Acompanhe hóspedes com permanência superior a três meses
  3. Mantenha contatos atualizados - Telefones e emails atualizados facilitam a comunicação
  4. Capture fotos sempre que possível - Fotos auxiliam a portaria na validação visual e aumentam a segurança
  5. Identifique o morador responsável - Sempre associe o hóspede ao morador que autorizou a estadia
  6. Use os filtros rápidos - Aproveite os cards para acessar rapidamente as informações mais relevantes

Resumo Rápido

Gestão de Hóspedes

  1. Use os cards de filtro rápido para visualizar hóspedes por status
  2. Clique em Novo Hóspede para cadastrar um hóspede individual
  3. Use Criar Múltiplos Hóspedes para importar hóspedes em lote via CSV
  4. Aplique Filtros Avançados para buscas específicas
  5. Configure as Colunas visíveis conforme sua necessidade
  6. Defina Períodos de Estadia compatíveis com a duração da hospedagem
  7. Gerencie fotos faciais através das opções Aprovar, Publicar e Despublicar
  8. Use Exportar para gerar documentos nos formatos PDF, CSV ou XLSX
  9. Acesse o menu Ações para operações individuais em cada hóspede