Briefing técnico – desenvolvimento do CRM com reconhecimento facial.

Objetivo
Construir, do zero, um módulo de CRM em Bubble (ou stack web equivalente) que receba eventos de reconhecimento facial, registre visitas e apresente ao atendente dados do cliente em tempo real, permitindo ações rápidas de recepção premium.

**1. Arquitetura**
Câmera IP ? Motor de Reconhecimento (Azure Face API ou local)
? ?
Webhook ? API ? Banco de Dados ? Front-end Tablet

Câmera captura rosto na entrada.

Motor de reconhecimento gera face_id em ?2 s.

Webhook (HTTPS) envia {face_id, timestamp, snapshot_url} ao back-end.

API back-end consulta banco, cria registro de visita e dispara evento de “chegada” para a interface.

Front-end (dashboard do atendente) atualiza a Fila de Chegada e abre o perfil do cliente.

2. Modelagem de dados
Tabela / Tipo
Campos principais
Observações
Cliente
id, nome, foto, face_id, nívelVIP, consentimentoLGPD, preferências (list), observações(text)
face_id é hash/UUID vindo do motor; preferências armazena JSON ou relational tag.
Visita
id, cliente_id, dataHora, atendente_id, notas
Criado a cada evento “chegada”.
Tarefa
id, cliente_id, tipo (mimo, transfer, etc.), status, criadoEm, concluídoEm
Ações disparadas pelo atendente.
Auditoria
id, user_id, ação, registroAfetado, timestamp
Log de privacidade (LGPD).

3. API e workflows
3.1 Webhook de chegada
POST /faceWebhook

json
{
"face_id": "e2c9-…",
"timestamp": "2025-07-18T14:08:55Z",
"snapshot_url": "https://…/img.jpeg"
}

**Passos internos**
Procurar Cliente onde face_id = body.face_id e consentimentoLGPD = true.

Se encontrado, criar Visita.

Emitir evento server-side “visitor_arrived” com cliente_id.

Se não encontrado, registrar em Auditoria como IdDesconhecido.

3.2 Evento “visitor_arrived”
Backend workflow que envia push ou publish via WebSocket para o front-end.

Payload mínimo: cliente_id, nome, foto, nívelVIP.

4. Interface do atendente (tablet paisagem)
Página Dashboard

Painel “Fila de Chegada” – lista horizontal de cartões com foto/nome e cronômetro de tempo de espera.

Toque em um cartão ? Modal Perfil do Cliente.

**Modal Perfil do Cliente**

Bloco superior: Foto ampla + saudação “Bem-vindo, <Nome>”.

Abaixo: Última visita, preferência de bebida, restrições, observações.

Área de ações rápidas (botões grandes):

Ver histórico (abre página “Histórico de Visitas”)

Enviar mimo (cria Tarefa tipo “Gift”)

Notificar lounge VIP (gatilho para equipe interna)

**Menu lateral**

Clientes Ativos | Fila de Chegada | Estatísticas | Aniversários

Página Estatísticas (para gerente)

Gráficos de visitas por período, valor médio de consumo, clientes TOP.

5. Permissões e privacidade
Papel
Acesso de leitura
Acesso de escrita
Diretor
Todos relatórios, dados consolidados
Nenhum
Gerente
Dados de cliente e visitas
Editar cliente, criar alertas
Atendente
Apenas dados de cliente no turno via evento “visitor_arrived”
Adicionar notas de visita, criar tarefas
Sistema
Webhook / backend
Gravar Visita, Auditar

Privacy Rules em Bubble garantem que atendentes nunca vejam CPF ou campos sensíveis.

6. LGPD
Campo consentimentoLGPD obrigatório para processar rosto.

Todo acesso ao registro de cliente grava linha em Auditoria.

Rotina diária de expurgo de logs anonimizados cuja finalidade expirou (> 5 anos).

7. Roadmap de implementação
Semana
Entrega
Detalhes
1
Data model & API webhook
Banco, segurança, mock de Face API
2
Dashboard + evento em tempo real
WebSockets / custom event
3
Modal de perfil + ações rápidas
Workflows de “Mimo” e “Notificar VIP”
4
Estatísticas, auditoria e testes E2E
LGPD, testes de latência

Tempo total estimado: 2 semanas.