# xarveth/campushelp architecture

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

- Interactive diagram: https://gitdiagram.com/xarveth/campushelp
- Repository: https://github.com/xarveth/campushelp

## Overview

CampusHelp is a student grievance web application: students register, submit categorized complaints, and track status/history; administrators review complaints, search and filter them, view dashboard reports, and change status. React pages call a Spring Boot API; its services enforce ownership and coordinate complaint, account, and status-history persistence in MySQL. The main workflow and capabilities are documented in the README; some backend and frontend links are supported only by the SOURCE INDEX, so unsampled behavior is not expanded beyond those references.

Main entry points: [`frontend/src/api.js`](https://github.com/xarveth/campushelp/blob/main/frontend/src/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/xarveth/campushelp/blob/main/frontend/src/App.jsx) (App routes), [`backend/src/main/java/com/campushelp/repository/ComplaintRepository.java`](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/repository/ComplaintRepository.java) (JPA repositories), [`backend/src/main/java/com/campushelp/service/ComplaintService.java`](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/ComplaintService.java) (Complaint lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student and Admin UI"]
  node_student["Student dashboard"]
  node_admin["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_detail["Complaint detail"]
  node_login["Login and register<br/>[Login.jsx]"]
  node_router["App routes<br/>[App.jsx]"]
  node_client["API client<br/>[api.js]"]
end

subgraph group_api["API and Security"]
  node_authctl["Auth endpoints"]
  node_complaintctl["Complaint endpoints"]
  node_adminctl["Admin endpoints"]
  node_categoryctl["Category endpoints"]
  node_security["JWT security<br/>[JwtFilter.java]"]
end

subgraph group_domain["Complaint and Account Services"]
  node_authsvc["Authentication<br/>[AuthService.java]"]
  node_complaintsvc["Complaint lifecycle"]
  node_adminsvc["Admin reporting<br/>[AdminService.java]"]
  node_models["Domain records<br/>[Complaint.java]"]
end

subgraph group_data["Persistence"]
  node_repositories["JPA repositories"]
  node_mysql[("MySQL database<br/>[schema.sql]")]
end

node_studentactor(("Student"))
node_adminactor(("Administrator"))

node_studentactor -->|"uses"| node_router
node_adminactor -->|"uses"| node_router
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_student
node_router -->|"routes to"| node_admin
node_router -->|"routes to"| node_detail
node_login -->|"requests through"| node_client
node_student -->|"requests through"| node_client
node_admin -->|"requests through"| node_client
node_detail -->|"requests through"| node_client
node_client -->|"calls API"| node_authctl
node_client -->|"calls API"| node_complaintctl
node_client -->|"calls API"| node_adminctl
node_client -->|"calls API"| node_categoryctl
node_authctl -->|"delegates to"| node_authsvc
node_complaintctl -->|"delegates to"| node_complaintsvc
node_adminctl -->|"delegates to"| node_adminsvc
node_adminctl -->|"delegates to"| node_complaintsvc
node_categoryctl -->|"reads categories"| node_repositories
node_authsvc -->|"reads and writes"| node_repositories
node_complaintsvc -->|"reads and writes"| node_repositories
node_adminsvc -->|"queries and updates"| node_repositories
node_adminsvc -->|"formats responses"| node_complaintsvc
node_authsvc -->|"issues JWT"| node_security
node_security -->|"loads user"| node_repositories
node_repositories -.->|"persists data"| node_mysql
node_complaintsvc -->|"builds complaints"| node_models
node_adminsvc -->|"updates status"| node_models

click node_student "https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/StudentDashboard.jsx"
click node_admin "https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_detail "https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/ComplaintDetail.jsx"
click node_login "https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/Login.jsx"
click node_router "https://github.com/xarveth/campushelp/blob/main/frontend/src/App.jsx"
click node_client "https://github.com/xarveth/campushelp/blob/main/frontend/src/api.js"
click node_authctl "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/AuthController.java"
click node_complaintctl "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/ComplaintController.java"
click node_adminctl "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/AdminController.java"
click node_categoryctl "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/CategoryController.java"
click node_security "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/security/JwtFilter.java"
click node_authsvc "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/AuthService.java"
click node_complaintsvc "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/ComplaintService.java"
click node_adminsvc "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/AdminService.java"
click node_models "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/entity/Complaint.java"
click node_repositories "https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/repository/ComplaintRepository.java"
click node_mysql "https://github.com/xarveth/campushelp/blob/main/database/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_student,node_admin,node_detail,node_login,node_router,node_client toneBlue
class node_authctl,node_complaintctl,node_adminctl,node_categoryctl,node_security toneAmber
class node_authsvc,node_complaintsvc,node_adminsvc,node_models toneMint
class node_repositories,node_mysql toneRose
class node_studentactor,node_adminactor toneIndigo
```

## Components

### Student and Admin UI

- [Student dashboard](https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/StudentDashboard.jsx): `frontend/src/pages/StudentDashboard.jsx`
- [Admin dashboard](https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Complaint detail](https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/ComplaintDetail.jsx): `frontend/src/pages/ComplaintDetail.jsx`
- [Login and register](https://github.com/xarveth/campushelp/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [App routes](https://github.com/xarveth/campushelp/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/xarveth/campushelp/blob/main/frontend/src/api.js): `frontend/src/api.js`

### API and Security

- [Auth endpoints](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/AuthController.java): `backend/src/main/java/com/campushelp/controller/AuthController.java`
- [Complaint endpoints](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/ComplaintController.java): `backend/src/main/java/com/campushelp/controller/ComplaintController.java`
- [Admin endpoints](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/AdminController.java): `backend/src/main/java/com/campushelp/controller/AdminController.java`
- [Category endpoints](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/controller/CategoryController.java): `backend/src/main/java/com/campushelp/controller/CategoryController.java`
- [JWT security](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/security/JwtFilter.java): `backend/src/main/java/com/campushelp/security/JwtFilter.java`

### Complaint and Account Services

- [Authentication](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/AuthService.java): `backend/src/main/java/com/campushelp/service/AuthService.java`
- [Complaint lifecycle](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/ComplaintService.java): `backend/src/main/java/com/campushelp/service/ComplaintService.java`
- [Admin reporting](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/service/AdminService.java): `backend/src/main/java/com/campushelp/service/AdminService.java`
- [Domain records](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/entity/Complaint.java): `backend/src/main/java/com/campushelp/entity/Complaint.java`

### Persistence

- [JPA repositories](https://github.com/xarveth/campushelp/blob/main/backend/src/main/java/com/campushelp/repository/ComplaintRepository.java): `backend/src/main/java/com/campushelp/repository/ComplaintRepository.java`
- [MySQL database](https://github.com/xarveth/campushelp/blob/main/database/schema.sql): `database/schema.sql`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → App routes: uses (evidence: `README.md`)
- Administrator → App routes: uses (evidence: `README.md`)
- App routes → Login and register: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Student dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Complaint detail: routes to (evidence: `frontend/src/App.jsx`)
- Login and register → API client: requests through (evidence: `frontend/src/pages/Login.jsx`)
- Student dashboard → API client: requests through (evidence: `frontend/src/pages/StudentDashboard.jsx`)
- Admin dashboard → API client: requests through (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Complaint detail → API client: requests through (evidence: `frontend/src/pages/ComplaintDetail.jsx`)
- API client → Auth endpoints: calls API (evidence: `README.md`)
- API client → Complaint endpoints: calls API (evidence: `README.md`)
- API client → Admin endpoints: calls API (evidence: `README.md`)
- API client → Category endpoints: calls API (evidence: `README.md`)
- Auth endpoints → Authentication: delegates to (evidence: `backend/src/main/java/com/campushelp/controller/AuthController.java`)
- Complaint endpoints → Complaint lifecycle: delegates to (evidence: `backend/src/main/java/com/campushelp/controller/ComplaintController.java`)
- Admin endpoints → Admin reporting: delegates to (evidence: `backend/src/main/java/com/campushelp/controller/AdminController.java`)
- Admin endpoints → Complaint lifecycle: delegates to (evidence: `backend/src/main/java/com/campushelp/controller/AdminController.java`)
- Category endpoints → JPA repositories: reads categories (evidence: `backend/src/main/java/com/campushelp/controller/CategoryController.java`)
- Authentication → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/campushelp/service/AuthService.java`)
- Complaint lifecycle → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/campushelp/service/ComplaintService.java`)
- Admin reporting → JPA repositories: queries and updates (evidence: `backend/src/main/java/com/campushelp/service/AdminService.java`)
- Admin reporting → Complaint lifecycle: formats responses (evidence: `backend/src/main/java/com/campushelp/service/AdminService.java`)
- Authentication → JWT security: issues JWT (evidence: `backend/src/main/java/com/campushelp/service/AuthService.java`)
- JWT security → JPA repositories: loads user (evidence: `backend/src/main/java/com/campushelp/security/JwtFilter.java`)
- JPA repositories → MySQL database: persists data (evidence: `README.md`)
- Complaint lifecycle → Domain records: builds complaints (evidence: `backend/src/main/java/com/campushelp/service/ComplaintService.java`)
- Admin reporting → Domain records: updates status (evidence: `backend/src/main/java/com/campushelp/service/AdminService.java`)
