# kaonieowkai/program_python-smartems architecture

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

- Interactive diagram: https://gitdiagram.com/kaonieowkai/program_python-smartems
- Repository: https://github.com/kaonieowkai/program_python-smartems

## Overview

SmartEMS is a health-monitoring suite with a Tkinter desktop app, a separate PyQt Thai-ID reader, and a FastAPI web app. The desktop workflow combines patient identification with vital-sign monitoring and camera capture, then supports PDF reports and alert checking; the web app provides patient/statistics views, report management, and SQLite-backed data. The source index confirms some desktop imports, while other capability links rely on README descriptions; those are marked unverified. The checked-in virtual environment is third-party software, not part of the product map.

Main entry points: [`SmartEMS.py`](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py) (Desktop app), [`python_ThaiCID-GUI-PyQT6-main/main.py`](https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/main.py) (Card reader GUI), [`SmartEMS-WebApp/main.py`](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py) (Web application), [`max30102.py`](https://github.com/kaonieowkai/program_python-smartems/blob/main/max30102.py) (MAX30102 driver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop monitoring"]
  node_desktop_app["Desktop app<br/>[SmartEMS.py]"]
  node_vitals["Vital signs<br/>[SmartEMS.py]"]
  node_camera["Camera capture<br/>[SmartEMS.py]"]
  node_pdf["PDF reports<br/>[SmartEMS.py]"]
  node_alert_check["Alert checking<br/>[SmartEMS.py]"]
end

subgraph group_identity["Thai ID reading"]
  node_cid_reader["Thai CID reader<br/>[ThaiCIDReader.py]"]
  node_card_gui["Card reader GUI<br/>[main.py]"]
  node_card_helper["Card helper<br/>[ThaiCIDHelper.py]"]
  node_card_data["Card data<br/>[DataThaiCID.py]"]
  node_card_images["Card images<br/>[imageHelper.py]"]
  node_card_state["Card state thread"]
end

subgraph group_web["Web management"]
  node_web_app["Web application<br/>[main.py]"]
  node_patient_views["Patient statistics<br/>[main.py]"]
  node_report_admin["Report management<br/>[main.py]"]
  node_web_alerts["Alert dispatch<br/>[main.py]"]
  node_sqlite[("SQLite data<br/>[main.py]")]
end

subgraph group_device["Hardware"]
  node_sensor_driver["MAX30102 driver<br/>[max30102.py]"]
end

node_operator(("Operator"))
node_health_sensor{{"MAX30102 sensor"}}
node_camera_device{{"Camera"}}

node_operator -->|"uses"| node_desktop_app
node_desktop_app -->|"imports"| node_cid_reader
node_desktop_app -->|"imports"| node_sensor_driver
node_desktop_app -.->|"monitors"| node_vitals
node_vitals -.->|"reads sensor"| node_sensor_driver
node_sensor_driver -.->|"reads"| node_health_sensor
node_desktop_app -.->|"captures images"| node_camera
node_camera -.->|"captures from"| node_camera_device
node_desktop_app -.->|"creates reports"| node_pdf
node_desktop_app -.->|"checks alerts"| node_alert_check
node_desktop_app -.->|"checks alert file"| node_web_alerts
node_operator -.->|"uses"| node_card_gui
node_card_gui -->|"imports"| node_card_helper
node_card_gui -->|"imports"| node_card_data
node_card_gui -->|"imports"| node_card_images
node_card_gui -->|"imports"| node_card_state
node_operator -.->|"uses"| node_web_app
node_web_app -.->|"displays"| node_patient_views
node_web_app -.->|"manages"| node_report_admin
node_web_app -.->|"dispatches"| node_web_alerts
node_web_app -.->|"reads and writes"| node_sqlite

click node_desktop_app "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py"
click node_vitals "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py"
click node_camera "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py"
click node_pdf "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py"
click node_alert_check "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py"
click node_cid_reader "https://github.com/kaonieowkai/program_python-smartems/blob/main/ThaiCIDReader.py"
click node_sensor_driver "https://github.com/kaonieowkai/program_python-smartems/blob/main/max30102.py"
click node_web_app "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py"
click node_patient_views "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py"
click node_report_admin "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py"
click node_web_alerts "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py"
click node_sqlite "https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py"
click node_card_gui "https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/main.py"
click node_card_helper "https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/ThaiCIDHelper.py"
click node_card_data "https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/DataThaiCID.py"
click node_card_images "https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/imageHelper.py"
click node_card_state "https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/threadCheckCardState.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_desktop_app,node_vitals,node_camera,node_pdf,node_alert_check toneBlue
class node_cid_reader,node_card_gui,node_card_helper,node_card_data,node_card_images,node_card_state toneAmber
class node_web_app,node_patient_views,node_report_admin,node_web_alerts,node_sqlite toneMint
class node_sensor_driver toneRose
class node_operator,node_health_sensor,node_camera_device toneIndigo
```

## Components

### Desktop monitoring

- [Desktop app](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py): `SmartEMS.py`
- [Vital signs](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py): `SmartEMS.py`
- [Camera capture](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py): `SmartEMS.py`
- [PDF reports](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py): `SmartEMS.py`
- [Alert checking](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS.py): `SmartEMS.py`

### Thai ID reading

- [Thai CID reader](https://github.com/kaonieowkai/program_python-smartems/blob/main/ThaiCIDReader.py): `ThaiCIDReader.py`
- [Card reader GUI](https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/main.py): `python_ThaiCID-GUI-PyQT6-main/main.py`
- [Card helper](https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/ThaiCIDHelper.py): `python_ThaiCID-GUI-PyQT6-main/ThaiCIDHelper.py`
- [Card data](https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/DataThaiCID.py): `python_ThaiCID-GUI-PyQT6-main/DataThaiCID.py`
- [Card images](https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/imageHelper.py): `python_ThaiCID-GUI-PyQT6-main/imageHelper.py`
- [Card state thread](https://github.com/kaonieowkai/program_python-smartems/blob/main/python_ThaiCID-GUI-PyQT6-main/threadCheckCardState.py): `python_ThaiCID-GUI-PyQT6-main/threadCheckCardState.py`

### Web management

- [Web application](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py): `SmartEMS-WebApp/main.py`
- [Patient statistics](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py): `SmartEMS-WebApp/main.py`
- [Report management](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py): `SmartEMS-WebApp/main.py`
- [Alert dispatch](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py): `SmartEMS-WebApp/main.py`
- [SQLite data](https://github.com/kaonieowkai/program_python-smartems/blob/main/SmartEMS-WebApp/main.py): `SmartEMS-WebApp/main.py`

### Hardware

- [MAX30102 driver](https://github.com/kaonieowkai/program_python-smartems/blob/main/max30102.py): `max30102.py`

### Other components

- **Operator**
- **MAX30102 sensor**
- **Camera**

## Connections

- Operator → Desktop app: uses
- Desktop app → Thai CID reader: imports (evidence: `SmartEMS.py`)
- Desktop app → MAX30102 driver: imports (evidence: `SmartEMS.py`)
- Desktop app → Vital signs: monitors (evidence: `SmartEMS.py`)
- Vital signs → MAX30102 driver: reads sensor (evidence: `SmartEMS.py`)
- MAX30102 driver → MAX30102 sensor: reads
- Desktop app → Camera capture: captures images (evidence: `SmartEMS.py`)
- Camera capture → Camera: captures from
- Desktop app → PDF reports: creates reports (evidence: `SmartEMS.py`)
- Desktop app → Alert checking: checks alerts (evidence: `SmartEMS.py`)
- Desktop app → Alert dispatch: checks alert file
- Operator → Card reader GUI: uses
- Card reader GUI → Card helper: imports (evidence: `python_ThaiCID-GUI-PyQT6-main/main.py`)
- Card reader GUI → Card data: imports (evidence: `python_ThaiCID-GUI-PyQT6-main/main.py`)
- Card reader GUI → Card images: imports (evidence: `python_ThaiCID-GUI-PyQT6-main/main.py`)
- Card reader GUI → Card state thread: imports (evidence: `python_ThaiCID-GUI-PyQT6-main/main.py`)
- Operator → Web application: uses
- Web application → Patient statistics: displays (evidence: `SmartEMS-WebApp/main.py`)
- Web application → Report management: manages (evidence: `SmartEMS-WebApp/main.py`)
- Web application → Alert dispatch: dispatches (evidence: `SmartEMS-WebApp/main.py`)
- Web application → SQLite data: reads and writes (evidence: `SmartEMS-WebApp/main.py`)
