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