# kaowri48/plant-care architecture

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

- Interactive diagram: https://gitdiagram.com/kaowri48/plant-care
- Repository: https://github.com/kaowri48/plant-care

## Overview

PlantCare is a desktop plant-care manager built with PySide6 and MySQL. A user opens the dashboard, where plant information and care summaries are presented; plant records can be added or edited, and watering schedule and care history are available in separate views. The sampled code shows these views querying the shared database helper, and plant dialogs writing through it. The dashboard excerpt is partial and the README is empty, so links from the dashboard to several feature views are not confirmed and are marked unverified.

Main entry points: [`plantcare/dashboard.py`](https://github.com/kaowri48/plant-care/blob/main/plantcare/dashboard.py) (Dashboard), [`plantcare/database.py`](https://github.com/kaowri48/plant-care/blob/main/plantcare/database.py) (Connection helper), [`plantcare/my_plants.py`](https://github.com/kaowri48/plant-care/blob/main/plantcare/my_plants.py) (My plants view), [`plantcare/add_plant.py`](https://github.com/kaowri48/plant-care/blob/main/plantcare/add_plant.py) (Add plant dialog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_entry["App entry<br/>[main.py]"]
  node_dashboard["Dashboard<br/>[dashboard.py]"]
  node_settings["Settings view<br/>[settings.py]"]
end

subgraph group_plants["Plant management"]
  node_myplants["My plants view<br/>[my_plants.py]"]
  node_addplant["Add plant dialog<br/>[add_plant.py]"]
  node_editplant["Edit plant dialog<br/>[edit_plant.py]"]
  node_plantqueries["Plant queries and stats<br/>[plants.py]"]
end

subgraph group_care["Care tracking"]
  node_schedule["Watering schedule<br/>[schedule.py]"]
  node_history["Care history<br/>[history.py]"]
end

subgraph group_data["Data access"]
  node_dbhelper["Connection helper<br/>[database.py]"]
  node_mysqldb[("MySQL database")]
end

node_user(("Plant-care user"))

node_user -->|"launches"| node_entry
node_entry -->|"creates"| node_dashboard
node_myplants -->|"opens"| node_addplant
node_myplants -->|"opens"| node_editplant
node_addplant -->|"requests connection"| node_dbhelper
node_editplant -->|"requests connection"| node_dbhelper
node_myplants -->|"requests connection"| node_dbhelper
node_plantqueries -->|"requests connection"| node_dbhelper
node_schedule -->|"requests connection"| node_dbhelper
node_history -->|"requests connection"| node_dbhelper
node_dbhelper -->|"connects to"| node_mysqldb
node_dashboard -.->|"feature link"| node_addplant
node_dashboard -.->|"feature link"| node_editplant
node_dashboard -.->|"feature link"| node_myplants
node_dashboard -.->|"loads summaries"| node_plantqueries
node_dashboard -.->|"feature link"| node_schedule
node_dashboard -.->|"feature link"| node_history
node_dashboard -.->|"feature link"| node_settings

click node_entry "https://github.com/kaowri48/plant-care/blob/main/plantcare/main.py"
click node_dashboard "https://github.com/kaowri48/plant-care/blob/main/plantcare/dashboard.py"
click node_myplants "https://github.com/kaowri48/plant-care/blob/main/plantcare/my_plants.py"
click node_addplant "https://github.com/kaowri48/plant-care/blob/main/plantcare/add_plant.py"
click node_editplant "https://github.com/kaowri48/plant-care/blob/main/plantcare/edit_plant.py"
click node_plantqueries "https://github.com/kaowri48/plant-care/blob/main/plantcare/plants.py"
click node_schedule "https://github.com/kaowri48/plant-care/blob/main/plantcare/schedule.py"
click node_history "https://github.com/kaowri48/plant-care/blob/main/plantcare/history.py"
click node_settings "https://github.com/kaowri48/plant-care/blob/main/plantcare/settings.py"
click node_dbhelper "https://github.com/kaowri48/plant-care/blob/main/plantcare/database.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_entry,node_dashboard,node_settings,node_user toneBlue
class node_myplants,node_addplant,node_editplant,node_plantqueries toneAmber
class node_schedule,node_history toneMint
class node_dbhelper,node_mysqldb toneRose
```

## Components

### Desktop app

- [App entry](https://github.com/kaowri48/plant-care/blob/main/plantcare/main.py): `plantcare/main.py`
- [Dashboard](https://github.com/kaowri48/plant-care/blob/main/plantcare/dashboard.py): `plantcare/dashboard.py`
- [Settings view](https://github.com/kaowri48/plant-care/blob/main/plantcare/settings.py): `plantcare/settings.py`

### Plant management

- [My plants view](https://github.com/kaowri48/plant-care/blob/main/plantcare/my_plants.py): `plantcare/my_plants.py`
- [Add plant dialog](https://github.com/kaowri48/plant-care/blob/main/plantcare/add_plant.py): `plantcare/add_plant.py`
- [Edit plant dialog](https://github.com/kaowri48/plant-care/blob/main/plantcare/edit_plant.py): `plantcare/edit_plant.py`
- [Plant queries and stats](https://github.com/kaowri48/plant-care/blob/main/plantcare/plants.py): `plantcare/plants.py`

### Care tracking

- [Watering schedule](https://github.com/kaowri48/plant-care/blob/main/plantcare/schedule.py): `plantcare/schedule.py`
- [Care history](https://github.com/kaowri48/plant-care/blob/main/plantcare/history.py): `plantcare/history.py`

### Data access

- [Connection helper](https://github.com/kaowri48/plant-care/blob/main/plantcare/database.py): `plantcare/database.py`
- **MySQL database**

### Other components

- **Plant-care user**

## Connections

- Plant-care user → App entry: launches
- App entry → Dashboard: creates (evidence: `plantcare/main.py`)
- My plants view → Add plant dialog: opens (evidence: `plantcare/my_plants.py`)
- My plants view → Edit plant dialog: opens (evidence: `plantcare/my_plants.py`)
- Add plant dialog → Connection helper: requests connection (evidence: `plantcare/add_plant.py`)
- Edit plant dialog → Connection helper: requests connection (evidence: `plantcare/edit_plant.py`)
- My plants view → Connection helper: requests connection (evidence: `plantcare/my_plants.py`)
- Plant queries and stats → Connection helper: requests connection (evidence: `plantcare/plants.py`)
- Watering schedule → Connection helper: requests connection (evidence: `plantcare/schedule.py`)
- Care history → Connection helper: requests connection (evidence: `plantcare/history.py`)
- Connection helper → MySQL database: connects to (evidence: `plantcare/database.py`)
- Dashboard → Add plant dialog: feature link (evidence: `plantcare/dashboard.py`)
- Dashboard → Edit plant dialog: feature link (evidence: `plantcare/dashboard.py`)
- Dashboard → My plants view: feature link (evidence: `plantcare/dashboard.py`)
- Dashboard → Plant queries and stats: loads summaries (evidence: `plantcare/dashboard.py`)
- Dashboard → Watering schedule: feature link (evidence: `plantcare/dashboard.py`)
- Dashboard → Care history: feature link (evidence: `plantcare/dashboard.py`)
- Dashboard → Settings view: feature link (evidence: `plantcare/dashboard.py`)
