Agenda — CRMappy Docs

📋 Visão Geral

A Agenda X é o módulo de gestão temporal do CRMAppy. É uma agenda somente leitura — não registra novas ações, mas oferece uma visão rica e contextualizada do que aconteceu e está agendado em cada dia.

Ao abrir, o módulo já posiciona no dia de hoje com o painel do dia aberto. O usuário navega pelo calendário clicando em qualquer dia para ver as empresas e ações daquele período. Dois modos de visualização estão disponíveis: Agenda (linha do tempo linear) e Empresa (agrupado por empresa).

🖥️ Anatomia da Tela

junho 2026

‹

Hoje

›

D

S

T

Q

S

4

5

6

7

8

9

10

2

11

3

12

1

13

14

15

16

17

2

4

3

2

4

5

6

7

8

9

10

11

12

13

Contexto do Dia — 02/06/2026

Modo: Agenda

🏢 Clínica São Lucas

Ligação (E)

Apresentação de proposta comercial

09:30

Whats (E)

Envio de contrato para assinatura

14:00

🏢 Distribuidora ABC

E-mail (R)

Resposta sobre renovação do contrato

11:15

📆 Calendário — Coluna Esquerda

O calendário exibe o mês atual com indicadores visuais em cada dia que tem ações registradas. Ao abrir o módulo, o dia de hoje já está selecionado automaticamente.

Elemento	Função
Botão ‹ (mês anterior)	Navega para o mês anterior. O calendário recarrega os indicadores do novo mês.
Botão Hoje	Volta ao mês atual e seleciona o dia de hoje, abrindo o painel com as ações do dia.
Botão › (próximo mês)	Navega para o mês seguinte.
Célula de dia	Clique em qualquer dia para abrir o painel com as ações e empresas daquele dia. O tooltip mostra a contagem de atrasadas, ativas e concluídas.

Legenda de Cores e Indicadores

2

Vermelho — Ações atrasadas

Dia com ações cuja data já passou e ainda não foram concluídas. Badge vermelho no canto com a contagem.

3

Azul — Ações ativas

Dia com ações agendadas e ainda abertas (hoje ou futuros). Badge azul com a contagem.

·

Azul claro — Dia futuro sem ações

Dia no futuro sem ações agendadas. Fundo levemente azulado para distinguir do passado.

·

Cinza — Dia passado sem ações

Dia anterior a hoje sem ações registradas. Fundo cinza neutro.

4

Verde — Ações concluídas

Badge verde no canto inferior direito indica quantas ações foram concluídas naquele dia.

②

Aro laranja — Dia selecionado

Aro laranja destaca o dia atualmente selecionado no calendário.

②

Aro cinza — Hoje (não selecionado)

Aro cinza claro marca o dia de hoje quando outro dia está selecionado.

📋 Painel do Dia — Coluna Direita

O painel exibe as ações e empresas do dia selecionado. O conteúdo e a forma de exibição dependem do Modo de Visualização ativo.

Elemento	Comportamento
Título do painel Clicável	Exibe "Contexto do Dia — DD/MM/AAAA". Clicar no título alterna o modo de visualização entre Agenda e Empresa.
Indicador de Modo Canto superior direito	Exibe "Modo: Agenda" ou "Modo: Empresa". O tooltip explica o comportamento do modo atual. O modo é salvo automaticamente para a próxima sessão.
Conteúdo do painel	Varia conforme o modo ativo. Ver seção seguinte.

🔄 Modos de Visualização

📅 Modo Agenda

Linha do tempo linear — padrão atual

Exibe todas as ações do dia em uma linha do tempo contínua, independente de qual empresa pertencem. As ações aparecem ordenadas por horário, com filtros e abas para segmentar por status ou tipo. Ideal para ter uma visão rápida e cronológica de todo o dia.

✓ Modo atual (V1)

🏢 Modo Empresa

Agrupado por empresa — modo legado

Exibe as ações agrupadas por empresa. Para cada empresa com ações no dia, aparece o dossiê completo da empresa (CompanyProfileCardFull) seguido da linha do tempo de ações daquela empresa (ChatsTimeline), tudo expandido por padrão. Ideal para contexto profundo de cada cliente no dia.

Legado — mantido

💡 Como alternar os modos Clique no título "Contexto do Dia" no cabeçalho do painel direito. O modo alterna entre Agenda e Empresa a cada clique. A preferência é salva automaticamente e mantida na próxima sessão.

🏢 Modo Empresa — Conteúdo do Dossiê

No Modo Empresa, cada empresa com ações no dia recebe dois blocos exibidos em sequência.

Bloco	O que exibe
CompanyProfileCardFull Dossiê da empresa	Perfil completo da empresa: nome fantasia, razão social, CNPJ, segmento, status, qualificação, responsável, website, e-mail, telefone, endereço, contatos com canais de comunicação e negócios (deals) vinculados.
ChatsTimeline Linha do tempo de ações	Ações da empresa no dia selecionado com abas: Ambos (padrão), filtrando por pendentes e concluídas. Página de até 20 ações, exibidas com tipo, canal, horário, assunto e status.

ℹ️ Nenhuma empresa no dia Se não houver empresas com ações na data selecionada, o painel exibe: "Nenhuma empresa com ações neste dia."

🔄 Dados e Persistência

Dado	Comportamento
Modo de visualização	Salvo no `localStorage` (chave `agendax:viewMode`). O módulo abre sempre no último modo usado. Padrão: Agenda.
Indicadores do calendário	Carregados do banco ao navegar entre meses. Cada célula mostra contagem de atrasadas, ativas e concluídas para o mês inteiro de uma vez — sem chamadas por dia.
Ações do dia	Carregadas via `agendaXBridge` com acesso via RLS — o usuário só vê as ações do seu tenant. A data é sempre calculada em horário local (sem conversão UTC) para evitar desvio de dia.
Somente leitura	A Agenda X não permite registro, edição ou exclusão de ações. Para isso, use o Cockpit.

⚠️ Agenda X é somente leitura Nenhuma ação pode ser criada, editada ou excluída pela Agenda X. O módulo serve para consulta e contextualização do dia — o registro de ações acontece no Cockpit.

▶️ Fluxo de Uso

1
Abra a Agenda X pelo menu lateral
O módulo abre direto no dia de hoje com o painel do dia já carregado. O calendário mostra o mês atual com indicadores coloridos em todos os dias com ações.
2
Navegue pelo calendário
Clique em qualquer dia para ver suas ações. Use os botões ‹ e › para mudar de mês. O botão "Hoje" volta ao dia atual a qualquer momento.
3
Escolha o modo de visualização
Clique no título do painel para alternar entre Modo Agenda (linha do tempo) e Modo Empresa (agrupado por empresa). O modo preferido é salvo para a próxima sessão.
4
Consulte as ações e empresas do dia
No Modo Agenda: veja a linha do tempo de todas as ações. No Modo Empresa: veja o dossiê de cada empresa com suas ações do dia expandidas.
5
Use a informação para planejar ou avaliar
Identifique dias com muitas atrasadas (vermelho), verifique o contexto de cada empresa e planeje as próximas interações. Para registrar ações, vá ao Cockpit.