# shivkoli07/smart_campus_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/shivkoli07/smart_campus_management_system
- Repository: https://github.com/shivkoli07/smart_campus_management_system

## Overview

Smart Campus is a student-and-administrator portal for attendance, complaints, leave, feedback, and campus information. The main workflow is a user submitting or viewing a request through a portal page, with REST endpoints handling domain operations and repositories persisting records. The sampled backend confirms direct controller-to-repository handling for attendance and complaints, and a controller-to-service-to-repository path for leave. The README documents REST APIs and PostgreSQL, but browser/API wiring and database configuration were not sampled, so those links are documented or marked unverified rather than inferred from names.

Main entry points: [`smart-campus-backend/src/main/java/com/smartcampus/repository/AttendanceRepository.java`](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/AttendanceRepository.java) (Attendance repository), [`smart-campus-backend/src/main/java/com/smartcampus/repository/ComplaintRepository.java`](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/ComplaintRepository.java) (Complaint repository), [`schema.sql`](https://github.com/shivkoli07/smart_campus_management_system/blob/main/schema.sql) (PostgreSQL database), [`smart-campus-backend/src/main/java/com/smartcampus/repository/LeaveRepository.java`](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/LeaveRepository.java) (Leave repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Web portal"]
  node_home["Portal home<br/>[index.html]"]
  node_campusinfo["Campus information"]
  node_departments["Departments"]
  node_attendancepages["Attendance pages"]
  node_complaintpages["Complaint pages"]
  node_leavepages["Leave pages"]
  node_feedbackpage["Feedback page<br/>[feed.html]"]
end

subgraph group_api["REST endpoints"]
  node_attendanceapi["Attendance API"]
  node_complaintapi["Complaint API"]
  node_leaveapi["Leave API"]
  node_feedbackapi["Feedback API"]
end

subgraph group_operations["Domain operations"]
  node_attendanceops["Attendance service"]
  node_complaintops["Complaint service"]
  node_leaveops["Leave service<br/>[LeaveService.java]"]
end

subgraph group_persistence["Persistence"]
  node_attendance_repo["Attendance repository"]
  node_complaint_repo["Complaint repository"]
  node_leave_repo["Leave repository"]
  node_feedback_repo["Feedback repository"]
  node_attendance_entity["Attendance record<br/>[Attendance.java]"]
  node_complaint_entity["Complaint record<br/>[Complaint.java]"]
  node_leave_entity["Leave application"]
  node_feedback_entity["Feedback record<br/>[Feedback.java]"]
  node_database[("PostgreSQL database<br/>[schema.sql]")]
end

node_students(("Students"))
node_administrators(("Administrators"))

node_students -->|"use portal"| node_home
node_administrators -->|"use portal"| node_home
node_students -->|"view attendance"| node_attendancepages
node_students -->|"submit or track"| node_complaintpages
node_students -->|"request leave"| node_leavepages
node_students -->|"submit feedback"| node_feedbackpage
node_administrators -->|"manage attendance"| node_attendancepages
node_administrators -->|"review complaints"| node_complaintpages
node_administrators -->|"review leave"| node_leavepages
node_attendancepages -.->|"REST requests"| node_attendanceapi
node_complaintpages -.->|"REST requests"| node_complaintapi
node_leavepages -.->|"REST requests"| node_leaveapi
node_feedbackpage -.->|"REST requests"| node_feedbackapi
node_attendanceapi -->|"reads and saves"| node_attendance_repo
node_complaintapi -->|"reads and saves"| node_complaint_repo
node_leaveapi -->|"delegates leave"| node_leaveops
node_leaveops -->|"reads and saves"| node_leave_repo
node_feedbackapi -->|"uses repository"| node_feedback_repo
node_attendanceops -->|"reads and saves"| node_attendance_repo
node_complaintops -->|"reads and saves"| node_complaint_repo
node_attendance_repo -->|"maps records"| node_attendance_entity
node_complaint_repo -->|"maps records"| node_complaint_entity
node_leave_repo -->|"maps records"| node_leave_entity
node_feedback_repo -->|"maps records"| node_feedback_entity
node_attendance_repo -.->|"persists records"| node_database
node_complaint_repo -.->|"persists records"| node_database
node_leave_repo -.->|"persists records"| node_database
node_feedback_repo -.->|"persists records"| node_database

click node_home "https://github.com/shivkoli07/smart_campus_management_system/blob/main/html%20files/index.html"
click node_campusinfo "https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/campus%20info%20page"
click node_departments "https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/departments%20info%20page"
click node_attendancepages "https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/attendance"
click node_complaintpages "https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/complaints"
click node_leavepages "https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/leave"
click node_feedbackpage "https://github.com/shivkoli07/smart_campus_management_system/blob/main/html%20files/feedback%20page/feed.html"
click node_attendanceapi "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/AttendanceController.java"
click node_complaintapi "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/ComplaintController.java"
click node_leaveapi "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/LeaveController.java"
click node_feedbackapi "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/FeedbackController.java"
click node_attendanceops "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/service/AttendanceService.java"
click node_complaintops "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/service/ComplaintService.java"
click node_leaveops "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/service/LeaveService.java"
click node_attendance_repo "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/AttendanceRepository.java"
click node_complaint_repo "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/ComplaintRepository.java"
click node_leave_repo "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/LeaveRepository.java"
click node_feedback_repo "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/FeedbackRepository.java"
click node_attendance_entity "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/Attendance.java"
click node_complaint_entity "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/Complaint.java"
click node_leave_entity "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/LeaveApplication.java"
click node_feedback_entity "https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/Feedback.java"
click node_database "https://github.com/shivkoli07/smart_campus_management_system/blob/main/schema.sql"

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_home,node_campusinfo,node_departments,node_attendancepages,node_complaintpages,node_leavepages,node_feedbackpage toneBlue
class node_attendanceapi,node_complaintapi,node_leaveapi,node_feedbackapi toneAmber
class node_attendanceops,node_complaintops,node_leaveops toneMint
class node_attendance_repo,node_complaint_repo,node_leave_repo,node_feedback_repo,node_attendance_entity,node_complaint_entity,node_leave_entity,node_feedback_entity,node_database toneRose
class node_students,node_administrators toneIndigo
```

## Components

### Web portal

- [Portal home](https://github.com/shivkoli07/smart_campus_management_system/blob/main/html%20files/index.html): `html files/index.html`
- [Campus information](https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/campus%20info%20page): `html files/campus info page`
- [Departments](https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/departments%20info%20page): `html files/departments info page`
- [Attendance pages](https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/attendance): `html files/attendance`
- [Complaint pages](https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/complaints): `html files/complaints`
- [Leave pages](https://github.com/shivkoli07/smart_campus_management_system/tree/main/html%20files/leave): `html files/leave`
- [Feedback page](https://github.com/shivkoli07/smart_campus_management_system/blob/main/html%20files/feedback%20page/feed.html): `html files/feedback page/feed.html`

### REST endpoints

- [Attendance API](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/AttendanceController.java): `smart-campus-backend/src/main/java/com/smartcampus/controller/AttendanceController.java`
- [Complaint API](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/ComplaintController.java): `smart-campus-backend/src/main/java/com/smartcampus/controller/ComplaintController.java`
- [Leave API](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/LeaveController.java): `smart-campus-backend/src/main/java/com/smartcampus/controller/LeaveController.java`
- [Feedback API](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/controller/FeedbackController.java): `smart-campus-backend/src/main/java/com/smartcampus/controller/FeedbackController.java`

### Domain operations

- [Attendance service](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/service/AttendanceService.java): `smart-campus-backend/src/main/java/com/smartcampus/service/AttendanceService.java`
- [Complaint service](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/service/ComplaintService.java): `smart-campus-backend/src/main/java/com/smartcampus/service/ComplaintService.java`
- [Leave service](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/service/LeaveService.java): `smart-campus-backend/src/main/java/com/smartcampus/service/LeaveService.java`

### Persistence

- [Attendance repository](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/AttendanceRepository.java): `smart-campus-backend/src/main/java/com/smartcampus/repository/AttendanceRepository.java`
- [Complaint repository](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/ComplaintRepository.java): `smart-campus-backend/src/main/java/com/smartcampus/repository/ComplaintRepository.java`
- [Leave repository](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/LeaveRepository.java): `smart-campus-backend/src/main/java/com/smartcampus/repository/LeaveRepository.java`
- [Feedback repository](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/repository/FeedbackRepository.java): `smart-campus-backend/src/main/java/com/smartcampus/repository/FeedbackRepository.java`
- [Attendance record](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/Attendance.java): `smart-campus-backend/src/main/java/com/smartcampus/entity/Attendance.java`
- [Complaint record](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/Complaint.java): `smart-campus-backend/src/main/java/com/smartcampus/entity/Complaint.java`
- [Leave application](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/LeaveApplication.java): `smart-campus-backend/src/main/java/com/smartcampus/entity/LeaveApplication.java`
- [Feedback record](https://github.com/shivkoli07/smart_campus_management_system/blob/main/smart-campus-backend/src/main/java/com/smartcampus/entity/Feedback.java): `smart-campus-backend/src/main/java/com/smartcampus/entity/Feedback.java`
- [PostgreSQL database](https://github.com/shivkoli07/smart_campus_management_system/blob/main/schema.sql): `schema.sql`

### Other components

- **Students**
- **Administrators**

## Connections

- Students → Portal home: use portal (evidence: `README.md`)
- Administrators → Portal home: use portal (evidence: `README.md`)
- Students → Attendance pages: view attendance (evidence: `README.md`)
- Students → Complaint pages: submit or track (evidence: `README.md`)
- Students → Leave pages: request leave (evidence: `README.md`)
- Students → Feedback page: submit feedback (evidence: `README.md`)
- Administrators → Attendance pages: manage attendance (evidence: `README.md`)
- Administrators → Complaint pages: review complaints (evidence: `README.md`)
- Administrators → Leave pages: review leave (evidence: `README.md`)
- Attendance pages → Attendance API: REST requests (evidence: `README.md`)
- Complaint pages → Complaint API: REST requests (evidence: `README.md`)
- Leave pages → Leave API: REST requests (evidence: `README.md`)
- Feedback page → Feedback API: REST requests (evidence: `README.md`)
- Attendance API → Attendance repository: reads and saves (evidence: `smart-campus-backend/src/main/java/com/smartcampus/controller/AttendanceController.java`)
- Complaint API → Complaint repository: reads and saves (evidence: `smart-campus-backend/src/main/java/com/smartcampus/controller/ComplaintController.java`)
- Leave API → Leave service: delegates leave (evidence: `smart-campus-backend/src/main/java/com/smartcampus/controller/LeaveController.java`)
- Leave service → Leave repository: reads and saves (evidence: `smart-campus-backend/src/main/java/com/smartcampus/service/LeaveService.java`)
- Feedback API → Feedback repository: uses repository (evidence: `smart-campus-backend/src/main/java/com/smartcampus/controller/FeedbackController.java`)
- Attendance service → Attendance repository: reads and saves (evidence: `smart-campus-backend/src/main/java/com/smartcampus/service/AttendanceService.java`)
- Complaint service → Complaint repository: reads and saves (evidence: `smart-campus-backend/src/main/java/com/smartcampus/service/ComplaintService.java`)
- Attendance repository → Attendance record: maps records (evidence: `smart-campus-backend/src/main/java/com/smartcampus/repository/AttendanceRepository.java`)
- Complaint repository → Complaint record: maps records (evidence: `smart-campus-backend/src/main/java/com/smartcampus/repository/ComplaintRepository.java`)
- Leave repository → Leave application: maps records (evidence: `smart-campus-backend/src/main/java/com/smartcampus/repository/LeaveRepository.java`)
- Feedback repository → Feedback record: maps records (evidence: `smart-campus-backend/src/main/java/com/smartcampus/controller/FeedbackController.java`)
- Attendance repository → PostgreSQL database: persists records
- Complaint repository → PostgreSQL database: persists records
- Leave repository → PostgreSQL database: persists records
- Feedback repository → PostgreSQL database: persists records
