docs: Lektionen und Routinen dokumentiert

- 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>
2026-06-05 23:52:31 +02:00
parent cd69a9c619
commit 8586e38bb4
2 changed files with 128 additions and 0 deletions
@@ -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
+```