Visão 360°
O painel de inteligência comercial do CRMAppy — uma visão completa do cliente com dados cadastrais, KPIs de interação, mini-gráficos analíticos e análise de IA sob demanda.
📋 Visão Geral
O usuário busca um cliente, e o sistema monta automaticamente um painel com quatro blocos: dados cadastrais completos, insights de ações e orçamentos com mini-gráficos, análise de IA sob demanda e histórico de conversas sem edição.
⚖️ Cockpit vs Visão 360°
- ✓ Foco operacional — registrar ações
- ✓ Lista empresas com ações ativas
- ✓ Formulário de registro de ação
- ✓ Edição de notas
- ✓ Histórico com opção de editar
- ✗ Sem KPIs nem mini-gráficos
- ✗ Sem análise de IA
- ✓ Foco analítico — consulta e decisão
- ✓ Busca qualquer cliente pelo nome
- ✓ KPIs de ações e orçamentos
- ✓ Mini-gráficos (spark, bar, donut)
- ✓ Análise de IA sob demanda
- ✗ Sem registro de novas ações
- ✗ Histórico somente leitura
🖥️ Fluxo da Tela
A página se monta de cima para baixo conforme o usuário seleciona o cliente. Cada bloco aparece em sequência após a busca.
🏢 Bloco 1 — Dados do Cliente
Exibido pelo componente CustomerDetailsCard. Consolida todas as
informações cadastrais da empresa selecionada em três sub-seções.
| Sub-seção | O que exibe |
|---|---|
| Dados da Empresa | Nome fantasia, razão social, telefone, e-mail, website (com link clicável), endereço completo, CNPJ formatado e responsável (dono da carteira). Se a empresa tiver qualificação registrada, exibe estrelas (1 a 5) no canto superior direito. |
| Contatos |
Um card por contato com: nome completo, cargo, departamento, guardião do contato
(contact_guard), status ativo/inativo (bolinha verde ou cinza) e canais de
comunicação (telefone e e-mail com link mailto:).
|
| Notas |
Histórico de anotações internas sobre a empresa (componente NotesSection).
Permite leitura e edição das notas diretamente na Visão 360°.
|
📊 Bloco 2 — Insights Rápidos
Exibido pelo componente InsightsStrip. Analisa as ações e orçamentos
do cliente no período selecionado e apresenta KPIs com mini-gráficos interativos.
O período padrão é os últimos 15 dias.
| KPI | O que mostra | Visualização |
|---|---|---|
| Ações no período | Total de ações registradas no período. Exibe média diária abaixo do valor. | Mini-gráfico de linha (sparkline) com tendência diária |
| Taxa de conclusão | Percentual de ações concluídas sobre o total. Indica produtividade no relacionamento. | Indicador de tendência (▲▼) comparando primeira vs segunda metade do período |
| Abertas vs Concluídas | Contagem absoluta de ações abertas e concluídas lado a lado. | Mini-barra proporcional (vermelho = abertas, verde = concluídas) |
| Por temperatura | Distribuição das ações por temperatura (quente, morna, fria). | Mini-donut colorido por temperatura |
| Atrasadas | Ações com data vencida e ainda não concluídas. | Número simples |
| Agendadas (7d) | Ações agendadas para os próximos 7 dias. | Número simples |
| Elemento | Função |
|---|---|
| Seletor de Período | Alterna o intervalo de análise. Opções pré-definidas (15, 30, 60 dias…) ou intervalo personalizado. Todos os KPIs e gráficos atualizam ao mudar o período. |
| Botão IA ✦ | Ícone circular azul ao lado do seletor de período. Aciona a análise de IA para o cliente e período selecionado. Fica desabilitado enquanto a análise está sendo processada. |
| Card de Orçamentos por Estágio | Exibe valores em R$ e contagens de orçamentos separados por estágio: Em Espera, Ganhos e Perdidos. |
✦ Análise de IA — Visão 360°
| Elemento | Comportamento |
|---|---|
| Como acionar | Clique no botão ✦ (Sparkles) ao lado do seletor de período. A análise é gerada para o cliente e período atualmente selecionados. |
| O que a IA analisa | Frequência de contatos, taxa de conclusão, temperatura das ações, ações atrasadas, orçamentos por estágio e tendência de atividade no período. |
| Resultado | Painel Vision360AiInsightsPanel aparece logo abaixo dos KPIs com o diagnóstico em linguagem natural e ações destacadas relevantes. |
| Salvar como nota | O resultado da análise pode ser salvo diretamente como nota interna da empresa, sem precisar copiar manualmente. |
| Cache de análises | Análises são cacheadas por 24h no banco (ai_analysis). Se já existir uma análise recente para o mesmo cliente e período, o sistema a reutiliza sem nova chamada à IA. |
🕓 Bloco 3 — Histórico de Conversas
O mesmo componente ConversationHistoryCard usado no Cockpit —
mas aqui operando em modo somente leitura (showEdit=false).
O lápis de edição não aparece. O histórico é consultivo, não operacional.
▶️ Fluxo de Uso
-
1
Abra a Visão 360° pelo menu lateral
A tela inicia com o campo de busca em destaque e os blocos ainda vazios.
-
2
Digite o nome do cliente
A partir de 2 caracteres o autocomplete sugere empresas. Clique na empresa desejada para carregar o painel completo.
-
3
Analise os dados cadastrais e contatos
O primeiro bloco exibe dados da empresa, contatos com canais e notas internas.
-
4
Consulte os Insights
Veja os KPIs e gráficos do período padrão. Altere o período pelo seletor se necessário.
-
5
Acione a análise de IA (opcional)
Clique no botão ✦ para gerar uma análise interpretativa do relacionamento com o cliente. Salve como nota se quiser registrar o diagnóstico.
-
6
Consulte o histórico de conversas
Role até o final para ver o histórico cronológico de todas as interações registradas com o cliente.