# aberuu/campus-event-management architecture

> Architecture diagram of the GitHub repository aberuu/campus-event-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aberuu/campus-event-management
- Repository: https://github.com/aberuu/campus-event-management

## Overview

Portal Event Kampus is a static campus-events site: visitors discover and filter events, inspect event details and calendar views, then use registration and calendar-sharing tools; administrators authenticate and manage the schedule. The graph includes the sampled runtime modules and README-documented About and legacy detail pages. Source excerpts confirm several calls; other documented capabilities are represented without speculative internal links.

Main entry points: [`js/calendar-service.js`](https://github.com/aberuu/campus-event-management/blob/main/js/calendar-service.js) (Calendar service), [`js/page-detail.js`](https://github.com/aberuu/campus-event-management/blob/main/js/page-detail.js) (Event details), [`js/page-calendar.js`](https://github.com/aberuu/campus-event-management/blob/main/js/page-calendar.js) (Calendar views), [`js/page-admin.js`](https://github.com/aberuu/campus-event-management/blob/main/js/page-admin.js) (Admin panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor experience"]
  node_home["Featured events<br/>[page-home.js]"]
  node_directory["Event directory<br/>[page-events.js]"]
  node_calendar["Calendar views<br/>[page-calendar.js]"]
  node_detail["Event details<br/>[page-detail.js]"]
  node_about["About campus<br/>[about.html]"]
  node_legacy["Legacy details"]
  node_registration["Registration form<br/>[page-detail.js]"]
end

subgraph group_admin["Schedule administration"]
  node_admin["Admin panel<br/>[page-admin.js]"]
  node_timeline["Timeline interaction<br/>[timeline-view.js]"]
end

subgraph group_shared["Shared event services"]
  node_service["Calendar service"]
  node_fallback[("Local event data<br/>[fallback-events.js]")]
  node_config["Portal configuration<br/>[config.example.js]"]
  node_ui["Shared UI<br/>[ui-common.js]"]
  node_ics["Calendar sharing tools<br/>[ics-helper.js]"]
  node_icsfiles["ICS event files"]
end

subgraph group_external["Calendar integration"]
  node_google[("Google Calendar")]
  node_oauth(("Google OAuth"))
end

node_visitor(("Event visitor"))
node_registrants(("Event registrant"))

node_visitor -->|"views"| node_home
node_visitor -->|"searches"| node_directory
node_visitor -->|"browses"| node_calendar
node_visitor -->|"opens"| node_detail
node_visitor -->|"views"| node_about
node_visitor -->|"opens"| node_legacy
node_home -->|"loads events"| node_service
node_directory -->|"loads events"| node_service
node_calendar -->|"loads schedule"| node_service
node_detail -->|"loads event"| node_service
node_service -.->|"falls back"| node_fallback
node_service -.->|"reads and writes"| node_google
node_service -.->|"uses settings"| node_config
node_home -->|"renders cards"| node_ui
node_directory -.->|"renders states"| node_ui
node_detail -->|"renders states"| node_ui
node_calendar -.->|"renders timeline"| node_timeline
node_admin -->|"renders timeline"| node_timeline
node_admin -->|"manages events"| node_service
node_admin -.->|"authenticates"| node_oauth
node_calendar -.->|"offers subscription"| node_ics
node_detail -->|"exports event"| node_ics
node_registrants -->|"submits details"| node_registration
node_registration -->|"validates locally"| node_registrants
node_detail -.->|"links legacy ICS"| node_icsfiles

click node_home "https://github.com/aberuu/campus-event-management/blob/main/js/page-home.js"
click node_directory "https://github.com/aberuu/campus-event-management/blob/main/js/page-events.js"
click node_calendar "https://github.com/aberuu/campus-event-management/blob/main/js/page-calendar.js"
click node_detail "https://github.com/aberuu/campus-event-management/blob/main/js/page-detail.js"
click node_about "https://github.com/aberuu/campus-event-management/blob/main/about.html"
click node_legacy "https://github.com/aberuu/campus-event-management/blob/main/event-hackathon-kampus.html"
click node_admin "https://github.com/aberuu/campus-event-management/blob/main/js/page-admin.js"
click node_timeline "https://github.com/aberuu/campus-event-management/blob/main/js/timeline-view.js"
click node_service "https://github.com/aberuu/campus-event-management/blob/main/js/calendar-service.js"
click node_fallback "https://github.com/aberuu/campus-event-management/blob/main/js/fallback-events.js"
click node_config "https://github.com/aberuu/campus-event-management/blob/main/js/config.example.js"
click node_ui "https://github.com/aberuu/campus-event-management/blob/main/js/ui-common.js"
click node_ics "https://github.com/aberuu/campus-event-management/blob/main/js/ics-helper.js"
click node_icsfiles "https://github.com/aberuu/campus-event-management/blob/main/assets/ics/hackathon-kampus.ics"
click node_registration "https://github.com/aberuu/campus-event-management/blob/main/js/page-detail.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_home,node_directory,node_calendar,node_detail,node_about,node_legacy,node_registration toneBlue
class node_admin,node_timeline toneAmber
class node_service,node_fallback,node_config,node_ui,node_ics,node_icsfiles toneMint
class node_google,node_oauth toneRose
class node_visitor,node_registrants toneIndigo
```

## Components

### Visitor experience

- [Featured events](https://github.com/aberuu/campus-event-management/blob/main/js/page-home.js): `js/page-home.js`
- [Event directory](https://github.com/aberuu/campus-event-management/blob/main/js/page-events.js): `js/page-events.js`
- [Calendar views](https://github.com/aberuu/campus-event-management/blob/main/js/page-calendar.js): `js/page-calendar.js`
- [Event details](https://github.com/aberuu/campus-event-management/blob/main/js/page-detail.js): `js/page-detail.js`
- [About campus](https://github.com/aberuu/campus-event-management/blob/main/about.html): `about.html`
- [Legacy details](https://github.com/aberuu/campus-event-management/blob/main/event-hackathon-kampus.html): `event-hackathon-kampus.html`
- [Registration form](https://github.com/aberuu/campus-event-management/blob/main/js/page-detail.js): `js/page-detail.js`

### Schedule administration

- [Admin panel](https://github.com/aberuu/campus-event-management/blob/main/js/page-admin.js): `js/page-admin.js`
- [Timeline interaction](https://github.com/aberuu/campus-event-management/blob/main/js/timeline-view.js): `js/timeline-view.js`

### Shared event services

- [Calendar service](https://github.com/aberuu/campus-event-management/blob/main/js/calendar-service.js): `js/calendar-service.js`
- [Local event data](https://github.com/aberuu/campus-event-management/blob/main/js/fallback-events.js): `js/fallback-events.js`
- [Portal configuration](https://github.com/aberuu/campus-event-management/blob/main/js/config.example.js): `js/config.example.js`
- [Shared UI](https://github.com/aberuu/campus-event-management/blob/main/js/ui-common.js): `js/ui-common.js`
- [Calendar sharing tools](https://github.com/aberuu/campus-event-management/blob/main/js/ics-helper.js): `js/ics-helper.js`
- [ICS event files](https://github.com/aberuu/campus-event-management/blob/main/assets/ics/hackathon-kampus.ics): `assets/ics/hackathon-kampus.ics`

### Calendar integration

- **Google Calendar**
- **Google OAuth**

### Other components

- **Event visitor**
- **Event registrant**

## Connections

- Event visitor → Featured events: views (evidence: `README.md`)
- Event visitor → Event directory: searches (evidence: `README.md`)
- Event visitor → Calendar views: browses (evidence: `README.md`)
- Event visitor → Event details: opens (evidence: `README.md`)
- Event visitor → About campus: views (evidence: `README.md`)
- Event visitor → Legacy details: opens (evidence: `README.md`)
- Featured events → Calendar service: loads events (evidence: `js/page-home.js`)
- Event directory → Calendar service: loads events (evidence: `js/page-events.js`)
- Calendar views → Calendar service: loads schedule (evidence: `README.md`)
- Event details → Calendar service: loads event (evidence: `js/page-detail.js`)
- Calendar service → Local event data: falls back (evidence: `README.md`)
- Calendar service → Google Calendar: reads and writes (evidence: `README.md`)
- Calendar service → Portal configuration: uses settings
- Featured events → Shared UI: renders cards (evidence: `js/page-home.js`)
- Event directory → Shared UI: renders states
- Event details → Shared UI: renders states (evidence: `js/page-detail.js`)
- Calendar views → Timeline interaction: renders timeline (evidence: `README.md`)
- Admin panel → Timeline interaction: renders timeline (evidence: `js/page-admin.js`)
- Admin panel → Calendar service: manages events (evidence: `js/page-admin.js`)
- Admin panel → Google OAuth: authenticates (evidence: `README.md`)
- Calendar views → Calendar sharing tools: offers subscription (evidence: `README.md`)
- Event details → Calendar sharing tools: exports event (evidence: `js/page-detail.js`)
- Event registrant → Registration form: submits details (evidence: `js/page-detail.js`)
- Registration form → Event registrant: validates locally (evidence: `js/page-detail.js`)
- Event details → ICS event files: links legacy ICS (evidence: `README.md`)
