# ritabrata777/aura architecture

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

- Interactive diagram: https://gitdiagram.com/ritabrata777/aura
- Repository: https://github.com/ritabrata777/aura

## Overview

This is an ESP32 health-monitoring device and web platform. Sensors collect vitals and ECG; firmware sends readings over MQTT, the API validates and routes them to account-specific storage, and dashboards receive live updates or request history. Provisioning and pairing associate devices with patient or individual-user accounts, while the clinical platform also supports doctor relationships, prescriptions, and video consultations. The README documents the system flow; unsampled implementation links are omitted where their callers are not established.

Main entry points: [`web-platform/apps/web/lib/api.ts`](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/web/lib/api.ts) (API client), [`main/esp32-health-device.c`](https://github.com/ritabrata777/aura/blob/main/main/esp32-health-device.c) (Firmware application), [`web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts`](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts) (MQTT ingestion), [`web-platform/apps/web/app`](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/web/app) (Health dashboards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Device firmware"]
  node_sensors["Vital sensors<br/>[max30102.c]"]
  node_ecg["ECG capture<br/>[ecg_ad8232.c]"]
  node_wifi["Wi-Fi manager<br/>[wifi_manager.c]"]
  node_device_comm["Device messaging<br/>[device_comm.c]"]
  node_firmware_app["Firmware application"]
end

subgraph group_platform["API platform"]
  node_mqtt_ingestion["MQTT ingestion"]
  node_auth["Accounts and auth<br/>[auth.service.ts]"]
  node_devices["Device provisioning"]
  node_measurements["Measurements"]
  node_relationships["Doctor relationships<br/>[doctors.service.ts]"]
  node_prescriptions["Prescriptions"]
  node_video["Video consultations"]
  node_ai["AI companion<br/>[ai.service.ts]"]
  node_individual["Wellness accounts"]
  node_websocket["Live updates"]
end

subgraph group_web["Web experience"]
  node_webapp["Health dashboards"]
  node_web_api["API client<br/>[api.ts]"]
  node_web_live["Live client<br/>[live.ts]"]
end

subgraph group_infra["Data and messaging"]
  node_postgres[("PostgreSQL")]
  node_broker["MQTT broker"]
  node_protocol["Shared protocol<br/>[index.ts]"]
end

node_person(("Patient or user"))

node_person -->|"uses"| node_webapp
node_webapp -->|"requests"| node_web_api
node_web_api -->|"authenticates"| node_auth
node_web_api -->|"provisions and pairs"| node_devices
node_web_api -->|"fetches history"| node_measurements
node_web_api -->|"manages care"| node_relationships
node_web_api -->|"manages prescriptions"| node_prescriptions
node_web_api -->|"requests tokens"| node_video
node_web_api -.->|"sends chat"| node_ai
node_webapp -->|"receives updates"| node_web_live
node_web_live -->|"connects by Socket.IO"| node_websocket
node_firmware_app -.->|"reads sensors"| node_sensors
node_firmware_app -.->|"captures ECG"| node_ecg
node_firmware_app -.->|"connects network"| node_wifi
node_firmware_app -.->|"sends device messages"| node_device_comm
node_device_comm -->|"publishes and subscribes"| node_broker
node_broker -->|"delivers device traffic"| node_mqtt_ingestion
node_mqtt_ingestion -->|"validates payloads"| node_protocol
node_mqtt_ingestion -->|"persists readings"| node_postgres
node_mqtt_ingestion -->|"broadcasts events"| node_websocket
node_devices -->|"stores device records"| node_postgres
node_auth -->|"stores account data"| node_postgres
node_relationships -->|"stores relationships"| node_postgres
node_individual -->|"stores wellness data"| node_postgres
node_person -.->|"is monitored"| node_firmware_app

click node_sensors "https://github.com/ritabrata777/aura/blob/main/main/max30102.c"
click node_ecg "https://github.com/ritabrata777/aura/blob/main/main/ecg_ad8232.c"
click node_wifi "https://github.com/ritabrata777/aura/blob/main/main/wifi_manager.c"
click node_device_comm "https://github.com/ritabrata777/aura/blob/main/main/device_comm.c"
click node_firmware_app "https://github.com/ritabrata777/aura/blob/main/main/esp32-health-device.c"
click node_mqtt_ingestion "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts"
click node_auth "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/auth/auth.service.ts"
click node_devices "https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/devices"
click node_measurements "https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/measurements"
click node_relationships "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/doctors/doctors.service.ts"
click node_prescriptions "https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/prescriptions"
click node_video "https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/video"
click node_ai "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/ai/ai.service.ts"
click node_individual "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/individual-users/individual-users.service.ts"
click node_websocket "https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/websocket"
click node_webapp "https://github.com/ritabrata777/aura/tree/main/web-platform/apps/web/app"
click node_web_api "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/web/lib/api.ts"
click node_web_live "https://github.com/ritabrata777/aura/blob/main/web-platform/apps/web/lib/live.ts"
click node_protocol "https://github.com/ritabrata777/aura/blob/main/web-platform/packages/protocol/src/index.ts"

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_sensors,node_ecg,node_wifi,node_device_comm,node_firmware_app,node_person toneBlue
class node_mqtt_ingestion,node_auth,node_devices,node_measurements,node_relationships,node_prescriptions,node_video,node_ai,node_individual,node_websocket toneAmber
class node_webapp,node_web_api,node_web_live toneMint
class node_postgres,node_broker,node_protocol toneRose
```

## Components

### Device firmware

- [Vital sensors](https://github.com/ritabrata777/aura/blob/main/main/max30102.c): `main/max30102.c`
- [ECG capture](https://github.com/ritabrata777/aura/blob/main/main/ecg_ad8232.c): `main/ecg_ad8232.c`
- [Wi-Fi manager](https://github.com/ritabrata777/aura/blob/main/main/wifi_manager.c): `main/wifi_manager.c`
- [Device messaging](https://github.com/ritabrata777/aura/blob/main/main/device_comm.c): `main/device_comm.c`
- [Firmware application](https://github.com/ritabrata777/aura/blob/main/main/esp32-health-device.c): `main/esp32-health-device.c`

### API platform

- [MQTT ingestion](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts): `web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts`
- [Accounts and auth](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/auth/auth.service.ts): `web-platform/apps/api/src/auth/auth.service.ts`
- [Device provisioning](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/devices): `web-platform/apps/api/src/devices`
- [Measurements](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/measurements): `web-platform/apps/api/src/measurements`
- [Doctor relationships](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/doctors/doctors.service.ts): `web-platform/apps/api/src/doctors/doctors.service.ts`
- [Prescriptions](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/prescriptions): `web-platform/apps/api/src/prescriptions`
- [Video consultations](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/video): `web-platform/apps/api/src/video`
- [AI companion](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/ai/ai.service.ts): `web-platform/apps/api/src/ai/ai.service.ts`
- [Wellness accounts](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/api/src/individual-users/individual-users.service.ts): `web-platform/apps/api/src/individual-users/individual-users.service.ts`
- [Live updates](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/api/src/websocket): `web-platform/apps/api/src/websocket`

### Web experience

- [Health dashboards](https://github.com/ritabrata777/aura/tree/main/web-platform/apps/web/app): `web-platform/apps/web/app`
- [API client](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/web/lib/api.ts): `web-platform/apps/web/lib/api.ts`
- [Live client](https://github.com/ritabrata777/aura/blob/main/web-platform/apps/web/lib/live.ts): `web-platform/apps/web/lib/live.ts`

### Data and messaging

- **PostgreSQL**
- **MQTT broker**
- [Shared protocol](https://github.com/ritabrata777/aura/blob/main/web-platform/packages/protocol/src/index.ts): `web-platform/packages/protocol/src/index.ts`

### Other components

- **Patient or user**

## Connections

- Patient or user → Health dashboards: uses
- Health dashboards → API client: requests
- API client → Accounts and auth: authenticates
- API client → Device provisioning: provisions and pairs
- API client → Measurements: fetches history
- API client → Doctor relationships: manages care
- API client → Prescriptions: manages prescriptions
- API client → Video consultations: requests tokens
- API client → AI companion: sends chat
- Health dashboards → Live client: receives updates
- Live client → Live updates: connects by Socket.IO
- Firmware application → Vital sensors: reads sensors
- Firmware application → ECG capture: captures ECG
- Firmware application → Wi-Fi manager: connects network
- Firmware application → Device messaging: sends device messages
- Device messaging → MQTT broker: publishes and subscribes
- MQTT broker → MQTT ingestion: delivers device traffic
- MQTT ingestion → Shared protocol: validates payloads (evidence: `web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts`)
- MQTT ingestion → PostgreSQL: persists readings
- MQTT ingestion → Live updates: broadcasts events (evidence: `web-platform/apps/api/src/mqtt/mqtt.ingestion.service.ts`)
- Device provisioning → PostgreSQL: stores device records (evidence: `web-platform/apps/api/src/devices/devices.service.ts`)
- Accounts and auth → PostgreSQL: stores account data (evidence: `web-platform/apps/api/src/auth/auth.service.ts`)
- Doctor relationships → PostgreSQL: stores relationships (evidence: `web-platform/apps/api/src/doctors/doctors.service.ts`)
- Wellness accounts → PostgreSQL: stores wellness data (evidence: `web-platform/apps/api/src/individual-users/individual-users.service.ts`)
- Patient or user → Firmware application: is monitored
