Files
cazubu/README.md
Gemini Bot 6ae4a1cb9b
All checks were successful
Docker Build & Push / build-and-push (push) Successful in 18s
Fix: Remove tracked user uploads from git and update .gitignore. Refine README.
2025-12-07 19:13:12 +00:00

77 lines
2.3 KiB
Markdown

# Cazubu - Dein Cannabis Zucht Buddy 🌱
Cazubu ist eine moderne Webanwendung zur Verwaltung und Überwachung deiner Cannabis-Zucht ("Homegrow"). Sie hilft dir, den Überblick über Pflanzen, Inventar, Samen und Umweltbedingungen zu behalten.
![Cazubu Dashboard](assets/dummy_plant.png)
## Funktionen 🚀
* **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 & Betrieb 🛠️
Dieses Projekt ist für den Betrieb als Docker-Container ausgelegt.
### 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
```
### 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
```
**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` |
---
## Bedienung 📖
* **Login:** `testnutzer` / `Start123!` (Bitte sofort ändern!)
* **Erste Schritte:**
1. Inventar -> Zonen anlegen.
2. Samen -> Samen erfassen.
3. Startseite -> Neue Pflanze.
---
## Sensoren integrieren 🌡️
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)*