# shayann-o/webtech_project_fall2026-27_groupnumber3 architecture

> Architecture diagram of the GitHub repository shayann-o/webtech_project_fall2026-27_groupnumber3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shayann-o/webtech_project_fall2026-27_groupnumber3
- Repository: https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3

## Overview

ClubKit is a browser-based frontend for university club membership, events, attendance-related volunteer work, and role-based administration. Users enter role-specific pages; members explore clubs and events, while executive and event-coordinator workflows manage club operations and treasurer pages handle finance tasks and reports. The sampled JavaScript validates forms and changes page content locally; it does not show durable storage or backend calls. Some member-page behavior and page-to-script wiring were not sampled, so those connections are left unasserted.

Main entry points: [`js/pages/executive/registration.js`](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/registration.js) (Executive applications), [`js/pages/executive/members.js`](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/members.js) (Member management), [`js/pages/executive/events.js`](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/events.js) (Event administration), [`js/pages/executive/announcements.js`](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/announcements.js) (Announcements)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_members["Member experience"]
  node_member_pages["Club discovery"]
  node_member_logic["Member interface<br/>[member.js]"]
end

subgraph group_executive["Executive administration"]
  node_exec_pages["Executive portal"]
  node_exec_login["Executive login<br/>[login.js]"]
  node_exec_registration["Executive applications<br/>[registration.js]"]
  node_exec_members["Member management<br/>[members.js]"]
  node_exec_events["Event administration<br/>[events.js]"]
  node_announcements["Announcements<br/>[announcements.js]"]
end

subgraph group_events["Event operations"]
  node_coordinator_pages["Coordinator portal"]
  node_coordinator_signup["Coordinator signup<br/>[signup.js]"]
  node_event_creation["Event creation<br/>[event.js]"]
  node_schedule_updates["Schedule updates<br/>[event_time.js]"]
  node_volunteer_assignment["Volunteer assignments<br/>[volunteer.js]"]
  node_expense_reporting["Expense reporting<br/>[report.js]"]
end

subgraph group_finance["Treasurer finance"]
  node_treasurer_pages["Treasurer portal"]
  node_treasurer_login["Treasurer login<br/>[login.js]"]
  node_treasurer_registration["Treasurer applications<br/>[registration.js]"]
  node_budget["Budget management<br/>[budget.js]"]
  node_transactions["Transactions<br/>[transactions.js]"]
  node_treasurer_reports["Financial reports<br/>[reports.js]"]
end

node_user(("Club user"))

node_user -.->|"browses"| node_member_pages
node_user -.->|"administers"| node_exec_pages
node_user -.->|"coordinates"| node_coordinator_pages
node_user -.->|"manages finances"| node_treasurer_pages
node_exec_members -->|"updates roles and assignments"| node_exec_members
node_exec_events -->|"adds and cancels"| node_exec_events
node_announcements -->|"adds notice history"| node_announcements
node_event_creation -->|"validates event details"| node_event_creation
node_schedule_updates -->|"validates changes"| node_schedule_updates
node_expense_reporting -->|"validates expenses"| node_expense_reporting
node_volunteer_assignment -->|"reads assignments"| node_volunteer_assignment
node_transactions -->|"validates and logs"| node_transactions
node_treasurer_reports -->|"validates and displays"| node_treasurer_reports
node_treasurer_login -->|"checks credentials"| node_treasurer_login
node_exec_registration -->|"validates application"| node_exec_registration
node_coordinator_signup -->|"validates registration"| node_coordinator_signup
node_treasurer_registration -->|"validates application"| node_treasurer_registration

click node_member_pages "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/member"
click node_member_logic "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/member.js"
click node_exec_pages "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/executive"
click node_exec_login "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/login.js"
click node_exec_registration "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/registration.js"
click node_exec_members "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/members.js"
click node_exec_events "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/events.js"
click node_announcements "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/announcements.js"
click node_coordinator_pages "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/event_coordinator"
click node_coordinator_signup "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/signup.js"
click node_event_creation "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/event.js"
click node_schedule_updates "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/event_time.js"
click node_volunteer_assignment "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/volunteer.js"
click node_expense_reporting "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/report.js"
click node_treasurer_pages "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/treasurer"
click node_treasurer_login "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/login.js"
click node_treasurer_registration "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/registration.js"
click node_budget "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/budget.js"
click node_transactions "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/transactions.js"
click node_treasurer_reports "https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/reports.js"

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_member_pages,node_member_logic,node_user toneBlue
class node_exec_pages,node_exec_login,node_exec_registration,node_exec_members,node_exec_events,node_announcements toneAmber
class node_coordinator_pages,node_coordinator_signup,node_event_creation,node_schedule_updates,node_volunteer_assignment,node_expense_reporting toneMint
class node_treasurer_pages,node_treasurer_login,node_treasurer_registration,node_budget,node_transactions,node_treasurer_reports toneRose
```

## Components

### Member experience

- [Club discovery](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/member): `pages/member`
- [Member interface](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/member.js): `js/pages/member.js`

### Executive administration

- [Executive portal](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/executive): `pages/executive`
- [Executive login](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/login.js): `js/pages/executive/login.js`
- [Executive applications](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/registration.js): `js/pages/executive/registration.js`
- [Member management](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/members.js): `js/pages/executive/members.js`
- [Event administration](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/events.js): `js/pages/executive/events.js`
- [Announcements](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/executive/announcements.js): `js/pages/executive/announcements.js`

### Event operations

- [Coordinator portal](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/event_coordinator): `pages/event_coordinator`
- [Coordinator signup](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/signup.js): `js/pages/event_coordinator/signup.js`
- [Event creation](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/event.js): `js/pages/event_coordinator/event.js`
- [Schedule updates](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/event_time.js): `js/pages/event_coordinator/event_time.js`
- [Volunteer assignments](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/volunteer.js): `js/pages/event_coordinator/volunteer.js`
- [Expense reporting](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/event_coordinator/report.js): `js/pages/event_coordinator/report.js`

### Treasurer finance

- [Treasurer portal](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/tree/main/pages/treasurer): `pages/treasurer`
- [Treasurer login](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/login.js): `js/pages/treasurer/login.js`
- [Treasurer applications](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/registration.js): `js/pages/treasurer/registration.js`
- [Budget management](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/budget.js): `js/pages/treasurer/budget.js`
- [Transactions](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/transactions.js): `js/pages/treasurer/transactions.js`
- [Financial reports](https://github.com/shayann-o/webtech_project_fall2026-27_groupnumber3/blob/main/js/pages/treasurer/reports.js): `js/pages/treasurer/reports.js`

### Other components

- **Club user**

## Connections

- Club user → Club discovery: browses
- Club user → Executive portal: administers
- Club user → Coordinator portal: coordinates
- Club user → Treasurer portal: manages finances
- Member management → Member management: updates roles and assignments (evidence: `js/pages/executive/members.js`)
- Event administration → Event administration: adds and cancels (evidence: `js/pages/executive/events.js`)
- Announcements → Announcements: adds notice history (evidence: `js/pages/executive/announcements.js`)
- Event creation → Event creation: validates event details (evidence: `js/pages/event_coordinator/event.js`)
- Schedule updates → Schedule updates: validates changes (evidence: `js/pages/event_coordinator/event_time.js`)
- Expense reporting → Expense reporting: validates expenses (evidence: `js/pages/event_coordinator/report.js`)
- Volunteer assignments → Volunteer assignments: reads assignments (evidence: `js/pages/event_coordinator/volunteer.js`)
- Transactions → Transactions: validates and logs (evidence: `js/pages/treasurer/transactions.js`)
- Financial reports → Financial reports: validates and displays (evidence: `js/pages/treasurer/reports.js`)
- Treasurer login → Treasurer login: checks credentials (evidence: `js/pages/treasurer/login.js`)
- Executive applications → Executive applications: validates application (evidence: `js/pages/executive/registration.js`)
- Coordinator signup → Coordinator signup: validates registration (evidence: `js/pages/event_coordinator/signup.js`)
- Treasurer applications → Treasurer applications: validates application (evidence: `js/pages/treasurer/registration.js`)
