# vetrichelvan2007/smartcampus architecture

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

- Interactive diagram: https://gitdiagram.com/vetrichelvan2007/smartcampus
- Repository: https://github.com/vetrichelvan2007/smartcampus

## Overview

SmartCampus is a role-based campus learning portal with a React frontend and Spring controllers backed by relational data. The main workflow is authentication, role-specific navigation, then student course participation or teacher course management—including materials, assignments, quizzes, and feedback. Admin and calendar/profile views are additional capabilities. The graph reflects routes, imports, and database use visible in the supplied excerpts and source index; backend HTTP-to-frontend wiring is not fully shown, so those links are omitted or marked unverified.

Main entry points: [`src/main/java/com/vetri/smartcampus/models/common/DataBaseConnection.java`](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/models/common/DataBaseConnection.java) (Database connection), [`frontend/src/App.jsx`](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/App.jsx) (Route and role guard), [`frontend/src/context/AuthContext.jsx`](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/context/AuthContext.jsx) (Auth context), [`src/main/java/com/vetri/smartcampus/controllers/student/StudentControllerSupport.java`](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentControllerSupport.java) (Student data support)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_spa["Route and role guard<br/>[App.jsx]"]
  node_login["Login screen<br/>[Login.jsx]"]
  node_studentui["Student views<br/>[Course.jsx]"]
  node_teacherui["Teacher course view<br/>[TeacherCourse.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_layout["Dashboard navigation"]
end

subgraph group_identity["Identity and access"]
  node_authstate["Auth context<br/>[AuthContext.jsx]"]
  node_authapi["API authentication"]
  node_web_auth["Web authentication"]
end

subgraph group_student["Student learning"]
  node_studentcourse["Course and registration"]
  node_studentwork["Assignments and materials"]
  node_studentquiz["Student quizzes"]
  node_studentfeedback["Student feedback"]
  node_studentcomic["Comic learning"]
  node_studentprofile["Student dashboard and profile"]
  node_studenthelper["Student data support"]
end

subgraph group_teacher["Teacher tools"]
  node_teacherwork["Course assignments"]
  node_teacherquiz["Quiz authoring"]
  node_teacherfeedback["Feedback management"]
  node_teacherdashboard["Teacher dashboard and roster"]
  node_teacherhelper["Teacher data support"]
end

subgraph group_platform["Platform services"]
  node_admin["Admin operations"]
  node_materialextract["Material text extraction"]
  node_comicclient["Comic learning client"]
  node_dbconnect["Database connection"]
end

node_visitor(("Campus user"))
node_database[("Relational database")]
node_comicservice["Comic learning service"]

node_visitor -->|"opens"| node_spa
node_spa -->|"routes to"| node_login
node_spa -->|"routes to"| node_studentui
node_spa -->|"routes to"| node_teacherui
node_spa -->|"routes to"| node_adminui
node_spa -->|"checks access"| node_authstate
node_login -->|"uses"| node_authstate
node_authstate -.->|"requests auth"| node_authapi
node_studentui -->|"renders"| node_layout
node_teacherui -->|"renders"| node_layout
node_layout -->|"uses"| node_authstate
node_studentui -->|"uses"| node_authstate
node_teacherui -->|"uses"| node_authstate
node_authapi -->|"queries"| node_dbconnect
node_web_auth -->|"queries"| node_dbconnect
node_admin -->|"queries"| node_dbconnect
node_studentcourse -.->|"queries"| node_dbconnect
node_studentwork -.->|"queries"| node_dbconnect
node_studentquiz -.->|"queries"| node_dbconnect
node_studentfeedback -->|"uses"| node_studenthelper
node_studentwork -.->|"uses"| node_studenthelper
node_studentquiz -->|"uses"| node_studenthelper
node_studenthelper -->|"queries"| node_dbconnect
node_teacherwork -->|"uses"| node_teacherhelper
node_teacherquiz -->|"uses"| node_teacherhelper
node_teacherfeedback -->|"uses"| node_teacherhelper
node_teacherhelper -->|"queries"| node_dbconnect
node_teacherdashboard -.->|"queries"| node_dbconnect
node_materialextract -->|"loads metadata"| node_dbconnect
node_studentcomic -->|"extracts material"| node_materialextract
node_studentcomic -->|"requests comics"| node_comicclient
node_comicclient -.->|"delegates to"| node_comicservice
node_dbconnect -->|"connects"| node_database

click node_spa "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/App.jsx"
click node_login "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/Login.jsx"
click node_studentui "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/Course.jsx"
click node_teacherui "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/TeacherCourse.jsx"
click node_adminui "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/AdminDashboard.jsx"
click node_layout "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/components/DashboardLayout.jsx"
click node_authstate "https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/context/AuthContext.jsx"
click node_authapi "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/api/ApiAuthController.java"
click node_web_auth "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/AuthController.java"
click node_studentcourse "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentCourseController.java"
click node_studentwork "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentAssignmentController.java"
click node_studentquiz "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentQuizController.java"
click node_studentfeedback "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentFeedbackController.java"
click node_studentcomic "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentComicLearningController.java"
click node_studentprofile "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentDashboardController.java"
click node_teacherwork "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherAssignmentController.java"
click node_teacherquiz "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherQuizController.java"
click node_teacherfeedback "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherFeedbackController.java"
click node_teacherdashboard "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherDashboardController.java"
click node_admin "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/admin/AdminDashboardController.java"
click node_studenthelper "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentControllerSupport.java"
click node_teacherhelper "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherControllerSupport.java"
click node_materialextract "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/services/CourseMaterialExtractionService.java"
click node_comicclient "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/services/ComicLearningClient.java"
click node_dbconnect "https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/models/common/DataBaseConnection.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_spa,node_login,node_studentui,node_teacherui,node_adminui,node_layout,node_visitor toneBlue
class node_authstate,node_authapi,node_web_auth,node_database toneAmber
class node_studentcourse,node_studentwork,node_studentquiz,node_studentfeedback,node_studentcomic,node_studentprofile,node_studenthelper toneMint
class node_teacherwork,node_teacherquiz,node_teacherfeedback,node_teacherdashboard,node_teacherhelper toneRose
class node_admin,node_materialextract,node_comicclient,node_dbconnect,node_comicservice toneIndigo
```

## Components

### Web client

- [Route and role guard](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login screen](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Student views](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/Course.jsx): `frontend/src/pages/Course.jsx`
- [Teacher course view](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/TeacherCourse.jsx): `frontend/src/pages/TeacherCourse.jsx`
- [Admin dashboard](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Dashboard navigation](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/components/DashboardLayout.jsx): `frontend/src/components/DashboardLayout.jsx`

### Identity and access

- [Auth context](https://github.com/vetrichelvan2007/smartcampus/blob/master/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API authentication](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/api/ApiAuthController.java): `src/main/java/com/vetri/smartcampus/controllers/api/ApiAuthController.java`
- [Web authentication](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/AuthController.java): `src/main/java/com/vetri/smartcampus/controllers/AuthController.java`

### Student learning

- [Course and registration](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentCourseController.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentCourseController.java`
- [Assignments and materials](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentAssignmentController.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentAssignmentController.java`
- [Student quizzes](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentQuizController.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentQuizController.java`
- [Student feedback](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentFeedbackController.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentFeedbackController.java`
- [Comic learning](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentComicLearningController.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentComicLearningController.java`
- [Student dashboard and profile](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentDashboardController.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentDashboardController.java`
- [Student data support](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/student/StudentControllerSupport.java): `src/main/java/com/vetri/smartcampus/controllers/student/StudentControllerSupport.java`

### Teacher tools

- [Course assignments](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherAssignmentController.java): `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherAssignmentController.java`
- [Quiz authoring](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherQuizController.java): `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherQuizController.java`
- [Feedback management](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherFeedbackController.java): `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherFeedbackController.java`
- [Teacher dashboard and roster](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherDashboardController.java): `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherDashboardController.java`
- [Teacher data support](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherControllerSupport.java): `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherControllerSupport.java`

### Platform services

- [Admin operations](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/controllers/admin/AdminDashboardController.java): `src/main/java/com/vetri/smartcampus/controllers/admin/AdminDashboardController.java`
- [Material text extraction](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/services/CourseMaterialExtractionService.java): `src/main/java/com/vetri/smartcampus/services/CourseMaterialExtractionService.java`
- [Comic learning client](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/services/ComicLearningClient.java): `src/main/java/com/vetri/smartcampus/services/ComicLearningClient.java`
- [Database connection](https://github.com/vetrichelvan2007/smartcampus/blob/master/src/main/java/com/vetri/smartcampus/models/common/DataBaseConnection.java): `src/main/java/com/vetri/smartcampus/models/common/DataBaseConnection.java`

### Other components

- **Campus user**
- **Relational database**
- **Comic learning service**

## Connections

- Campus user → Route and role guard: opens (evidence: `frontend/src/App.jsx`)
- Route and role guard → Login screen: routes to (evidence: `frontend/src/App.jsx`)
- Route and role guard → Student views: routes to (evidence: `frontend/src/App.jsx`)
- Route and role guard → Teacher course view: routes to (evidence: `frontend/src/App.jsx`)
- Route and role guard → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route and role guard → Auth context: checks access (evidence: `frontend/src/App.jsx`)
- Login screen → Auth context: uses (evidence: `frontend/src/pages/Login.jsx`)
- Auth context → API authentication: requests auth
- Student views → Dashboard navigation: renders (evidence: `frontend/src/pages/Course.jsx`)
- Teacher course view → Dashboard navigation: renders (evidence: `frontend/src/pages/TeacherCourse.jsx`)
- Dashboard navigation → Auth context: uses (evidence: `frontend/src/components/DashboardLayout.jsx`)
- Student views → Auth context: uses (evidence: `frontend/src/pages/Course.jsx`)
- Teacher course view → Auth context: uses (evidence: `frontend/src/pages/TeacherCourse.jsx`)
- API authentication → Database connection: queries (evidence: `src/main/java/com/vetri/smartcampus/controllers/api/ApiAuthController.java`)
- Web authentication → Database connection: queries (evidence: `src/main/java/com/vetri/smartcampus/controllers/AuthController.java`)
- Admin operations → Database connection: queries (evidence: `src/main/java/com/vetri/smartcampus/controllers/admin/AdminDashboardController.java`)
- Course and registration → Database connection: queries
- Assignments and materials → Database connection: queries
- Student quizzes → Database connection: queries
- Student feedback → Student data support: uses (evidence: `src/main/java/com/vetri/smartcampus/controllers/student/StudentFeedbackController.java`)
- Assignments and materials → Student data support: uses
- Student quizzes → Student data support: uses (evidence: `src/main/java/com/vetri/smartcampus/controllers/student/StudentQuizController.java`)
- Student data support → Database connection: queries (evidence: `src/main/java/com/vetri/smartcampus/controllers/student/StudentControllerSupport.java`)
- Course assignments → Teacher data support: uses (evidence: `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherAssignmentController.java`)
- Quiz authoring → Teacher data support: uses (evidence: `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherQuizController.java`)
- Feedback management → Teacher data support: uses (evidence: `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherFeedbackController.java`)
- Teacher data support → Database connection: queries (evidence: `src/main/java/com/vetri/smartcampus/controllers/teacher/TeacherControllerSupport.java`)
- Teacher dashboard and roster → Database connection: queries
- Material text extraction → Database connection: loads metadata (evidence: `src/main/java/com/vetri/smartcampus/services/CourseMaterialExtractionService.java`)
- Comic learning → Material text extraction: extracts material (evidence: `src/main/java/com/vetri/smartcampus/controllers/student/StudentComicLearningController.java`)
- Comic learning → Comic learning client: requests comics (evidence: `src/main/java/com/vetri/smartcampus/controllers/student/StudentComicLearningController.java`)
- Comic learning client → Comic learning service: delegates to
- Database connection → Relational database: connects (evidence: `src/main/java/com/vetri/smartcampus/models/common/DataBaseConnection.java`)
