Este projeto é parte integrate do curso Aprenda a Testar Aplicações Javascript (https://javascript.tv.br) e dá suporte ao módulo 4: desenvolvimento e testes server side com Node.js e Express.
O projeto utiliza Express.js (https://expressjs.com/en/starter/installing.html) para roteamento e controle de requisições HTTP e Sequelize ORM (https://sequelize.org/master/) para interface com o banco de dados. Para manter a configuração o mais simples possível, o banco de dados escolhido foi o SQLite porém, como explicado em /src/database/models/index.js a troca de banco de dados é muito simples, tendo como único pré-requisito o suporte dentro do ORM (Sequelize).
O projeto já conta com o Jest como test runner e 3 scripts npm estão a disposição para executar os testes em modo watch ou com a geração do relatório de coverage.
O branch master não contém qualquer teste pois é o ponto de partida para as aulas. Você pode no entanto escrever seus testes e nomear os arquivos com .spec.js ou .test.js e o Jest fará seu trabalho.
O gerenciamento de logs está a cargo do Winston e dois de seus transportes estão habilitados: console e file. Mais transportes podem ser adicionados sob demanda.
Pré-requisito: Node versão 12+.
- Faça o clone do repositório e utilizando o Terminal execute
npm installouyarn; - Copie o
.env.examplepara.enve mantenha seu conteúdo;- Este arquivo faz parte do .gitignore e não deve ser enviado para o controle de versão, pois contém informações pertinentes ao seu ambiente local e, possivelmente, dados sensíveis.
- Execute
npm run devouyarn devpara executar o servidor, que estará disponível na porta 3000. Caso deseje mudar a porta faça isso no arquivo.env; - Utilize o arquivo encontrado em
/supportpara carregar as requisições HTTP usadas para testar manualmente a API. O arquivo funciona no aplicativo Insomnia (https://insomnia.rest/), Paw (https://paw.cloud/) ou Postman (https://www.postman.com/).