# aagagu1/proyecto-zenith architecture

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

## Overview

The repository implements an environmental telemetry dashboard backend: it accepts submitted telemetry and also polls live weather and air-quality data, stores packets, and broadcasts them to connected WebSocket clients. The web tree includes a PHP entry point and dashboard assets, but their contents were not sampled, so their runtime behavior and wiring are uncertain. The graph distinguishes ingestion, persistence, and delivery; arrows reflect shown calls or documented server behavior, with unverified browser connectivity dashed.

Main entry points: [`python-services/catcher.py`](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py) (Live data poller), [`python-services/broadcaster.py`](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/broadcaster.py) (Packet receiver), [`web/public/index.php`](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/index.php) (PHP entry point), [`web/public/assets/index.html`](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/index.html) (Dashboard page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Telemetry ingestion"]
  node_catcher_api["Telemetry API<br/>[catcher.py]"]
  node_poller["Live data poller<br/>[catcher.py]"]
  node_transform["Packet preparation<br/>[catcher.py]"]
  node_mongo[("Packet collection<br/>[catcher.py]")]
end

subgraph group_delivery["Live delivery"]
  node_internal_receiver["Packet receiver<br/>[broadcaster.py]"]
  node_ws_broadcaster["WebSocket broadcaster<br/>[broadcaster.py]"]
end

subgraph group_web["Dashboard"]
  node_browser(("Dashboard browser"))
  node_php_entry["PHP entry point<br/>[index.php]"]
  node_dashboard_html["Dashboard page<br/>[index.html]"]
  node_dashboard_script["Dashboard script<br/>[script.js]"]
  node_ws_script["WebSocket client asset<br/>[telemetry-ws.js]"]
  node_dashboard_styles["Dashboard styles<br/>[styles.css]"]
end

subgraph group_external["External data"]
  node_weather["Weather API"]
  node_air_quality["Air quality API"]
end

node_submitter(("Telemetry sender"))

node_submitter -->|"posts packets"| node_catcher_api
node_catcher_api -->|"stores packets"| node_mongo
node_catcher_api -->|"forwards packets"| node_internal_receiver
node_poller -->|"queries weather"| node_weather
node_poller -->|"queries air quality"| node_air_quality
node_poller -->|"prepares packets"| node_transform
node_poller -->|"stores packets"| node_mongo
node_poller -->|"forwards packets"| node_internal_receiver
node_internal_receiver -->|"broadcasts packets"| node_ws_broadcaster
node_browser -.->|"connects by WebSocket"| node_ws_broadcaster
node_php_entry -->|"loads page"| node_dashboard_html

click node_catcher_api "https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py"
click node_poller "https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py"
click node_transform "https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py"
click node_mongo "https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py"
click node_internal_receiver "https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/broadcaster.py"
click node_ws_broadcaster "https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/broadcaster.py"
click node_php_entry "https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/index.php"
click node_dashboard_html "https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/index.html"
click node_dashboard_script "https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/script.js"
click node_ws_script "https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/telemetry-ws.js"
click node_dashboard_styles "https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/styles.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_catcher_api,node_poller,node_transform,node_mongo toneBlue
class node_internal_receiver,node_ws_broadcaster toneAmber
class node_browser,node_php_entry,node_dashboard_html,node_dashboard_script,node_ws_script,node_dashboard_styles toneMint
class node_weather,node_air_quality toneRose
class node_submitter toneIndigo
```

## Components

### Telemetry ingestion

- [Telemetry API](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py): `python-services/catcher.py`
- [Live data poller](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py): `python-services/catcher.py`
- [Packet preparation](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py): `python-services/catcher.py`
- [Packet collection](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/catcher.py): `python-services/catcher.py`

### Live delivery

- [Packet receiver](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/broadcaster.py): `python-services/broadcaster.py`
- [WebSocket broadcaster](https://github.com/aagagu1/proyecto-zenith/blob/main/python-services/broadcaster.py): `python-services/broadcaster.py`

### Dashboard

- **Dashboard browser**
- [PHP entry point](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/index.php): `web/public/index.php`
- [Dashboard page](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/index.html): `web/public/assets/index.html`
- [Dashboard script](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/script.js): `web/public/assets/script.js`
- [WebSocket client asset](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/telemetry-ws.js): `web/public/assets/telemetry-ws.js`
- [Dashboard styles](https://github.com/aagagu1/proyecto-zenith/blob/main/web/public/assets/styles.css): `web/public/assets/styles.css`

### External data

- **Weather API**
- **Air quality API**

### Other components

- **Telemetry sender**

## Connections

- Telemetry sender → Telemetry API: posts packets (evidence: `python-services/catcher.py`)
- Telemetry API → Packet collection: stores packets (evidence: `python-services/catcher.py`)
- Telemetry API → Packet receiver: forwards packets (evidence: `python-services/catcher.py`)
- Live data poller → Weather API: queries weather (evidence: `python-services/catcher.py`)
- Live data poller → Air quality API: queries air quality (evidence: `python-services/catcher.py`)
- Live data poller → Packet preparation: prepares packets (evidence: `python-services/catcher.py`)
- Live data poller → Packet collection: stores packets (evidence: `python-services/catcher.py`)
- Live data poller → Packet receiver: forwards packets (evidence: `python-services/catcher.py`)
- Packet receiver → WebSocket broadcaster: broadcasts packets (evidence: `python-services/broadcaster.py`)
- Dashboard browser → WebSocket broadcaster: connects by WebSocket
- PHP entry point → Dashboard page: loads page (evidence: `web/public/index.php`)
