Exibir código-fonte para Adição de Notas no Força de Vendas

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

== Necessidade ==
Atualmente, o GeoSales Evo, não permite adição de notas, assim como podemos registra-las em um  CRM (informações relevantes de interações, negociações, eventos e acompanhamentos comerciais), então necessita disponibilizar de forma integrada no Força de Vendas a opção de adição.

Essa limitação dificulta o acesso rápido às informações históricas durante a atuação dos vendedores em campo, podendo gerar perda de contexto, retrabalho, falhas de comunicação e menor eficiência no relacionamento com clientes e prospects.

Dessa forma, torna-se necessária a disponibilização de uma funcionalidade que permita visualizar e registrar notas diretamente no GeoSales(Força de Vendas), mantendo a rastreabilidade e o vínculo correto dessas informações com os principais objetos comerciais.

== Solução ==
Será implementada no Força de Vendas a funcionalidade de adição, visualização e consulta de notas, permitindo que os usuários registrem e acessem informações relevantes diretamente pelo aplicativo/sistema de vendas.

As notas poderão ser vinculadas aos seguintes contextos:

- Pedido
- Evento
- Cliente
- Cliente Prospect

A solução garantirá que as notas sejam armazenadas de forma centralizada, respeitando as regras de negócio, permissões de acesso e mantendo a consistência das informações entre os sistemas.

== Escopo ==

=== Escopo Incluso ===
Inclusão de funcionalidade para criar notas no Força de Vendas.
Consulta e visualização das notas existentes.

Vinculação das notas a:

- Pedido
- Evento
- Cliente
- Cliente Prospect
- Identificação do usuário criador, data e hora do registro.
- Exibição das notas de acordo com o contexto selecionado.
- Aplicação das regras de permissão conforme perfil do usuário.

=== Escopo Não Incluso ===
- Alteração da estrutura de notas já existentes no CRM.

- Exclusão definitiva de notas (caso aplicável, apenas leitura).

- Customizações visuais avançadas ou relatórios analíticos de notas.

-Integrações com sistemas externos além do CRM.

== Atores ==

**Vendedor:** Usuário responsável por incluir e consultar notas.
**Força de Vendas:** Sistema responsável por armazenar e gerenciar as notas.


== Pré-condições ==

O usuário deve estar autenticado no Força de Vendas.
O usuário deve possuir permissão para incluir e/ou visualizar notas.
O pedido, evento, cliente ou cliente prospect deve existir e estar válido no sistema.

== Regras de Negócio ==

'''[RN1] - '''  As notas registradas no Força de Vendas devem ser armazenadas como fonte oficial dos dados na estrutura do força de vendas;

'''[RN2] - ''' Cada nota deve estar obrigatoriamente vinculada a apenas um contexto principal: pedido, evento, cliente ou cliente prospect;

'''[RN3] - ''' Um mesmo cliente ou prospect pode possuir múltiplas notas associadas;

'''[RN4] - ''' As notas devem registrar automaticamente:
- Código da nota
- Usuário responsável pela inclusão
- Data e hora do registro
- Data e hora de alterações

'''[RN5] - ''' Apenas usuários com permissão adequada poderão incluir ou visualizar notas, através do controle de permissão;

'''[RN6] - ''' As notas devem ser exibidas no Força de Vendas conforme o contexto selecionado pelo usuário;

'''[RN7] - ''' Notas vinculadas a pedidos ou eventos devem permanecer disponíveis mesmo após o encerramento do pedido ou evento;

'''[RN8] - ''' A funcionalidade deve ser acessível tanto em ambiente web quanto mobile, conforme disponibilidade do Força de Vendas.

== 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 ||
|- 
|}