Exibir código-fonte para Criação de Semáforo de Itens Pedidos/mês e clientes pedidos/mês

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem 
! Comentários 
|-
| 18/11/2021  || João Ramon || Criação do documento
|-
| 07/12/2021 || João Ramon || Alteração do documento
|-
|}

== Necessidade ==

O cliente possui equipes de vendas que tem por modo de operação visitar um determinado cliente mais de uma vez dentro de um ciclo de vendas (mês comercial). Por conta desta estrutura, torna-se de difícil controle visualizar, a partir da relação dos clientes daquele vendedor, quais deles já foram visitados neste ciclo. Isso porque, ao realizar visitas a um cliente pela segunda vez, o vendedor não consegue identificar, a partir do sistema, quais clientes já foram visitados no ciclo presente e, se visitados, quais itens já foram oferecidos ao cliente neste ciclo. Por essa razão, há uma necessidade por parte do cliente em que se desenvolva um recurso visual que permita ao vendedor verificar que seu cliente já foi visitado dentro do período determinado e, ao fazê-lo, permitir que os itens vendidos no ciclo de vendas sejam devidamente marcados.

== Solução ==

Visto que duas são as demandas para esta customização: 1-desenvolver um recurso que permita ao vendedor identificar itens já vendidos a um cliente dentro do ciclo de vendas e 2- desenvolver um recurso que permita ao vendedor identificar os clientes já visitados dentro do ciclo de vendas, a solução será também implementada em duas partes:
<ol>
<li> Implementação de um '''''semáforo''''' no card dos itens do pedido, que farão a identificação visual de itens que foram vendidos no ciclo presente, em ciclos anteriores ou em situações previamente demandadas pelo cliente;</li>
<li> Implementação de marcadores visuais na tela da lista de clientes do vendedor, os quais deverão informar quais clientes já foram visitados no ciclo, e quais ainda não foram.</li>
</ol>

== Implementação ==

=== Semáforo de Itens Pedidos ===

Ao entrar na tela de pedidos, os cards dos itens já apresentam informações pré-parametrizadas. Existe um ícone de informação, de cor cinza, que abre uma tela com informações de item ao selecioná-lo. Considerando que o ciclo de vendas corresponde ao  período entre o início do mês comercial e o seu final, o item deverá ter um comportamento na qual a cor deste ícone pode mudar de acordo com a periodicidade em que este item foi pedido dentro do ciclo de vendas, ou de ciclos anteriores. Para isto, o ícone de informação, que possui a cor cinza como ''default'', poderá ter as cores alteradas para '''''verde''''', '''''amarela''''' ou '''''vermelha''''', de acordo com os períodos parametrizados pelo cliente.
Se tomarmos como exemplo a necessidade corrente do cliente, o novo comportamento da funcionalidade será a seguinte: O vendedor acessará a tela de pedidos, na qual os cards dos itens estarão dispostos. Se o item na lista ainda não foi vendido no ciclo de vendas atual, o ícone de informação apresentará a cor ''default'' cinza. Se o cliente já tiver feito o pedido daquele item dentro do ciclo de vendas atual, o ícone de informação apresentará a cor verde, sinalizando ao vendedor que tal item já foi oferecido àquele cliente neste ciclo de vendas. Caso seja do interesse do cliente, outras cores do semáforo poderão ser parametrizadas, como a apresentação da cor amarela, caso o item não tenha sido vendido no ciclo corrente, mas foi no ciclo anterior, ou a apresentação na cor vermelha, caso o item não tenha sido vendido nos últimos 90 dias.

=== Adição de marcadores à Lista de clientes ===

Ao exibir a lista de clientes, deverá ser incluída uma nova coluna, ao lado da coluna de marcadores de risco, denominada '''''visitados no ciclo''''', e deve trazer um sinal positivo para os clientes já visitados, e um sinal negativo, para os não visitados, de acordo com o mockup abaixo:

[[imagem: visita.png]]


=== Importante===

* Tanto a customização do semáforo de itens pedidos no ciclo como de marcadores de clientes visitados no ciclo deverão ser habilitados/desabilitados por meio do controle de ações.


* As marcações de item pedido no ciclo e de cliente visitado no ciclo terão como critério de ativação o faturamento do pedido. Portanto, o sinal só deverá marcar os itens ou clientes cujo faturamento tiver sido já realizado. 

<!--Na tela de Atendimento ao cliente, alguns campos de filtro já existem, permitindo que o usuário possa fazer agrupamentos de pesquisa de clientes conforme vários cenários e necessidades. Para o atendimento da demanda de verificação de cliente já atendido em um determinado ciclo de vendas, deve-se ser criado um novo campo de filtro, denominado "Verificação Atendimento", com as seguintes opções: "Atendidos no ciclo atual" e "não Atendidos no ciclo atual". Caso o usuário realize o filtro com o preenchimento do campo "Verificação Atendimento" na seleção "Atendidos no ciclo atual", a pesquisa deverá retornar os clientes que '''já''' tiveram pedidos realizados dentro do ciclo de vendas corrente. Caso o usuário realize o filtro com o preenchimento do campo "Verificação Atendimento" na seleção "Não Atendidos no ciclo atual", a pesquisa deverá retornar os clientes que '''não''' tiveram pedidos realizados dentro do ciclo de vendas corrente.

A implementação para esta demanda deverá ser desenvolvida nestes moldes pelos seguintes motivos:
<ul>
<li> O uso de sinal visual de cliente visitado no ciclo na própria lista de clientes poderia trazer confusão de informações, visto que tal lista já possui um sinal visual, que trata do risco do cliente;</li>
<li> A formatação de apresentação em lista com as apresentações de clientes visitados e não visitados demandaria uma quantidade considerável de memória do sistema, tornando o processo de busca lento.</li>
</ul>
-->

== Cenários ==

Considere para a composição do cenário as seguintes massas de dados:

'''Ciclo de Vendas:''' Período de 30 dias, no qual o início se dá no primeiro dia do mês, e o final se dá no último dia do mês.

'''Vendedor:''' VEND_001

'''Produtos de venda'''

{|class="wikitable"
!CD_FAMILIA
!NM_FAMILIA
|-
| 1 || ITEM_001
|-
| 2 || ITEM_002
|-
| 3 || ITEM_003
|-
| 4 || ITEM_004
|-
|}


'''Carteira de Clientes'''

{|class="wikitable"
!CD_CLIENTE
!NM_CLIENTE
|-
| 1 || CLIENTE_001
|-
| 2 || CLIENTE_002
|-
| 3 || CLIENTE_003
|-
| 4 || CLIENTE_004
|-
|}

=== Cenário 1.1: Semáforo de item pedido no Ciclo - Pedido Inicial ===

O Vendedor, no dia '''01''', visita o cliente '''01''' e vende o item '''01'''


{| class = "wikitable"
!NM_VENDEDOR
!DIA_CICLO
!NM_CLIENTE
!NM_ITEM
|-
| VEND_001 || 01 || CLIENTE_001 || ITEM_001
|-
|}

Pelo exposto, o cliente efetuou a venda do item 01 no primeiro dia do ciclo de vendas. Como não há venda anterior deste item cadastrado, o sinal apresentado no card no momento da venda possui a cor ''default'' cinza.

=== Cenário 1.2: Semáforo de item pedido no Ciclo - Segundo Pedido ===

O Vendedor, no dia '''05''', visita o cliente '''01''' e vende o item '''01'''


{| class = "wikitable"
!NM_VENDEDOR
!DIA_CICLO
!NM_CLIENTE
!NM_ITEM
|-
| VEND_001 || 05 || CLIENTE_001 || ITEM_001
|-
|}

Pelo exposto, o cliente efetuou a venda do item 01 no quinto dia do ciclo de vendas. Como existe venda anterior deste item cadastrado, o sinal apresentado no card no momento da venda virá com a cor verde.

=== Cenário 1.3: Semáforo de item pedido no Ciclo - Pedido num Ciclo distinto ===

O Vendedor, no dia '''01''' no ciclo seguinte (ex: próximo mês), visita o cliente '''01''' e vende o item '''01'''


{| class = "wikitable"
!NM_VENDEDOR
!DIA_CICLO
!NM_CLIENTE
!NM_ITEM
|-
| VEND_001 || 01 || CLIENTE_001 || ITEM_001
|-
|}

Pelo exposto, o cliente efetuou a venda do item 01 no primeiro dia do ciclo de vendas. Como no ciclo anterior o item foi vendido em pedidos passados, o card do item trará o sinal de informação na cor '''amarela''', identificando que o pedido não foi feito no ciclo atual, mas foi feito no ciclo anterior.


=== Cenário 1.4: Semáforo de item pedido no Ciclo - Segundo Pedido num segundo ciclo ===


Nesta situação, repete-se o ocorrido no cenário 1.2.


=== Cenário 1.5: Semáforo de item pedido no Ciclo - Pedido num Ciclo distante ===

O Vendedor, no dia '''01''' de um ciclo posterior (ex: daqui a dois meses), visita o cliente '''01''' e vende o item '''01'''


{| class = "wikitable"
!NM_VENDEDOR
!DIA_CICLO
!NM_CLIENTE
!NM_ITEM
|-
| VEND_001 || 01 || CLIENTE_001 || ITEM_001
|-
|}

Pelo exposto, o cliente efetuou a venda do item 01 no primeiro dia do ciclo de vendas. Como há dois ciclos anteriores o item foi vendido em pedidos passados, o card do item trará o sinal de informação na cor '''vermelha''', identificando que o pedido não foi feito no ciclo atual, nem no ciclo anterior.



=== Cenário 1.6: Semáforo de item pedido no Ciclo - segundo Pedido num Ciclo distante ===

Nesta situação, repete-se o ocorrido no cenário 1.2. e 1.4.


=== Cenário 2: Verificação de lista de clientes visitados num determinado ciclo ===

Em primeiro lugar, a função deverá estar habilitada no controle de ações. Uma vez habilitada, ao realizar o filtro da lista de clientes na tela de pedidos, a coluna de clientes visitados já estará visível ao usuário.



== Regras de Negócios ==

'''[RN1] - ''' As parametrizações de semáforo de itens pedidos no ciclo de vendas serão declaradas, a princípio, via ERP;

'''[RN2] - ''' Da mesma forma, a declaração do ciclo de vendas deve igualmente ser feita via integração;

'''[RN3] - ''' O campo de filtro "Verificação atendimento" deverá trazer pré-populadas as opções "Atendidos no ciclo atual" e "não atendidos no ciclo atual", e não deve haver a possibilidade de selecionar as duas ao mesmo tempo.

'''[RN4] - ''' Tanto a opção de inserir semáforo de itens pedidos no ciclo como de inserir os marcadores de clientes visitados no ciclo deverão ser parametrizados via 'controle de ações'.

'''[RN5] - ''' As marcações de item pedido no ciclo e de cliente visitado no ciclo terão como critério de ativação o faturamento do pedido. Portanto, o sinal só deverá marcar os itens ou clientes cujo faturamento tiver sido já realizado.

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

|- 
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|- 
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

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