# michaeljerin/campusverse architecture

> Architecture diagram of the GitHub repository michaeljerin/campusverse, 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/michaeljerin/campusverse
- Repository: https://github.com/michaeljerin/campusverse

## Overview

CampusVerse is a campus community platform spanning business discovery and reviews, peer-to-peer listings, mentorship matching, and account/profile features. The apparent user workflow is to browse or search a campus resource, then interact with it through actions such as reviewing a business, managing a listing, or requesting a match. The Java backend separates HTTP controllers, domain services, persistence repositories, and entity models; browser code provides the frontend. The README is empty, and several controllers and services were not sampled, so links for those areas are omitted rather than inferred.

Main entry points: [`campusverse/src/main/java/com/campusverse/repository/ReviewRepository.java`](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/repository/ReviewRepository.java) (Persistence repositories), [`frontend/js/api.js`](https://github.com/michaeljerin/campusverse/blob/main/frontend/js/api.js) (Browser interface), [`campusverse/src/main/java/com/campusverse/service/AuthService.java`](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/AuthService.java) (Registration and login), [`campusverse/src/main/java/com/campusverse/service/ReviewService.java`](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/ReviewService.java) (Business reviews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_web_ui["Browser interface<br/>[api.js]"]
  node_auth_ui["Authentication UI<br/>[auth.js]"]
  node_market_ui["Marketplace UI<br/>[listings.js]"]
  node_business_ui["Business UI<br/>[business-detail.js]"]
  node_mentor_ui["Mentorship UI<br/>[mentorship.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_controller["Authentication endpoint"]
  node_auth_service["Registration and login<br/>[AuthService.java]"]
  node_jwt["JWT generation<br/>[JwtService.java]"]
  node_profile["Profile management<br/>[UserService.java]"]
  node_user_details["User authentication lookup"]
end

subgraph group_commerce["Campus discovery"]
  node_business_api["Business endpoints"]
  node_business_service["Business discovery"]
  node_business_reviews["Business reviews<br/>[ReviewService.java]"]
  node_listing_api["Listing endpoints"]
  node_listing_service["Listings and search"]
  node_saved_search["Saved searches"]
end

subgraph group_community["Community interactions"]
  node_mentorship["Mentorship matching"]
  node_notifications["Notification feed"]
end

subgraph group_backend["Backend foundations"]
  node_domain_models["Domain entities<br/>[Business.java]"]
  node_api_contracts["API data contracts"]
  node_repositories["Persistence repositories"]
  node_database[("Relational database")]
  node_exception_handler["API error handling"]
end

node_campus_user(("Campus user"))

node_campus_user -.->|"uses"| node_web_ui
node_web_ui -.->|"requests"| node_auth_controller
node_auth_controller -.->|"delegates"| node_auth_service
node_auth_service -->|"generates token"| node_jwt
node_auth_service -->|"uses user repository"| node_repositories
node_user_details -->|"loads user"| node_repositories
node_business_api -->|"delegates"| node_business_service
node_business_service -->|"queries businesses and reviews"| node_repositories
node_business_ui -.->|"uses API client"| node_web_ui
node_listing_api -->|"delegates"| node_listing_service
node_listing_service -->|"queries listings"| node_repositories
node_business_reviews -->|"reads and saves reviews"| node_repositories
node_business_reviews -->|"loads businesses"| node_repositories
node_saved_search -->|"stores searches"| node_repositories
node_mentorship -.->|"uses match repository"| node_repositories
node_notifications -->|"reads feed sources"| node_repositories
node_repositories -.->|"persists entities"| node_database
node_mentor_ui -.->|"uses API client"| node_web_ui

click node_web_ui "https://github.com/michaeljerin/campusverse/blob/main/frontend/js/api.js"
click node_auth_ui "https://github.com/michaeljerin/campusverse/blob/main/frontend/js/auth.js"
click node_market_ui "https://github.com/michaeljerin/campusverse/blob/main/frontend/js/listings.js"
click node_business_ui "https://github.com/michaeljerin/campusverse/blob/main/frontend/js/business-detail.js"
click node_mentor_ui "https://github.com/michaeljerin/campusverse/blob/main/frontend/js/mentorship.js"
click node_auth_controller "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/controller/AuthController.java"
click node_auth_service "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/AuthService.java"
click node_jwt "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/config/JwtService.java"
click node_profile "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/UserService.java"
click node_user_details "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/config/CustomUserDetailsService.java"
click node_business_api "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/controller/BusinessController.java"
click node_business_service "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/BusinessService.java"
click node_business_reviews "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/ReviewService.java"
click node_listing_api "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/controller/ListingController.java"
click node_listing_service "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/ListingService.java"
click node_saved_search "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/SavedSearchService.java"
click node_mentorship "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/MatchRequestService.java"
click node_notifications "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/NotificationService.java"
click node_domain_models "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/model/Business.java"
click node_api_contracts "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/dto/ListingRequest.java"
click node_repositories "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/repository/ReviewRepository.java"
click node_exception_handler "https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/exception/GlobalExceptionHandler.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_web_ui,node_auth_ui,node_market_ui,node_business_ui,node_mentor_ui,node_campus_user toneBlue
class node_auth_controller,node_auth_service,node_jwt,node_profile,node_user_details toneAmber
class node_business_api,node_business_service,node_business_reviews,node_listing_api,node_listing_service,node_saved_search toneMint
class node_mentorship,node_notifications toneRose
class node_domain_models,node_api_contracts,node_repositories,node_database,node_exception_handler toneIndigo
```

## Components

### Browser client

- [Browser interface](https://github.com/michaeljerin/campusverse/blob/main/frontend/js/api.js): `frontend/js/api.js`
- [Authentication UI](https://github.com/michaeljerin/campusverse/blob/main/frontend/js/auth.js): `frontend/js/auth.js`
- [Marketplace UI](https://github.com/michaeljerin/campusverse/blob/main/frontend/js/listings.js): `frontend/js/listings.js`
- [Business UI](https://github.com/michaeljerin/campusverse/blob/main/frontend/js/business-detail.js): `frontend/js/business-detail.js`
- [Mentorship UI](https://github.com/michaeljerin/campusverse/blob/main/frontend/js/mentorship.js): `frontend/js/mentorship.js`

### Identity and profiles

- [Authentication endpoint](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/controller/AuthController.java): `campusverse/src/main/java/com/campusverse/controller/AuthController.java`
- [Registration and login](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/AuthService.java): `campusverse/src/main/java/com/campusverse/service/AuthService.java`
- [JWT generation](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/config/JwtService.java): `campusverse/src/main/java/com/campusverse/config/JwtService.java`
- [Profile management](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/UserService.java): `campusverse/src/main/java/com/campusverse/service/UserService.java`
- [User authentication lookup](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/config/CustomUserDetailsService.java): `campusverse/src/main/java/com/campusverse/config/CustomUserDetailsService.java`

### Campus discovery

- [Business endpoints](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/controller/BusinessController.java): `campusverse/src/main/java/com/campusverse/controller/BusinessController.java`
- [Business discovery](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/BusinessService.java): `campusverse/src/main/java/com/campusverse/service/BusinessService.java`
- [Business reviews](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/ReviewService.java): `campusverse/src/main/java/com/campusverse/service/ReviewService.java`
- [Listing endpoints](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/controller/ListingController.java): `campusverse/src/main/java/com/campusverse/controller/ListingController.java`
- [Listings and search](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/ListingService.java): `campusverse/src/main/java/com/campusverse/service/ListingService.java`
- [Saved searches](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/SavedSearchService.java): `campusverse/src/main/java/com/campusverse/service/SavedSearchService.java`

### Community interactions

- [Mentorship matching](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/MatchRequestService.java): `campusverse/src/main/java/com/campusverse/service/MatchRequestService.java`
- [Notification feed](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/service/NotificationService.java): `campusverse/src/main/java/com/campusverse/service/NotificationService.java`

### Backend foundations

- [Domain entities](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/model/Business.java): `campusverse/src/main/java/com/campusverse/model/Business.java`
- [API data contracts](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/dto/ListingRequest.java): `campusverse/src/main/java/com/campusverse/dto/ListingRequest.java`
- [Persistence repositories](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/repository/ReviewRepository.java): `campusverse/src/main/java/com/campusverse/repository/ReviewRepository.java`
- **Relational database**
- [API error handling](https://github.com/michaeljerin/campusverse/blob/main/campusverse/src/main/java/com/campusverse/exception/GlobalExceptionHandler.java): `campusverse/src/main/java/com/campusverse/exception/GlobalExceptionHandler.java`

### Other components

- **Campus user**

## Connections

- Campus user → Browser interface: uses
- Browser interface → Authentication endpoint: requests
- Authentication endpoint → Registration and login: delegates
- Registration and login → JWT generation: generates token (evidence: `campusverse/src/main/java/com/campusverse/service/AuthService.java`)
- Registration and login → Persistence repositories: uses user repository (evidence: `campusverse/src/main/java/com/campusverse/service/AuthService.java`)
- User authentication lookup → Persistence repositories: loads user (evidence: `campusverse/src/main/java/com/campusverse/config/CustomUserDetailsService.java`)
- Business endpoints → Business discovery: delegates (evidence: `campusverse/src/main/java/com/campusverse/controller/BusinessController.java`)
- Business discovery → Persistence repositories: queries businesses and reviews (evidence: `campusverse/src/main/java/com/campusverse/service/BusinessService.java`)
- Business UI → Browser interface: uses API client
- Listing endpoints → Listings and search: delegates (evidence: `campusverse/src/main/java/com/campusverse/controller/ListingController.java`)
- Listings and search → Persistence repositories: queries listings (evidence: `campusverse/src/main/java/com/campusverse/service/ListingService.java`)
- Business reviews → Persistence repositories: reads and saves reviews (evidence: `campusverse/src/main/java/com/campusverse/service/ReviewService.java`)
- Business reviews → Persistence repositories: loads businesses (evidence: `campusverse/src/main/java/com/campusverse/service/ReviewService.java`)
- Saved searches → Persistence repositories: stores searches (evidence: `campusverse/src/main/java/com/campusverse/service/SavedSearchService.java`)
- Mentorship matching → Persistence repositories: uses match repository
- Notification feed → Persistence repositories: reads feed sources (evidence: `campusverse/src/main/java/com/campusverse/service/NotificationService.java`)
- Persistence repositories → Relational database: persists entities
- Mentorship UI → Browser interface: uses API client
