# jehrlichglenhaven/scrape-weatherstory architecture

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

- Interactive diagram: https://gitdiagram.com/jehrlichglenhaven/scrape-weatherstory
- Repository: https://github.com/jehrlichglenhaven/scrape-weatherstory

## Overview

This repository is a static weather-channel experience: visitors view live radar, current conditions, a seven-day forecast ticker, rotating NWS Weather Story images, and alert banners. The image pipeline fetches Weather Story tab images, archives dated copies, and publishes a latest-image manifest for the page. The page implementation is represented by README-described responsibilities because index.html was not sampled; its internal wiring is therefore not inferred beyond documented behavior.

Main entry points: [`index.html`](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html) (Weather channel), [`scripts/scrape_weatherstory.py`](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/scripts/scrape_weatherstory.py) (Image scraper), [`assets`](https://github.com/jehrlichglenhaven/scrape-weatherstory/tree/main/assets) (Image assets), [`assets/weatherstory-manifest.json`](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/assets/weatherstory-manifest.json) (Latest manifest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Visitor experience"]
  node_site["Weather channel<br/>[index.html]"]
  node_header["Header and ticker<br/>[index.html]"]
end

subgraph group_live["Live weather"]
  node_radar["Live radar<br/>[index.html]"]
  node_conditions["Current conditions<br/>[index.html]"]
  node_forecast["7-day forecast<br/>[index.html]"]
  node_alerts["Alert banner<br/>[index.html]"]
end

subgraph group_images["Weather Story images"]
  node_scraper["Image scraper"]
  node_tab_parse["Tab image extraction"]
end

subgraph group_published["Published assets"]
  node_asset_store[("Image assets")]
  node_latest_manifest["Latest manifest"]
  node_dated_archive[("Dated archives")]
end

node_visitor(("Visitor"))
node_weather_api["Weather API"]
node_story_page["NWS Story page"]

node_visitor -->|"opens"| node_site
node_site -->|"displays"| node_radar
node_site -->|"shows"| node_conditions
node_site -->|"renders"| node_header
node_site -->|"shows"| node_forecast
node_site -->|"cycles"| node_alerts
node_alerts -->|"refreshes alerts"| node_weather_api
node_site -->|"rotates images"| node_asset_store
node_scraper -->|"fetches page"| node_story_page
node_scraper -->|"extracts tabs"| node_tab_parse
node_scraper -->|"downloads and copies"| node_asset_store
node_scraper -->|"writes manifest"| node_latest_manifest
node_scraper -->|"archives manifest"| node_dated_archive
node_site -->|"loads latest images"| node_latest_manifest

click node_site "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html"
click node_header "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html"
click node_radar "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html"
click node_conditions "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html"
click node_forecast "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html"
click node_alerts "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html"
click node_scraper "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/scripts/scrape_weatherstory.py"
click node_tab_parse "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/scripts/scrape_weatherstory.py"
click node_asset_store "https://github.com/jehrlichglenhaven/scrape-weatherstory/tree/main/assets"
click node_latest_manifest "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/assets/weatherstory-manifest.json"
click node_dated_archive "https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/assets/2026-08-12/weatherstory-manifest.json"

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_site,node_header toneBlue
class node_radar,node_conditions,node_forecast,node_alerts toneAmber
class node_scraper,node_tab_parse,node_weather_api toneMint
class node_asset_store,node_latest_manifest,node_dated_archive toneRose
class node_visitor,node_story_page toneIndigo
```

## Components

### Visitor experience

- [Weather channel](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html): `index.html`
- [Header and ticker](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html): `index.html`

### Live weather

- [Live radar](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html): `index.html`
- [Current conditions](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html): `index.html`
- [7-day forecast](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html): `index.html`
- [Alert banner](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/index.html): `index.html`

### Weather Story images

- [Image scraper](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/scripts/scrape_weatherstory.py): `scripts/scrape_weatherstory.py`
- [Tab image extraction](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/scripts/scrape_weatherstory.py): `scripts/scrape_weatherstory.py`

### Published assets

- [Image assets](https://github.com/jehrlichglenhaven/scrape-weatherstory/tree/main/assets): `assets`
- [Latest manifest](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/assets/weatherstory-manifest.json): `assets/weatherstory-manifest.json`
- [Dated archives](https://github.com/jehrlichglenhaven/scrape-weatherstory/blob/main/assets/2026-08-12/weatherstory-manifest.json): `assets/2026-08-12/weatherstory-manifest.json`

### Other components

- **Visitor**
- **Weather API**
- **NWS Story page**

## Connections

- Visitor → Weather channel: opens (evidence: `README.md`)
- Weather channel → Live radar: displays (evidence: `README.md`)
- Weather channel → Current conditions: shows (evidence: `README.md`)
- Weather channel → Header and ticker: renders (evidence: `README.md`)
- Weather channel → 7-day forecast: shows (evidence: `README.md`)
- Weather channel → Alert banner: cycles (evidence: `README.md`)
- Alert banner → Weather API: refreshes alerts (evidence: `README.md`)
- Weather channel → Image assets: rotates images (evidence: `README.md`)
- Image scraper → NWS Story page: fetches page (evidence: `scripts/scrape_weatherstory.py`)
- Image scraper → Tab image extraction: extracts tabs (evidence: `scripts/scrape_weatherstory.py`)
- Image scraper → Image assets: downloads and copies (evidence: `scripts/scrape_weatherstory.py`)
- Image scraper → Latest manifest: writes manifest (evidence: `scripts/scrape_weatherstory.py`)
- Image scraper → Dated archives: archives manifest (evidence: `scripts/scrape_weatherstory.py`)
- Weather channel → Latest manifest: loads latest images (evidence: `README.md`)
