budget-backend-gradle is a ready-to-run Spring Boot backend service that provides full CRUD management for:

• Budgets
• Expenses
• Users
• Customers
• Orders
• Tasks
• Transactions

All resources are exposed via a standard REST API, backed by MongoDB (for NoSQL collections) and PostgreSQL (via JPA for relational data), with out-of-the-box support for JWT authentication, Lombok code generation, and easy extension.

• Complete REST Endpoints
  Each entity has a dedicated controller under /api/{resource} with
  GET, POST, PUT and DELETE operations.

• Polyglot Persistence

  • MongoDB for fast, schemaless storage of Budgets, Expenses, Users, Customers, Orders, Tasks, Transactions
  • PostgreSQL (JPA) for relational joins, audit logs, and transaction histories

• JWT Authentication Prepared
  Library included (jjwt) and ready to plug into Spring Security for protected routes.

• Lombok Annotations
  Reduces boilerplate with @Data, @Builder, @NoArgsConstructor, @AllArgsConstructor.

• Spring Data Repositories
  Interfaces for each model—just inject and use them in your services.

• Service + Controller Layered Architecture
  Business logic is isolated in service classes; REST wiring lives in controller classes.

• Docker-Ready
  A sample Dockerfile (multi-stage build) is included—just build the JAR and wrap it in a lightweight image.

• Maven & Gradle Compatible
  Although published via Gradle, you can consume it from Maven or Gradle builds alike.

<dependency>
  <groupId>com.github.hoangsonww</groupId>
  <artifactId>budget-backend-gradle</artifactId>
  <version>1.0.0</version>
</dependency>

repositories {
  maven {
    url = uri("https://maven.pkg.github.com/hoangsonww/Budget-Management-Backend-API")
    credentials {
      username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_USER")
      password = project.findProperty("gpr.token") ?: System.getenv("GITHUB_TOKEN")
    }
  }
}

dependencies {
  implementation "com.github.hoangsonww:budget-backend-gradle:1.0.0"
}

1. Clone & configure

   git clone https://github.com/hoangsonww/Budget-Management-Backend-API.git
   cd Budget-Management-Backend-API/gradle

2. Set environment

   # src/main/resources/application.properties
   spring.data.mongodb.uri=mongodb://localhost:27017/budget_manager
   spring.datasource.url=jdbc:postgresql://localhost:5432/budget_manager
   spring.datasource.username=<your_pg_user>
   spring.datasource.password=<your_pg_password>
   jwt.secret=<your_jwt_secret>

3. Build & run

   ./gradlew bootRun

4. Test the API

   • GET /api/budgets
   • POST /api/expenses
   • …etc.

• License: MIT
• Author: Son Nguyen (hoangsonww)
• Homepage: https://github.com/hoangsonww/Budget-Management-Backend-API

Feel free to open issues or pull requests for bugs, improvements, or new features!