rochajario / financial-control Goto Github PK

From now on, every expense must have a category, which must be one of the following options:

• Food
• Health
• Home
• Transport
• Education
• Leisure
• Unforeseen
• Others

You will need to adjust the expense registration endpoint to receive this new information.

Business rules

• When registering an expense, the category information is optional
• If the expense category is not informed, the API should automatically assign the Other category to the expense

The API must have an endpoint to search for expenses by description.

The endpoint must be the same as the one used for expense listing, and it must be changed to include a parameter called description.

Examples of how the endpoint should work from this change:

• GET /expenses -> must return all income
• GET /expenses?descricao=expto -> must return all expenses whose description contains the word indicated in the description parameter

A API deve possuir um endpoint para exibir os detalhes de uma determinada receita, sendo que ele deve aceitar requisições do tipo GET para a URI /receitas/{id}.

Os dados da receita(descrição, valor e data) devem ser devolvidos no corpo da resposta, no formato JSON.

The API must have an endpoint to search for recipes by description.

The endpoint must be the same as the one used for listing recipes, and this must be changed to include a parameter called description.

Examples of how the endpoint should work from this change:

• GET /recipes -> must return all recipes
• GET /recipes?descricao=xpto -> must return all recipes whose description contains the word indicated in the description parameter

A API deve possuir um endpoint para o cadastro de receitas, sendo que ele deve aceitar requisições do tipo POST para a URI /receitas.

Os dados da receita(descrição, valor e data) devem ser enviados no corpo da requisição, no formato JSON.

Regras de negócio

• Todas as informações da receita são obrigatórias
• A API não deve permitir o cadastro de receitas duplicadas(contendo a mesma descrição, dentro do mesmo mês)

The API must have an endpoint for the listing of all recipes for a given month, and it must accept GET requests for the URI summary/earnings /{year}/ {month}.

Recipe data (description, value and date) must be returned in the response body, in JSON format.

A API deve possuir um endpoint para a listagem de todas as receitas, sendo que ele deve aceitar requisições do tipo GET para a URI /receitas.

Os dados das receitas(descrição, valor e data) devem ser devolvidos no corpo da resposta, no formato JSON.

You will need to update the application database to allow
the storage of the category of each expense.

Você vai precisar utilizar um banco de dados para armazenar as informações da aplicação.

Para o cadastro de receitas, estas são as informações necessárias:

• id
• descricao
• valor
• data

Para o cadastro de despesas, estas são as informações necessárias:

• id
• descricao
• valor
• data

A modelagem da(s) tabela(s) fica a seu critério.

A API deve possuir um endpoint para a atualização dos dados de uma determinada despesa, sendo que ele deve aceitar requisições do tipo PUT para a URI /despesas/{id}.

Obs: as mesmas regras de negócio do cadastro de uma despesa devem ser realizadas também na atualização dela.

A API deve possuir um endpoint para a exclusão de uma determinada despesa, sendo que ele deve aceitar requisições do tipo DELETE para a URI /despesas/{id}.

A API deve possuir um endpoint para exibir os detalhes de uma determinada despesa, sendo que ele deve aceitar requisições do tipo GET para a URI /despesas/{id}.

Os dados da despesa(descrição, valor e data) devem ser devolvidos no corpo da resposta, no formato JSON.

From now on, only authenticated users can interact with the API.

Implement an authentication mechanism in the API, so that users can authenticate themselves and trigger requests to it

The API must have an endpoint to detail the summary of a given month, and it must accept GET requests for the URI /summary/{year}/{month}.

The summary data must be returned in the response body, in JSON format.

Business rules

The month summary should contain the following information:

• Total amount of revenue in the month
• Total amount of expenses in the month
• Ending balance for the month
• Total amount spent in the month in each of the categories

You will need to create an account, if you don't already have one, on a Cloud provider, such as Heroku, in order to deploy the API on it.

Note: you can use Docker, if you are familiar with it, to perform the API deployment process.

A API deve possuir um endpoint para a atualização dos dados de uma determinada receita, sendo que ele deve aceitar requisições do tipo PUT para a URI /receitas/{id}.

Obs: as mesmas regras de negócio do cadastro de uma receita devem ser realizadas também na atualização dela.

The API must have an endpoint for listing all expenses for a given month, and it must accept GET requests for the URI /summary/expenses/{year}/ {month}.

The expense data (description, amount, date and category) must be returned in the body of the response, in JSON format.

A API deve possuir um endpoint para a listagem de todas as despesas, sendo que ele deve aceitar requisições do tipo GET para a URI /despesas.

Os dados das despesas(descrição, valor e data) devem ser devolvidos no corpo da resposta, no formato JSON.

To implement the authentication mechanism in the API, you will need to change the structure of the API's database, including in it a new table to store the users' authentication data.

A API deve possuir um endpoint para o cadastro de despesas, sendo que ele deve aceitar requisições do tipo POST para a URI /despesas.

Os dados da despesa(descrição, valor e data) devem ser enviados no corpo da requisição, no formato JSON.

Regras de negócio

• Todas as informações da despesa são obrigatórias
• A API não deve permitir o cadastro de depesas duplicadas(contendo a mesma descrição, dentro do mesmo mês)

A API deve possuir um endpoint para a exclusão de uma determinada receita, sendo que ele deve aceitar requisições do tipo DELETE para a URI /receitas/{id}.

Olá, back-ender!

Primeiramente, gostaria de te parabenizar por aceitar o desafio e mergulhar de cabeça nessa segunda edição do Challenge de Back-End da Alura.
Como recordação da sua participação e reconhecimento por compartilhar seu aprendizado com a comunidade, deixamos essa badge 🏅

Abraços e te vejo nos próximos Challenges!