Uma empresa precisa importar faturas por meio de um arquivo CSV e notificar os clientes que ela está disponível para ser paga. Essa empresa necessita agrupar as faturas pelo CPF ou CNPJ do cliente. Para cada fatura agrupada o cliente receberá um email informando que a consolidação dessas faturas está disponível. A empresa pode posteriormente consultar essas faturas disponíveis mediante a autenticação.

Com base nos requisitos deste projeto, observamos que:

• Podemos utilizar o MailTrap para fazer o envio dos emails de notificação;
• Podemos utilizar JWT para fazer a autenticação da empresa;
• Não precisa ser uma arquitetura/framework robusto para resolver o problema.

(Diagrama de Casos de Uso)

(Modelo Lógico do Banco de Dados)

Seguindo esses requisitos, iremos trabalhar com as seguintes ferramentas e tecnologias:

• PHP 7.2
• Slim 3 Framework
• Banco de dados SQLite

Nossas dependências:

"slim/slim": "3.*",
"doctrine/orm": "^2.7",
"oscarotero/psr7-middlewares": "^3.21",
"monolog/monolog": "^2.1",
"firebase/php-jwt": "^5.2",
"tuupola/slim-jwt-auth": "^3.4",
"phpmailer/phpmailer": "^6.1"

Baixe a imagem desafio-finnet.tar. Carrege a imagem com esse comando:

docker load -i desafio-finnet.tar

Copie o IMAGE ID da imagem carregada com o comando:

docker images

Cole o IMAGE ID da imagem nesse último comando:

docker run -d -p 8000:8000 <IMAGE ID>

Pronto.

Para instalar o sistema basta executar os seguintes comandos:

#Baixar o projeto
git clone https://github.com/leonammp/desafio-finnet/
cd desafio-finnet

#Instalar as dependências
composer install

Para executar, na pasta do sistema, vamos criar um servidor php no localhost na porta 8000 com este comando:

php -S localhost:8000

Agora já está tudo rodando.

No Postman, vamos importar as rotas que iremos utilizar. Siga os passos:

• Clique em Import;
• Escolha o arquivo 'desafio-finnet.postman_collection.json' que se encontra nesse link;
• Pronto.

No total, temos 6 rotas na aplicação. Todas elas estão na versão 1 (/v1/).

• http://localhost:8000/v1/company (POST)
  • {"name": "finnet", "password": 1234}

• http://localhost:8000/v1/login (POST)
  • {"name": "finnet", "password": 1234}

• http://localhost:8000/v1/importCSV (GET)

• http://localhost:8000/v1/sendEmails (GET)
  • *estamos enviando apenas para os 5 primeiros clientes para não acabar a cota do MailTrap hehe ;)

• http://localhost:8000/v1/invoices (GET)
  • Headers
    • {"X-Token": "< auth-jwt que você recebeu em /login >"}