Fix: Remove tracked user uploads from git and update .gitignore. Refine README.
All checks were successful
Docker Build & Push / build-and-push (push) Successful in 18s

This commit is contained in:
Gemini Bot
2025-12-07 19:13:12 +00:00
parent ab24142fc3
commit 6ae4a1cb9b
6 changed files with 23251 additions and 75 deletions

128
README.md
View File

@@ -6,93 +6,71 @@ Cazubu ist eine moderne Webanwendung zur Verwaltung und Überwachung deiner Cann
## Funktionen 🚀
### 1. Pflanzenverwaltung 🌿
* **Lebenszyklus:** Dokumentiere jeden Schritt vom Keimen bis zur Ernte.
* **Details:** Erfasse Sorte, Standort (Zone/Zelt), Phase (Wachstum/Blüte) und Alter.
* **Bildergalerie:** Lade Fotos deiner Pflanzen hoch, um die Entwicklung festzuhalten.
* **Aktivitäten-Log:** Protokolliere Gießen, Düngen, Umtopfen oder Beschneiden.
* **Messungen:** Erfasse regelmäßig die Höhe deiner Pflanzen.
### 2. Sensor-Überwachung 🌡️
* **Live-Daten:** Visualisierung von Temperatur und Luftfeuchtigkeit.
* **Historie:** Interaktive Graphen für 24h, 7 Tage oder 30 Tage.
* **API-Schnittstelle:** Einfache Integration von ESP32/Arduino Sensoren.
### 3. Inventar & Samenbank 📦
* **Zonen:** Definiere deine Anbaubereiche (z.B. "Zelt 1", "Outdoor").
* **Gefäße:** Verwalte deine Töpfe und deren Größen.
* **Samen:** Behalte den Überblick über deine Genetik-Sammlung (Sativa/Indica Anteil, Autoflower, Anzahl).
### 4. Dashboard 📊
* Schneller Überblick über offene Aufgaben und Bestände.
* Direkteinstieg in die wichtigsten Bereiche.
* **Pflanzenverwaltung:** Lebenszyklus, Details, Bildergalerie, Aktivitäten-Log.
* **Sensor-Überwachung:** Live-Daten (Temp/Feuchte) & Historie (24h/7d/30d).
* **Inventar & Samenbank:** Zonen, Gefäße, Genetik-Datenbank.
* **Dashboard:** Alles auf einen Blick.
---
## Installation 🛠️
## Installation & Betrieb 🛠️
### Voraussetzungen
* Docker & Docker Compose
* Alternativ: Webserver mit PHP 8.2+ und MySQL/MariaDB
Dieses Projekt ist für den Betrieb als Docker-Container ausgelegt.
### Docker Quickstart
1. **Repository klonen:**
```bash
git clone https://git.klenzel.net/admin/cazubu.git
cd cazubu
```
2. **Container starten:**
```bash
docker-compose up -d
```
*Die App ist nun unter `http://localhost:8090` erreichbar.*
3. **Standard-Login:**
* Benutzer: `testnutzer`
* Passwort: `Start123!`
### Manuelle Installation (ohne Docker)
1. Kopiere den Inhalt von `src/` in dein Webroot.
2. Importiere `src/database/install.sql` in deine Datenbank.
3. Passe `src/includes/db_connect.php` oder die Umgebungsvariablen an.
---
## Bedienungsanleitung 📖
### Erste Schritte
1. **Inventar anlegen:** Gehe zu "Inventar" und erstelle mindestens eine **Zone** (z.B. "Growbox") und ein **Pflanzgefäß** (z.B. "11L Topf").
2. **Samen erfassen:** Trage deine Samen unter "Samen" ein.
3. **Pflanze starten:** Klicke auf dem Dashboard oder unter "Pflanzen" auf "+ Neue Pflanze". Wähle Samen, Zone und Topf aus.
### Sensoren verbinden
Jeder Benutzer hat einen eigenen API-Key (siehe "Profil").
Sende Sensordaten per HTTP GET Request an:
### 1. Voraussetzungen
* Docker Engine
* Eine laufende MySQL/MariaDB Datenbank (extern)
### 2. Datenbank vorbereiten
Importiere die Struktur in deine Datenbank:
```bash
mysql -u dein_user -p deine_db < src/database/install.sql
```
http://DEINE-IP/api.php?apikey=DEIN_KEY&pflanze=PFLANZEN_ID&sensor=temp&wert=24.5
http://DEINE-IP/api.php?apikey=DEIN_KEY&pflanze=PFLANZEN_ID&sensor=humidity&wert=60
### 3. Container starten (Docker CLI)
Verwende diesen Befehl, um den Container zu starten. Passe die Werte für `DB_SERVER`, `DB_USERNAME`, `DB_PASSWORD` und `DB_NAME` an deine Umgebung an.
```bash
docker run -d \
--name cazubu \
--restart unless-stopped \
-p 8080:80 \
-e DB_SERVER="192.168.1.100" \
-e DB_USERNAME="cazubu_user" \
-e DB_PASSWORD="dein_sicheres_passwort" \
-e DB_NAME="cazubu_db" \
-v cazubu_uploads:/var/www/html/uploads \
172.30.1.213/admin/cazubu:latest
```
*Die `PFLANZEN_ID` findest du in der Detailansicht der Pflanze.*
**Wichtig:** Das Volume `-v cazubu_uploads:/var/www/html/uploads` ist notwendig, damit hochgeladene Bilder bei einem Update nicht verloren gehen!
### Umgebungsvariablen
| Variable | Beschreibung | Standard |
|----------|--------------|----------|
| `DB_SERVER` | IP oder Hostname des Datenbankservers | `172.30.242.130` |
| `DB_USERNAME` | Datenbank-Benutzer | `cazubu` |
| `DB_PASSWORD` | Datenbank-Passwort | (intern) |
| `DB_NAME` | Name der Datenbank | `cazubu` |
---
## Tech Stack 💻
* **Frontend:** Bootstrap 5.3, Chart.js, jQuery
* **Backend:** PHP 8.2 (Native)
* **Datenbank:** MySQL / MariaDB
* **Design:** Custom "Organic Light Glass" Theme (CSS Variables, Backdrop Filter)
## Bedienung 📖
* **Login:** `testnutzer` / `Start123!` (Bitte sofort ändern!)
* **Erste Schritte:**
1. Inventar -> Zonen anlegen.
2. Samen -> Samen erfassen.
3. Startseite -> Neue Pflanze.
---
## Changelog
**v18.3.0** (Aktuell)
* Redesign: Modernes "Light Glass" UI.
* Feature: Sensor-Historie mit Zeitfilter (24h/7d/30d).
* Verbesserung: Erweiterte Samen-Datenbank mit Genetik-Anzeige.
* Fix: Diverse Bugfixes in Tabellen und DataTables.
## Sensoren integrieren 🌡️
**v1.0.0**
* Initiale Dockerisierung und Grundfunktionen.
Sende Daten per HTTP GET (z.B. vom ESP32):
`http://DEINE-IP/api.php?apikey=DEIN_KEY&pflanze=ID&sensor=temp&wert=24.5`
*(API-Key findest du im Profil, Pflanzen-ID in der Detailansicht)*