Funcionalidades
- Cadastro de Receitas
- Valor: Valor da receita.
- Descrição: Descrição da receita.
- Data: Data em que a receita foi recebida.
{
"valor": 1000,
"descricao": "Salário",
"data": "03/10/2024"
}- Cadastro de Despesas
- Valor: Valor da despesa.
- Descrição: Descrição da despesa.
- Categoria: Categoria da despesa (Ex.: Alimentação, Transporte).
- Data: Data em que a despesa foi realizada.
{
"valor": 200,
"descricao": "Jantar",
"categoria": "ALIMENTACAO",
"data": "03/10/2024"
}
- Listagem de Receitas/Despesas
- Exibe uma listagem completa das receitas e despesas cadastradas, podendo listar por:
- Ano e Mês
- Paginação
- Query
- Por ID
- Relatório Mensal
- Gera um relatório detalhado com:
- Total de receitas.
- Total de despesas.
- Saldo total.
- Total de despesas por categoria.
{
"totalIncome": 1000.0,
"totalExpense": 500.0,
"totalBalance": 500.0,
"totalExpenseByCategory": [
{
"category": "ALIMENTACAO",
"total": 200.0
},
{
"category": "TRANSPORTE",
"total": 300.0
}
]
}- Autenticação e Autorização
- Autenticação JWT para proteger as rotas e assegurar que apenas usuários autenticados possam acessar os dados financeiros.
- Documentação
- Utilização do Swagger para documentação da API.
- Acesse a documentação na sua máquina local via
http://localhost:8080/
Full Changelog: https://github.com/lucasmoraist/balancea-api/commits/v1.0