# qingtian1927/arduclimate architecture

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

- Interactive diagram: https://gitdiagram.com/qingtian1927/arduclimate
- Repository: https://github.com/qingtian1927/arduclimate

## Overview

ArduClimate combines Arduino-based environmental monitoring with a Spring Boot website. The documented workflow collects temperature and humidity, displays readings on a seven-segment display, and uploads readings over WiFi to the web server; users interact with the website. The tree also identifies separate server controllers, services, repositories, and models. Source excerpts were unavailable, so internal calls and data persistence are not shown; edges reflect only README-documented relationships.

Main entry points: [`temp_humidity_monitor/temp_humidity_sensor/temp_humidity_sensor.ino`](https://github.com/qingtian1927/arduclimate/blob/main/temp_humidity_monitor/temp_humidity_sensor/temp_humidity_sensor.ino) (Climate monitor), [`seven_segment_clock/seven_segment_clock.ino`](https://github.com/qingtian1927/arduclimate/blob/main/seven_segment_clock/seven_segment_clock.ino) (Seven-segment clock), [`webserver/src/main/java/com/example/iotwebserver/IotWebServerApplication.java`](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/IotWebServerApplication.java) (Spring Boot app), [`webserver/src/main/resources/templates`](https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/resources/templates) (Web templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hardware["Arduino hardware"]
  node_monitor["Climate monitor"]
  node_display["Seven-segment clock"]
end

subgraph group_server["Web server"]
  node_application["Spring Boot app"]
  node_api["API controller<br/>[ApiController.java]"]
  node_dashboard["Dashboard controller"]
  node_login["Login controller"]
  node_signup["Signup controller"]
  node_reading_service["Reading service"]
  node_user_service["User service<br/>[UserService.java]"]
  node_settings_service["Settings service"]
  node_repositories["JPA repositories"]
  node_models["Domain models"]
end

subgraph group_web["Website interface"]
  node_templates["Web templates"]
end

node_user(("User"))
node_wifi["WiFi module"]

node_monitor -->|"uploads readings"| node_wifi
node_wifi -->|"sends readings"| node_application
node_monitor -->|"displays readings"| node_display
node_user -->|"uses website"| node_templates

click node_monitor "https://github.com/qingtian1927/arduclimate/blob/main/temp_humidity_monitor/temp_humidity_sensor/temp_humidity_sensor.ino"
click node_display "https://github.com/qingtian1927/arduclimate/blob/main/seven_segment_clock/seven_segment_clock.ino"
click node_application "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/IotWebServerApplication.java"
click node_api "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/ApiController.java"
click node_dashboard "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/DashboardController.java"
click node_login "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/LoginController.java"
click node_signup "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/SignupController.java"
click node_reading_service "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/service/ReadingService.java"
click node_user_service "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/service/UserService.java"
click node_settings_service "https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/service/UserSettingsService.java"
click node_repositories "https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/java/com/example/iotwebserver/repository"
click node_models "https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/java/com/example/iotwebserver/model"
click node_templates "https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/resources/templates"

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_monitor,node_display,node_user toneBlue
class node_application,node_api,node_dashboard,node_login,node_signup,node_reading_service,node_user_service,node_settings_service,node_repositories,node_models toneAmber
class node_templates toneMint
class node_wifi toneIndigo
```

## Components

### Arduino hardware

- [Climate monitor](https://github.com/qingtian1927/arduclimate/blob/main/temp_humidity_monitor/temp_humidity_sensor/temp_humidity_sensor.ino): `temp_humidity_monitor/temp_humidity_sensor/temp_humidity_sensor.ino`
- [Seven-segment clock](https://github.com/qingtian1927/arduclimate/blob/main/seven_segment_clock/seven_segment_clock.ino): `seven_segment_clock/seven_segment_clock.ino`

### Web server

- [Spring Boot app](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/IotWebServerApplication.java): `webserver/src/main/java/com/example/iotwebserver/IotWebServerApplication.java`
- [API controller](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/ApiController.java): `webserver/src/main/java/com/example/iotwebserver/controller/ApiController.java`
- [Dashboard controller](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/DashboardController.java): `webserver/src/main/java/com/example/iotwebserver/controller/DashboardController.java`
- [Login controller](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/LoginController.java): `webserver/src/main/java/com/example/iotwebserver/controller/LoginController.java`
- [Signup controller](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/controller/SignupController.java): `webserver/src/main/java/com/example/iotwebserver/controller/SignupController.java`
- [Reading service](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/service/ReadingService.java): `webserver/src/main/java/com/example/iotwebserver/service/ReadingService.java`
- [User service](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/service/UserService.java): `webserver/src/main/java/com/example/iotwebserver/service/UserService.java`
- [Settings service](https://github.com/qingtian1927/arduclimate/blob/main/webserver/src/main/java/com/example/iotwebserver/service/UserSettingsService.java): `webserver/src/main/java/com/example/iotwebserver/service/UserSettingsService.java`
- [JPA repositories](https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/java/com/example/iotwebserver/repository): `webserver/src/main/java/com/example/iotwebserver/repository`
- [Domain models](https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/java/com/example/iotwebserver/model): `webserver/src/main/java/com/example/iotwebserver/model`

### Website interface

- [Web templates](https://github.com/qingtian1927/arduclimate/tree/main/webserver/src/main/resources/templates): `webserver/src/main/resources/templates`

### Other components

- **User**
- **WiFi module**

## Connections

- Climate monitor → WiFi module: uploads readings (evidence: `README.md`)
- WiFi module → Spring Boot app: sends readings (evidence: `README.md`)
- Climate monitor → Seven-segment clock: displays readings (evidence: `README.md`)
- User → Web templates: uses website (evidence: `README.md`)
