# nodestark/mdb-esp32-cashless architecture

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

- Interactive diagram: https://gitdiagram.com/nodestark/mdb-esp32-cashless
- Repository: https://github.com/nodestark/mdb-esp32-cashless

## Overview

VMflow is an IoT vending platform spanning ESP32 machine control, operator mobile and web clients, cloud payment/credit functions, and telemetry. A typical operator workflow is to register and configure a board, monitor machines and sales, then issue credit; a payer can instead request an x402 quote and pay for a vend. README statements establish the broad product links; source excerpts and the index support only selected implementation relationships, so other links are omitted rather than inferred.

Main entry points: [`docker/volumes/mqtt/domain/mqtt_domain.py`](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/mqtt/domain/mqtt_domain.py) (MQTT Service), [`mdb-slave-esp32s3/main/mdb-slave-esp32s3.c`](https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/mdb-slave-esp32s3.c) (MDB Controller), [`android/app/src/main/java/xyz/vmflow/target/MainActivity.java`](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/MainActivity.java) (App Navigation), [`docker/volumes/functions/x402-vend/index.ts`](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/x402-vend/index.ts) (x402 Vend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_firmware["Machine Firmware"]
  node_firmware_main["MDB Controller"]
  node_eva["EVA DTS<br/>[eva-dts.c]"]
  node_ble["BLE Connectivity<br/>[nimble.c]"]
  node_device_auth["RPC Authentication<br/>[rpc-auth.c]"]
end

subgraph group_mobile["Android Operator App"]
  node_android_auth["Android Login<br/>[LoginActivity.java]"]
  node_android_nav["App Navigation<br/>[MainActivity.java]"]
  node_device_setup["Device Setup"]
  node_nearby["Nearby Devices"]
  node_machine_admin["Machine Admin"]
  node_sales_mobile["Sales View<br/>[SalesFragment.java]"]
end

subgraph group_web["Web Dashboard"]
  node_web_app["Dashboard Shell<br/>[App.vue]"]
  node_web_routes["Dashboard Views"]
  node_web_supabase["Web Data Client<br/>[supabase.js]"]
end

subgraph group_cloud["Cloud Functions"]
  node_edge_request["Request Credit<br/>[index.ts]"]
  node_edge_send["Send Credit<br/>[index.ts]"]
  node_edge_payload["Signed RPC Payload<br/>[vmflow-payload.ts]"]
  node_x402["x402 Vend<br/>[index.ts]"]
  node_checkout["Checkout Functions<br/>[index.ts]"]
  node_webhooks["Payment Webhooks<br/>[index.ts]"]
end

node_operator(("Operator"))
node_payer(("Payer or Agent"))
node_mqtt["MQTT Service<br/>[mqtt_domain.py]"]
node_supabase[("Supabase")]
node_facilitator["x402 Facilitator"]

node_operator -->|"logs in"| node_android_auth
node_android_auth -->|"opens app"| node_android_nav
node_android_nav -->|"navigates to"| node_device_setup
node_android_nav -->|"navigates to"| node_nearby
node_android_nav -->|"navigates to"| node_machine_admin
node_android_nav -->|"navigates to"| node_sales_mobile
node_device_setup -->|"sends credit"| node_mqtt
node_nearby -->|"requests credit"| node_edge_request
node_operator -->|"opens dashboard"| node_web_app
node_web_app -->|"renders views"| node_web_routes
node_web_routes -.->|"uses data client"| node_web_supabase
node_operator -->|"sends credit"| node_edge_send
node_edge_request -->|"signs RPC"| node_edge_payload
node_edge_send -->|"signs RPC"| node_edge_payload
node_edge_request -->|"publishes command"| node_mqtt
node_edge_send -->|"publishes command"| node_mqtt
node_mqtt -->|"delivers commands"| node_firmware_main
node_firmware_main -->|"uses authentication"| node_device_auth
node_firmware_main -->|"uses BLE"| node_ble
node_firmware_main -->|"uses EVA DTS"| node_eva
node_firmware_main -->|"reports telemetry"| node_mqtt
node_payer -->|"requests vend"| node_x402
node_x402 -->|"verifies payment"| node_facilitator
node_x402 -->|"signs credit"| node_edge_payload
node_x402 -->|"publishes vend"| node_mqtt
node_operator -.->|"starts checkout"| node_checkout
node_checkout -.->|"payment callback"| node_webhooks
node_webhooks -->|"signs credit"| node_edge_payload
node_webhooks -.->|"publishes credit"| node_mqtt
node_android_auth -->|"authenticates"| node_supabase
node_machine_admin -->|"reads and writes"| node_supabase
node_sales_mobile -.->|"reads sales"| node_supabase
node_web_supabase -.->|"accesses data"| node_supabase

click node_firmware_main "https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/mdb-slave-esp32s3.c"
click node_eva "https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/eva-dts.c"
click node_ble "https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/nimble.c"
click node_device_auth "https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/rpc-auth.c"
click node_android_auth "https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/LoginActivity.java"
click node_android_nav "https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/MainActivity.java"
click node_device_setup "https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/EmbeddesFragment.java"
click node_nearby "https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/NearestFragment.java"
click node_machine_admin "https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/MachinesFragment.java"
click node_sales_mobile "https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/SalesFragment.java"
click node_web_app "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/vuejs/src/App.vue"
click node_web_routes "https://github.com/nodestark/mdb-esp32-cashless/tree/main/docker/vuejs/src/views"
click node_web_supabase "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/vuejs/src/lib/supabase.js"
click node_edge_request "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/request-credit/index.ts"
click node_edge_send "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/send-credit/index.ts"
click node_edge_payload "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/_shared/vmflow-payload.ts"
click node_x402 "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/x402-vend/index.ts"
click node_checkout "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/create-checkout-stripe/index.ts"
click node_webhooks "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/webhook-stripe/index.ts"
click node_mqtt "https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/mqtt/domain/mqtt_domain.py"

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_firmware_main,node_eva,node_ble,node_device_auth toneBlue
class node_android_auth,node_android_nav,node_device_setup,node_nearby,node_machine_admin,node_sales_mobile,node_supabase toneAmber
class node_web_app,node_web_routes,node_web_supabase toneMint
class node_edge_request,node_edge_send,node_edge_payload,node_x402,node_checkout,node_webhooks toneRose
class node_operator,node_payer,node_facilitator toneIndigo
class node_mqtt toneTeal
```

## Components

### Machine Firmware

- [MDB Controller](https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/mdb-slave-esp32s3.c): `mdb-slave-esp32s3/main/mdb-slave-esp32s3.c`
- [EVA DTS](https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/eva-dts.c): `mdb-slave-esp32s3/main/eva-dts.c`
- [BLE Connectivity](https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/nimble.c): `mdb-slave-esp32s3/main/nimble.c`
- [RPC Authentication](https://github.com/nodestark/mdb-esp32-cashless/blob/main/mdb-slave-esp32s3/main/rpc-auth.c): `mdb-slave-esp32s3/main/rpc-auth.c`

### Android Operator App

- [Android Login](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/LoginActivity.java): `android/app/src/main/java/xyz/vmflow/target/LoginActivity.java`
- [App Navigation](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/MainActivity.java): `android/app/src/main/java/xyz/vmflow/target/MainActivity.java`
- [Device Setup](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/EmbeddesFragment.java): `android/app/src/main/java/xyz/vmflow/target/EmbeddesFragment.java`
- [Nearby Devices](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/NearestFragment.java): `android/app/src/main/java/xyz/vmflow/target/NearestFragment.java`
- [Machine Admin](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/MachinesFragment.java): `android/app/src/main/java/xyz/vmflow/target/MachinesFragment.java`
- [Sales View](https://github.com/nodestark/mdb-esp32-cashless/blob/main/android/app/src/main/java/xyz/vmflow/target/SalesFragment.java): `android/app/src/main/java/xyz/vmflow/target/SalesFragment.java`

### Web Dashboard

- [Dashboard Shell](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/vuejs/src/App.vue): `docker/vuejs/src/App.vue`
- [Dashboard Views](https://github.com/nodestark/mdb-esp32-cashless/tree/main/docker/vuejs/src/views): `docker/vuejs/src/views`
- [Web Data Client](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/vuejs/src/lib/supabase.js): `docker/vuejs/src/lib/supabase.js`

### Cloud Functions

- [Request Credit](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/request-credit/index.ts): `docker/volumes/functions/request-credit/index.ts`
- [Send Credit](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/send-credit/index.ts): `docker/volumes/functions/send-credit/index.ts`
- [Signed RPC Payload](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/_shared/vmflow-payload.ts): `docker/volumes/functions/_shared/vmflow-payload.ts`
- [x402 Vend](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/x402-vend/index.ts): `docker/volumes/functions/x402-vend/index.ts`
- [Checkout Functions](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/create-checkout-stripe/index.ts): `docker/volumes/functions/create-checkout-stripe/index.ts`
- [Payment Webhooks](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/functions/webhook-stripe/index.ts): `docker/volumes/functions/webhook-stripe/index.ts`

### Other components

- **Operator**
- **Payer or Agent**
- [MQTT Service](https://github.com/nodestark/mdb-esp32-cashless/blob/main/docker/volumes/mqtt/domain/mqtt_domain.py): `docker/volumes/mqtt/domain/mqtt_domain.py`
- **Supabase**
- **x402 Facilitator**

## Connections

- Operator → Android Login: logs in (evidence: `README.md`)
- Android Login → App Navigation: opens app (evidence: `android/app/src/main/java/xyz/vmflow/target/LoginActivity.java`)
- App Navigation → Device Setup: navigates to (evidence: `android/app/src/main/java/xyz/vmflow/target/MainActivity.java`)
- App Navigation → Nearby Devices: navigates to (evidence: `android/app/src/main/java/xyz/vmflow/target/MainActivity.java`)
- App Navigation → Machine Admin: navigates to (evidence: `android/app/src/main/java/xyz/vmflow/target/MainActivity.java`)
- App Navigation → Sales View: navigates to (evidence: `android/app/src/main/java/xyz/vmflow/target/MainActivity.java`)
- Device Setup → MQTT Service: sends credit (evidence: `README.md`)
- Nearby Devices → Request Credit: requests credit (evidence: `android/app/src/main/java/xyz/vmflow/target/NearestFragment.java`)
- Operator → Dashboard Shell: opens dashboard (evidence: `README.md`)
- Dashboard Shell → Dashboard Views: renders views
- Dashboard Views → Web Data Client: uses data client
- Operator → Send Credit: sends credit (evidence: `README.md`)
- Request Credit → Signed RPC Payload: signs RPC (evidence: `docker/volumes/functions/request-credit/index.ts`)
- Send Credit → Signed RPC Payload: signs RPC (evidence: `docker/volumes/functions/send-credit/index.ts`)
- Request Credit → MQTT Service: publishes command (evidence: `README.md`)
- Send Credit → MQTT Service: publishes command (evidence: `README.md`)
- MQTT Service → MDB Controller: delivers commands (evidence: `README.md`)
- MDB Controller → RPC Authentication: uses authentication (evidence: `mdb-slave-esp32s3/main/mdb-slave-esp32s3.c`)
- MDB Controller → BLE Connectivity: uses BLE (evidence: `mdb-slave-esp32s3/main/mdb-slave-esp32s3.c`)
- MDB Controller → EVA DTS: uses EVA DTS (evidence: `mdb-slave-esp32s3/main/mdb-slave-esp32s3.c`)
- MDB Controller → MQTT Service: reports telemetry (evidence: `README.md`)
- Payer or Agent → x402 Vend: requests vend (evidence: `README.md`)
- x402 Vend → x402 Facilitator: verifies payment (evidence: `docker/volumes/functions/x402-vend/index.ts`)
- x402 Vend → Signed RPC Payload: signs credit (evidence: `docker/volumes/functions/x402-vend/index.ts`)
- x402 Vend → MQTT Service: publishes vend (evidence: `docker/volumes/functions/x402-vend/index.ts`)
- Operator → Checkout Functions: starts checkout
- Checkout Functions → Payment Webhooks: payment callback
- Payment Webhooks → Signed RPC Payload: signs credit (evidence: `docker/volumes/functions/webhook-stripe/index.ts`)
- Payment Webhooks → MQTT Service: publishes credit
- Android Login → Supabase: authenticates (evidence: `android/app/src/main/java/xyz/vmflow/target/LoginActivity.java`)
- Machine Admin → Supabase: reads and writes (evidence: `android/app/src/main/java/xyz/vmflow/target/MachinesFragment.java`)
- Sales View → Supabase: reads sales
- Web Data Client → Supabase: accesses data
