|
| 1 | +# working in readme... |
| 2 | +# 5th chalenge complete  |
| 3 | + |
| 4 | +## :rocket: Sobre o desafio |
| 5 | + |
| 6 | +Nesse desafio, você deve criar uma aplicação para continuar treinando o que você aprendeu até agora no Node.js junto ao TypeScript, utilizando o conceito de models, repositories e services! |
| 7 | + |
| 8 | +Essa será uma aplicação para armazenar transações financeiras de entrada e saída, que deve permitir o cadastro e a listagem dessas transações. |
| 9 | + |
| 10 | +### Rotas da aplicação |
| 11 | + |
| 12 | +Agora que você já está com o template clonado, e pronto para continuar, você deve 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. |
| 13 | + |
| 14 | +- **`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 saídas (retiradas). Ao cadastrar uma nova transação, ela deve ser armazenada dentro de um objeto com o seguinte formato : |
| 15 | + |
| 16 | +```json |
| 17 | +{ |
| 18 | + "id": "uuid", |
| 19 | + "title": "Salário", |
| 20 | + "value": 3000, |
| 21 | + "type": "income" |
| 22 | +} |
| 23 | +``` |
| 24 | + |
| 25 | +- **`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: |
| 26 | + |
| 27 | +```json |
| 28 | +{ |
| 29 | + "transactions": [ |
| 30 | + { |
| 31 | + "id": "uuid", |
| 32 | + "title": "Salário", |
| 33 | + "value": 4000, |
| 34 | + "type": "income" |
| 35 | + }, |
| 36 | + { |
| 37 | + "id": "uuid", |
| 38 | + "title": "Freela", |
| 39 | + "value": 2000, |
| 40 | + "type": "income" |
| 41 | + }, |
| 42 | + { |
| 43 | + "id": "uuid", |
| 44 | + "title": "Pagamento da fatura", |
| 45 | + "value": 4000, |
| 46 | + "type": "outcome" |
| 47 | + }, |
| 48 | + { |
| 49 | + "id": "uuid", |
| 50 | + "title": "Cadeira Gamer", |
| 51 | + "value": 1200, |
| 52 | + "type": "outcome" |
| 53 | + } |
| 54 | + ], |
| 55 | + "balance": { |
| 56 | + "income": 6000, |
| 57 | + "outcome": 5200, |
| 58 | + "total": 800 |
| 59 | + } |
| 60 | +} |
| 61 | +``` |
| 62 | + |
| 63 | +**Dica**: Dentro de balance, o income é a soma de todos os valores das transações com `type` income. O outcome é a soma de todos os valores das transações com `type` outcome, e o total é o valor de `income - outcome`. |
| 64 | + |
| 65 | +**Dica 2**: Para fazer a soma dos valores, você pode usar a função [reduce](https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce) para agrupar as transações pela propriedade `type`, assim você irá conseguir somar todos os valores com facilidade e obter o retorno do `balance`. |
| 66 | + |
| 67 | +### Especificação dos testes |
| 68 | + |
| 69 | +Em cada teste, tem uma breve descrição no que sua aplicação deve cumprir para que o teste passe. |
| 70 | + |
| 71 | +Caso você tenha dúvidas quanto ao que são os testes, e como interpretá-los, dé uma olhada em **[nosso FAQ](https://github.com/Rocketseat/bootcamp-gostack-desafios/tree/master/faq-desafios).** |
| 72 | + |
| 73 | +Para esse desafio temos os seguintes testes: |
| 74 | + |
| 75 | +- **`should be able to create a new transaction`**: Para que esse teste passe, sua aplicação deve permitir que uma transação seja criada, e retorne um json com a transação criada. |
| 76 | + |
| 77 | +- **`should be able to list the transactions`**: Para que esse teste passe, sua 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. |
| 78 | + |
| 79 | +- **`should not be able to create outcome transaction without a valid balance`**: Para que esse teste passe, sua 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 }` |
| 80 | + |
| 81 | +## :calendar: Entrega |
| 82 | + |
| 83 | +Esse desafio deve ser entregue a partir da plataforma da Rocketseat, envie o link do repositório que você fez suas alterações. Após concluir o desafio, fazer um post no Linkedin e postar o código no Github é uma boa forma de demonstrar seus conhecimentos e esforços para evoluir na sua carreira para oportunidades futuras. |
| 84 | + |
| 85 | +## :memo: Licença |
| 86 | + |
| 87 | +Esse projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes. |
| 88 | +# 4th chalenge complete  |
| 89 | + |
| 90 | +## :rocket: Sobre o desafio |
| 91 | + |
| 92 | +Nesse desafio, você deve criar uma aplicação para continuar treinando o que você aprendeu até agora no Node.js junto ao TypeScript, utilizando o conceito de models, repositories e services! |
| 93 | + |
| 94 | +Essa será uma aplicação para armazenar transações financeiras de entrada e saída, que deve permitir o cadastro e a listagem dessas transações. |
| 95 | + |
| 96 | +### Rotas da aplicação |
| 97 | + |
| 98 | +Agora que você já está com o template clonado, e pronto para continuar, você deve 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. |
| 99 | + |
| 100 | +- **`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 saídas (retiradas). Ao cadastrar uma nova transação, ela deve ser armazenada dentro de um objeto com o seguinte formato : |
| 101 | + |
| 102 | +```json |
| 103 | +{ |
| 104 | + "id": "uuid", |
| 105 | + "title": "Salário", |
| 106 | + "value": 3000, |
| 107 | + "type": "income" |
| 108 | +} |
| 109 | +``` |
| 110 | + |
| 111 | +- **`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: |
| 112 | + |
| 113 | +```json |
| 114 | +{ |
| 115 | + "transactions": [ |
| 116 | + { |
| 117 | + "id": "uuid", |
| 118 | + "title": "Salário", |
| 119 | + "value": 4000, |
| 120 | + "type": "income" |
| 121 | + }, |
| 122 | + { |
| 123 | + "id": "uuid", |
| 124 | + "title": "Freela", |
| 125 | + "value": 2000, |
| 126 | + "type": "income" |
| 127 | + }, |
| 128 | + { |
| 129 | + "id": "uuid", |
| 130 | + "title": "Pagamento da fatura", |
| 131 | + "value": 4000, |
| 132 | + "type": "outcome" |
| 133 | + }, |
| 134 | + { |
| 135 | + "id": "uuid", |
| 136 | + "title": "Cadeira Gamer", |
| 137 | + "value": 1200, |
| 138 | + "type": "outcome" |
| 139 | + } |
| 140 | + ], |
| 141 | + "balance": { |
| 142 | + "income": 6000, |
| 143 | + "outcome": 5200, |
| 144 | + "total": 800 |
| 145 | + } |
| 146 | +} |
| 147 | +``` |
| 148 | + |
| 149 | +**Dica**: Dentro de balance, o income é a soma de todos os valores das transações com `type` income. O outcome é a soma de todos os valores das transações com `type` outcome, e o total é o valor de `income - outcome`. |
| 150 | + |
| 151 | +**Dica 2**: Para fazer a soma dos valores, você pode usar a função [reduce](https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce) para agrupar as transações pela propriedade `type`, assim você irá conseguir somar todos os valores com facilidade e obter o retorno do `balance`. |
| 152 | + |
| 153 | +### Especificação dos testes |
| 154 | + |
| 155 | +Em cada teste, tem uma breve descrição no que sua aplicação deve cumprir para que o teste passe. |
| 156 | + |
| 157 | +Caso você tenha dúvidas quanto ao que são os testes, e como interpretá-los, dé uma olhada em **[nosso FAQ](https://github.com/Rocketseat/bootcamp-gostack-desafios/tree/master/faq-desafios).** |
| 158 | + |
| 159 | +Para esse desafio temos os seguintes testes: |
| 160 | + |
| 161 | +- **`should be able to create a new transaction`**: Para que esse teste passe, sua aplicação deve permitir que uma transação seja criada, e retorne um json com a transação criada. |
| 162 | + |
| 163 | +- **`should be able to list the transactions`**: Para que esse teste passe, sua 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. |
| 164 | + |
| 165 | +- **`should not be able to create outcome transaction without a valid balance`**: Para que esse teste passe, sua 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 }` |
| 166 | + |
| 167 | +## :calendar: Entrega |
| 168 | + |
| 169 | +Esse desafio deve ser entregue a partir da plataforma da Rocketseat, envie o link do repositório que você fez suas alterações. Após concluir o desafio, fazer um post no Linkedin e postar o código no Github é uma boa forma de demonstrar seus conhecimentos e esforços para evoluir na sua carreira para oportunidades futuras. |
| 170 | + |
| 171 | +## :memo: Licença |
| 172 | + |
| 173 | +Esse projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes. |
0 commit comments