Repository files navigation

ASpring Boot 3 + Maven powered backend service for a SaaS-style e-learning platform.This project demonstrates how to build aproduction-ready backend with authentication, user management, and secure APIs.

Designed to showcase clean architecture, modern Java practices, and readiness for scaling SaaS applications.

• Backend Framework:Spring Boot 3
• Build Tool: Maven
• Language: Java 17+
• Database: PostgreSQL (configurable to H2 for testing)
• ORM: Spring Data JPA
• Authentication & Security: Spring Security with form login (extendable to JWT/OAuth2)
• Testing: JUnit 5, Spring Boot Test
• Dev Tools: Lombok, Spring Boot DevTools

backend/│── src/│   ├── main/java/com/sass/│   │   ├── BackendApplication.java        # Main entry point│   │   ├── config/                        # Spring Security & App Config│   │   ├── controller/                    # REST API controllers│   │   ├── model/                         # JPA Entities│   │   ├── repository/                    # Data Access Layer│   │   └── service/                       # Business Logic Layer│   └── test/java/com/sass/│       └── DemoApplicationTests.java      # Unit/Integration tests│└── pom.xml                                # Maven dependencies

1. Entry Point

   • BackendApplication.java starts the application withSpringApplication.run(...).
   • Automatically scanscom.sass package and its subpackages.

2. User Request

   • Example: User navigates tohttp://localhost:8080/login.
   • Spring Security intercepts the request and shows alogin page.

3. Authentication

   • If login fails → redirected to/login?error.
   • If login succeeds → redirected to home page or protected API.

4. Controllers

   • REST controllers incontroller/ handle user-facing endpoints like/api/courses,/api/users.

5. Services

   • Business logic resides inservice/ classes (e.g., course creation, enrollment rules).

6. Data Persistence

   • Services callrepository/ interfaces.
   • Spring Data JPA translates repository calls into SQL queries to PostgreSQL.

7. Response

   • Data is returned asJSON, ready to be consumed by a React/Flutter frontend.

git clone https://github.com/ManibalaSinha/saas-backend.gitcd saas-backend

Updateapplication.properties insrc/main/resources/:

spring.datasource.url=jdbc:postgresql://localhost:5432/saasdbspring.datasource.username=postgresspring.datasource.password=yourpasswordspring.jpa.hibernate.ddl-auto=update

(For quick start, you can switch to in-memory H2 by uncommenting H2 config.)

mvn spring-boot:run

Backend will start on:http://localhost:8080

mvntest

• GET /login → Login Page (Spring Security)
• GET /api/users → Fetch all users
• POST /api/courses → Create new course
• GET /api/courses/{id} → Fetch course details

clean architecture in a real-world SaaS backend.Spring Security for authentication & authorization.Built withmodern Spring Boot 3 and Java 17.Integrating withReact frontend.Followsenterprise-grade practices

** Manibala Sinha**🔗LinkedIn |GitHub

If you like this project, don’t forget to star the repo – it motivates me to build more!