# aditi-sanghvi/cbit-club-connect architecture

> Architecture diagram of the GitHub repository aditi-sanghvi/cbit-club-connect, 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/aditi-sanghvi/cbit-club-connect
- Repository: https://github.com/aditi-sanghvi/cbit-club-connect

## Overview

ClubConnect is a Spring application for student and club event management. Users can sign up or log in; public users can browse clubs and events, then register for an event. Club and event management, attendance, and admin/user functions are also represented in the source tree. The graph separates API handling, domain records, and persistence interfaces. Several controllers and the static pages were not excerpted, so their detailed behavior and UI-to-endpoint connections are not inferred.

Main entry points: [`src/main/java/com/cbit/club_connect/clubconnect/Repository/ClubRepository.java`](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/ClubRepository.java) (Club repository), [`src/main/java/com/cbit/club_connect/clubconnect/Repository/EventRepository.java`](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/EventRepository.java) (Event repository), [`src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java`](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java) (Event registration), [`src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java`](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API controllers"]
  node_auth["Authentication"]
  node_public["Public browsing"]
  node_registration["Event registration"]
  node_events["Event management"]
  node_clubs["Club management"]
  node_attendance["Attendance handling"]
  node_admin["Admin functions"]
  node_pages["Page routing"]
  node_userctl["User endpoint"]
end

subgraph group_domain["Domain records"]
  node_user[("User record<br/>[User.java]")]
  node_club[("Club record<br/>[Club.java]")]
  node_event[("Event record<br/>[Event.java]")]
  node_registration_record[("Registration record<br/>[Registration.java]")]
  node_attendance_record[("Attendance record<br/>[Attendance.java]")]
end

subgraph group_persistence["Persistence"]
  node_userrepo["User repository"]
  node_clubrepo["Club repository"]
  node_eventrepo["Event repository"]
  node_registrationrepo["Registration repository"]
  node_attendancerepo["Attendance repository"]
end

node_browser(("Web user"))
node_staticpages["Static pages"]

node_browser -->|"submits credentials"| node_auth
node_auth -->|"reads and saves users"| node_userrepo
node_auth -->|"checks club login"| node_clubrepo
node_public -->|"lists clubs"| node_clubrepo
node_public -->|"reads events"| node_eventrepo
node_registration -->|"looks up event"| node_eventrepo
node_registration -->|"saves registration"| node_registrationrepo
node_events -->|"manages events"| node_eventrepo
node_events -->|"validates club"| node_clubrepo
node_attendance -->|"records attendance"| node_attendancerepo
node_admin -->|"manages users"| node_userrepo
node_userrepo -->|"persists"| node_user
node_clubrepo -->|"persists"| node_club
node_eventrepo -->|"persists"| node_event
node_registrationrepo -->|"persists"| node_registration_record
node_attendancerepo -->|"persists"| node_attendance_record
node_attendance_record -->|"references"| node_event
node_attendance_record -->|"references"| node_user
node_registration -->|"accepts page submissions"| node_staticpages

click node_auth "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java"
click node_public "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/PublicController.java"
click node_registration "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java"
click node_events "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/EventController.java"
click node_clubs "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/ClubController.java"
click node_attendance "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AttendanceController.java"
click node_admin "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AdminController.java"
click node_pages "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/PageController.java"
click node_userctl "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/UserController.java"
click node_user "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/User.java"
click node_club "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Club.java"
click node_event "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Event.java"
click node_registration_record "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Registration.java"
click node_attendance_record "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Attendance.java"
click node_userrepo "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/UserRepository.java"
click node_clubrepo "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/ClubRepository.java"
click node_eventrepo "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/EventRepository.java"
click node_registrationrepo "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/RegistrationRepository.java"
click node_attendancerepo "https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/AttendanceRepository.java"
click node_staticpages "https://github.com/aditi-sanghvi/cbit-club-connect/tree/main/src/main/resources/static"

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_auth,node_public,node_registration,node_events,node_clubs,node_attendance,node_admin,node_pages,node_userctl,node_browser toneBlue
class node_user,node_club,node_event,node_registration_record,node_attendance_record toneAmber
class node_userrepo,node_clubrepo,node_eventrepo,node_registrationrepo,node_attendancerepo toneMint
class node_staticpages toneTeal
```

## Components

### API controllers

- [Authentication](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java`
- [Public browsing](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/PublicController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/PublicController.java`
- [Event registration](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java`
- [Event management](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/EventController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/EventController.java`
- [Club management](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/ClubController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/ClubController.java`
- [Attendance handling](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AttendanceController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/AttendanceController.java`
- [Admin functions](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/AdminController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/AdminController.java`
- [Page routing](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/PageController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/PageController.java`
- [User endpoint](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/controller/UserController.java): `src/main/java/com/cbit/club_connect/clubconnect/controller/UserController.java`

### Domain records

- [User record](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/User.java): `src/main/java/com/cbit/club_connect/clubconnect/entity/User.java`
- [Club record](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Club.java): `src/main/java/com/cbit/club_connect/clubconnect/entity/Club.java`
- [Event record](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Event.java): `src/main/java/com/cbit/club_connect/clubconnect/entity/Event.java`
- [Registration record](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Registration.java): `src/main/java/com/cbit/club_connect/clubconnect/entity/Registration.java`
- [Attendance record](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/entity/Attendance.java): `src/main/java/com/cbit/club_connect/clubconnect/entity/Attendance.java`

### Persistence

- [User repository](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/UserRepository.java): `src/main/java/com/cbit/club_connect/clubconnect/Repository/UserRepository.java`
- [Club repository](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/ClubRepository.java): `src/main/java/com/cbit/club_connect/clubconnect/Repository/ClubRepository.java`
- [Event repository](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/EventRepository.java): `src/main/java/com/cbit/club_connect/clubconnect/Repository/EventRepository.java`
- [Registration repository](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/RegistrationRepository.java): `src/main/java/com/cbit/club_connect/clubconnect/Repository/RegistrationRepository.java`
- [Attendance repository](https://github.com/aditi-sanghvi/cbit-club-connect/blob/main/src/main/java/com/cbit/club_connect/clubconnect/Repository/AttendanceRepository.java): `src/main/java/com/cbit/club_connect/clubconnect/Repository/AttendanceRepository.java`

### Other components

- **Web user**
- [Static pages](https://github.com/aditi-sanghvi/cbit-club-connect/tree/main/src/main/resources/static): `src/main/resources/static`

## Connections

- Web user → Authentication: submits credentials (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java`)
- Authentication → User repository: reads and saves users (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java`)
- Authentication → Club repository: checks club login (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/AuthController.java`)
- Public browsing → Club repository: lists clubs (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/PublicController.java`)
- Public browsing → Event repository: reads events (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/PublicController.java`)
- Event registration → Event repository: looks up event (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java`)
- Event registration → Registration repository: saves registration (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java`)
- Event management → Event repository: manages events (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/EventController.java`)
- Event management → Club repository: validates club (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/EventController.java`)
- Attendance handling → Attendance repository: records attendance (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/AttendanceController.java`)
- Admin functions → User repository: manages users (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/AdminController.java`)
- User repository → User record: persists (evidence: `src/main/java/com/cbit/club_connect/clubconnect/Repository/UserRepository.java`)
- Club repository → Club record: persists (evidence: `src/main/java/com/cbit/club_connect/clubconnect/Repository/ClubRepository.java`)
- Event repository → Event record: persists (evidence: `src/main/java/com/cbit/club_connect/clubconnect/Repository/EventRepository.java`)
- Registration repository → Registration record: persists (evidence: `src/main/java/com/cbit/club_connect/clubconnect/Repository/RegistrationRepository.java`)
- Attendance repository → Attendance record: persists (evidence: `src/main/java/com/cbit/club_connect/clubconnect/Repository/AttendanceRepository.java`)
- Attendance record → Event record: references (evidence: `src/main/java/com/cbit/club_connect/clubconnect/entity/Attendance.java`)
- Attendance record → User record: references (evidence: `src/main/java/com/cbit/club_connect/clubconnect/entity/Attendance.java`)
- Event registration → Static pages: accepts page submissions (evidence: `src/main/java/com/cbit/club_connect/clubconnect/controller/RegistrationController.java`)
