# bragee7/capstone- architecture

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

- Interactive diagram: https://gitdiagram.com/bragee7/capstone-
- Repository: https://github.com/bragee7/capstone-

## Overview

CampusHire is a campus hiring platform: students authenticate, complete profiles, discover published drives, apply, and track or withdraw applications; recruiters maintain company profiles, manage drive publication, and review candidates. The React routes call a JWT-secured Spring REST API, whose services enforce domain rules and use repositories backed by MySQL. The README also documents role-based admin monitoring and Swagger. Edges are limited to relationships shown in sampled sources or explicitly documented; unsampled capability details are represented without speculative internal calls.

Main entry points: [`backend/src/main/java/com/campushire/controller`](https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/controller) (REST endpoints), [`frontend/src/App.jsx`](https://github.com/bragee7/capstone-/blob/main/frontend/src/App.jsx) (Routes and pages), [`backend/src/main/java/com/campushire/repository`](https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/repository) (JPA repositories), [`frontend/src/lib/api.js`](https://github.com/bragee7/capstone-/blob/main/frontend/src/lib/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Routes and pages<br/>[App.jsx]"]
  node_authui["Auth context<br/>[AuthContext.jsx]"]
  node_apiclient["API client<br/>[api.js]"]
  node_studentui["Student pages"]
  node_recruiterui["Recruiter pages"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_security["API security"]
end

subgraph group_hiring["Hiring workflows"]
  node_studentprofile["Student profiles"]
  node_companyprofile["Company profiles"]
  node_drives["Drive lifecycle<br/>[DriveService.java]"]
  node_applications["Applications"]
  node_controllers["REST endpoints"]
end

subgraph group_domain["Domain and persistence"]
  node_entities["Hiring records"]
  node_repositories["JPA repositories"]
  node_mysql[("MySQL")]
  node_errors["API error handling"]
  node_swagger["OpenAPI docs<br/>[OpenApiConfig.java]"]
end

node_student(("Students"))
node_recruiter(("Recruiters"))
node_admin(("Admins"))

node_student -->|"uses"| node_app
node_recruiter -->|"uses"| node_app
node_admin -.->|"monitors"| node_controllers
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_studentui
node_app -->|"routes to"| node_recruiterui
node_authui -->|"calls"| node_apiclient
node_studentui -->|"calls"| node_apiclient
node_recruiterui -->|"calls"| node_apiclient
node_apiclient -->|"requests API"| node_controllers
node_controllers -->|"delegates auth"| node_authservice
node_authservice -->|"issues token"| node_jwt
node_controllers -->|"delegates drives"| node_drives
node_controllers -->|"delegates applications"| node_applications
node_controllers -.->|"delegates profile"| node_studentprofile
node_controllers -.->|"delegates profile"| node_companyprofile
node_authservice -->|"persists accounts"| node_repositories
node_studentprofile -->|"reads and writes"| node_repositories
node_drives -->|"reads and writes"| node_repositories
node_applications -->|"reads and writes"| node_repositories
node_repositories -->|"stores records"| node_mysql
node_drives -->|"uses records"| node_entities
node_applications -->|"checks eligibility"| node_entities
node_security -.->|"validates tokens"| node_jwt
node_controllers -.->|"formats failures"| node_errors
node_swagger -->|"documents API"| node_controllers

click node_app "https://github.com/bragee7/capstone-/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/bragee7/capstone-/blob/main/frontend/src/context/AuthContext.jsx"
click node_apiclient "https://github.com/bragee7/capstone-/blob/main/frontend/src/lib/api.js"
click node_studentui "https://github.com/bragee7/capstone-/tree/main/frontend/src/pages/student"
click node_recruiterui "https://github.com/bragee7/capstone-/tree/main/frontend/src/pages/recruiter"
click node_authcontroller "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/controller/AuthController.java"
click node_authservice "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/AuthService.java"
click node_jwt "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/security/JwtService.java"
click node_security "https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/security"
click node_studentprofile "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/StudentService.java"
click node_companyprofile "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/CompanyService.java"
click node_drives "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/DriveService.java"
click node_applications "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/ApplicationService.java"
click node_controllers "https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/controller"
click node_entities "https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/model/entity"
click node_repositories "https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/repository"
click node_errors "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/exception/GlobalExceptionHandler.java"
click node_swagger "https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/config/OpenApiConfig.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_app,node_authui,node_apiclient,node_studentui,node_recruiterui toneBlue
class node_authcontroller,node_authservice,node_jwt,node_security toneAmber
class node_studentprofile,node_companyprofile,node_drives,node_applications,node_controllers toneMint
class node_entities,node_repositories,node_mysql,node_errors,node_swagger toneRose
class node_student,node_recruiter,node_admin toneIndigo
```

## Components

### Web experience

- [Routes and pages](https://github.com/bragee7/capstone-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth context](https://github.com/bragee7/capstone-/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/bragee7/capstone-/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`
- [Student pages](https://github.com/bragee7/capstone-/tree/main/frontend/src/pages/student): `frontend/src/pages/student`
- [Recruiter pages](https://github.com/bragee7/capstone-/tree/main/frontend/src/pages/recruiter): `frontend/src/pages/recruiter`

### Identity and access

- [Auth endpoints](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/controller/AuthController.java): `backend/src/main/java/com/campushire/controller/AuthController.java`
- [Auth service](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/AuthService.java): `backend/src/main/java/com/campushire/service/AuthService.java`
- [JWT service](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/security/JwtService.java): `backend/src/main/java/com/campushire/security/JwtService.java`
- [API security](https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/security): `backend/src/main/java/com/campushire/security`

### Hiring workflows

- [Student profiles](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/StudentService.java): `backend/src/main/java/com/campushire/service/StudentService.java`
- [Company profiles](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/CompanyService.java): `backend/src/main/java/com/campushire/service/CompanyService.java`
- [Drive lifecycle](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/DriveService.java): `backend/src/main/java/com/campushire/service/DriveService.java`
- [Applications](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/service/ApplicationService.java): `backend/src/main/java/com/campushire/service/ApplicationService.java`
- [REST endpoints](https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/controller): `backend/src/main/java/com/campushire/controller`

### Domain and persistence

- [Hiring records](https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/model/entity): `backend/src/main/java/com/campushire/model/entity`
- [JPA repositories](https://github.com/bragee7/capstone-/tree/main/backend/src/main/java/com/campushire/repository): `backend/src/main/java/com/campushire/repository`
- **MySQL**
- [API error handling](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/exception/GlobalExceptionHandler.java): `backend/src/main/java/com/campushire/exception/GlobalExceptionHandler.java`
- [OpenAPI docs](https://github.com/bragee7/capstone-/blob/main/backend/src/main/java/com/campushire/config/OpenApiConfig.java): `backend/src/main/java/com/campushire/config/OpenApiConfig.java`

### Other components

- **Students**
- **Recruiters**
- **Admins**

## Connections

- Students → Routes and pages: uses (evidence: `frontend/src/App.jsx`)
- Recruiters → Routes and pages: uses (evidence: `frontend/src/App.jsx`)
- Admins → REST endpoints: monitors (evidence: `README.md`)
- Routes and pages → Auth context: provides auth (evidence: `frontend/src/App.jsx`)
- Routes and pages → Student pages: routes to (evidence: `frontend/src/App.jsx`)
- Routes and pages → Recruiter pages: routes to (evidence: `frontend/src/App.jsx`)
- Auth context → API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Student pages → API client: calls (evidence: `README.md`)
- Recruiter pages → API client: calls (evidence: `frontend/src/pages/recruiter/DriveFormPage.jsx`)
- API client → REST endpoints: requests API (evidence: `README.md`)
- REST endpoints → Auth service: delegates auth (evidence: `backend/src/main/java/com/campushire/controller/AuthController.java`)
- Auth service → JWT service: issues token (evidence: `backend/src/main/java/com/campushire/service/AuthService.java`)
- REST endpoints → Drive lifecycle: delegates drives (evidence: `backend/src/main/java/com/campushire/controller/RecruiterDriveController.java`)
- REST endpoints → Applications: delegates applications (evidence: `backend/src/main/java/com/campushire/controller/RecruiterDriveController.java`)
- REST endpoints → Student profiles: delegates profile (evidence: `backend/src/main/java/com/campushire/controller/StudentController.java`)
- REST endpoints → Company profiles: delegates profile
- Auth service → JPA repositories: persists accounts (evidence: `backend/src/main/java/com/campushire/service/AuthService.java`)
- Student profiles → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/campushire/service/StudentService.java`)
- Drive lifecycle → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/campushire/service/DriveService.java`)
- Applications → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/campushire/service/ApplicationService.java`)
- JPA repositories → MySQL: stores records (evidence: `README.md`)
- Drive lifecycle → Hiring records: uses records (evidence: `backend/src/main/java/com/campushire/service/DriveService.java`)
- Applications → Hiring records: checks eligibility (evidence: `backend/src/main/java/com/campushire/service/ApplicationService.java`)
- API security → JWT service: validates tokens (evidence: `backend/src/main/java/com/campushire/security/JwtService.java`)
- REST endpoints → API error handling: formats failures
- OpenAPI docs → REST endpoints: documents API (evidence: `README.md`)
