# jpeterson96/uwm_clubs_and_events architecture

> Architecture diagram of the GitHub repository jpeterson96/uwm_clubs_and_events, 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/jpeterson96/uwm_clubs_and_events
- Repository: https://github.com/jpeterson96/uwm_clubs_and_events

## Overview

UWM Clubs and Events is a Django campus-events and organization hub. Students enter through routed views, browse and filter events, and can manage accounts, organizations, and event listings; the views render page templates and delegate selected operations to utility classes. Event discovery, calendars, organization pages, and account features are represented as responsibilities within the sampled views and documented routes. The model layer defines the domain records, backed by the configured SQLite database. Source excerpts do not show every view implementation, so some feature-level connections are intentionally omitted.

Main entry points: [`UWM_Clubs_and_Events/views.py`](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py) (Request views), [`UWM_Clubs_and_Events/models.py`](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/models.py) (Domain models), [`classes/organization_util.py`](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/organization_util.py) (Organization operations), [`classes/user_util.py`](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/user_util.py) (User operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_routes["URL routing<br/>[urls.py]"]
  node_views["Request views<br/>[views.py]"]
  node_pages["Page templates"]
end

subgraph group_domain["Campus features"]
  node_discovery["Event discovery<br/>[views.py]"]
  node_calendar["Calendars<br/>[views.py]"]
  node_accounts["Account management<br/>[views.py]"]
  node_organizations["Organization management<br/>[views.py]"]
  node_event_lifecycle["Event management<br/>[views.py]"]
end

subgraph group_services["Domain utilities"]
  node_event_util["Event operations<br/>[event_util.py]"]
  node_user_util["User operations<br/>[user_util.py]"]
  node_organization_util["Organization operations"]
end

subgraph group_persistence["Data layer"]
  node_models["Domain models<br/>[models.py]"]
  node_sqlite[("SQLite database<br/>[db.sqlite3]")]
  node_settings["Django settings<br/>[settings.py]"]
end

node_student(("Campus user"))

node_student -->|"requests pages"| node_routes
node_routes -->|"routes requests"| node_views
node_views -->|"renders pages"| node_pages
node_views -->|"delegates filtering"| node_event_util
node_views -->|"delegates user tasks"| node_user_util
node_views -->|"delegates org edits"| node_organization_util
node_views -->|"queries records"| node_models
node_event_util -->|"queries events"| node_models
node_user_util -->|"manages user records"| node_models
node_organization_util -->|"manages org records"| node_models
node_organization_util -->|"checks contacts"| node_user_util
node_settings -->|"configures database"| node_sqlite

click node_routes "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/urls.py"
click node_views "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py"
click node_pages "https://github.com/jpeterson96/uwm_clubs_and_events/tree/main/templates"
click node_discovery "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py"
click node_calendar "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py"
click node_accounts "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py"
click node_organizations "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py"
click node_event_lifecycle "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py"
click node_event_util "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/event_util.py"
click node_user_util "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/user_util.py"
click node_organization_util "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/organization_util.py"
click node_models "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/models.py"
click node_sqlite "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/db.sqlite3"
click node_settings "https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/settings.py"

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_routes,node_views,node_pages,node_student toneBlue
class node_discovery,node_calendar,node_accounts,node_organizations,node_event_lifecycle toneAmber
class node_event_util,node_user_util,node_organization_util toneMint
class node_models,node_sqlite,node_settings toneRose
```

## Components

### Web interface

- [URL routing](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/urls.py): `UWM_Clubs_and_Events/urls.py`
- [Request views](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py): `UWM_Clubs_and_Events/views.py`
- [Page templates](https://github.com/jpeterson96/uwm_clubs_and_events/tree/main/templates): `templates`

### Campus features

- [Event discovery](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py): `UWM_Clubs_and_Events/views.py`
- [Calendars](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py): `UWM_Clubs_and_Events/views.py`
- [Account management](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py): `UWM_Clubs_and_Events/views.py`
- [Organization management](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py): `UWM_Clubs_and_Events/views.py`
- [Event management](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/views.py): `UWM_Clubs_and_Events/views.py`

### Domain utilities

- [Event operations](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/event_util.py): `classes/event_util.py`
- [User operations](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/user_util.py): `classes/user_util.py`
- [Organization operations](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/classes/organization_util.py): `classes/organization_util.py`

### Data layer

- [Domain models](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/models.py): `UWM_Clubs_and_Events/models.py`
- [SQLite database](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/db.sqlite3): `db.sqlite3`
- [Django settings](https://github.com/jpeterson96/uwm_clubs_and_events/blob/main/UWM_Clubs_and_Events/settings.py): `UWM_Clubs_and_Events/settings.py`

### Other components

- **Campus user**

## Connections

- Campus user → URL routing: requests pages (evidence: `UWM_Clubs_and_Events/urls.py`)
- URL routing → Request views: routes requests (evidence: `UWM_Clubs_and_Events/urls.py`)
- Request views → Page templates: renders pages (evidence: `UWM_Clubs_and_Events/views.py`)
- Request views → Event operations: delegates filtering (evidence: `UWM_Clubs_and_Events/views.py`)
- Request views → User operations: delegates user tasks (evidence: `UWM_Clubs_and_Events/views.py`)
- Request views → Organization operations: delegates org edits (evidence: `UWM_Clubs_and_Events/views.py`)
- Request views → Domain models: queries records (evidence: `UWM_Clubs_and_Events/views.py`)
- Event operations → Domain models: queries events (evidence: `classes/event_util.py`)
- User operations → Domain models: manages user records (evidence: `classes/user_util.py`)
- Organization operations → Domain models: manages org records (evidence: `classes/organization_util.py`)
- Organization operations → User operations: checks contacts (evidence: `classes/organization_util.py`)
- Django settings → SQLite database: configures database (evidence: `UWM_Clubs_and_Events/settings.py`)
