Skip to content

Latest commit

 

History

History
140 lines (105 loc) · 5.39 KB

instructions.md

File metadata and controls

140 lines (105 loc) · 5.39 KB
Raw

Desafio de programação

O objetivo desse teste é avaliar as suas habilidades em programação.

Descrição do projeto

Surgiu uma nova demanda urgente e precisamos de uma área exclusiva para fazer o upload de um arquivo das transações feitas na venda de produtos por nossos clientes.

Nossa plataforma trabalha no modelo criador-afiliado, sendo assim um criador pode vender seus produtos e ter 1 ou mais afiliados também vendendo esses produtos, desde que seja paga uma comissão por venda.

Uma transação financeira é um contrato de compra e venda. No contexto do enunciado, vamos considerar que cada transação resulta na mudança do saldo, podendo ser do produtor ou afiliado.

Sua tarefa é construir uma interface web que possibilite o upload de um arquivo de transações de produtos vendidos, normalizar os dados e armazená-los em um banco de dados relacional.

Você deve utilizar o arquivo sales.txt para fazer o teste da aplicação. O formato esá descrito na seção "Formato do arquivo de entrada".

Configurando Seu Ambiente

  1. No diretório onde você descompactou o arquivo do desafio crie um repo git e uma branch: 
    git init --initial-branch=main
git checkout -b desafio
  2. Desenvolva o desafio fazendo commits no repositório.

Requisitos Funcionais

Sua aplicação deve:

  1. Ter uma tela (via formulário) para fazer o upload do arquivo
  2. Fazer o parsing do arquivo recebido, normalizar os dados e armazená-los em um banco de dados relacional, seguindo as definições de interpretação do arquivo
  3. Exibir a lista de todas as transações de produtos importadas
  4. Exibir o saldo final do produtor
  5. Exibir o saldo final de um afiliado
  6. Fazer tratamento de erros no backend, e reportar mensagens de erro amigáveis no frontend.

Requisitos Não Funcionais

  1. Escreva um README descrevendo o projeto e como fazer o setup.

  2. A aplicação deve ser simples de configurar e rodar, compatível com ambiente Unix. Você deve utilizar apenas bibliotecas gratuitas ou livres.

  3. Utilize docker para os diferentes serviços que compõe a aplicação para que funcione facilmente fora do seu ambiente pessoal.

  4. Use qualquer banco de dados relacional.

  5. Use commits pequenos no Git e escreva uma boa descrição para cada um.

  6. Escreva unit tests tanto no backend quanto do frontend.

  7. Faça o código mais legível e limpo possível.

  8. Escreva o código (nomes e comentários) em inglês. A documentação pode ser em português se preferir.

  9. Grave um vídeo de poucos minutos (até 5) mostrando sua solução em funcionamento. Mesmo usando Docker já tivemos problemas.

    Isso vai nos dar mais velocidade e agilidade para corrigir. Se não puder gravar um vídeo, adicione imagens de todas as telas (mas o vídeo é preferível). Ferramenta para gravar tela:

    • Windows, Mac, Linux: OBS Studio
    • Mac: gravador nativo (basta apertar cmd+shift+5)

    Se o vídeo tiver tamanho final menor que 25mb, o que é improvável, pode enviar por email mesmo. Do contrário, pode ser tanto por um link do Google Drive ou do YouTube (não listado). Ambos gratuitos.

Requisitos Bônus

Sua aplicação não precisa, mas ficaremos impressionados se ela:

  1. Tiver documentação das APIs do backend.
  2. Utilizar docker-compose para orquestar os serviços num todo.
  3. Ter testes de integração ou end-to-end.
  4. Tiver toda a documentação escrita em inglês fácil de entender.
  5. Lidar com autenticação e/ou autorização.

Formato do arquivo de entrada

Campo Início Fim Tamanho Descrição
Tipo 1 1 1 Tipo da transação
Data 2 26 25 Data - ISO Date + GMT
Produto 27 56 30 Descrição do produto
Valor 57 66 10 Valor da transação em centavos
Vendedor 67 86 20 Nome do vendedor

Tipos de transação

Esses são os valores possíveis para o campo Tipo:

Tipo Descrição Natureza Sinal
1 Venda produtor Entrada +
2 Venda afiliado Entrada +
3 Comissão paga Saída -
4 Comissão recebida Entrada +

Avaliação

Seu projeto será avaliado de acordo com os seguintes critérios:

  1. Documentação do setup do ambiente e execução que rode a aplicação com sucesso.
  2. Cumprimento dos requisitos funcionais e não funcionais.
  3. Boa estruturação do componentes e layout de código, mas sem over engineering.
  4. Legibilidade do código.
  5. Boa cobertura de testes.
  6. Claridade e extensão da documentação.
  7. Cumprimento de algum requisito bônus.

Entregando a Resposta do Desafio

  1. Crie um git bundle com o seu trabalho: 
    git bundle create nome-sobrenome.bundle HEAD desafio
  2. Envie o arquivo do bundle para nós via email, para a mesma pessoa que te enviou o desafio.

Verificar o bundle

Para verificar o arquivo antes de enviar utilize o seguinte comando:

git clone nome-sobrenome.bundle hubla-take-home

A cópia do seu trabalho vai estar em hubla-take-home.

Boa Sorte!!!