rodrigoftw / desafio05-fundamentos-nodejs

Desafio 05 - Fundamentos Node.js

Desafio 05 - Fundamentos Node.js

Desafio 05: Fundamentos do Node.js

🚀 Sobre o desafio

Nesse desafio, deve-se criar uma aplicação para continuar treinando o que aprendido até agora no Node.js junto ao TypeScript, utilizando o conceito de models, repositories e services.

Essa será uma aplicação que deve armazenar transações financeiras de entrada e saída, que deve permitir o cadastro e a listagem dessas transações.

Rotas da aplicação

Deve-se verificar os arquivos da pasta src e completar onde não possui código com o código para atingir os objetivos de cada rota.

• POST /transactions: A rota deve receber title, value e type dentro do corpo da requisição, sendo type o tipo da transação, que deve ser income para entradas (depósitos) e outcome para saidas (retiradas). Ao cadastrar uma nova transação, ela deve ser armazenada dentro de um objeto com o formato como o seguinte:

{
  "id": "uuid",
  "title": "Salário",
  "value": 3000,
  "type": "income"
}

• GET /transactions: Essa rota deve retornar uma listagem com todas as transações que você cadastrou até agora, junto com o valor de soma de entradas, retiradas e total de crédito. Essa rota deve retornar um objeto com o formato a seguir:

{
  "transactions": [
    {
      "id": "uuid",
      "title": "Salário",
      "value": 4000,
      "type": "income"
    },
    {
      "id": "uuid",
      "title": "Freela",
      "value": 2000,
      "type": "income"
    },
    {
      "id": "uuid",
      "title": "Pagamento da fatura",
      "value": 4000,
      "type": "outcome"
    },
    {
      "id": "uuid",
      "title": "Cadeira Gamer",
      "value": 1200,
      "type": "outcome"
    }
  ],
  "balance": {
    "income": 6000,
    "outcome": 5200,
    "total": 800
  }
}

Específicação dos testes

Em cada teste, há uma breve descrição no que a aplicação deve cumprir para que o teste passe.

Para esse desafio existem os seguintes testes:

• should be able to create a new transaction: Para que esse teste passe, a aplicação deve permitir que uma transação seja criada, e retorne um json com a transação criado.

• should be able to list the transactions: Para que esse teste passe, a aplicação deve permitir que seja retornado um objeto contendo todas as transações junto ao balanço de income, outcome e total das transações que foram criadas até o momento.

• should not be able to create outcome transaction without a valid balance: Para que esse teste passe, a aplicação não deve permitir que uma transação do tipo outcome extrapole o valor total que o usuário tem em caixa, retornando uma resposta com código HTTP 400 e uma mensagem de erro no seguinte formato: { error: string }