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:
- Clique no botão Novo Hóspede na barra de ferramentas
- Preencha os campos do formulário:
Campos Obrigatórios¶
| Campo | Descrição |
|---|---|
| Nome Completo | Nome completo do hóspede (máximo 100 caracteres) |
| 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.
- Clique em Criar para salvar o cadastro
Criar Múltiplos Hóspedes¶
Para cadastrar vários hóspedes de uma só vez:
- Clique no botão Criar Múltiplos Hóspedes na barra de ferramentas
- 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 | 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
- Opcionalmente, defina um Apartamento padrão para linhas sem unidade especificada
- Clique em Validar Dados para verificar os registros
- 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:
- Clique no botão Filtros na barra de ferramentas
- Configure os critérios desejados:
| Filtro | Descrição |
|---|---|
| Nome | Filtrar por nome do hóspede |
| 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 |
- Clique em Aplicar Filtros para visualizar os resultados
- Use Limpar Filtros para remover todos os critérios
- 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 |
| 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:
- Clique no botão Colunas na barra de ferramentas
-
Marque ou desmarque as colunas desejadas:
- Seleção (obrigatória)
- Foto
- Nome (obrigatória)
- RG/CPF
- Apartamento (obrigatória)
- 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)
-
Clique em Aplicar Configuração para salvar
- Use Selecionar Todas para marcar todas as colunas
- 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.
Menu de Ações do Hóspede¶
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:
- Acesse o menu Ações do hóspede desejado
- Clique em Editar
-
Atualize os campos necessários:
- Nome Completo
- Telefone
- RG/CPF
- Apartamento
- Autorizado Por
- Período de Acesso
- Foto (via captura)
-
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¶
- Captura: Administrador captura a foto do hóspede via webcam
- Aprovação: Administrador revisa e aprova a foto manualmente
- 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:
- Clique no botão Exportar na barra de ferramentas
- Selecione o formato desejado:
| Formato | Descrição |
|---|---|
| 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:
- Clique no menu Ações do hóspede desejado
- Selecione Histórico de Auditoria
- 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
- Defina períodos coerentes - Configure datas de estadia compatíveis com a duração real da hospedagem
- Monitore estadias prolongadas - Acompanhe hóspedes com permanência superior a três meses
- Mantenha contatos atualizados - Telefones e emails atualizados facilitam a comunicação
- Capture fotos sempre que possível - Fotos auxiliam a portaria na validação visual e aumentam a segurança
- Identifique o morador responsável - Sempre associe o hóspede ao morador que autorizou a estadia
- Use os filtros rápidos - Aproveite os cards para acessar rapidamente as informações mais relevantes
Resumo Rápido¶
Gestão de Hóspedes
- Use os cards de filtro rápido para visualizar hóspedes por status
- Clique em Novo Hóspede para cadastrar um hóspede individual
- Use Criar Múltiplos Hóspedes para importar hóspedes em lote via CSV
- Aplique Filtros Avançados para buscas específicas
- Configure as Colunas visíveis conforme sua necessidade
- Defina Períodos de Estadia compatíveis com a duração da hospedagem
- Gerencie fotos faciais através das opções Aprovar, Publicar e Despublicar
- Use Exportar para gerar documentos nos formatos PDF, CSV ou XLSX
- Acesse o menu Ações para operações individuais em cada hóspede