# emd0dds/csci4830_team_project_eventlocator architecture

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

- Interactive diagram: https://gitdiagram.com/emd0dds/csci4830_team_project_eventlocator
- Repository: https://github.com/emd0dds/csci4830_team_project_eventlocator

## Overview

EventLocator is a Django event-discovery and hosting application. Signed-in users can browse nearby events, with Omaha as the fallback location; the home view fetches category-specific results, formats and sorts cards, caches complete results, and falls back to demo cards when none are available. Users can also submit hosted events, and the domain includes bookmarks. The excerpts show the discovery, account, and hosting paths, but not bookmark interactions or project-level URL wiring; those links are therefore omitted.

Main entry points: [`HomePage/views.py`](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py) (Event lookup), [`HomePage/APIcalls.py`](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/APIcalls.py) (PredictHQ client), [`LoginSignup/views.py`](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/views.py) (Login and signup), [`LoginSignup/forms.py`](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/forms.py) (Account forms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_account_view["Login and signup<br/>[views.py]"]
  node_account_forms["Account forms<br/>[forms.py]"]
  node_user_model[("User account<br/>[models.py]")]
end

subgraph group_discovery["Event discovery"]
  node_home_view["Home view<br/>[views.py]"]
  node_event_lookup["Event lookup<br/>[views.py]"]
  node_api_client["PredictHQ client<br/>[APIcalls.py]"]
  node_event_cards["Event card formatting<br/>[views.py]"]
  node_event_page["Home page template<br/>[home.html]"]
  node_event_cache[("Django cache")]
end

subgraph group_hosting["Hosted events"]
  node_hosting_view["Host-event view<br/>[views.py]"]
  node_event_form["Event form<br/>[forms.py]"]
  node_event_model[("Hosted event<br/>[models.py]")]
  node_bookmark_model[("Bookmarks<br/>[models.py]")]
  node_host_page["Host-event page<br/>[host_event.html]"]
end

subgraph group_runtime["Django runtime"]
  node_login_url["Login route<br/>[urls.py]"]
  node_home_url["Home routes<br/>[urls.py]"]
  node_django["Django application<br/>[settings.py]"]
end

node_visitor(("User"))
node_predict_hq{{"PredictHQ"}}
node_geocoder{{"Nominatim geocoder"}}

node_visitor -->|"opens login"| node_login_url
node_login_url -->|"routes to"| node_account_view
node_account_view -->|"validates"| node_account_forms
node_account_forms -->|"creates user"| node_user_model
node_visitor -.->|"requests home"| node_home_url
node_home_url -->|"routes to"| node_home_view
node_home_view -->|"loads events"| node_event_lookup
node_event_lookup -->|"reads and writes"| node_event_cache
node_event_lookup -->|"requests categories"| node_api_client
node_api_client -->|"fetches events"| node_predict_hq
node_api_client -->|"geocodes location"| node_geocoder
node_event_lookup -->|"formats results"| node_event_cards
node_home_view -->|"renders page"| node_event_page
node_visitor -.->|"submits event"| node_hosting_view
node_hosting_view -->|"validates submission"| node_event_form
node_event_form -->|"saves event"| node_event_model
node_hosting_view -->|"sets host and saves"| node_event_model
node_hosting_view -->|"renders page"| node_host_page
node_django -.->|"provides cache"| node_event_cache

click node_account_view "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/views.py"
click node_account_forms "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/forms.py"
click node_user_model "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/models.py"
click node_home_view "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py"
click node_event_lookup "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py"
click node_api_client "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/APIcalls.py"
click node_event_cards "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py"
click node_event_page "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/templates/home.html"
click node_hosting_view "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py"
click node_event_form "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/forms.py"
click node_event_model "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/models.py"
click node_bookmark_model "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/models.py"
click node_host_page "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/templates/host_event.html"
click node_login_url "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/urls.py"
click node_home_url "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/urls.py"
click node_django "https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/EventLocator/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_account_view,node_account_forms,node_user_model,node_visitor toneBlue
class node_home_view,node_event_lookup,node_api_client,node_event_cards,node_event_page,node_event_cache toneAmber
class node_hosting_view,node_event_form,node_event_model,node_bookmark_model,node_host_page toneMint
class node_login_url,node_home_url,node_django toneRose
class node_predict_hq,node_geocoder toneIndigo
```

## Components

### Accounts

- [Login and signup](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/views.py): `LoginSignup/views.py`
- [Account forms](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/forms.py): `LoginSignup/forms.py`
- [User account](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/models.py): `LoginSignup/models.py`

### Event discovery

- [Home view](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py): `HomePage/views.py`
- [Event lookup](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py): `HomePage/views.py`
- [PredictHQ client](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/APIcalls.py): `HomePage/APIcalls.py`
- [Event card formatting](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py): `HomePage/views.py`
- [Home page template](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/templates/home.html): `HomePage/templates/home.html`
- **Django cache**

### Hosted events

- [Host-event view](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/views.py): `HomePage/views.py`
- [Event form](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/forms.py): `HomePage/forms.py`
- [Hosted event](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/models.py): `HomePage/models.py`
- [Bookmarks](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/models.py): `HomePage/models.py`
- [Host-event page](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/templates/host_event.html): `HomePage/templates/host_event.html`

### Django runtime

- [Login route](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/LoginSignup/urls.py): `LoginSignup/urls.py`
- [Home routes](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/HomePage/urls.py): `HomePage/urls.py`
- [Django application](https://github.com/emd0dds/csci4830_team_project_eventlocator/blob/main/EventLocator/settings.py): `EventLocator/settings.py`

### Other components

- **User**
- **PredictHQ**
- **Nominatim geocoder**

## Connections

- User → Login route: opens login (evidence: `LoginSignup/urls.py`)
- Login route → Login and signup: routes to (evidence: `LoginSignup/urls.py`)
- Login and signup → Account forms: validates (evidence: `LoginSignup/views.py`)
- Account forms → User account: creates user (evidence: `LoginSignup/forms.py`)
- User → Home routes: requests home
- Home routes → Home view: routes to (evidence: `HomePage/urls.py`)
- Home view → Event lookup: loads events (evidence: `HomePage/views.py`)
- Event lookup → Django cache: reads and writes (evidence: `HomePage/views.py`)
- Event lookup → PredictHQ client: requests categories (evidence: `HomePage/views.py`)
- PredictHQ client → PredictHQ: fetches events (evidence: `HomePage/APIcalls.py`)
- PredictHQ client → Nominatim geocoder: geocodes location (evidence: `HomePage/APIcalls.py`)
- Event lookup → Event card formatting: formats results (evidence: `HomePage/views.py`)
- Home view → Home page template: renders page (evidence: `HomePage/views.py`)
- User → Host-event view: submits event
- Host-event view → Event form: validates submission (evidence: `HomePage/views.py`)
- Event form → Hosted event: saves event (evidence: `HomePage/forms.py`)
- Host-event view → Hosted event: sets host and saves (evidence: `HomePage/views.py`)
- Host-event view → Host-event page: renders page (evidence: `HomePage/views.py`)
- Django application → Django cache: provides cache
