# aea2669/hctime architecture

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

## Overview

HCTime is a collection of standalone browser dashboards for aviation operations teams. The main workflow combines scheduled countdowns with airport weather: the command-center page polls the aviation weather API, falls back through CORS proxies, parses METAR data, and displays conditions and alerts. Separate pages provide world clocks, detailed DFW/CLT weather, and operational alerts. The README documents the main dashboard’s failover to the clocks page. No source excerpts were provided, so internal relationships are limited to those explicitly described in the README; the alert pages with little documentation are represented without inferred connections.

Main entry points: [`index.html`](https://github.com/aea2669/hctime/blob/main/index.html) (Operations Dashboard), [`Clocks.html`](https://github.com/aea2669/hctime/blob/main/Clocks.html) (World Clocks), [`dfw.html`](https://github.com/aea2669/hctime/blob/main/dfw.html) (DFW Weather Detail), [`clt.html`](https://github.com/aea2669/hctime/blob/main/clt.html) (CLT Weather Detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_command["Command Center"]
  node_dashboard["Operations Dashboard<br/>[index.html]"]
  node_countdowns["Schedule Countdowns<br/>[index.html]"]
  node_settings["Display Settings<br/>[index.html]"]
  node_weatherfetch["Weather Polling<br/>[index.html]"]
  node_metarparse["METAR Parsing<br/>[index.html]"]
  node_weatherdisplay["Weather Overview<br/>[index.html]"]
  node_watchdogs["Stability Watchdogs<br/>[index.html]"]
end

subgraph group_time["Time Displays"]
  node_clocks["World Clocks<br/>[Clocks.html]"]
end

subgraph group_weather["Weather Intelligence"]
  node_dfwweather["DFW Weather Detail<br/>[dfw.html]"]
  node_cltweather["CLT Weather Detail<br/>[clt.html]"]
end

subgraph group_alerts["Operational Alerts"]
  node_highwinds["High Winds Alert<br/>[High Winds.html]"]
  node_rampclosed["Ramp Closed Alert<br/>[Ramp Closed.html]"]
  node_yellowalert["Yellow Alert<br/>[Yellow Alert.html]"]
end

node_operator(("Operations Team"))
node_weatherapi["Aviation Weather API"]
node_corsproxies["CORS Proxy Chain"]

node_operator -->|"opens"| node_dashboard
node_dashboard -->|"shows"| node_countdowns
node_dashboard -->|"polls"| node_weatherfetch
node_weatherfetch -->|"fetches"| node_weatherapi
node_weatherfetch -->|"falls back"| node_corsproxies
node_weatherfetch -->|"parses response"| node_metarparse
node_dashboard -->|"displays"| node_weatherdisplay
node_dashboard -->|"provides"| node_settings
node_dashboard -->|"uses"| node_watchdogs
node_watchdogs -->|"fails over"| node_clocks
node_operator -->|"opens"| node_clocks
node_operator -->|"opens"| node_dfwweather
node_operator -->|"opens"| node_cltweather
node_operator -->|"opens"| node_highwinds
node_operator -->|"opens"| node_rampclosed
node_operator -.->|"opens"| node_yellowalert

click node_dashboard "https://github.com/aea2669/hctime/blob/main/index.html"
click node_countdowns "https://github.com/aea2669/hctime/blob/main/index.html"
click node_settings "https://github.com/aea2669/hctime/blob/main/index.html"
click node_weatherfetch "https://github.com/aea2669/hctime/blob/main/index.html"
click node_metarparse "https://github.com/aea2669/hctime/blob/main/index.html"
click node_weatherdisplay "https://github.com/aea2669/hctime/blob/main/index.html"
click node_watchdogs "https://github.com/aea2669/hctime/blob/main/index.html"
click node_clocks "https://github.com/aea2669/hctime/blob/main/Clocks.html"
click node_dfwweather "https://github.com/aea2669/hctime/blob/main/dfw.html"
click node_cltweather "https://github.com/aea2669/hctime/blob/main/clt.html"
click node_highwinds "https://github.com/aea2669/hctime/blob/main/High%20Winds.html"
click node_rampclosed "https://github.com/aea2669/hctime/blob/main/Ramp%20Closed.html"
click node_yellowalert "https://github.com/aea2669/hctime/blob/main/Yellow%20Alert.html"

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_dashboard,node_countdowns,node_settings,node_weatherfetch,node_metarparse,node_weatherdisplay,node_watchdogs toneBlue
class node_clocks toneAmber
class node_dfwweather,node_cltweather,node_weatherapi toneMint
class node_highwinds,node_rampclosed,node_yellowalert toneRose
class node_operator,node_corsproxies toneIndigo
```

## Components

### Command Center

- [Operations Dashboard](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`
- [Schedule Countdowns](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`
- [Display Settings](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`
- [Weather Polling](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`
- [METAR Parsing](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`
- [Weather Overview](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`
- [Stability Watchdogs](https://github.com/aea2669/hctime/blob/main/index.html): `index.html`

### Time Displays

- [World Clocks](https://github.com/aea2669/hctime/blob/main/Clocks.html): `Clocks.html`

### Weather Intelligence

- [DFW Weather Detail](https://github.com/aea2669/hctime/blob/main/dfw.html): `dfw.html`
- [CLT Weather Detail](https://github.com/aea2669/hctime/blob/main/clt.html): `clt.html`

### Operational Alerts

- [High Winds Alert](https://github.com/aea2669/hctime/blob/main/High%20Winds.html): `High Winds.html`
- [Ramp Closed Alert](https://github.com/aea2669/hctime/blob/main/Ramp%20Closed.html): `Ramp Closed.html`
- [Yellow Alert](https://github.com/aea2669/hctime/blob/main/Yellow%20Alert.html): `Yellow Alert.html`

### Other components

- **Operations Team**
- **Aviation Weather API**
- **CORS Proxy Chain**

## Connections

- Operations Team → Operations Dashboard: opens (evidence: `README.md`)
- Operations Dashboard → Schedule Countdowns: shows (evidence: `README.md`)
- Operations Dashboard → Weather Polling: polls (evidence: `README.md`)
- Weather Polling → Aviation Weather API: fetches (evidence: `README.md`)
- Weather Polling → CORS Proxy Chain: falls back (evidence: `README.md`)
- Weather Polling → METAR Parsing: parses response (evidence: `README.md`)
- Operations Dashboard → Weather Overview: displays (evidence: `README.md`)
- Operations Dashboard → Display Settings: provides (evidence: `README.md`)
- Operations Dashboard → Stability Watchdogs: uses (evidence: `README.md`)
- Stability Watchdogs → World Clocks: fails over (evidence: `README.md`)
- Operations Team → World Clocks: opens (evidence: `README.md`)
- Operations Team → DFW Weather Detail: opens (evidence: `README.md`)
- Operations Team → CLT Weather Detail: opens (evidence: `README.md`)
- Operations Team → High Winds Alert: opens (evidence: `README.md`)
- Operations Team → Ramp Closed Alert: opens (evidence: `README.md`)
- Operations Team → Yellow Alert: opens
