Exibir código-fonte para Integração das imagens dos produtos

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

== Necessidade ==

A empresa dispõe de um amplo portfólio de produtos e necessita garantir a disponibilidade das respectivas imagens para exibição durante o processo de venda, tanto no Portal quanto no aplicativo Evo. Considerando o elevado volume de itens, torna-se essencial a implementação de uma funcionalidade que permita a integração das imagens em lote, por meio da leitura de arquivos disponibilizados em um diretório acessível ao sistema.

== Solução ==
Para viabilizar a exibição das imagens de produtos tanto no Portal quanto no App Evo, é necessário garantir a sincronização entre as estruturas de "imagem" e "produto imagem". As imagens devem estar armazenadas em um diretório do servidor do cliente, acessível por meio de um caminho público via HTTPS. A associação entre imagem e produto será feita com base no código de referência do produto.


A exibição das imagens seguirá os parâmetros de venda configurados individualmente para cada produto. Somente serão consideradas as imagens dos produtos habilitados para venda.

Para que o sistema consiga apresentar corretamente as imagens nas aplicações Portal e App GeoSales, é necessário que:

*As imagens estejam disponíveis em um diretório acessível via HTTPS.

*Os arquivos de imagem sigam o padrão de nomenclatura baseado no código de referência do produto.

*As imagens estejam no formato .jpg.

*Para produtos com múltiplas imagens (máximo de 5), os arquivos devem seguir a seguinte convenção:

 * https://www.wsdistribuidora.com.br/ws-img/02070337.jpg
 * https://www.wsdistribuidora.com.br/ws-img/02070337_1.jpg
 * https://www.wsdistribuidora.com.br/ws-img/02070337_2.jpg
 * https://www.wsdistribuidora.com.br/ws-img/02070337_3.jpg
 * https://www.wsdistribuidora.com.br/ws-img/02070337_4.jpg


Todas as imagens disponíveis no diretório que seguirem esse padrão serão automaticamente associadas aos produtos e exibidas nas aplicações. A GeoSales não realizará validação do conteúdo ou qualidade das imagens disponibilizadas, cabendo ao cliente garantir o correto preenchimento e organização do diretório.

== Regras de Negócios ==

'''[RN-1]-''' As imagens podem ser inseridas via portal também em caso de necessidade;

'''[RN-2]-''' As imagens a serem integradas para o uso no Portal/App, deve ser disponibilizadas no diretório em que seja possível acessa-las.

'''[RN-3]-''' O caminho a ser usado para acesso as imagens deve ser https;

'''[RN-4]-''' Os arquivos dentro do diretório deve ter como nome seu código de produto(referencia);

'''[RN-5]-''' O formato do arquivo deve ser jpg;

'''[RN-6]-''' Os produtos que deve ter suas informações inseridas nas estruturas para exibição de imagens, devem está disponíveis para venda;

'''[RN-7]-''' O endereço da imagens deve ser o seguinte: https://www.wsdistribuidora.com.br/ws-img/CD_REFERENCIA_X.jpg, onde o pode chegar até 4, assim representará as imagens amarradas ao produto;

'''[RN-8]-''' AS imagens que respeitarem os critérios estabelecidos serão disponibilizados sem previa avalição das imagens;

'''[RN-9]-''' As dimensões das imagens devem ser 500 x 400.

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