# jp-05-cb/jp-event-talks-app architecture

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

- Interactive diagram: https://gitdiagram.com/jp-05-cb/jp-event-talks-app
- Repository: https://github.com/jp-05-cb/jp-event-talks-app

## Overview

BigQuery Release Radar turns Google Cloud’s Atom release feed into a browsable dashboard: the browser requests notes, Flask fetches or reuses cached feed data, and the server splits entries into individual updates for display. Users can search and filter updates, copy or export them, and compose a post for X; the interface also supports light and dark themes. The graph preserves these documented capabilities. Backend request and parsing links are visible in app.py; frontend and template details are only partly sampled, so those links rely on README statements.

Main entry points: [`static/js/app.js`](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js) (Browser app), [`app.py`](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py) (Feed fetch), [`templates/index.html`](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/templates/index.html) (Dashboard page), [`static/css/style.css`](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/css/style.css) (Theme styles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backend["Feed service"]
  node_api["Notes endpoint<br/>[app.py]"]
  node_cache[("Feed cache<br/>[app.py]")]
  node_feed_fetch["Feed fetch<br/>[app.py]"]
  node_atom_parse["Atom parsing<br/>[app.py]"]
  node_entry_split["Update splitting<br/>[app.py]"]
end

subgraph group_frontend["Dashboard"]
  node_dashboard["Dashboard page<br/>[index.html]"]
  node_browser["Browser app<br/>[app.js]"]
  node_search_filter["Search and filters<br/>[app.js]"]
  node_note_render["Release cards<br/>[app.js]"]
end

subgraph group_sharing["Sharing tools"]
  node_copy["Clipboard copy<br/>[app.js]"]
  node_csv["CSV export<br/>[app.js]"]
  node_tweet_composer["Tweet composer<br/>[app.js]"]
end

subgraph group_presentation["Visual presentation"]
  node_theme["Theme toggle<br/>[app.js]"]
  node_styles["Theme styles<br/>[style.css]"]
end

node_developer(("Developer"))
node_google_feed["BigQuery Atom feed"]
node_x_intent["X post intent"]

node_developer -->|"opens"| node_dashboard
node_dashboard -->|"loads script"| node_browser
node_browser -->|"requests notes"| node_api
node_api -->|"calls"| node_feed_fetch
node_feed_fetch -->|"reads or updates"| node_cache
node_feed_fetch -->|"fetches feed"| node_google_feed
node_feed_fetch -->|"parses XML"| node_atom_parse
node_atom_parse -->|"splits entries"| node_entry_split
node_api -->|"returns notes"| node_browser
node_browser -->|"filters notes"| node_search_filter
node_search_filter -->|"renders results"| node_note_render
node_note_render -->|"offers copy"| node_copy
node_note_render -->|"opens composer"| node_tweet_composer
node_browser -->|"exports filtered notes"| node_csv
node_tweet_composer -->|"opens post intent"| node_x_intent
node_browser -->|"toggles theme"| node_theme
node_theme -->|"applies theme"| node_styles

click node_dashboard "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/templates/index.html"
click node_browser "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_api "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py"
click node_cache "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py"
click node_feed_fetch "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py"
click node_atom_parse "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py"
click node_entry_split "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py"
click node_search_filter "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_note_render "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_copy "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_csv "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_tweet_composer "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_theme "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js"
click node_styles "https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/css/style.css"

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_api,node_cache,node_feed_fetch,node_atom_parse,node_entry_split toneBlue
class node_dashboard,node_browser,node_search_filter,node_note_render toneAmber
class node_copy,node_csv,node_tweet_composer toneMint
class node_theme,node_styles toneRose
class node_developer,node_google_feed,node_x_intent toneIndigo
```

## Components

### Feed service

- [Notes endpoint](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py): `app.py`
- [Feed cache](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py): `app.py`
- [Feed fetch](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py): `app.py`
- [Atom parsing](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py): `app.py`
- [Update splitting](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/app.py): `app.py`

### Dashboard

- [Dashboard page](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/templates/index.html): `templates/index.html`
- [Browser app](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`
- [Search and filters](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`
- [Release cards](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`

### Sharing tools

- [Clipboard copy](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`
- [CSV export](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`
- [Tweet composer](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`

### Visual presentation

- [Theme toggle](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/js/app.js): `static/js/app.js`
- [Theme styles](https://github.com/jp-05-cb/jp-event-talks-app/blob/main/static/css/style.css): `static/css/style.css`

### Other components

- **Developer**
- **BigQuery Atom feed**
- **X post intent**

## Connections

- Developer → Dashboard page: opens (evidence: `README.md`)
- Dashboard page → Browser app: loads script (evidence: `README.md`)
- Browser app → Notes endpoint: requests notes (evidence: `static/js/app.js`)
- Notes endpoint → Feed fetch: calls (evidence: `app.py`)
- Feed fetch → Feed cache: reads or updates (evidence: `app.py`)
- Feed fetch → BigQuery Atom feed: fetches feed (evidence: `app.py`)
- Feed fetch → Atom parsing: parses XML (evidence: `app.py`)
- Atom parsing → Update splitting: splits entries (evidence: `app.py`)
- Notes endpoint → Browser app: returns notes (evidence: `static/js/app.js`)
- Browser app → Search and filters: filters notes (evidence: `static/js/app.js`)
- Search and filters → Release cards: renders results (evidence: `static/js/app.js`)
- Release cards → Clipboard copy: offers copy (evidence: `static/js/app.js`)
- Release cards → Tweet composer: opens composer (evidence: `static/js/app.js`)
- Browser app → CSV export: exports filtered notes (evidence: `README.md`)
- Tweet composer → X post intent: opens post intent (evidence: `static/js/app.js`)
- Browser app → Theme toggle: toggles theme (evidence: `static/js/app.js`)
- Theme toggle → Theme styles: applies theme (evidence: `README.md`)
