# acm-alexandria/acm-alexandria-chapter-official-website architecture

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

- Interactive diagram: https://gitdiagram.com/acm-alexandria/acm-alexandria-chapter-official-website
- Repository: https://github.com/acm-alexandria/acm-alexandria-chapter-official-website

## Overview

This is the official ACM Alexandria Chapter website: a React client backed by a Spring Boot API for chapter information, registrations, account access, and administration. Visitors browse events, clubs, and programs and submit registrations; administrators manage content and review registrations. The README also documents radio, organizational visualizations, subscriptions, media uploads, Sheets/Drive exports, and email notifications, so these remain represented despite limited source excerpts. Edges are limited to excerpted calls, indexed references, and documented capabilities; some feature-to-integration wiring is therefore omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/App.jsx) (Route application), [`backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/entity/Event.java`](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/entity/Event.java) (Application database), [`backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java`](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java) (Club management), [`backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java`](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java) (Event management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_app["Route application<br/>[App.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminPage.jsx]"]
  node_adminapi["Admin API client<br/>[adminService.js]"]
  node_authui["Authentication client<br/>[authService.js]"]
end

subgraph group_identity["Identity and access"]
  node_authcontrollers["Auth endpoints"]
  node_userservice["User accounts<br/>[UserService.java]"]
  node_user[("User record<br/>[User.java]")]
  node_security["JWT security<br/>[JwtFilter.java]"]
end

subgraph group_chapter["Chapter features"]
  node_events["Event management<br/>[EventService.java]"]
  node_clubs["Club management<br/>[ClubService.java]"]
  node_registrations["Registration workflows"]
  node_programs["Programs"]
  node_committees["Committees and boards"]
  node_radio["Radio and podcasts<br/>[RadioService.java]"]
  node_subscriptions["Subscriptions"]
  node_content["Chapter content"]
end

subgraph group_operations["Administration and integrations"]
  node_sheets["Sheets export"]
  node_email["Email delivery"]
  node_cloudinary["Cloudinary media"]
  node_database[("Application database<br/>[Event.java]")]
end

node_visitor(("Visitor"))
node_admin(("Administrator"))
node_google["Google Sheets and Drive"]
node_smtp["Gmail SMTP"]
node_cloudinarysvc["Cloudinary service"]

node_visitor -->|"browses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_adminui
node_adminui -.->|"requests data"| node_adminapi
node_adminapi -->|"HTTP requests"| node_events
node_adminapi -->|"HTTP requests"| node_clubs
node_visitor -->|"signs in"| node_authui
node_authui -.->|"HTTP requests"| node_authcontrollers
node_authcontrollers -.->|"delegates"| node_userservice
node_userservice -.->|"manages accounts"| node_user
node_app -.->|"browses events"| node_events
node_app -.->|"browses programs"| node_programs
node_app -.->|"browses radio"| node_radio
node_visitor -->|"submits registration"| node_registrations
node_events -.->|"reads and writes"| node_database
node_clubs -.->|"reads and writes"| node_database
node_events -->|"exports registrations"| node_sheets
node_clubs -->|"exports registrations"| node_sheets
node_sheets -->|"synchronizes"| node_google
node_subscriptions -->|"sends notifications"| node_email
node_clubs -->|"notifies subscribers"| node_subscriptions
node_email -->|"delivers mail"| node_smtp
node_content -.->|"uploads media"| node_cloudinary
node_cloudinary -->|"stores media"| node_cloudinarysvc
node_security -.->|"guards requests"| node_authcontrollers
node_committees -.->|"manages chapter structure"| node_database
node_programs -.->|"manages programs"| node_database
node_radio -.->|"manages episodes"| node_database
node_registrations -.->|"stores submissions"| node_database

click node_app "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/App.jsx"
click node_adminui "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/pages/AdminPage.jsx"
click node_adminapi "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/services/adminService.js"
click node_authui "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/services/authService.js"
click node_authcontrollers "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/controller/AuthController.java"
click node_userservice "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/service/UserService.java"
click node_user "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/entity/User.java"
click node_security "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/core/config/JwtFilter.java"
click node_events "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java"
click node_clubs "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java"
click node_registrations "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/RegistrationService.java"
click node_programs "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ProgramService.java"
click node_committees "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/controller/CommitteeController.java"
click node_radio "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/RadioService.java"
click node_subscriptions "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/SubscriptionService.java"
click node_content "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/controller/GalleryController.java"
click node_sheets "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/GoogleSheetsService.java"
click node_email "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/core/service/impl/GmailEmailService.java"
click node_cloudinary "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ImageUploadService.java"
click node_database "https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/entity/Event.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_adminui,node_adminapi,node_authui toneBlue
class node_authcontrollers,node_userservice,node_user,node_security toneAmber
class node_events,node_clubs,node_registrations,node_programs,node_committees,node_radio,node_subscriptions,node_content toneMint
class node_sheets,node_email,node_cloudinary,node_database toneRose
class node_visitor,node_admin,node_google,node_smtp,node_cloudinarysvc toneIndigo
```

## Components

### Web client

- [Route application](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Admin dashboard](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/pages/AdminPage.jsx): `frontend/src/pages/AdminPage.jsx`
- [Admin API client](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/services/adminService.js): `frontend/src/services/adminService.js`
- [Authentication client](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`

### Identity and access

- [Auth endpoints](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/controller/AuthController.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/controller/AuthController.java`
- [User accounts](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/service/UserService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/service/UserService.java`
- [User record](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/entity/User.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/entity/User.java`
- [JWT security](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/core/config/JwtFilter.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/core/config/JwtFilter.java`

### Chapter features

- [Event management](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java`
- [Club management](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java`
- [Registration workflows](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/RegistrationService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/RegistrationService.java`
- [Programs](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ProgramService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ProgramService.java`
- [Committees and boards](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/controller/CommitteeController.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/controller/CommitteeController.java`
- [Radio and podcasts](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/RadioService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/RadioService.java`
- [Subscriptions](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/SubscriptionService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/SubscriptionService.java`
- [Chapter content](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/controller/GalleryController.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/controller/GalleryController.java`

### Administration and integrations

- [Sheets export](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/GoogleSheetsService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/GoogleSheetsService.java`
- [Email delivery](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/core/service/impl/GmailEmailService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/core/service/impl/GmailEmailService.java`
- [Cloudinary media](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ImageUploadService.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ImageUploadService.java`
- [Application database](https://github.com/acm-alexandria/acm-alexandria-chapter-official-website/blob/main/backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/entity/Event.java): `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/entity/Event.java`

### Other components

- **Visitor**
- **Administrator**
- **Google Sheets and Drive**
- **Gmail SMTP**
- **Cloudinary service**

## Connections

- Visitor → Route application: browses (evidence: `README.md`)
- Administrator → Route application: uses (evidence: `README.md`)
- Route application → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Admin dashboard → Admin API client: requests data
- Admin API client → Event management: HTTP requests (evidence: `frontend/src/services/adminService.js`)
- Admin API client → Club management: HTTP requests (evidence: `frontend/src/services/adminService.js`)
- Visitor → Authentication client: signs in (evidence: `README.md`)
- Authentication client → Auth endpoints: HTTP requests
- Auth endpoints → User accounts: delegates (evidence: `backend/acmwebsite/src/main/java/com/acm/acmwebsite/User_Authentication/controller/AuthController.java`)
- User accounts → User record: manages accounts
- Route application → Event management: browses events
- Route application → Programs: browses programs
- Route application → Radio and podcasts: browses radio
- Visitor → Registration workflows: submits registration (evidence: `README.md`)
- Event management → Application database: reads and writes (evidence: `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java`)
- Club management → Application database: reads and writes
- Event management → Sheets export: exports registrations (evidence: `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/EventService.java`)
- Club management → Sheets export: exports registrations (evidence: `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java`)
- Sheets export → Google Sheets and Drive: synchronizes (evidence: `README.md`)
- Subscriptions → Email delivery: sends notifications (evidence: `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/SubscriptionService.java`)
- Club management → Subscriptions: notifies subscribers (evidence: `backend/acmwebsite/src/main/java/com/acm/acmwebsite/feature/service/ClubService.java`)
- Email delivery → Gmail SMTP: delivers mail (evidence: `README.md`)
- Chapter content → Cloudinary media: uploads media
- Cloudinary media → Cloudinary service: stores media (evidence: `README.md`)
- JWT security → Auth endpoints: guards requests
- Committees and boards → Application database: manages chapter structure
- Programs → Application database: manages programs
- Radio and podcasts → Application database: manages episodes
- Registration workflows → Application database: stores submissions
