# padmanababalaji/online-learning-platform architecture

> Architecture diagram of the GitHub repository padmanababalaji/online-learning-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/padmanababalaji/online-learning-platform
- Repository: https://github.com/padmanababalaji/online-learning-platform

## Overview

This is a Spring-based online learning platform backend. Its visible workflows handle user registration and login, course creation and management, and contact submissions and retrieval through REST controllers, services, and persistence components. The source index and excerpts support these call paths, but provide no README details or frontend implementation; the frontend directory is therefore not expanded. Persistence is represented by repositories and entities, without assuming a particular database configuration.

Main entry points: [`src/main/java/com/jsp/lms/controller/AuthController.java`](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/AuthController.java) (Auth endpoints), [`src/main/java/com/jsp/lms/controller/CourseController.java`](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/CourseController.java) (Course endpoints), [`src/main/java/com/jsp/lms/controller/ContactController.java`](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/ContactController.java) (Contact endpoints), [`src/main/java/com/jsp/lms/service/AuthService.java`](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_controller["Auth endpoints"]
  node_course_controller["Course endpoints"]
  node_contact_controller["Contact endpoints"]
  node_react_forward["React forwarding"]
end

subgraph group_domain["Platform Services"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_course_service["Course management<br/>[CourseService.java]"]
  node_contact_service["Contact handling"]
end

subgraph group_persistence["Persistence"]
  node_user_dao["User data access<br/>[UserDao.java]"]
  node_course_dao["Course data access<br/>[CourseDao.java]"]
  node_contact_dao["Contact data access<br/>[ContactDao.java]"]
  node_user_repo["User repository"]
  node_course_repo["Course repository"]
  node_contact_repo["Contact repository"]
end

subgraph group_shared["Shared Models"]
  node_user_entity["User record<br/>[User.java]"]
  node_course_entity["Course record<br/>[Course.java]"]
  node_contact_entity["Contact record<br/>[Contact.java]"]
  node_login_request["Login request<br/>[LoginRequest.java]"]
  node_course_request["Course request<br/>[CourseRequest.java]"]
  node_contact_request["Contact request"]
  node_api_response["API response<br/>[ApiResponse.java]"]
  node_exceptions["Error handling"]
end

node_user(("Platform user"))

node_user -->|"sends requests"| node_auth_controller
node_user -->|"sends requests"| node_course_controller
node_user -->|"sends requests"| node_contact_controller
node_auth_controller -->|"calls"| node_auth_service
node_course_controller -->|"calls"| node_course_service
node_contact_controller -->|"calls"| node_contact_service
node_auth_service -->|"queries and saves"| node_user_dao
node_course_service -->|"manages courses"| node_course_dao
node_contact_service -->|"saves and lists"| node_contact_dao
node_user_dao -->|"delegates to"| node_user_repo
node_course_dao -->|"delegates to"| node_course_repo
node_contact_dao -->|"delegates to"| node_contact_repo
node_user_repo -->|"persists"| node_user_entity
node_course_repo -->|"persists"| node_course_entity
node_contact_repo -->|"persists"| node_contact_entity
node_auth_controller -->|"accepts"| node_login_request
node_course_controller -->|"accepts"| node_course_request
node_contact_controller -->|"accepts"| node_contact_request
node_auth_controller -->|"returns"| node_api_response
node_course_controller -->|"returns"| node_api_response
node_contact_controller -->|"returns"| node_api_response
node_auth_service -->|"raises handled errors"| node_exceptions

click node_auth_controller "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/AuthController.java"
click node_course_controller "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/CourseController.java"
click node_contact_controller "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/ContactController.java"
click node_react_forward "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/ReactForwardController.java"
click node_auth_service "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/AuthService.java"
click node_course_service "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/CourseService.java"
click node_contact_service "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/ContactService.java"
click node_user_dao "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dao/UserDao.java"
click node_course_dao "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dao/CourseDao.java"
click node_contact_dao "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dao/ContactDao.java"
click node_user_repo "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/repository/UserRepository.java"
click node_course_repo "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/repository/CourseRepository.java"
click node_contact_repo "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/repository/ContactRepository.java"
click node_user_entity "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/entity/User.java"
click node_course_entity "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/entity/Course.java"
click node_contact_entity "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/entity/Contact.java"
click node_login_request "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/LoginRequest.java"
click node_course_request "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/CourseRequest.java"
click node_contact_request "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/ContactRequest.java"
click node_api_response "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/ApiResponse.java"
click node_exceptions "https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/exception/GlobalExceptionHandler.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_controller,node_course_controller,node_contact_controller,node_react_forward,node_user toneBlue
class node_auth_service,node_course_service,node_contact_service toneAmber
class node_user_dao,node_course_dao,node_contact_dao,node_user_repo,node_course_repo,node_contact_repo toneMint
class node_user_entity,node_course_entity,node_contact_entity,node_login_request,node_course_request,node_contact_request,node_api_response,node_exceptions toneRose
```

## Components

### REST API

- [Auth endpoints](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/AuthController.java): `src/main/java/com/jsp/lms/controller/AuthController.java`
- [Course endpoints](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/CourseController.java): `src/main/java/com/jsp/lms/controller/CourseController.java`
- [Contact endpoints](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/ContactController.java): `src/main/java/com/jsp/lms/controller/ContactController.java`
- [React forwarding](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/controller/ReactForwardController.java): `src/main/java/com/jsp/lms/controller/ReactForwardController.java`

### Platform Services

- [Authentication](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/AuthService.java): `src/main/java/com/jsp/lms/service/AuthService.java`
- [Course management](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/CourseService.java): `src/main/java/com/jsp/lms/service/CourseService.java`
- [Contact handling](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/service/ContactService.java): `src/main/java/com/jsp/lms/service/ContactService.java`

### Persistence

- [User data access](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dao/UserDao.java): `src/main/java/com/jsp/lms/dao/UserDao.java`
- [Course data access](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dao/CourseDao.java): `src/main/java/com/jsp/lms/dao/CourseDao.java`
- [Contact data access](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dao/ContactDao.java): `src/main/java/com/jsp/lms/dao/ContactDao.java`
- [User repository](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/repository/UserRepository.java): `src/main/java/com/jsp/lms/repository/UserRepository.java`
- [Course repository](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/repository/CourseRepository.java): `src/main/java/com/jsp/lms/repository/CourseRepository.java`
- [Contact repository](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/repository/ContactRepository.java): `src/main/java/com/jsp/lms/repository/ContactRepository.java`

### Shared Models

- [User record](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/entity/User.java): `src/main/java/com/jsp/lms/entity/User.java`
- [Course record](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/entity/Course.java): `src/main/java/com/jsp/lms/entity/Course.java`
- [Contact record](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/entity/Contact.java): `src/main/java/com/jsp/lms/entity/Contact.java`
- [Login request](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/LoginRequest.java): `src/main/java/com/jsp/lms/dto/LoginRequest.java`
- [Course request](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/CourseRequest.java): `src/main/java/com/jsp/lms/dto/CourseRequest.java`
- [Contact request](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/ContactRequest.java): `src/main/java/com/jsp/lms/dto/ContactRequest.java`
- [API response](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/dto/ApiResponse.java): `src/main/java/com/jsp/lms/dto/ApiResponse.java`
- [Error handling](https://github.com/padmanababalaji/online-learning-platform/blob/master/src/main/java/com/jsp/lms/exception/GlobalExceptionHandler.java): `src/main/java/com/jsp/lms/exception/GlobalExceptionHandler.java`

### Other components

- **Platform user**

## Connections

- Platform user → Auth endpoints: sends requests (evidence: `src/main/java/com/jsp/lms/controller/AuthController.java`)
- Platform user → Course endpoints: sends requests (evidence: `src/main/java/com/jsp/lms/controller/CourseController.java`)
- Platform user → Contact endpoints: sends requests (evidence: `src/main/java/com/jsp/lms/controller/ContactController.java`)
- Auth endpoints → Authentication: calls (evidence: `src/main/java/com/jsp/lms/controller/AuthController.java`)
- Course endpoints → Course management: calls (evidence: `src/main/java/com/jsp/lms/controller/CourseController.java`)
- Contact endpoints → Contact handling: calls (evidence: `src/main/java/com/jsp/lms/controller/ContactController.java`)
- Authentication → User data access: queries and saves (evidence: `src/main/java/com/jsp/lms/service/AuthService.java`)
- Course management → Course data access: manages courses (evidence: `src/main/java/com/jsp/lms/service/CourseService.java`)
- Contact handling → Contact data access: saves and lists (evidence: `src/main/java/com/jsp/lms/service/ContactService.java`)
- User data access → User repository: delegates to (evidence: `src/main/java/com/jsp/lms/dao/UserDao.java`)
- Course data access → Course repository: delegates to (evidence: `src/main/java/com/jsp/lms/dao/CourseDao.java`)
- Contact data access → Contact repository: delegates to (evidence: `src/main/java/com/jsp/lms/dao/ContactDao.java`)
- User repository → User record: persists (evidence: `src/main/java/com/jsp/lms/repository/UserRepository.java`)
- Course repository → Course record: persists (evidence: `src/main/java/com/jsp/lms/repository/CourseRepository.java`)
- Contact repository → Contact record: persists (evidence: `src/main/java/com/jsp/lms/repository/ContactRepository.java`)
- Auth endpoints → Login request: accepts (evidence: `src/main/java/com/jsp/lms/controller/AuthController.java`)
- Course endpoints → Course request: accepts (evidence: `src/main/java/com/jsp/lms/controller/CourseController.java`)
- Contact endpoints → Contact request: accepts (evidence: `src/main/java/com/jsp/lms/controller/ContactController.java`)
- Auth endpoints → API response: returns (evidence: `src/main/java/com/jsp/lms/controller/AuthController.java`)
- Course endpoints → API response: returns (evidence: `src/main/java/com/jsp/lms/controller/CourseController.java`)
- Contact endpoints → API response: returns (evidence: `src/main/java/com/jsp/lms/controller/ContactController.java`)
- Authentication → Error handling: raises handled errors (evidence: `src/main/java/com/jsp/lms/exception/GlobalExceptionHandler.java`)
