Quantum Save Backend v1.0.0 — Production-ready API

Quantum Save Backend v1.0.0 🚀

First stable release of the Quantum Save Backend API — a production-style Spring Boot service powering secure personal finance workflows (income, expenses, categories, dashboard summaries) with reporting and email automation.

✅ Highlights

• Stateless JWT authentication (Spring Security + custom JWT filter)
• Strict user-scoped data isolation (ownership enforced server-side)
• Finance domain workflows
  • Categories with type enforcement (income vs expense)
  • Income & Expense tracking (create, list, delete)
  • Derived dashboard totals and recent activity
• Reporting & automation
  • Excel exports (.xlsx) for current-month income/expenses (Apache POI)
  • Email delivery via Brevo (HTML templates + attachments)
  • Scheduled notification jobs (daily reminders + daily expense summary)

🔌 API Surface

Base path: /api/v1.0

Public

• POST /login
• POST /register
• GET /activate
• POST /resend-verification
• GET /status
• GET /health

Authenticated (JWT)

• GET /profile
• GET /dashboard
• GET/POST/PUT /categories (+ /categories/{type})
• GET/POST/DELETE /incomes
• GET/POST/DELETE /expenses
• POST /filter
• GET /excel/download/income
• GET /excel/download/expense
• GET /email/income-excel
• GET /email/expense-excel

🔐 Security Notes

• JWT auth is enforced in the security filter chain before controllers.
• Ownership checks prevent cross-user access even with crafted requests.
• Passwords are hashed using BCrypt.

🧰 Tech Stack

Java 21 • Spring Boot 3.x • Spring Security • JWT • PostgreSQL • JPA/Hibernate • Maven
Deployed on Render.

🛠️ How to run

mvn clean install
mvn spring-boot:run