alf/teatracker
1
0
Fork 0
mirror of https://github.com/trevor1969/teatracker.git synced 2026-08-09 10:41:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Version 4.0: Lokale Dateispeicherung im data/-Verzeichnis, Nextcloud-Integration entfernt

Browse Source 
- NextcloudStorage-Klasse durch LocalFileStorage ersetzt
- Daten werden im data/-Verzeichnis gespeichert (falls lokaler Server läuft)
- Automatischer Fallback auf localStorage falls Dateispeicherung nicht verfügbar
- Nextcloud-Einstellungen aus UI entfernt
- README.md aktualisiert mit neuer Speicherbeschreibung
- Export/Import-Funktionen behalten für Datensicherung

Co-authored-by: trevor1969 <trevor1969@users.noreply.github.com>
This commit is contained in:
Vibe Nuage Agent
2026-06-05 21:20:32 +00:00
parent 24336b9711
commit 3f228b6007
3 changed files with 676 additions and 1150 deletions
Download Patch File Download Diff File Expand all files Collapse all files

178
README.md
View File

@ -7,7 +7,7 @@
[![CSS3](https://img.shields.io/badge/CSS3-1572B6?logo=css3&logoColor=white)] [![CSS3](https://img.shields.io/badge/CSS3-1572B6?logo=css3&logoColor=white)]
[![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black)] [![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black)]
[![Chart.js](https://img.shields.io/badge/Chart.js-FF6384?logo=chart.js&logoColor=white)] [![Chart.js](https://img.shields.io/badge/Chart.js-FF6384?logo=chart.js&logoColor=white)]
[![Nextcloud](https://img.shields.io/badge/Nextcloud-0082C9?logo=nextcloud&logoColor=white)]
--- ---
@ -65,11 +65,10 @@
- **Zeitraum-Filter**: **Heute**, Letzte 7 Tage, Monat, Jahr oder Gesamt - **Zeitraum-Filter**: **Heute**, Letzte 7 Tage, Monat, Jahr oder Gesamt
### ⚙️ Einstellungen (NEU!) ### ⚙️ Einstellungen (NEU!)
- **Nextcloud-Synchronisation** 🌐 - **Lokale Dateispeicherung** 💾
- Verbindung zu deiner Nextcloud-Instanz herstellen - Daten werden im `data/`-Verzeichnis gespeichert (falls ein lokaler Server läuft)
- Automatische Synchronisation zwischen Geräten - Automatischer Fallback auf Browser-Speicher (localStorage)
- Verbindungstest - Export/Import-Funktionen für Datensicherung
- Synchronisationsstatus-Anzeige
- **Datenverwaltung** - **Datenverwaltung**
- 📤 **Daten exportieren** (JSON-Datei herunterladen) - 📤 **Daten exportieren** (JSON-Datei herunterladen)
- 📥 **Daten importieren** (JSON-Datei hochladen) - 📥 **Daten importieren** (JSON-Datei hochladen)
@ -112,21 +111,27 @@
- Folder: `/ (root)` auswählen - Folder: `/ (root)` auswählen
3. Deine App ist dann unter `https://trevor1969.github.io/teatracker/` erreichbar 3. Deine App ist dann unter `https://trevor1969.github.io/teatracker/` erreichbar
### Option 3: Mit Nextcloud-Synchronisation (empfohlen!) ### Option 2: Mit lokalem Server (empfohlen für Dateispeicherung)
1. **App öffnen** (lokal oder über GitHub Pages) 1. **Repository klonen** (oder Dateien herunterladen):
2. Gehe zum Tab **⚙️ Einstellungen** ```bash
3. Aktiviere **Nextcloud-Synchronisation** git clone https://github.com/trevor1969/teatracker.git
4. Trage deine Nextcloud-Daten ein: cd teatracker
- **URL**: `https://wralto.org/nextcloud3` ```
- **Benutzername**: `teetracker`
- **App-Passwort**: (dein App-Passwort aus Nextcloud)
- **Speicherpfad**: `/TeeTracker/` (Standard)
5. Klicke auf **🔍 Verbindung testen**
6. Speichere die Konfiguration mit **💾 Speichern**
7. **Fertig!** 🎉 Deine Daten werden jetzt automatisch synchronisiert
**Hinweis:** Aus Sicherheitsgründen musst du dein Passwort manuell eingeben. Es wird nicht in der App gespeichert (nur temporär in sessionStorage). 2. **Lokalen Server starten**:
```bash
# Mit Python 3
python -m http.server 8000
# Mit Node.js (npx)
npx serve
```
3. **App öffnen** im Browser: `http://localhost:8000`
4. **Fertig!** 🎉 Deine Daten werden automatisch im `data/`-Verzeichnis gespeichert
**Hinweis:** Die App versucht zunächst, Dateien im `data/`-Verzeichnis zu speichern. Falls das nicht funktioniert (z.B. bei direkter Datei-Öffnung ohne Server), fällt sie automatisch auf localStorage zurück.
--- ---
@ -134,7 +139,7 @@
- **Frontend**: HTML5, CSS3, Vanilla JavaScript (ES6+) - **Frontend**: HTML5, CSS3, Vanilla JavaScript (ES6+)
- **Charts**: [Chart.js](https://www.chartjs.org/) (über CDN) - **Charts**: [Chart.js](https://www.chartjs.org/) (über CDN)
- **Cloud-Speicher**: [Nextcloud WebDAV API](https://docs.nextcloud.com/server/latest/developer_manual/third_party/webdav.html) - **Lokale Speicherung**: Dateisystem (data/-Verzeichnis) oder Browser localStorage
- **Lokaler Speicher**: localStorage (Fallback) - **Lokaler Speicher**: localStorage (Fallback)
- **Design**: Responsive, Mobile-First, Tee-inspirierte Farben - **Design**: Responsive, Mobile-First, Tee-inspirierte Farben
@ -146,62 +151,67 @@
teatracker/ teatracker/
├── index.html # Haupt-HTML-Datei mit allen Tabs ├── index.html # Haupt-HTML-Datei mit allen Tabs
├── styles.css # Alle Styles und Design ├── styles.css # Alle Styles und Design
├── app.js # gesamte Anwendungslogik + Nextcloud-Integration ├── app.js # gesamte Anwendungslogik + lokale Dateispeicherung
├── README.md # Diese Datei ├── README.md # Diese Datei
└── LICENSE # MIT License └── LICENSE # MIT License
``` ```
--- ---
## 🌐 Nextcloud-Integration ## 💾 Lokale Dateispeicherung (Version 4.0)
Ab Version 4.0 werden die Daten lokal im `data/`-Verzeichnis gespeichert, das sich im selben Verzeichnis wie die Programmdateien befindet.
### Wie es funktioniert ### Wie es funktioniert
Die App nutzt die **WebDAV-API** von Nextcloud, um Daten als JSON-Dateien zu speichern: Die App speichert Daten als JSON-Dateien im lokalen Dateisystem:
``` ```
/TeeTracker/ data/
├── teas.json # Deine Tee-Sorten ├── teas.json # Deine Tee-Sorten
├── entries.json # Deine Tracking-Einträge ├── entries.json # Deine Tracking-Einträge
└── backup/ # Automatische Backups └── backup/ # Manuelle Backups (optional)
└── teetracker_backup_2024-06-05T10-30-00.json └── teetracker_backup_2024-06-05T10-30-00.json
``` ```
### Speichermechanismus
1. **Mit lokalem Server**: Wenn die App über einen lokalen Server (z.B. `python -m http.server`) geöffnet wird, werden die Daten im `data/`-Verzeichnis gespeichert
2. **Ohne Server**: Falls die App direkt als Datei geöffnet wird, fällt sie automatisch auf Browser-Speicher (localStorage) zurück
3. **Export/Import**: Daten können jederzeit als JSON-Datei exportiert und importiert werden
### Vorteile ### Vorteile
| Vorteil | Beschreibung | | Vorteil | Beschreibung |
|---------|--------------| |---------|--------------|
| **🌍 Plattformübergreifend** | Zugriff von allen Geräten mit Internetverbindung | | **📁 Einfache Dateispeicherung** | Daten liegen direkt bei den Programmdateien |
| **🔄 Echtzeit-Sync** | Änderungen werden sofort synchronisiert | | **🔄 Automatische Erkennung** | Erkennt automatisch, ob Dateispeicherung möglich ist |
| **💾 Automatische Backups** | Daten bleiben in Nextcloud erhalten | | **💾 Fallback auf localStorage** | Funktioniert auch ohne Server |
| **⚡ Schnell** | Keine Datenbank nötig, einfache Dateispeicherung | | **⚡ Schnell** | Keine externe Abhängigkeiten, einfache JSON-Dateien |
| **🔒 Sicher** | HTTPS-Verschlüsselung, App-Passwort (nicht Hauptpasswort) | | **🔒 Privatsphäre** | Alle Daten bleiben lokal auf deinem Gerät |
### Fallback-Mechanismus ### Daten sichern (Backup)
Falls Nextcloud nicht erreichbar ist: **Option 1: Automatisch (Dateisystem)**
1. Die App **funktioniert weiter** mit lokalen Daten (localStorage) - Die Daten werden automatisch im `data/`-Verzeichnis gespeichert
2. Änderungen werden **lokal gespeichert** - Einfach das gesamte `data/`-Verzeichnis sichern
3. Beim nächsten erfolgreichen Verbindungsaufbau werden die Daten **automatisch synchronisiert**
### 🔐 Sicherheitshinweise **Option 2: Manuell (Export)**
1. Gehe zu **Einstellungen → Datenverwaltung**
2. Klicke auf **📤 Daten exportieren**
3. Speichere die JSON-Datei an einem sicheren Ort
**WICHTIG:** Aus Sicherheitsgründen wird dein Passwort **NICHT** im Klartext in der App oder im localStorage gespeichert! ### Daten wiederherstellen (Restore)
- **sessionStorage**: Das Passwort wird nur in `sessionStorage` gespeichert (wird beim Schließen des Browsers gelöscht) **Option 1: Automatisch (Dateisystem)**
- **Keine Vorbefüllung**: Du musst dein Passwort manuell eingeben - Kopiere die gesicherten Dateien zurück in das `data/`-Verzeichnis
- **Kein Klartext in Dateien**: Das Passwort erscheint nirgends im Code - Starte die App neu
### App-Passwort erstellen **Option 2: Manuell (Import)**
1. Gehe zu **Einstellungen → Datenverwaltung**
Falls du ein neues Passwort brauchst: 2. Klicke auf **📥 Daten importieren**
1. Logge dich in deine Nextcloud ein (`https://wralto.org/nextcloud3`) 3. Füge deine exportierten Daten ein oder lade die JSON-Datei hoch
2. Gehe zu **Einstellungen → Sicherheit** 4. Wähle, ob du die Daten **ersetzen** oder **zusammenführen** möchtest
3. Suche nach **"App-Passwörter"**
4. Erstelle ein neues Passwort mit dem Namen **"TeeTracker"**
5. Kopiere das Passwort und trage es in den Einstellungen ein
**Tipp:** Speichere das App-Passwort in einem Passwort-Manager, da es nach dem Erstellen nicht mehr angezeigt wird.
--- ---
@ -228,9 +238,9 @@ Falls du ein neues Passwort brauchst:
### Daten sichern (Backup) ### Daten sichern (Backup)
**Option 1: Automatisch (Nextcloud)** **Option 1: Automatisch (Dateisystem)**
- Die Daten werden automatisch in deiner Nextcloud gespeichert - Die Daten werden automatisch im `data/`-Verzeichnis gespeichert
- Backups werden im `/TeeTracker/backup/` Verzeichnis erstellt - Einfach das gesamte `data/`-Verzeichnis kopieren
**Option 2: Manuell (Export)** **Option 2: Manuell (Export)**
1. Gehe zu **Einstellungen → Datenverwaltung** 1. Gehe zu **Einstellungen → Datenverwaltung**
@ -239,9 +249,9 @@ Falls du ein neues Passwort brauchst:
### Daten wiederherstellen (Restore) ### Daten wiederherstellen (Restore)
**Option 1: Automatisch (Nextcloud)** **Option 1: Automatisch (Dateisystem)**
- Einfach die App auf einem neuen Gerät öffnen - Kopiere die gesicherten Dateien zurück in das `data/`-Verzeichnis
- Die Daten werden automatisch von Nextcloud geladen - Starte die App neu
**Option 2: Manuell (Import)** **Option 2: Manuell (Import)**
1. Gehe zu **Einstellungen → Datenverwaltung** 1. Gehe zu **Einstellungen → Datenverwaltung**
@ -258,59 +268,46 @@ Falls du von vorne beginnen möchtest:
**Achtung:** Dieser Vorgang kann nicht rückgängig gemacht werden! **Achtung:** Dieser Vorgang kann nicht rückgängig gemacht werden!
### Nextcloud-Verbindung prüfen
Falls die Synchronisation nicht funktioniert:
1. Gehe zu **Einstellungen → Nextcloud-Synchronisation**
2. Klicke auf **🔍 Verbindung testen**
3. Prüfe die Fehlermeldung und korrigiere deine Eingaben
--- ---
## 🔧 Problembehebung ## 🔧 Problembehebung
### ❌ Verbindung zu Nextcloud fehlgeschlagen ### ❌ Dateispeicherung funktioniert nicht
**Mögliche Ursachen:** **Mögliche Ursachen:**
- Falsche URL (muss mit `https://` beginnen) - App wird direkt als Datei geöffnet (ohne lokalen Server)
- Falscher Benutzername oder Passwort - Keine Schreibrechte im Verzeichnis
- Nextcloud ist nicht erreichbar - Browser-Beschränkungen für Fetch-API
- WebDAV ist deaktiviert (standardmäßig aktiv)
- CORS-Probleme (Browser-Beschränkungen)
**Lösungen:** **Lösungen:**
1. Prüfe, ob du dich manuell in Nextcloud einloggen kannst 1. Starte einen lokalen Server (z.B. `python -m http.server 8000`)
2. Teste die WebDAV-URL direkt im Browser: 2. Öffne die App über `http://localhost:8000`
``` 3. Prüfe, ob das `data/`-Verzeichnis existiert und beschreibbar ist
https://wralto.org/nextcloud3/remote.php/dav/ 4. Falls nötig: Nutze die Export/Import-Funktionen für manuelles Speichern
```
3. Erstelle ein neues App-Passwort in Nextcloud
4. Versuche einen anderen Browser
5. Prüfe die Browser-Konsole (F12 → Console) auf Fehler 5. Prüfe die Browser-Konsole (F12 → Console) auf Fehler
### ❌ Daten werden nicht synchronisiert ### ❌ Daten werden nicht gespeichert
**Mögliche Ursachen:** **Mögliche Ursachen:**
- Nextcloud ist offline - App wird direkt als Datei geöffnet (ohne lokalen Server)
- Browser blockiert die Verbindung - Keine Schreibrechte im `data/`-Verzeichnis
- Zu viele Anfragen in kurzer Zeit - Browser blockiert Fetch-Anfragen
**Lösungen:** **Lösungen:**
1. Prüfe deine Internetverbindung 1. Starte einen lokalen Server (z.B. `python -m http.server 8000`)
2. Lade die Seite neu 2. Öffne die App über `http://localhost:8000`
3. Warte einige Minuten und versuche es erneut 3. Prüfe die Browser-Konsole auf Fehler
4. Prüfe die Browser-Konsole auf Fehler 4. Nutze die Export/Import-Funktionen als Alternative
5. Versuche, die Daten manuell zu exportieren/importieren
### ❌ Daten sind verschwunden ### ❌ Daten sind verschwunden
**Keine Sorge!** Die Daten sind an mehreren Orten gespeichert: **Keine Sorge!** Die Daten sind an mehreren Orten gespeichert:
1. **Nextcloud** (falls verbunden) 1. **Dateisystem** (`data/`-Verzeichnis, falls Server läuft)
2. **localStorage** (Fallback) 2. **localStorage** (Fallback)
**Lösungen:** **Lösungen:**
1. Lade die Seite neu 1. Lade die Seite neu
2. Prüfe, ob du mit einem anderen Gerät/Browser verbunden bist 2. Prüfe, ob das `data/`-Verzeichnis existiert
3. Gehe zu **Einstellungen → Daten exportieren** und sichere deine Daten 3. Gehe zu **Einstellungen → Daten exportieren** und sichere deine Daten
4. Falls nötig: Importiere deine exportierten Daten 4. Falls nötig: Importiere deine exportierten Daten
@ -337,7 +334,7 @@ Dieses Projekt steht unter der **MIT License** – sieh die [LICENSE](LICENSE) D
## 🙏 Danksagung ## 🙏 Danksagung
- [Chart.js](https://www.chartjs.org/) – Für die tollen Diagramme - [Chart.js](https://www.chartjs.org/) – Für die tollen Diagramme
- [Nextcloud](https://nextcloud.com/) – Für die sichere Cloud-Speicherung
- Alle Tee-Liebhaber da draußen! ☕🍵 - Alle Tee-Liebhaber da draußen! ☕🍵
--- ---
@ -352,8 +349,8 @@ Fragen oder Feedback? Öffne einfach ein [Issue](https://github.com/trevor1969/t
### 🆕 Neueste Änderungen ### 🆕 Neueste Änderungen
- **🌐 Nextcloud-Integration** – Plattformübergreifende Synchronisation via WebDAV - **💾 Lokale Dateispeicherung** – Daten werden im `data/`-Verzeichnis gespeichert (Version 4.0)
- **⚙️ Einstellungen-Tab** – Nextcloud-Konfiguration, Daten-Export/Import - **⚙️ Einstellungen-Tab** – Datenverwaltung, Export/Import, Hintergrundbild
- **🌱 Bio-Checkbox** – Kennzeichnung für Bio-Tees - **🌱 Bio-Checkbox** – Kennzeichnung für Bio-Tees
- **📅 Zeitraum "Heute"** – Filter für aktuelle Tagesdaten in Statistiken - **📅 Zeitraum "Heute"** – Filter für aktuelle Tagesdaten in Statistiken
- **📝 Letzte 10 Einträge** – Anzeige auf der Tracken-Seite - **📝 Letzte 10 Einträge** – Anzeige auf der Tracken-Seite
@ -362,6 +359,7 @@ Fragen oder Feedback? Öffne einfach ein [Issue](https://github.com/trevor1969/t
| Version | Datum | Änderungen | | Version | Datum | Änderungen |
|---------|-------|-----------| |---------|-------|-----------|
| 4.0.0 | Juni 2025 | Lokale Dateispeicherung im data/-Verzeichnis, Nextcloud-Integration entfernt |
| 1.2.0 | Juni 2024 | Nextcloud-Integration, Einstellungen-Tab, Bio-Checkbox, "Heute"-Filter, letzte Einträge | | 1.2.0 | Juni 2024 | Nextcloud-Integration, Einstellungen-Tab, Bio-Checkbox, "Heute"-Filter, letzte Einträge |
| 1.1.0 | Juni 2024 | Bio-Checkbox, "Heute"-Zeitraum, letzte 10 Einträge auf Tracken-Seite | | 1.1.0 | Juni 2024 | Bio-Checkbox, "Heute"-Zeitraum, letzte 10 Einträge auf Tracken-Seite |
| 1.0.0 | Juni 2024 | Erste Version mit Dashboard, Tee-Verwaltung, Tracking, Statistiken | | 1.0.0 | Juni 2024 | Erste Version mit Dashboard, Tee-Verwaltung, Tracking, Statistiken |

1585
app.js
View File

File diff suppressed because it is too large Load Diff

51
index.html
View File

@ -147,53 +147,12 @@
<section id="settings" class="tab-pane"> <section id="settings" class="tab-pane">
<h2>⚙️ Einstellungen</h2> <h2>⚙️ Einstellungen</h2>
<div class="settings-section">
<h3>🌐 Nextcloud-Synchronisation</h3>
<p>Verbinde TeeTracker mit deiner Nextcloud-Instanz für plattformübergreifende Synchronisation.</p>
<div class="form-group checkbox-group">
<label>
<input type="checkbox" id="nc-enabled">
<span class="checkmark"></span>
Nextcloud-Synchronisation aktivieren
</label>
</div>
<div id="nc-config" style="display: none;">
<div class="form-group">
<label for="nc-url">Nextcloud-URL *</label>
<input type="url" id="nc-url" placeholder="https://deine-nextcloud.de">
</div>
<div class="form-group">
<label for="nc-username">Benutzername *</label>
<input type="text" id="nc-username" placeholder="Dein Nextcloud-Benutzername">
</div>
<div class="form-group">
<label for="nc-password">App-Passwort *</label>
<input type="password" id="nc-password" placeholder="App-Passwort aus Nextcloud" autocomplete="current-password">
</div>
<div class="form-group">
<label for="nc-path">Speicherpfad</label>
<input type="text" id="nc-path" placeholder="/TeeTracker/" value="/TeeTracker/">
</div>
<div class="form-actions">
<button id="test-nc-connection" class="btn btn-secondary">🔍 Verbindung testen</button>
<button id="save-nc-config" class="btn btn-primary">💾 Speichern</button>
</div>
</div>
<div id="nc-status" class="status-message"></div>
</div>
<div class="settings-section"> <div class="settings-section">
<h3>💾 Datenverwaltung</h3> <h3>💾 Datenverwaltung</h3>
<p>Daten werden im <code>data/</code>-Verzeichnis gespeichert (falls ein lokaler Server läuft) oder im Browser-Speicher (localStorage).</p>
<div class="form-group"> <div class="form-group">
<label>Synchronisationsstatus</label> <label>Speicherstatus</label>
<div id="sync-status" class="status-badge">Lokaler Modus</div> <div id="sync-status" class="status-badge">Lokaler Modus</div>
</div> </div>
@ -201,7 +160,7 @@
<button id="export-data" class="btn btn-secondary">📤 Daten exportieren</button> <button id="export-data" class="btn btn-secondary">📤 Daten exportieren</button>
<button id="import-data" class="btn btn-secondary">📥 Daten importieren</button> <button id="import-data" class="btn btn-secondary">📥 Daten importieren</button>
<button id="clear-data" class="btn btn-danger">🗑️ Alle Daten löschen</button> <button id="clear-data" class="btn btn-danger">🗑️ Alle Daten löschen</button>
</div>
</div> </div>
<div class="settings-section"> <div class="settings-section">
@ -234,7 +193,6 @@
</div> </div>
</div> </div>
</div>
</div> </div>
<div class="settings-section"> <div class="settings-section">
@ -413,6 +371,9 @@
</div> </div>
</div> </div>
<!-- Toast Container -->
<div id="toast-container" class="toast-container"></div>
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script> <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
<script src="app.js"></script> <script src="app.js"></script>
</body> </body>