# jonathanchan1996/enosewebble architecture

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

## Overview

eNoseWebBle is a browser dashboard for connecting to an eNose BLE sensor, polling its readings, visualizing them, and downloading logged data as CSV. The principal workflow runs from user controls through BLE connection and acquisition to live display and export; time-series plotting and reconnect behavior are additional capabilities. The sampled source places these behaviors in app.js; index.html and style.css are present, but their contents were not provided, so UI implementation details beyond the app’s DOM bindings are not inferred.

Main entry points: [`app.js`](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js) (Dashboard controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["BLE acquisition"]
  node_controls["Dashboard controls<br/>[app.js]"]
  node_ble["Web Bluetooth<br/>[app.js]"]
  node_poller["Reading poller<br/>[app.js]"]
  node_reconnect["Reconnect handling<br/>[app.js]"]
  node_decode["Sensor decoding<br/>[app.js]"]
end

subgraph group_dashboard["Live dashboard"]
  node_live["Live sensor grid<br/>[app.js]"]
  node_timeseries["Time-series plot<br/>[app.js]"]
  node_selection["Sensor selection<br/>[app.js]"]
end

subgraph group_export["Data export"]
  node_log[("Reading log<br/>[app.js]")]
  node_csv["CSV generation<br/>[app.js]"]
  node_download["CSV download<br/>[app.js]"]
end

node_user(("Dashboard user"))
node_sensor{{"eNose BLE module"}}

node_user -->|"uses"| node_controls
node_controls -->|"connects via"| node_ble
node_ble -->|"connects to"| node_sensor
node_controls -->|"starts or stops"| node_poller
node_poller -->|"reads data"| node_ble
node_ble -->|"reads characteristics"| node_sensor
node_poller -->|"recovers errors"| node_reconnect
node_poller -->|"decodes readings"| node_decode
node_decode -->|"renders values"| node_live
node_decode -->|"appends readings"| node_log
node_decode -->|"updates samples"| node_timeseries
node_selection -->|"selects sensors"| node_timeseries
node_controls -->|"configures sensors"| node_selection
node_controls -->|"requests export"| node_csv
node_csv -->|"serializes rows"| node_log
node_csv -->|"creates file"| node_download
node_download -->|"saves CSV"| node_user

click node_controls "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_ble "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_poller "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_reconnect "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_decode "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_live "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_timeseries "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_selection "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_log "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_csv "https://github.com/jonathanchan1996/enosewebble/blob/main/app.js"
click node_download "https://github.com/jonathanchan1996/enosewebble/blob/main/app.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_controls,node_ble,node_poller,node_reconnect,node_decode,node_user toneBlue
class node_live,node_timeseries,node_selection toneAmber
class node_log,node_csv,node_download toneMint
class node_sensor toneIndigo
```

## Components

### BLE acquisition

- [Dashboard controls](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [Web Bluetooth](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [Reading poller](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [Reconnect handling](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [Sensor decoding](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`

### Live dashboard

- [Live sensor grid](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [Time-series plot](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [Sensor selection](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`

### Data export

- [Reading log](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [CSV generation](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`
- [CSV download](https://github.com/jonathanchan1996/enosewebble/blob/main/app.js): `app.js`

### Other components

- **Dashboard user**
- **eNose BLE module**

## Connections

- Dashboard user → Dashboard controls: uses (evidence: `app.js`)
- Dashboard controls → Web Bluetooth: connects via (evidence: `app.js`)
- Web Bluetooth → eNose BLE module: connects to (evidence: `app.js`)
- Dashboard controls → Reading poller: starts or stops (evidence: `app.js`)
- Reading poller → Web Bluetooth: reads data (evidence: `app.js`)
- Web Bluetooth → eNose BLE module: reads characteristics (evidence: `app.js`)
- Reading poller → Reconnect handling: recovers errors (evidence: `app.js`)
- Reading poller → Sensor decoding: decodes readings (evidence: `app.js`)
- Sensor decoding → Live sensor grid: renders values (evidence: `app.js`)
- Sensor decoding → Reading log: appends readings (evidence: `app.js`)
- Sensor decoding → Time-series plot: updates samples (evidence: `app.js`)
- Sensor selection → Time-series plot: selects sensors (evidence: `app.js`)
- Dashboard controls → Sensor selection: configures sensors (evidence: `app.js`)
- Dashboard controls → CSV generation: requests export (evidence: `app.js`)
- CSV generation → Reading log: serializes rows (evidence: `app.js`)
- CSV generation → CSV download: creates file (evidence: `app.js`)
- CSV download → Dashboard user: saves CSV (evidence: `README.md`)
