# altaga/doppler-drone architecture

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

- Interactive diagram: https://gitdiagram.com/altaga/doppler-drone
- Repository: https://github.com/altaga/doppler-drone

## Overview

Doppler-Drone is a disaster-response system that uses drones to deploy hotspot-tracking devices, relay counts of people and injured people, and guide delivery of customized medical supplies. The documented cloud workflow sends Sigfox data through Watson IoT to a Python console, stores alerts in Cloudant, and presents information on a web app. The repository also includes a Bluetooth-controlled claw module. The README describes several cloud links and product capabilities; where source excerpts are absent, the graph reflects documented links rather than inferred implementation details.

Main entry points: [`Watson Studio/Python Jupyter Notebook/Call4CodePython.ipynb`](https://github.com/altaga/doppler-drone/blob/master/Watson%20Studio/Python%20Jupyter%20Notebook/Call4CodePython.ipynb) (Python Console), [`Sigfox Module/Arduino Code/Arduino_LCD-Pot-Serial.ino`](https://github.com/altaga/doppler-drone/blob/master/Sigfox%20Module/Arduino%20Code/Arduino_LCD-Pot-Serial.ino) (Hotspot Tracker), [`WepApp/index.html`](https://github.com/altaga/doppler-drone/blob/master/WepApp/index.html) (Web App), [`Sigfox Module/Pycom Code/main.py`](https://github.com/altaga/doppler-drone/blob/master/Sigfox%20Module/Pycom%20Code/main.py) (Sigfox Uplink)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_field["Field Equipment"]
  node_drone["Delivery Drone"]
  node_hotspot["Hotspot Tracker"]
  node_sigfox_pycom["Sigfox Uplink<br/>[main.py]"]
  node_claw["Bluetooth Claw<br/>[Claw.ino]"]
end

subgraph group_telemetry["Telemetry Cloud"]
  node_sigfox_backend["Sigfox Backend"]
  node_watson_iot["Watson IoT"]
  node_console["Python Console"]
  node_cloudant[("Cloudant DB")]
end

subgraph group_dashboard["Command Dashboard"]
  node_webapp["Web App<br/>[index.html]"]
  node_mqtt_client["MQTT Client<br/>[mqttws31.js]"]
end

subgraph group_response["Aid Response"]
  node_medical_aid["Medical Packages"]
end

node_authorities(("Responders"))

node_drone -->|"deploys tracker"| node_hotspot
node_hotspot -->|"sends readings"| node_sigfox_backend
node_sigfox_pycom -->|"sends bytes"| node_sigfox_backend
node_sigfox_backend -->|"forwards data"| node_watson_iot
node_watson_iot -->|"delivers events"| node_console
node_console -->|"stores alerts"| node_cloudant
node_watson_iot -->|"sends information"| node_webapp
node_cloudant -->|"provides database data"| node_webapp
node_mqtt_client -.->|"MQTT messaging"| node_watson_iot
node_authorities -.->|"controls by Bluetooth"| node_claw
node_authorities -->|"dispatches aid"| node_drone
node_drone -->|"delivers supplies"| node_medical_aid
node_console -->|"informs targeting"| node_authorities

click node_hotspot "https://github.com/altaga/doppler-drone/blob/master/Sigfox%20Module/Arduino%20Code/Arduino_LCD-Pot-Serial.ino"
click node_sigfox_pycom "https://github.com/altaga/doppler-drone/blob/master/Sigfox%20Module/Pycom%20Code/main.py"
click node_claw "https://github.com/altaga/doppler-drone/blob/master/Claw%20Module/Arduino%20Code/Claw.ino"
click node_console "https://github.com/altaga/doppler-drone/blob/master/Watson%20Studio/Python%20Jupyter%20Notebook/Call4CodePython.ipynb"
click node_webapp "https://github.com/altaga/doppler-drone/blob/master/WepApp/index.html"
click node_mqtt_client "https://github.com/altaga/doppler-drone/blob/master/WepApp/js/mqttws31.js"

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_drone,node_hotspot,node_sigfox_pycom,node_claw toneBlue
class node_sigfox_backend,node_watson_iot,node_console,node_cloudant toneAmber
class node_webapp,node_mqtt_client toneMint
class node_medical_aid toneRose
class node_authorities toneIndigo
```

## Components

### Field Equipment

- **Delivery Drone**
- [Hotspot Tracker](https://github.com/altaga/doppler-drone/blob/master/Sigfox%20Module/Arduino%20Code/Arduino_LCD-Pot-Serial.ino): `Sigfox Module/Arduino Code/Arduino_LCD-Pot-Serial.ino`
- [Sigfox Uplink](https://github.com/altaga/doppler-drone/blob/master/Sigfox%20Module/Pycom%20Code/main.py): `Sigfox Module/Pycom Code/main.py`
- [Bluetooth Claw](https://github.com/altaga/doppler-drone/blob/master/Claw%20Module/Arduino%20Code/Claw.ino): `Claw Module/Arduino Code/Claw.ino`

### Telemetry Cloud

- **Sigfox Backend**
- **Watson IoT**
- [Python Console](https://github.com/altaga/doppler-drone/blob/master/Watson%20Studio/Python%20Jupyter%20Notebook/Call4CodePython.ipynb): `Watson Studio/Python Jupyter Notebook/Call4CodePython.ipynb`
- **Cloudant DB**

### Command Dashboard

- [Web App](https://github.com/altaga/doppler-drone/blob/master/WepApp/index.html): `WepApp/index.html`
- [MQTT Client](https://github.com/altaga/doppler-drone/blob/master/WepApp/js/mqttws31.js): `WepApp/js/mqttws31.js`

### Aid Response

- **Medical Packages**

### Other components

- **Responders**

## Connections

- Delivery Drone → Hotspot Tracker: deploys tracker
- Hotspot Tracker → Sigfox Backend: sends readings
- Sigfox Uplink → Sigfox Backend: sends bytes
- Sigfox Backend → Watson IoT: forwards data
- Watson IoT → Python Console: delivers events
- Python Console → Cloudant DB: stores alerts
- Watson IoT → Web App: sends information
- Cloudant DB → Web App: provides database data
- MQTT Client → Watson IoT: MQTT messaging
- Responders → Bluetooth Claw: controls by Bluetooth
- Responders → Delivery Drone: dispatches aid
- Delivery Drone → Medical Packages: delivers supplies
- Python Console → Responders: informs targeting