# tanrif21/bluecycle-smart-pond-monitoring-system architecture

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

- Interactive diagram: https://gitdiagram.com/tanrif21/bluecycle-smart-pond-monitoring-system
- Repository: https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system

## Overview

BlueCycle monitors pond conditions and automatically controls equipment, while presenting readings through local and on-device interfaces. The documented workflow is sensing, including an Arduino UNO pH bridge, followed by ESP32-led monitoring and control. The README supports these system-level relationships, but no source excerpts were provided, so implementation details and finer control logic are not asserted.

Main entry points: [`BlueCycle_ESP32_Main_Code.ino`](https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/BlueCycle_ESP32_Main_Code.ino) (ESP32 Controller), [`Arduino_UNO_pH_I2C_Code.ino`](https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/Arduino_UNO_pH_I2C_Code.ino) (UNO pH Bridge), [`interface_html`](https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/interface_html) (WiFi Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Pond Sensing"]
  node_uno["UNO pH Bridge"]
  node_ph["pH Sensor"]
  node_water_sensors["Water Sensors"]
end

subgraph group_control["Monitoring and Control"]
  node_esp32["ESP32 Controller"]
  node_relay_pumps["Relay Pumps"]
  node_feeder["Servo Feeder"]
  node_buzzer["Buzzer Alert"]
end

subgraph group_interfaces["User Interfaces"]
  node_lcd["LCD Display"]
  node_dashboard["WiFi Dashboard"]
end

node_farmer(("Fish Farmer"))

node_uno -->|"reads"| node_ph
node_uno -->|"provides pH"| node_esp32
node_esp32 -->|"reads"| node_water_sensors
node_esp32 -->|"controls"| node_relay_pumps
node_esp32 -->|"schedules feeding"| node_feeder
node_esp32 -->|"alerts"| node_buzzer
node_esp32 -->|"displays locally"| node_lcd
node_esp32 -->|"creates"| node_dashboard
node_farmer -->|"monitors pond"| node_dashboard

click node_esp32 "https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/BlueCycle_ESP32_Main_Code.ino"
click node_uno "https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/Arduino_UNO_pH_I2C_Code.ino"
click node_dashboard "https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/interface_html"

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_uno,node_ph,node_water_sensors toneBlue
class node_esp32,node_relay_pumps,node_feeder,node_buzzer toneAmber
class node_lcd,node_dashboard toneMint
class node_farmer toneIndigo
```

## Components

### Pond Sensing

- [UNO pH Bridge](https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/Arduino_UNO_pH_I2C_Code.ino): `Arduino_UNO_pH_I2C_Code.ino`
- **pH Sensor**
- **Water Sensors**

### Monitoring and Control

- [ESP32 Controller](https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/BlueCycle_ESP32_Main_Code.ino): `BlueCycle_ESP32_Main_Code.ino`
- **Relay Pumps**
- **Servo Feeder**
- **Buzzer Alert**

### User Interfaces

- **LCD Display**
- [WiFi Dashboard](https://github.com/tanrif21/bluecycle-smart-pond-monitoring-system/blob/main/interface_html): `interface_html`

### Other components

- **Fish Farmer**

## Connections

- UNO pH Bridge → pH Sensor: reads (evidence: `README.md`)
- UNO pH Bridge → ESP32 Controller: provides pH (evidence: `README.md`)
- ESP32 Controller → Water Sensors: reads (evidence: `README.md`)
- ESP32 Controller → Relay Pumps: controls (evidence: `README.md`)
- ESP32 Controller → Servo Feeder: schedules feeding (evidence: `README.md`)
- ESP32 Controller → Buzzer Alert: alerts (evidence: `README.md`)
- ESP32 Controller → LCD Display: displays locally (evidence: `README.md`)
- ESP32 Controller → WiFi Dashboard: creates (evidence: `README.md`)
- Fish Farmer → WiFi Dashboard: monitors pond (evidence: `README.md`)
