Description • Functionalities • Technologies • Installation and Configuration • Endpoints • License • Author
Financerto is a Rest API designed to help users manage their personal finances. With Financerto, users can track their expenses, revenues, financial targets and wallet balance easily and conveniently.
- 🧑 User:
- Registration of new users.
- Login with authentication via JWT Token.
- 📉 Expense
- Complete CRUD for expense management.
- Possibility to add, view, update and delete expenses.
- 📈 Revenue
- Complete CRUD for revenue management.
- Possibility to add, view, update and delete revenues.
- 🎯 Target
- Complete CRUD for target management.
- Possibility to add, view, update and delete financial targets.
- Track target progress in %.
- 💸 Wallet
- Total user balance.
- Total amount of expenses.
- Total amount of revenues.
- Java 17
- Spring Boot 3
- Spring Security
- Flyway
- PostgreSQL
- JUnit and Mockito
- Springdoc
You need to have JDK and PostgreSQL installed.
- Clone Git repository.
git clone https://github.com/rodrigues14/financerto-backend.git
- Check if all dependencies have been installed.
- Configure database properties in
application.properties
file.
spring.datasource.url=jdbc:postgresql://localhost/yourDB
spring.datasource.username=username
spring.datasource.password=password
- Run the spring boot application.
- Test the application through postman/Insomnia or Swagger: http://localhost:8080/swagger-ui/index.html#/
REQUEST
{
"name": "Lucas",
"email": "lucas14@gmail.com",
"password": "123456"
}
REQUEST
{
"login": "lucas14@gmail.com",
"password": "123456"
}
RESPONSE
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJmaW5hbmNlcnRvIiwic3ViIjoibHVjYXMxNEBnbWFpbC5jb20iLCJleHAiOjE3MTU3ODgzMDR9.6UA9S_BjzaGZYBjkbZQwLl0z_U10A6EzGkUWr4oJ5TM"
}