How nodestark/mdb-esp32-cashless works
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: mqtt_domain.py MQTT Service · mdb-slave-esp32s3.c MDB Controller · MainActivity.java App Navigation · index.ts x402 Vend
Components 24
Machine Firmware
- MDB Controller
mdb-slave-esp32s3/main/mdb-slave-esp32s3.c - EVA DTS
mdb-slave-esp32s3/main/eva-dts.c - BLE Connectivity
mdb-slave-esp32s3/main/nimble.c - RPC Authentication
mdb-slave-esp32s3/main/rpc-auth.c
Android Operator App
- Android Login
android/app/src/main/java/xyz/vmflow/target/LoginActivity.java - App Navigation
android/app/src/main/java/xyz/vmflow/target/MainActivity.java - Device Setup
android/app/src/main/java/xyz/vmflow/target/EmbeddesFragment.java - Nearby Devices
android/app/src/main/java/xyz/vmflow/target/NearestFragment.java - Machine Admin
android/app/src/main/java/xyz/vmflow/target/MachinesFragment.java - Sales View
android/app/src/main/java/xyz/vmflow/target/SalesFragment.java
Web Dashboard
- Dashboard Shell
docker/vuejs/src/App.vue - Dashboard Views
docker/vuejs/src/views - Web Data Client
docker/vuejs/src/lib/supabase.js
Cloud Functions
- Request Credit
docker/volumes/functions/request-credit/index.ts - Send Credit
docker/volumes/functions/send-credit/index.ts - Signed RPC Payload
docker/volumes/functions/_shared/vmflow-payload.ts - x402 Vend
docker/volumes/functions/x402-vend/index.ts - Checkout Functions
docker/volumes/functions/create-checkout-stripe/index.ts - Payment Webhooks
docker/volumes/functions/webhook-stripe/index.ts
Other components
- Operator
- Payer or Agent
- MQTT Service
docker/volumes/mqtt/domain/mqtt_domain.py - Supabase
- x402 Facilitator
Connections 33
- Operator → Android Login: logs in
README.md - Android Login → App Navigation: opens app
android/app/src/main/java/xyz/vmflow/target/LoginActivity.java - App Navigation → Device Setup: navigates to
android/app/src/main/java/xyz/vmflow/target/MainActivity.java - App Navigation → Nearby Devices: navigates to
android/app/src/main/java/xyz/vmflow/target/MainActivity.java - App Navigation → Machine Admin: navigates to
android/app/src/main/java/xyz/vmflow/target/MainActivity.java - App Navigation → Sales View: navigates to
android/app/src/main/java/xyz/vmflow/target/MainActivity.java - Device Setup → MQTT Service: sends credit
README.md - Nearby Devices → Request Credit: requests credit
android/app/src/main/java/xyz/vmflow/target/NearestFragment.java - Operator → Dashboard Shell: opens dashboard
README.md - Dashboard Shell → Dashboard Views: renders views
- Dashboard Views → Web Data Client: uses data client
- Operator → Send Credit: sends credit
README.md - Request Credit → Signed RPC Payload: signs RPC
docker/volumes/functions/request-credit/index.ts - Send Credit → Signed RPC Payload: signs RPC
docker/volumes/functions/send-credit/index.ts - Request Credit → MQTT Service: publishes command
README.md - Send Credit → MQTT Service: publishes command
README.md - MQTT Service → MDB Controller: delivers commands
README.md - MDB Controller → RPC Authentication: uses authentication
mdb-slave-esp32s3/main/mdb-slave-esp32s3.c - MDB Controller → BLE Connectivity: uses BLE
mdb-slave-esp32s3/main/mdb-slave-esp32s3.c - MDB Controller → EVA DTS: uses EVA DTS
mdb-slave-esp32s3/main/mdb-slave-esp32s3.c - MDB Controller → MQTT Service: reports telemetry
README.md - Payer or Agent → x402 Vend: requests vend
README.md - x402 Vend → x402 Facilitator: verifies payment
docker/volumes/functions/x402-vend/index.ts - x402 Vend → Signed RPC Payload: signs credit
docker/volumes/functions/x402-vend/index.ts - x402 Vend → MQTT Service: publishes vend
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
docker/volumes/functions/webhook-stripe/index.ts - Payment Webhooks → MQTT Service: publishes credit
- Android Login → Supabase: authenticates
android/app/src/main/java/xyz/vmflow/target/LoginActivity.java - Machine Admin → Supabase: reads and writes
android/app/src/main/java/xyz/vmflow/target/MachinesFragment.java - Sales View → Supabase: reads sales
- Web Data Client → Supabase: accesses data