fortunecookie/ROUTINEN.md

Routinen & Workflow - FortuneCookie App

📌 Täglicher Entwicklungsworkflow

1️⃣ Arbeiten im daily-Branch

# 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

# Auf testing wechseln
git checkout testing

# daily in testing mergen
git merge daily

# Auf Gitea-Server pushen
git push origin testing

3️⃣ App installieren

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)

# 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:

# 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