chore(ci): add Jenkins pipeline with headless GUT test runner

Downloads Godot 4.6.2 on first run, caches in /tmp, runs all 231 unit tests headless on every push via Gitea webhook. Also updates development-plan.md: mark sprints 0-22 complete, document scope extensions, remove iOS references. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 13:09:26 +02:00
parent cda31fcac9
commit fb4434a537
2 changed files with 123 additions and 36 deletions
@@ -0,0 +1,46 @@
+pipeline {
+    agent any
+
+    environment {
+        GODOT_VERSION = '4.6.2-stable'
+        GODOT_BIN     = '/tmp/godot_ci/Godot_v4.6.2-stable_linux.x86_64'
+    }
+
+    stages {
+        stage('Godot Setup') {
+            steps {
+                sh '''
+                    if [ ! -x "$GODOT_BIN" ]; then
+                        mkdir -p /tmp/godot_ci
+                        wget -q -O /tmp/godot_ci/godot.zip \
+                            "https://github.com/godotengine/godot/releases/download/${GODOT_VERSION}/Godot_v${GODOT_VERSION}_linux.x86_64.zip"
+                        unzip -o /tmp/godot_ci/godot.zip -d /tmp/godot_ci/
+                        chmod +x "$GODOT_BIN"
+                    fi
+                '''
+            }
+        }
+
+        stage('Import Assets') {
+            steps {
+                // Godot must import assets before tests can run
+                sh '$GODOT_BIN --headless --import || true'
+            }
+        }
+
+        stage('Unit Tests') {
+            steps {
+                sh '$GODOT_BIN --headless -s res://addons/gut/gut_cmdln.gd -gdir=res://test/ -gexit'
+            }
+        }
+    }
+
+    post {
+        success {
+            echo '✅ All tests passed'
+        }
+        failure {
+            echo '❌ Tests failed'
+        }
+    }
+}
@@ -65,7 +65,6 @@ Hospital (Node2D)

 - **Entwicklungs-Rechner:** Dein Arbeitsplatz reicht
 - **Android-Export:** Android Studio SDK + JDK (einmalig einrichten)
- **iOS-Export:** Mac + Xcode + Apple Developer Account (€99/Jahr) — **oder:** Android zuerst, iOS später nachziehen
 - **Version Control:** Git (Godot-Projekte sind git-freundlich, `.import/` und `.godot/` in `.gitignore`)

 ### Empfohlene VS Code Setup (alternativ zum Godot-Editor)
@@ -234,25 +233,24 @@ Hier scheitern die meisten Hobby-Gamedev-Projekte. Drei realistische Wege:

 Realistisch für einen Vollzeit-Entwickler mit Familie und Side-Projekten. Kürzer geht, wenn du die Abende länger nutzt.

-### Sprint 0: Setup (Woche 1)
- [ ] Godot 4 installieren, Android-Export einrichten
- [ ] Git-Repo anlegen
- [ ] GDScript-Grundlagen durchgehen (Godot-Docs, 3-5h)
- [ ] Apple Developer Account falls iOS geplant
- [ ] Projektname + Logo-Idee
+### Sprint 0: Setup (Woche 1) ✅
+- [x] Godot 4 installieren, Android-Export einrichten
+- [x] Git-Repo anlegen
+- [x] GDScript-Grundlagen durchgehen (Godot-Docs, 3-5h)
+- [x] Projektname + Logo-Idee → "Cozypaw Hospital"

-### Sprint 1-2: Proof of Concept (Woche 2-3)
- [ ] Ein Raum (z.B. Empfang) mit Hintergrund
- [ ] Eine Figur (Platzhalter-Häschen) per Drag bewegen
- [ ] Ein interaktives Objekt (z.B. Blume pflücken)
- [ ] Auf echtem Tablet testen
- **Gate:** Funktioniert der Kern-Loop? Finden die Kinder es gut?
+### Sprint 1-2: Proof of Concept (Woche 2-3) ✅
+- [x] Ein Raum (z.B. Empfang) mit Hintergrund
+- [x] Eine Figur (Platzhalter-Häschen) per Drag bewegen
+- [x] Ein interaktives Objekt (z.B. Blume pflücken)
+- [x] Auf echtem Tablet testen
+- **Gate:** ✅ Kern-Loop funktioniert

-### Sprint 3-4: Core Systems (Woche 4-5)
- [ ] Raum-Navigationssystem (Etagen-Wechsel per Aufzug)
- [ ] Save/Load-System
- [ ] Settings-Menü (Lautstärke, Reset)
- [ ] Character-State-System (gesund, krank, schläft)
+### Sprint 3-4: Core Systems (Woche 4-5) ✅
+- [x] Raum-Navigationssystem (Etagen-Wechsel per Aufzug)
+- [x] Save/Load-System
+- [x] Settings-Menü (Lautstärke, Reset)
+- [x] Character-State-System (gesund, krank, schläft)

 ### Sprint 5-7: Erdgeschoss (Woche 6-8) ✅
 - [x] Empfang komplett
@@ -271,22 +269,71 @@ Realistisch für einen Vollzeit-Entwickler mit Familie und Side-Projekten. Kürz
 - [x] Kreißsaal (kindgerecht: Mama kommt rein, Baby ist da)
 - [x] Säuglingsstation mit Wiegen

-### Sprint 14: Zuhause & Garten (Woche 15)
- [ ] Garten-Szene
- [ ] Party-Mechanik (Geschenke auspacken, Tee)
+---

-### Sprint 15: Polish & Sound (Woche 16)
- [ ] Alle Sounds einbauen
- [ ] Hintergrundmusik mit Cross-Fade
- [ ] Animations-Feinschliff
- [ ] Tutorial / erster Start
+> **Scope-Erweiterung:** Die folgenden Sprints gingen über den ursprünglichen 16-Wochen-Plan hinaus und bauten das Spielsystem signifikant aus.

-### Sprint 16: Release-Vorbereitung (Woche 17+)
+### Sprint 15 (git): Character v2 ✅
+- [x] SnapPoint-System (Figuren rasten an Möbeln/Objekten ein)
+- [x] SnapReceiver-Komponente
+- [x] AnimState-System (idle, picked_up, placed)
+- [x] OutfitLayers (visuelle Outfit-Schichten pro Figur)
+- [x] HandSlots (Figur kann Objekte halten)
+
+### Sprint 16 (git): Snap-Points in allen Räumen ✅
+- [x] 25 SnapPoints quer über alle 12 Räume
+- [x] 115 Unit-Tests
+
+### Sprint 17 (git): Hand-Slots & Outfit-Items ✅
+- [x] HoldableItem mit Hand-Slot-Erkennung
+- [x] OutfitItem mit Tap-to-Undress
+- [x] GameState v2 — Outfit und gehaltene Items werden gespeichert
+
+### Sprint 18 (git): Room Chests & Item-Spawning ✅
+- [x] RoomChest mit Spawn- und Rücknahme-Logik
+- [x] ChestItemData Resource
+- [x] RoomChestConfig (alle Räume konfiguriert)
+- [x] Chest-Nodes in allen 12 Räumen
+
+### Sprint 19 (git): AudioManager & Cross-Fade ✅
+- [x] AudioManager Autoload mit `_SFX_MAP`
+- [x] Etagen-Musik mit Cross-Fade zwischen Räumen
+- [x] Basis-SFX: item_drag, item_drop, item_spawn, chest_tap
+
+### Sprint 20 (git): Navigation-Integration ✅
+- [x] RoomNavigator → GameState.set_current_room
+- [x] AudioManager wird beim Raumwechsel getriggert
+- [x] Kamera wird beim Laden auf gespeicherten Raum restored
+
+### Sprint 21 (git): Interaktive Objekte SFX ✅
+- [x] 7 neue `play_sfx`-Aufrufe in interaktiven Objekten
+- [x] SFX: xray_scan, gift_open, tea_pour, cradle_rock, ambulance_siren, delivery_cheer, object_tap
+
+### Sprint 22 (git): Character SFX & Ambient ✅
+- [x] character_pickup, character_tap, character_place SFX
+- [x] UltrasoundMachine: loopender Herzschlag-Ambient
+
+---
+
+### Sprint 14: Zuhause & Garten ✅
+- [x] Garten-Szene (GardenParty)
+- [x] Party-Mechanik: Geschenke auspacken (GiftBox), Tee einschenken (TeaPot)
+- [x] Kuchen schneiden (Cake) mit Reset-Statemachine
+- [x] Luftballons (Balloon) mit Pop/Respawn-Statemachine
+- [x] Stuhl-SnapPoints in der Gartenparty
+- [x] Floor-Music-Tracks 0–3 (echte CC0-Audiodateien)
+
+### Sprint 15 (Plan): Polish & Sound ✅
+- [x] Alle Sounds einbauen → erledigt in Sprint 21 + 22
+- [x] Hintergrundmusik mit Cross-Fade → erledigt in Sprint 19
+- [x] Animations-Feinschliff → erledigt in Sprint 15 (git) Character v2
+- [ ] Tutorial / erster Start ← **offen**
+
+### Sprint 16 (Plan): Release-Vorbereitung
 - [ ] Icon, Splash Screen
 - [ ] Play Console Setup, Screenshots, Beschreibung
- [ ] Internal Testing mit Kindern
- [ ] Release auf Play Store (Android zuerst)
- [ ] iOS-Port falls gewünscht
+- [ ] Internal Testing mit Kindern (UAT)
+- [ ] Release auf Play Store (Android)

 ---

@@ -298,11 +345,6 @@ Realistisch für einen Vollzeit-Entwickler mit Familie und Side-Projekten. Kürz
 3. Oder: Direkte APK-Distribution in der Familie (kein Store nötig)
 4. Ggf. später: Öffentlicher Release

-### iOS (später)
- Apple Developer Account (€99/Jahr)
- TestFlight für Familie
- App Store Review deutlich strenger als Google
-
 ### **WICHTIG — COPPA/Kids-Compliance**
 Da Zielgruppe 3+ Jahre:
 - Keine Analytics (Google Analytics, Firebase, etc.)
@@ -324,7 +366,6 @@ Da Zielgruppe 3+ Jahre:
 | Risiko | Mitigation |
 |---|---|
 | **Asset-Produktion zieht sich** | Mit Platzhaltern entwickeln, Assets parallelisieren |
-| **iOS-Deployment kompliziert** | Erst Android, iOS später |
 | **Feature-Creep** | Strikt am MVP-Plan halten, später iterieren |
 | **Motivation ebbt nach 2 Monaten ab** | Kinder regelmäßig Build zeigen → Feedback = Motor |
 | **Komplexe Animationen** | Mit einfachen 2-Frame-Animationen starten |