TESTE TÉCNICO SHOPPER - DESENVOLVEDOR FULL STACK - REACT + NODE (TypeScript)

Instalação

Back-end

• Para instalação de todas as dependências, execute no terminal:

    npm install

• Para configuração das variáveis de ambiente:
  • Renomeie o arquivo .env.example para .env;
  • Atribua o valor da "variável" PORT= para 8000
  • Atribua o valor da "variável" CONNECTION_STRING= seguindo o padrão: mysql://USUÁRIO:PASSWORD@localhost:3306/NOMEDODATABASE
• Para execução do servidor, execute no terminal:

    npm run dev

Banco de dados

• A partir do arquivo database.sql contido na pasta docs, execute-o no database criado no mysql
  • A partir do USUÁRIO, SENHA no mysql e do NOME do database, é que vai alterar o arquivo .env

Front-end

• Para instalação de todas as dependências, execute no terminal:

    npm install

• Para execução da aplicação, execute no terminal:

    npm run dev

Descrição e Cenário

CENÁRIO

---

Em qualquer empresa de e-commerce é essencial que os usuários possam atualizar os preços de suas lojas para se manterem competitivos e manterem seus preços alinhados com os custos de operação. Essa tarefa parece simples, porém quando falamos de lojas com milhares de produtos, se torna essencial a existência de uma ferramenta que permita atualizar os produtos de forma massiva e com recursos adicionais para evitar erros que possam prejudicar o negócio.

Você foi encarregado de desenvolver essa ferramenta e após uma série de reuniões com as áreas envolvidas, os seguintes requisitos foram levantados:

1. O time Compras, responsável por definir os preços, se comprometeu em gerar um arquivo CSV (exemplo em anexo) contendo código do produto e o novo preço que será carregado.
2. O time Financeiro, preocupado com o faturamento, solicitou que o sistema impeça que o preço de venda dos produtos fique abaixo do custo deles;
3. O time de Marketing, preocupado com o impacto de reajustes nos clientes, solicitou que o sistema impeça qualquer reajuste maior ou menor do que 10% do preço atual do produto
4. Alguns produtos são vendidos em pacotes, ou seja, um produto que composto por um ou mais produtos em quantidades diferentes. Estabeleceu-se a regra que, ao reajustar o preço de um pacote, o mesmo arquivo deve conter os reajustes dos preços dos componentes do pacote de modo que o preço final da soma dos componentes seja igual ao preço do pacote.

Exemplos 1 -

Imagine o produto PACK GUARANA 1L – 6 Unidades Ele é composto por 6 unidades do produto GUARANA 1L O preço do pack é de R$ 24,00. O preço do componente é de R$ 4,00. Se o arquivo do time de precificação pedir um reajuste do preço do pacote para R$ 30,00, o mesmo arquivo deve conter o reajuste do preço do componente, no caso mudando o preço para R$ 5,00 (6 x 5 = 30)

Exemplos 2 -

Imaginando o produto KIT ESCOVA DE DENTE + PASTA DE DENTE, vendido a R$ 25,00 O produto é composto por 1 unidade do produto ESCOVA DE DENTES (R$ 10,00) e 1 unidade do produto PASTA DE DENTE (R$ 15,00). Se o preço da ESCOVA DE DENTES for reajustado para R$ 20,00, o arquivo também deve conter um reajuste do preço do pacote para R$ 35,00 (R$ 20,00 + R$ 15,00)

A ferramenta deve impedir atualizações de preço que quebrem essa regra.

REQUISITOS

Diante desse cenário, você deve construir um sistema com os seguintes requisitos:

• O sistema deve ter um back end (node.js), contendo as todas as regras definidas e um front-end (React.js) que será utilizado pelo usuário da ferramenta
• Você deve escrever seu código em Javascript ou TypeScript (preferencialmente)
• O banco de dados deve ser MySQL (versão 5 ou 8)
• O sistema deve permitir que o usuário carregue o arquivo de precificação
• O sistema deve ter um botão chamado VALIDAR.
• Ao clicar em VALIDAR, o sistema deve ler todo o arquivo e fazer as seguintes verificações:
  • Todos os campos necessários existem?
  • Os códigos de produtos informados existem?
  • Os preços estão preenchidos e são valores numéricos validos.?
  • O arquivo respeita as regras levantadas na seção CENARIO?
• Ao final da validação o sistema deve exibir as seguintes informações dos produtos que foram enviados.
  • Codigo, Nome, Preço Atual, Novo Preço
• Caso uma ou mais regras de validação tenham sido quebradas, o sistema também deve exibir ao lado de cada produto qual regra foi quebrada.
• O sistema também deve ter um botão ATUALIZAR. Que só ficará habilitado se todos os produtos dos arquivos estiverem validados e sem regras quebradas
• Ao clica em ATUALIZAR, o sistema deve salvar o novo preço no banco de dados e já deixar a tela pronta para o envio de um novo arquivo.
• O preço de custo dos pacotes também deve ser atualizado como a soma dos custos dos seus componentes. Os preço de custo dos produtos que não são pacotes não deve ser atualizado

Ferramentas