From 8586e38bb4cb12b84a1dc349635eefa5b852afb0 Mon Sep 17 00:00:00 2001
From: darklithium <dev@darklithium.de>
Date: Fri, 5 Jun 2026 23:52:31 +0200
Subject: [PATCH] docs: Lektionen und Routinen dokumentiert
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- LEKTIONEN_2026-06-05.md: Git-Server-Hinweis hinzugefügt
- ROUTINEN.md: Täglicher Workflow und Git-Branch-Strategie

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
---
 LEKTIONEN_2026-06-05.md |  10 ++++
 ROUTINEN.md             | 118 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 128 insertions(+)
 create mode 100644 ROUTINEN.md

diff --git a/LEKTIONEN_2026-06-05.md b/LEKTIONEN_2026-06-05.md
index 6bcb869..f8258e3 100644
--- a/LEKTIONEN_2026-06-05.md
+++ b/LEKTIONEN_2026-06-05.md
@@ -52,3 +52,13 @@
 ### JSON-Formatierung
 - Zeilenumbrüche in Strings: `\n\n` für Leerzeile, `\n` für Zeilenumbruch
 - Bei Konvertierungen: Datei als Text lesen, nicht als JSON, um Newlines korrekt zu verarbeiten
+
+## 📚 Siehe auch
+- [ROUTINEN.md](./ROUTINEN.md) - Täglicher Workflow und Git-Branch-Strategie
+
+### Git-Server (Gitea) auf YunoHost
+- **Installation**: `sudo yunohost app install gitea`
+- **Repository-URL**: `https://git.darklithium.de/<username>/<repo>`
+- **SSH-URL**: `gitea@<server>:<username>/<repo>.git`
+- **SSH-Key**: Benutzer `gitea` (nicht `git`) auf dem Server
+- **Hinweis**: Externer SSH-Zugriff (Port 22) oft blockiert → intern oder HTTPS verwenden
diff --git a/ROUTINEN.md b/ROUTINEN.md
new file mode 100644
index 0000000..2b637e0
--- /dev/null
+++ b/ROUTINEN.md
@@ -0,0 +1,118 @@
+# Routinen & Workflow - FortuneCookie App
+
+## 📌 Täglicher Entwicklungsworkflow
+
+### 1️⃣ **Arbeiten im `daily`-Branch**
+```bash
+# Im Projektverzeichnis
+cd /home/chrischi/DEV/UT/fortunecookie-neu/testing
+
+# Änderungen commiten
+git add -A
+git commit -m "Beschreibung der Änderungen"
+
+# Auf Gitea-Server pushen
+git push origin daily
+```
+
+### 2️⃣ **Testing-Branch aktualisieren**
+```bash
+# Auf testing wechseln
+git checkout testing
+
+# daily in testing mergen
+git merge daily
+
+# Auf Gitea-Server pushen
+git push origin testing
+```
+
+### 3️⃣ **App installieren**
+```bash
+cd /home/chrischi/DEV/UT/fortunecookie-neu/testing
+clickable build && clickable install
+```
+
+---
+
+## 🔄 Git-Branch-Strategie
+
+| Branch | Zweck | Wann wird gemerged? |
+|--------|-------|-------------------|
+| `daily` | Entwicklung, Experimente | → `testing` nach successful Tests |
+| `testing` | Getestete Versionen | → `stable` bei Release |
+| `stable` | Releases | Nur bei fertigen Versionen |
+
+---
+
+## 📁 Git-Server (Gitea)
+
+- **Repository-URL:** `https://git.darklithium.de/chrischi/fortunecookie`
+- **SSH-URL:** `gitea@darklithium:chrischi/fortunecookie.git`
+- **Standard-Branch:** `daily`
+
+### SSH-Key einrichten (einmalig)
+```bash
+# Key erstellen (auf Notebook/PC)
+ssh-keygen -t ed25519 -C "chrischi@darklithium.de"
+
+# Key zu Agent hinzufügen
+eval $(ssh-agent -s)
+ssh-add ~/.ssh/id_ed25519
+
+# Öffentlichen Key in Gitea hinterlegen
+# (https://git.darklithium.de → Einstellungen → SSH Keys)
+cat ~/.ssh/id_ed25519.pub
+```
+
+---
+
+## 📝 OpenStore-Veröffentlichung
+
+- **Repository-URL:** `https://git.darklithium.de/chrischi/fortunecookie`
+- **Verlinkter Branch:** `testing` (oder `daily` für Entwicklerversionen)
+
+---
+
+## 🎯 Quality Gates (vor Merge nach testing)
+
+- [ ] App startet ohne Fehler
+- [ ] Alle Listen funktionieren
+- [ ] Keine englischen Texte in deutschen Listen
+- [ ] Formatierung stimmt (Zeilenumbrüche, Ursprünge etc.)
+- [ ] Keine Syntax-Fehler in JSON-Dateien
+- [ ] Installation erfolgreich
+
+---
+
+## 📌 Wichtige Dateien & Pfade
+
+```
+fortunecookie-neu/
+├── testing/                    # Aktuelle Entwicklungsversion
+│   ├── qml/Main.qml           # UI & Logik
+│   ├── src/fortunecookie.py   # Backend & Spruchlisten-Verwaltung
+│   └── assets/fortunes/       # Alle Spruchlisten (*.json)
+│
+└── STABLE/                    # Stabilisierte Versionen
+    └── v1.0.1/                # Letztes Release
+```
+
+---
+
+## 🔧 Notfall: Remote neu setzen
+
+Falls das Remote verloren geht:
+```bash
+# Alle Remotes anzeigen
+git remote -v
+
+# Remote entfernen
+git remote remove origin
+
+# Remote neu setzen (SSH)
+git remote add origin gitea@darklithium:chrischi/fortunecookie.git
+
+# ODER (HTTPS)
+git remote add origin https://git.darklithium.de/chrischi/fortunecookie.git
+```