GeoSales - Contribuições do(a) usuário(a) [pt-br]

Atendimento ao Cliente Força de Vendas CRM

2026-05-04T12:37:30Z

Renatolima: /* Funcionalidades principais: */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial, esta aba deve ser trocada para Reunião.
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

Na tela onde criamos os tipo de evento(reunião), tem um checkbox que tem a descrição "Visita presencial obrigatória" para "Reunião Obrigatória".

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

==== Comportamento ====

Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes

====Resumo das Notas (Painel Direito)====

Apresenta indicadores consolidados:

* Notas no mês
* Notas não lidas
*Pendentes de retorno
* Último registro

==== Ações Rápidas (Floating Actions) ====

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1100px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-05-04T12:33:30Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial, esta aba deve ser trocada para Reunião.
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

==== Comportamento ====

Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes

====Resumo das Notas (Painel Direito)====

Apresenta indicadores consolidados:

* Notas no mês
* Notas não lidas
*Pendentes de retorno
* Último registro

==== Ações Rápidas (Floating Actions) ====

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1100px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:30:08Z

Renatolima: /* Componentes da Tela */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

==== Comportamento ====

Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes

====Resumo das Notas (Painel Direito)====

Apresenta indicadores consolidados:

* Notas no mês
* Notas não lidas
*Pendentes de retorno
* Último registro

==== Ações Rápidas (Floating Actions) ====

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1100px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:28:11Z

Renatolima: /* Documentos relacionados */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1100px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:26:04Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1100px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:25:53Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1200px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:25:44Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1300px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:25:33Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1400px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:25:23Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|1200px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:25:08Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Mermaid-diagram_(1).png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Arquivo:Mermaid-diagram (1).png

2026-04-29T14:24:51Z

Renatolima:

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:16:05Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Navegação

O usuário deve conseguir navegar entre os módulos sem perder o contexto do cliente selecionado.

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

'''[RN12] - ''' Exibição das Abas
A exibição das abas devem ser controladas por ações dentro do controle de permissão.

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:13:07Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' Todos os cadastros podem ser feitos para clientes ativos ou bloqueados, desde que esteja, disponíveis no Geosales.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:12:07Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - '''

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

Eventos poderão ser classificados como:

* Presencial
* Online

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T14:11:05Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Vinculação ao Cliente

Todas as informações devem estar vinculadas a um cliente
* Contatos
* Notas
* Atividades
* Eventos
* Fases Pedidos

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' Cada contato deve possuir, no mínimo:
* Nome
* Forma de contato (telefone ou e-mail)

'''[RN4] - ''' O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

'''[RN5] - ''' Atualização em Tempo Real

Indicadores, resumos e painéis devem refletir os dados atualizados conforme alterações realizadas no sistema.

'''[RN6] - ''' Pesquisa e Filtros
Todas as abas, os filtros devem seguir o padrão de filtro Geosales, levando em consideração o conceito da aba;
* Filtros de datas, Pedido, Tipo de eventos, por contato, por fases.

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - ''' Cadastro de Evento

Todo evento deve possuir:

* Título
* Data
* Horário

'''[RN11] - ''' Tipo do Evento

Eventos poderão ser classificados como:

* Presencial
* Online

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T13:47:39Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Todas as informações devem estar vinculadas a um cliente

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - ''' O que definirá se um evento deve ser exibido da aba de eventos ou atividade, deve ser a seleção no cadastro tipo do Evento, onde hoje indicamos se é uma visita presencial. Quando o tipo de evento usado no cadastro de um evento estiver com a opção '''Visita presencial obrigatória''', estes eventos devem ser exibidos na aba de eventos, quando for um tipo de evento sem a seleção deste campo, este deve ser apresentado na aba de atividades.

'''[RN4] - '''

'''[RN5] - ''' Contatos devem estar vinculados ao cliente

'''[RN6] - '''

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - '''

'''[RN11] - '''

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-29T13:37:54Z

Renatolima: /* Atividades: */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
Disponibilizar uma visão organizada das atividades comerciais, permitindo que os usuários planejem, acompanhem e priorizem tarefas relacionadas ao cliente, garantindo melhor gestão do tempo e aumento da produtividade da equipe de vendas.
A tela apresenta um modelo de pipeline de atividades, com listagem clara das tarefas e indicadores de desempenho, permitindo:

* Visualização rápida das atividades pendentes
* Controle de prazos e prioridades
* Acompanhamento de produtividade

==== Ações e Filtros ====
* Botão "Nova atividade": criação de nova tarefa
* Filtro por prioridade: (ex: "Todas as prioridades")
* Campo de busca: "Buscar atividade..."

==== Pipeline de Atividades (Painel Esquerdo) ====

Lista de atividades organizadas de forma sequencial.

==== Estrutura da Atividade ====

Cada atividade contém:

* Título da atividade
* Prazo (data e hora)
* Descrição/objetivo
* Indicador visual (status ou marcador)

==== Comportamento ====
* Ordenação por prazo ou prioridade
* Atualização dinâmica ao criar nova atividade
* Destaque para atividades próximas do vencimento

==== Indicadores (Painel Direito) ====

Apresenta métricas resumidas das atividades:

* Atividades abertas
* Atividades concluídas
* Vencendo hoje
* Prioridade alta

==== Ações Rápidas (Floating Actions) ====

Botões flutuantes:

* Criar/editar atividade
* Ações complementares
* Menu adicional

[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Todas as informações devem estar vinculadas a um cliente

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - ''' Contatos devem estar vinculados ao cliente

'''[RN6] - '''

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - '''

'''[RN11] - '''

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-28T19:29:43Z

Renatolima: /* Fases do Pedido: */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
Permitir a visualização, acompanhamento e gestão dos pedidos realizados por um cliente, oferecendo ao usuário uma visão consolidada das informações principais e do status de cada pedido, além de detalhar o andamento (fase) de um pedido específico.
A tela foi estruturada em dois painéis principais:

* Painel esquerdo: Lista de pedidos do cliente
* Painel direito: Detalhamento da fase do pedido selecionado

Com isso, o usuário consegue navegar rapidamente entre os pedidos e visualizar o status detalhado sem sair da tela.

==== Filtros e Busca ====
Filtro de pedidos: (ex: "Todos os pedidos")
Ordenação: (ex: "Mais recentes")
Campo de busca: "Buscar pedido...

==== Lista de Pedidos (Painel Esquerdo) ====

'''Cada pedido apresenta:'''

* Número do pedido
* Data de emissão
* Vendedor responsável
* Quantidade de itens
* Valor total
* Status do pedido (ex: Validação pendente, Em trânsito, Entregue)
* Tags adicionais (ex: Alta prioridade, Entrega programada)

==== Comportamento: ====

Ao clicar em um pedido, ele é destacado
Atualiza o painel direito com os detalhes da fase

==== Fase do Pedido (Painel Direito) ====

Exibe o progresso do pedido selecionado em formato de linha do tempo.

[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

====Componentes da Tela====

'''Ações e Filtros'''

*Botão "Novo evento": criação de novo compromisso

*Filtro de período: (ex: "Próximos 30 dias")

*Campo de busca: "Buscar evento..."

'''Agenda Comercial (Painel Esquerdo)'''

Lista de eventos organizados por data e relevância.

'''Estrutura do Evento'''

Cada evento contém:

*Título do evento
*Data e horário (início e fim)
*Local ou formato (ex: presencial, online)
*Descrição/objetivo
*Tags/categorias (ex: Diretoria, Produto, Interno)
*Status do evento:
*Confirmado

'''Comportamento'''
*Ordenação por data (eventos mais próximos primeiro)
*Atualização dinâmica ao criar novos eventos
*Destaque visual por status
*Separação clara entre eventos

'''Visão Rápida (Painel Direito)'''

Apresenta indicadores consolidados dos eventos:

*Eventos no mês
*Eventos confirmados
*Eventos online
*Eventos presenciais

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

*Criar/editar evento
*Ações complementares
*Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Todas as informações devem estar vinculadas a um cliente

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - ''' Contatos devem estar vinculados ao cliente

'''[RN6] - '''

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - '''

'''[RN11] - '''

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T18:51:56Z

Renatolima: /* Eventos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T18:51:22Z

Renatolima: /* Eventos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T18:43:11Z

Renatolima: /* Eventos: */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente identificou a necessidade de centralizar as informações de relacionamento com seus clientes dentro do aplicativo de força de vendas, permitindo que a equipe comercial tenha uma visão unificada e contextualizada durante sua rotina em campo.

Atualmente, há demanda por:

* Consolidar '''histórico de interações (notas)'''

* Organizar e acompanhar '''atividades e follow-ups'''

* Gerenciar '''eventos e agenda comercial'''

* Visualizar e manter '''contatos vinculados ao cliente'''

* Acompanhar '''pedidos e suas fases''' no mesmo contexto

Essa centralização visa melhorar a produtividade da equipe, evitar perda de informações e proporcionar maior eficiência na tomada de decisão durante visitas e negociações.

== Solução ==
Implementação de um módulo de CRM embarcado no Força de Vendas, organizado em abas dentro do cadastro do cliente, contendo:

* '''Fases Pedidos''' → acompanhamento completo do fluxo do pedido
* '''Notas''' → registro de interações e histórico
* '''Atividades''' → controle de tarefas e follow-ups
* '''Eventos''' → gestão da agenda comercial
* '''Contatos''' → cadastro e consulta de contatos do cliente

A solução segue o padrão visual e usabilidade já adotados no sistema, garantindo rápida adaptação dos usuários.

== Implementação ==
A implementação será realizada através da criação de um novo container de CRM dentro da tela de cliente, com navegação por abas:

=== Funcionalidades principais: ===
* Estrutura de abas navegáveis
* Componentes de:
* Timeline (Notas)
* Pipeline (Atividades)
* Agenda (Eventos)
* Cards (Contatos)
* Lista + Fases (Pedidos)
* Filtros e ordenações por contexto
* Ações rápidas:
* Criar nota
* Criar atividade
* Criar evento
* Criar contato
* Menu flutuante (FAB) para ações rápidas

=== Fases do Pedido: ===
[[Arquivo:Fases_do_pedido.png|800px]]

=== Notas: ===
Permitir o registro, acompanhamento e organização de interações e observações relacionadas ao cliente, garantindo histórico centralizado e fácil acesso às informações relevantes para equipes comerciais e de relacionamento. A tela foi projetada com foco em produtividade e rastreabilidade, dividida em:

* Linha do tempo de notas (timeline) para visualização cronológica
* Resumo das notas com indicadores quantitativos
* Ações rápidas para criação e gestão

==== Componentes da Tela ====

'''Menu de Navegação'''

Abas disponíveis:

* Pedidos
* Notas (ativa)
* Atividades
* Eventos
* Contatos

'''Ações e Filtros'''

* Botão "Nova nota": inicia o cadastro de uma nova anotação
* Ordenação: (ex: "Mais recentes")
* Filtro por tipo: (ex: "Todos os tipos")
* Campo de busca: "Buscar nota..."

'''Linha do Tempo de Notas (Painel Esquerdo)'''

Exibe as notas em ordem cronológica, agrupadas por data.

'''Estrutura da Nota'''

Cada registro contém:

* Título da nota
* Horário
* Usuário responsável pelo registro
* Descrição detalhada
* Tags/categorias (ex: Oportunidade, Visita, Follow-up)
* Status da nota:
* Não lida
Recente

'''Agrupamento'''

Separação por datas (ex: Hoje, Ontem)
Indicador visual de linha do tempo

4.3. Comportamento
Ordenação conforme filtro selecionado
Atualização dinâmica ao inserir nova nota
Destaque visual para notas não lidas ou recentes
5. Resumo das Notas (Painel Direito)

Apresenta indicadores consolidados:

Notas no mês
Notas não lidas
Pendentes de retorno
Último registro
6. Ações Rápidas (Floating Actions)

'''Botões flutuantes:'''

* Criar nova nota
* Outras ações (ex: anexos ou exportação – dependendo da implementação)
* Menu adicional

'''Interações do Usuário'''
* Criar nova nota
* Filtrar por tipo
* Ordenar notas
* Buscar por conteúdo
* Visualizar histórico cronológico
* Identificar pendências de retorno

[[Arquivo:Notas.png|800px]]

=== Atividades: ===
[[Arquivo:Atividades.png|800px]]

=== Eventos: ===
Permitir o planejamento, organização e acompanhamento de compromissos comerciais com clientes, garantindo visibilidade da agenda e melhor coordenação entre equipes de vendas.
A tela apresenta uma agenda comercial estruturada, com listagem de eventos futuros e indicadores de acompanhamento, possibilitando:

* Controle de reuniões e compromissos
* Organização por período
* Identificação rápida do status dos eventos

Componentes da Tela
3.1. Cabeçalho
Título: CRM no Força de Vendas
Descrição explicativa do contexto CRM
3.2. Menu de Navegação

Abas disponíveis:

Pedidos
Notas
Atividades
Eventos (ativa)
Contatos
3.3. Ações e Filtros
Botão "Novo evento": criação de novo compromisso
Filtro de período: (ex: "Próximos 30 dias")
Campo de busca: "Buscar evento..."
4. Agenda Comercial (Painel Esquerdo)

Lista de eventos organizados por data e relevância.

4.1. Estrutura do Evento

Cada evento contém:

Título do evento
Data e horário (início e fim)
Local ou formato (ex: presencial, online)
Descrição/objetivo
Tags/categorias (ex: Diretoria, Produto, Interno)
Status do evento:
Confirmado
Em análise
4.2. Exemplos de Eventos
Reunião de descoberta com diretoria
Demo do protótipo com time de produto
4.3. Comportamento
Ordenação por data (eventos mais próximos primeiro)
Atualização dinâmica ao criar novos eventos
Destaque visual por status
Separação clara entre eventos
5. Visão Rápida (Painel Direito)

Apresenta indicadores consolidados dos eventos:

Eventos no mês
Eventos confirmados
Eventos online
Eventos presenciais
6. Ações Rápidas (Floating Actions)

Botões flutuantes:

✏️ Criar/editar evento
📄 Ações complementares
⋮ Menu adicional
[[Arquivo:Eventos.png|800px]]

=== Contatos: ===
Permitir o gerenciamento dos contatos vinculados ao cliente, centralizando informações de pessoas-chave envolvidas no relacionamento comercial, facilitando a comunicação, acompanhamento e tomada de decisão. A tela apresenta uma visão organizada dos contatos do cliente em formato de cards, acompanhada de indicadores estratégicos de relacionamento, possibilitando:

* Visualização rápida dos contatos

* Identificação de papéis e responsabilidades

*Acesso fácil às informações de comunicação

==== Componentes da Tela ====

'''Ações e Filtros'''

*Botão "Novo contato": cadastro de um novo contato

*Filtro por cargo: (ex: "Todos os cargos")

*Campo de busca: "Buscar contato..."

==== Contatos Vinculados (Painel Principal) ====

Lista de contatos exibidos em formato de cards.

'''Estrutura do Card'''

Cada contato contém:

* Iniciais do nome (avatar)

* Nome completo

* Cargo/função

* Telefone

* E-mail

* Descrição/responsabilidade no cliente

'''Comportamento'''
*Listagem dinâmica conforme filtros aplicados

*Possibilidade de expansão futura para edição/visualização detalhada

*Organização visual para facilitar leitura e identificação

'''Resumo de Relacionamento (Painel Direito)'''

* Apresenta indicadores estratégicos:

* Contatos ativos
* Decisores
* Usuários-chave
* Última interação

'''Ações Rápidas (Floating Actions)'''

Botões flutuantes:

* Criar/editar contato

* Ações complementares

* Menu adicional

[[Arquivo:Captura_de_tela_2026-04-22_151839.png|800px]]

== Documentos relacionados ==
* [[ Alterações cadastrado de eventos]]

== Escopo ==

=== Escopo Incluso ===
* Criação da estrutura de abas de CRM

* Implementação de:
- Notas (timeline)

- Atividades (pipeline)

- Eventos (agenda)

- Contatos (cards)

- Pedidos (lista + fases)

* Integração com dados já existentes:

- Cliente

- Pedido

* Filtros e busca em cada módulo
* Interface responsiva

=== Escopo Não Incluso ===
* Integrações externas (ex: ERPs adicionais)
* Automação avançada de CRM (ex: gatilhos automáticos)
* Inteligência analítica (BI, dashboards avançados)
* Notificações push ou integrações com calendário externo
* Customizações específicas por cliente (fora do padrão)

== Atores ==
Vendedor / Representante Comercial

Gestor Comercial

Equipe de Suporte/Backoffice

Administrador do Sistema

== Pré-condições ==
* Cliente devidamente cadastrado no sistema
* Usuário autenticado
* Permissão de acesso ao módulo CRM
* Existência de dados básicos (pedido, contatos, etc.)

== Regras de Negócio ==

'''[RN1] - ''' Todas as informações devem estar vinculadas a um cliente

'''[RN2] - ''' Notas devem registrar:
* Data/hora
* Usuário responsável

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - ''' Contatos devem estar vinculados ao cliente

'''[RN6] - '''

'''[RN7] - ''' Apenas usuários autorizados podem editar dados

'''[RN8] - ''' Informações devem ser exibidas em ordem cronológica (quando aplicável)

'''[RN9] - ''' Itens podem possuir status visuais (ex: pendente, concluído, alerta)

'''[RN10] - '''

'''[RN11] - '''

== Fluxograma ==

[[Arquivo:Cliente Contato Acesso Flow-2026-04-07-190658.png|900px]]

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:18:04Z

Renatolima: /* Notas: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:13:29Z

Renatolima: /* Notas: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:05:04Z

Renatolima: /* Fases do Pedido: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:04:31Z

Renatolima: /* Eventos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:04:11Z

Renatolima: /* Atividades: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:03:50Z

Renatolima: /* Notas: */

Arquivo:Notas.png

2026-04-24T17:03:10Z

Renatolima:

Arquivo:Eventos.png

2026-04-24T17:02:31Z

Renatolima:

Arquivo:Atividades.png

2026-04-24T17:02:11Z

Renatolima:

Arquivo:Fases do pedido.png

2026-04-24T17:01:46Z

Renatolima:

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:00:17Z

Renatolima: /* Eventos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:00:11Z

Renatolima: /* Atividades: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T17:00:00Z

Renatolima: /* Notas: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:59:54Z

Renatolima: /* Fases do Pedido: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:59:00Z

Renatolima: /* Contatos Vinculados (Painel Principal) */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:57:35Z

Renatolima: /* Contatos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:56:37Z

Renatolima: /* Contatos Vinculados (Painel Principal) */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:49:59Z

Renatolima: /* Contatos Vinculados (Painel Principal) */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:48:41Z

Renatolima: /* Contatos Vinculados (Painel Principal) */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:47:55Z

Renatolima: /* Componentes da Tela */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:47:05Z

Renatolima: /* Componentes da Tela */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:46:51Z

Renatolima: /* Componentes da Tela */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:46:39Z

Renatolima: /* Componentes da Tela */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:46:20Z

Renatolima: /* Contatos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:45:49Z

Renatolima: /* Componentes da Tela= */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:45:21Z

Renatolima: /* Componentes da Tela = */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:45:06Z

Renatolima: /* Componentes da Tela = */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:44:46Z

Renatolima: /* Contatos: */

Atendimento ao Cliente Força de Vendas CRM

2026-04-24T16:43:37Z

Renatolima: /* Contatos: */