# vananh-13/backend_hit_learning_connect architecture

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

- Interactive diagram: https://gitdiagram.com/vananh-13/backend_hit_learning_connect
- Repository: https://github.com/vananh-13/backend_hit_learning_connect

## Overview

HIT Learning Connect is a Spring Boot backend for an online learning platform. Its documented user workflow is to authenticate, manage a profile, and use course and enrollment APIs; instructors or admins can review enrollment requests. The README describes a controller–service–repository architecture backed by MySQL, with Redis caching and optional email and Cloudinary integrations. The tree also shows blog, contest, and document modules, but their runtime relationships are not established by the available evidence, so they are represented without inferred connections. No source excerpts were available; edges below rely on README statements.

Main entry points: [`src/main/java/com/example/projectbase/controller`](https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/controller) (REST API), [`src/main/java/com/example/projectbase/repository`](https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/repository) (JPA Repositories), [`src/main/java/com/example/projectbase/controller/UserController.java`](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/UserController.java) (User API), [`src/main/java/com/example/projectbase/controller/ClassController.java`](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/ClassController.java) (Course API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API Layer"]
  node_rest["REST API"]
  node_user_api["User API"]
  node_class_api["Course API"]
  node_enrollment_api["Enrollment API"]
  node_auth_api["Auth API"]
  node_blog_api["Blog API"]
  node_contest_api["Contest APIs"]
  node_document_api["Document API"]
end

subgraph group_learning["Learning Features"]
  node_user_service["User Management<br/>[UserService.java]"]
  node_class_service["Course Management<br/>[ClassService.java]"]
  node_enrollment_service["Enrollment Management"]
  node_blog_service["Blog Service<br/>[BlogService.java]"]
  node_contest_service["Contest Service"]
  node_document_service["Document Service"]
end

subgraph group_identity["Identity"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_security["JWT Security"]
end

subgraph group_platform["Platform Services"]
  node_repositories["JPA Repositories"]
  node_mysql[("MySQL")]
  node_redis[("Redis Cache<br/>[RedisConfig.java]")]
  node_storage["File Storage"]
  node_cloudinary["Cloudinary"]
  node_mail["Email Service<br/>[MailService.java]"]
  node_smtp["SMTP / SendGrid"]
end

node_learner(("Learner / Staff"))

node_learner -->|"uses APIs"| node_rest
node_rest -->|"routes requests"| node_user_api
node_rest -->|"routes requests"| node_class_api
node_rest -->|"routes requests"| node_enrollment_api
node_rest -->|"routes requests"| node_auth_api
node_user_api -->|"delegates to"| node_user_service
node_class_api -->|"delegates to"| node_class_service
node_enrollment_api -->|"delegates to"| node_enrollment_service
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"uses JWT"| node_security
node_user_service -->|"uses persistence"| node_repositories
node_class_service -->|"uses persistence"| node_repositories
node_enrollment_service -->|"uses persistence"| node_repositories
node_repositories -->|"persists data"| node_mysql
node_rest -.->|"routes requests"| node_blog_api
node_rest -.->|"routes requests"| node_contest_api
node_rest -.->|"routes requests"| node_document_api
node_blog_api -.->|"delegates to"| node_blog_service
node_contest_api -.->|"delegates to"| node_contest_service
node_document_api -.->|"delegates to"| node_document_service
node_redis -.->|"caches data"| node_mysql
node_storage -.->|"uploads files"| node_cloudinary
node_mail -.->|"sends email"| node_smtp

click node_rest "https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/controller"
click node_user_api "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/UserController.java"
click node_class_api "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/ClassController.java"
click node_enrollment_api "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/ClassRegistrationController.java"
click node_auth_api "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/AuthController.java"
click node_blog_api "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/BlogController.java"
click node_contest_api "https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/controller/contest"
click node_document_api "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/DocumentController.java"
click node_user_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/UserService.java"
click node_class_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/ClassService.java"
click node_enrollment_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/ClassRegistrationService.java"
click node_blog_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/BlogService.java"
click node_contest_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/ContestService.java"
click node_document_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/DocumentService.java"
click node_auth_service "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/AuthService.java"
click node_security "https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/security"
click node_repositories "https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/repository"
click node_redis "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/config/RedisConfig.java"
click node_storage "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/StorageService.java"
click node_mail "https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/MailService.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_rest,node_user_api,node_class_api,node_enrollment_api,node_auth_api,node_blog_api,node_contest_api,node_document_api toneBlue
class node_user_service,node_class_service,node_enrollment_service,node_blog_service,node_contest_service,node_document_service toneAmber
class node_auth_service,node_security toneMint
class node_repositories,node_mysql,node_redis,node_storage,node_cloudinary,node_mail,node_smtp toneRose
class node_learner toneIndigo
```

## Components

### API Layer

- [REST API](https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/controller): `src/main/java/com/example/projectbase/controller`
- [User API](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/UserController.java): `src/main/java/com/example/projectbase/controller/UserController.java`
- [Course API](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/ClassController.java): `src/main/java/com/example/projectbase/controller/ClassController.java`
- [Enrollment API](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/ClassRegistrationController.java): `src/main/java/com/example/projectbase/controller/ClassRegistrationController.java`
- [Auth API](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/AuthController.java): `src/main/java/com/example/projectbase/controller/AuthController.java`
- [Blog API](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/BlogController.java): `src/main/java/com/example/projectbase/controller/BlogController.java`
- [Contest APIs](https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/controller/contest): `src/main/java/com/example/projectbase/controller/contest`
- [Document API](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/controller/DocumentController.java): `src/main/java/com/example/projectbase/controller/DocumentController.java`

### Learning Features

- [User Management](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/UserService.java): `src/main/java/com/example/projectbase/service/UserService.java`
- [Course Management](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/ClassService.java): `src/main/java/com/example/projectbase/service/ClassService.java`
- [Enrollment Management](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/ClassRegistrationService.java): `src/main/java/com/example/projectbase/service/ClassRegistrationService.java`
- [Blog Service](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/BlogService.java): `src/main/java/com/example/projectbase/service/BlogService.java`
- [Contest Service](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/ContestService.java): `src/main/java/com/example/projectbase/service/ContestService.java`
- [Document Service](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/DocumentService.java): `src/main/java/com/example/projectbase/service/DocumentService.java`

### Identity

- [Authentication](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/AuthService.java): `src/main/java/com/example/projectbase/service/AuthService.java`
- [JWT Security](https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/security): `src/main/java/com/example/projectbase/security`

### Platform Services

- [JPA Repositories](https://github.com/vananh-13/backend_hit_learning_connect/tree/main/src/main/java/com/example/projectbase/repository): `src/main/java/com/example/projectbase/repository`
- **MySQL**
- [Redis Cache](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/config/RedisConfig.java): `src/main/java/com/example/projectbase/config/RedisConfig.java`
- [File Storage](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/StorageService.java): `src/main/java/com/example/projectbase/service/StorageService.java`
- **Cloudinary**
- [Email Service](https://github.com/vananh-13/backend_hit_learning_connect/blob/main/src/main/java/com/example/projectbase/service/MailService.java): `src/main/java/com/example/projectbase/service/MailService.java`
- **SMTP / SendGrid**

### Other components

- **Learner / Staff**

## Connections

- Learner / Staff → REST API: uses APIs (evidence: `README.md`)
- REST API → User API: routes requests (evidence: `README.md`)
- REST API → Course API: routes requests (evidence: `README.md`)
- REST API → Enrollment API: routes requests (evidence: `README.md`)
- REST API → Auth API: routes requests (evidence: `README.md`)
- User API → User Management: delegates to (evidence: `README.md`)
- Course API → Course Management: delegates to (evidence: `README.md`)
- Enrollment API → Enrollment Management: delegates to (evidence: `README.md`)
- Auth API → Authentication: delegates to (evidence: `README.md`)
- Authentication → JWT Security: uses JWT (evidence: `README.md`)
- User Management → JPA Repositories: uses persistence (evidence: `README.md`)
- Course Management → JPA Repositories: uses persistence (evidence: `README.md`)
- Enrollment Management → JPA Repositories: uses persistence (evidence: `README.md`)
- JPA Repositories → MySQL: persists data (evidence: `README.md`)
- REST API → Blog API: routes requests
- REST API → Contest APIs: routes requests
- REST API → Document API: routes requests
- Blog API → Blog Service: delegates to
- Contest APIs → Contest Service: delegates to
- Document API → Document Service: delegates to
- Redis Cache → MySQL: caches data (evidence: `README.md`)
- File Storage → Cloudinary: uploads files (evidence: `README.md`)
- Email Service → SMTP / SendGrid: sends email (evidence: `README.md`)
