# abhishekhulule9579/study-group-finder architecture

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

- Interactive diagram: https://gitdiagram.com/abhishekhulule9579/study-group-finder
- Repository: https://github.com/abhishekhulule9579/study-group-finder

## Overview

Study Group Finder is a full-stack platform for finding course peers and coordinating study groups. Students create accounts and academic profiles, enroll in courses, discover peers or groups, then collaborate through group messaging and scheduled sessions. The frontend routes users to these workflows; Spring controllers expose backend operations, with services implementing domain rules. The README documents MySQL persistence and email notifications. Source excerpts establish several backend calls, but most feature implementations and frontend API wiring were not sampled, so those links are omitted or shown as documented capabilities only.

Main entry points: [`frontend/src/App.jsx`](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/App.jsx) (App router), [`backend/src/main/java/com/studyGroup/backend/service/UserService.java`](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/UserService.java) (User accounts), [`backend/src/main/java/com/studyGroup/backend/service/GroupService.java`](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/GroupService.java) (Group rules), [`backend/src/main/java/com/studyGroup/backend/service/CalendarEventService.java`](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/CalendarEventService.java) (Event scheduling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App router<br/>[App.jsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_login["Authentication"]
  node_user_service["User accounts<br/>[UserService.java]"]
  node_jwt["JWT service<br/>[JWTService.java]"]
  node_profile["Profile management"]
  node_profile_model["Profile records<br/>[Profile.java]"]
end

subgraph group_discovery["Academic discovery"]
  node_course_ui["Course browsing<br/>[MyCourses.jsx]"]
  node_courses["Course management<br/>[CourseService.java]"]
  node_peer_ui["Peer discovery<br/>[FindPeers.jsx]"]
  node_dashboard["Dashboard"]
end

subgraph group_collaboration["Group collaboration"]
  node_group_ui["Group discovery<br/>[MyGroups.jsx]"]
  node_group_api["Group endpoints"]
  node_groups["Group rules<br/>[GroupService.java]"]
  node_group_model["Study groups<br/>[Group.java]"]
  node_group_chat["Group chat<br/>[GroupChat.jsx]"]
  node_chat_service["Messaging"]
end

subgraph group_coordination["Coordination"]
  node_calendar_ui["Session calendar<br/>[CalendarView.jsx]"]
  node_calendar_api["Calendar endpoints"]
  node_calendar["Event scheduling"]
  node_notifications["Notifications"]
end

node_student(("Student"))
node_mysql[("MySQL")]
node_smtp["Gmail SMTP"]

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_course_ui
node_app -->|"routes to"| node_peer_ui
node_app -->|"routes to"| node_group_ui
node_app -->|"renders"| node_group_chat
node_login -->|"delegates to"| node_user_service
node_user_service -->|"generates tokens"| node_jwt
node_user_service -->|"creates profile"| node_profile_model
node_profile -->|"updates"| node_profile_model
node_course_ui -.->|"browses and enrolls"| node_courses
node_peer_ui -.->|"finds classmates"| node_courses
node_app -->|"routes to"| node_dashboard
node_group_ui -.->|"manages groups"| node_group_api
node_group_api -->|"delegates to"| node_groups
node_groups -->|"manages"| node_group_model
node_group_chat -.->|"sends messages"| node_chat_service
node_app -.->|"routes to"| node_calendar_ui
node_calendar_ui -.->|"schedules sessions"| node_calendar_api
node_calendar_api -->|"delegates to"| node_calendar
node_calendar -->|"creates alerts"| node_notifications
node_calendar -.->|"emails reminders"| node_smtp
node_profile -.->|"persists data"| node_mysql
node_groups -.->|"persists groups"| node_mysql

click node_app "https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/controller/UserController.java"
click node_user_service "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/UserService.java"
click node_jwt "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/JWTService.java"
click node_profile "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/ProfileService.java"
click node_profile_model "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/model/Profile.java"
click node_course_ui "https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/MyCourses.jsx"
click node_courses "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/CourseService.java"
click node_peer_ui "https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/FindPeers.jsx"
click node_dashboard "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/DashboardService.java"
click node_group_ui "https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/MyGroups.jsx"
click node_group_api "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/controller/GroupController.java"
click node_groups "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/GroupService.java"
click node_group_model "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/model/Group.java"
click node_group_chat "https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/groups/GroupChat.jsx"
click node_chat_service "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/GroupMessageService.java"
click node_calendar_ui "https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/Calendar/CalendarView.jsx"
click node_calendar_api "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/controller/CalendarEventController.java"
click node_calendar "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/CalendarEventService.java"
click node_notifications "https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/NotificationService.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 toneBlue
class node_login,node_user_service,node_jwt,node_profile,node_profile_model,node_mysql toneAmber
class node_course_ui,node_courses,node_peer_ui,node_dashboard toneMint
class node_group_ui,node_group_api,node_groups,node_group_model,node_group_chat,node_chat_service toneRose
class node_calendar_ui,node_calendar_api,node_calendar,node_notifications,node_student,node_smtp toneIndigo
```

## Components

### Web client

- [App router](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Identity and profiles

- [Authentication](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/controller/UserController.java): `backend/src/main/java/com/studyGroup/backend/controller/UserController.java`
- [User accounts](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/UserService.java): `backend/src/main/java/com/studyGroup/backend/service/UserService.java`
- [JWT service](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/JWTService.java): `backend/src/main/java/com/studyGroup/backend/service/JWTService.java`
- [Profile management](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/ProfileService.java): `backend/src/main/java/com/studyGroup/backend/service/ProfileService.java`
- [Profile records](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/model/Profile.java): `backend/src/main/java/com/studyGroup/backend/model/Profile.java`

### Academic discovery

- [Course browsing](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/MyCourses.jsx): `frontend/src/components/MyCourses.jsx`
- [Course management](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/CourseService.java): `backend/src/main/java/com/studyGroup/backend/service/CourseService.java`
- [Peer discovery](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/FindPeers.jsx): `frontend/src/components/FindPeers.jsx`
- [Dashboard](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/DashboardService.java): `backend/src/main/java/com/studyGroup/backend/service/DashboardService.java`

### Group collaboration

- [Group discovery](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/MyGroups.jsx): `frontend/src/components/MyGroups.jsx`
- [Group endpoints](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/controller/GroupController.java): `backend/src/main/java/com/studyGroup/backend/controller/GroupController.java`
- [Group rules](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/GroupService.java): `backend/src/main/java/com/studyGroup/backend/service/GroupService.java`
- [Study groups](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/model/Group.java): `backend/src/main/java/com/studyGroup/backend/model/Group.java`
- [Group chat](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/groups/GroupChat.jsx): `frontend/src/components/groups/GroupChat.jsx`
- [Messaging](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/GroupMessageService.java): `backend/src/main/java/com/studyGroup/backend/service/GroupMessageService.java`

### Coordination

- [Session calendar](https://github.com/abhishekhulule9579/study-group-finder/blob/main/frontend/src/components/Calendar/CalendarView.jsx): `frontend/src/components/Calendar/CalendarView.jsx`
- [Calendar endpoints](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/controller/CalendarEventController.java): `backend/src/main/java/com/studyGroup/backend/controller/CalendarEventController.java`
- [Event scheduling](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/CalendarEventService.java): `backend/src/main/java/com/studyGroup/backend/service/CalendarEventService.java`
- [Notifications](https://github.com/abhishekhulule9579/study-group-finder/blob/main/backend/src/main/java/com/studyGroup/backend/service/NotificationService.java): `backend/src/main/java/com/studyGroup/backend/service/NotificationService.java`

### Other components

- **Student**
- **MySQL**
- **Gmail SMTP**

## Connections

- Student → App router: uses
- App router → Authentication: routes to (evidence: `frontend/src/App.jsx`)
- App router → Course browsing: routes to (evidence: `frontend/src/App.jsx`)
- App router → Peer discovery: routes to (evidence: `frontend/src/App.jsx`)
- App router → Group discovery: routes to (evidence: `frontend/src/App.jsx`)
- App router → Group chat: renders (evidence: `frontend/src/App.jsx`)
- Authentication → User accounts: delegates to (evidence: `backend/src/main/java/com/studyGroup/backend/controller/UserController.java`)
- User accounts → JWT service: generates tokens (evidence: `backend/src/main/java/com/studyGroup/backend/service/UserService.java`)
- User accounts → Profile records: creates profile (evidence: `backend/src/main/java/com/studyGroup/backend/service/UserService.java`)
- Profile management → Profile records: updates (evidence: `backend/src/main/java/com/studyGroup/backend/service/ProfileService.java`)
- Course browsing → Course management: browses and enrolls
- Peer discovery → Course management: finds classmates
- App router → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Group discovery → Group endpoints: manages groups
- Group endpoints → Group rules: delegates to (evidence: `backend/src/main/java/com/studyGroup/backend/controller/GroupController.java`)
- Group rules → Study groups: manages (evidence: `backend/src/main/java/com/studyGroup/backend/service/GroupService.java`)
- Group chat → Messaging: sends messages
- App router → Session calendar: routes to (evidence: `frontend/src/App.jsx`)
- Session calendar → Calendar endpoints: schedules sessions
- Calendar endpoints → Event scheduling: delegates to (evidence: `backend/src/main/java/com/studyGroup/backend/controller/CalendarEventController.java`)
- Event scheduling → Notifications: creates alerts (evidence: `backend/src/main/java/com/studyGroup/backend/service/CalendarEventService.java`)
- Event scheduling → Gmail SMTP: emails reminders
- Profile management → MySQL: persists data
- Group rules → MySQL: persists groups
