docs(03-03): complete forest scene plan

- SUMMARY.md with forest scene implementation details
- STATE.md updated with progress and decisions
- ROADMAP.md updated with plan progress
- Requirements FRST-01, FRST-02, FRST-03 marked complete

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.planning/REQUIREMENTS.md

@@ -67,9 +67,9 @@ Requirements for initial release (MVP). Each maps to roadmap phases.
 
 ### Forest
 
-- [ ] **FRST-01**: Waldszene: SVG-Hintergrund + 4×3 Grid für generierte Bilder
+- [x] **FRST-01**: Waldszene: SVG-Hintergrund + 4×3 Grid für generierte Bilder
-- [ ] **FRST-02**: Neue Elemente mit fade-in + scale-up Animation
+- [x] **FRST-02**: Neue Elemente mit fade-in + scale-up Animation
-- [ ] **FRST-03**: Alle bisherigen Elemente aus IndexedDB geladen und angezeigt
+- [x] **FRST-03**: Alle bisherigen Elemente aus IndexedDB geladen und angezeigt
 - [x] **FRST-04**: Stufenkarte: Level-Grid mit Status (locked/current/completed)
 - [x] **FRST-05**: "Weiter üben" Button startet nächste offene Stufe
 
@@ -193,9 +193,9 @@ Which phases cover which requirements. Updated during roadmap creation.
 | LEVL-04 | Phase 3 | Pending |
 | LEVL-05 | Phase 3 | Pending |
 | LEVL-06 | Phase 3 | Pending |
-| FRST-01 | Phase 3 | Pending |
+| FRST-01 | Phase 3 | Complete |
-| FRST-02 | Phase 3 | Pending |
+| FRST-02 | Phase 3 | Complete |
-| FRST-03 | Phase 3 | Pending |
+| FRST-03 | Phase 3 | Complete |
 | RWRD-01 | Phase 3 | Pending |
 | RWRD-02 | Phase 3 | Pending |
 | RWRD-03 | Phase 3 | Pending |

.planning/ROADMAP.md

@@ -73,7 +73,7 @@ Plans:
 Plans:
 - [ ] 03-01-PLAN.md — Word lists per level, Progress type extension, rate limit update
 - [ ] 03-02-PLAN.md — Lesson 3-phase state machine (discover/practice/words), review + repetition logic
-- [ ] 03-03-PLAN.md — Forest visual scene (SVG background, 4x3 grid, element rendering from IndexedDB)
+- [x] 03-03-PLAN.md — Forest visual scene (SVG background, 4x3 grid, element rendering from IndexedDB)
 - [ ] 03-04-PLAN.md — Reward screen with pre-generation, full flow wiring (lesson -> reward -> forest)
 - [ ] 03-05-PLAN.md — Parent area (access gate, stats overview, settings panel)
 

.planning/STATE.md

@@ -2,15 +2,15 @@
 gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
-status: verifying
+status: executing
-stopped_at: Phase 3 context gathered (assumptions mode)
+stopped_at: Completed 03-03-PLAN.md
-last_updated: "2026-03-29T11:28:24.608Z"
+last_updated: "2026-03-29T11:42:33.082Z"
 last_activity: 2026-03-29
 progress:
   total_phases: 4
   completed_phases: 2
-  total_plans: 10
+  total_plans: 15
-  completed_plans: 10
+  completed_plans: 11
   percent: 0
 ---
 
@@ -21,13 +21,13 @@ progress:
 See: .planning/PROJECT.md (updated 2026-03-29)
 
 **Core value:** Das Kind übt freiwillig weiter, weil es wissen will, was als Nächstes im Wald erscheint — nicht weil es Punkte sammelt.
-**Current focus:** Phase 02 — gemini-integration-asset-pipeline
+**Current focus:** Phase 03 — komplettes-spielerlebnis
 
 ## Current Position
 
-Phase: 3
+Phase: 03 (komplettes-spielerlebnis) — EXECUTING
-Plan: Not started
+Plan: 2 of 5
-Status: Phase complete — ready for verification
+Status: Ready to execute
 Last activity: 2026-03-29
 
 Progress: [░░░░░░░░░░] 0%
@@ -62,6 +62,7 @@ Progress: [░░░░░░░░░░] 0%
 | Phase 02 P04 | 1min | 1 tasks | 2 files |
 | Phase 02 P03 | 6min | 2 tasks | 12 files |
 | Phase 02 P05 | 3min | 3 tasks | 7 files |
+| Phase 03 P03 | 2min | 2 tasks | 3 files |
 
 ## Accumulated Context
 
@@ -88,6 +89,7 @@ Recent decisions affecting current work:
 - [Phase 02]: Fixed imageModel name: gemini-3.1-flash-preview-image -> gemini-3.1-flash-image-preview (was 404)
 - [Phase 02]: Asset generation script skips existing files for idempotent re-runs
 - [Phase 02]: Vite static imports for avatar PNGs with onerror emoji fallback pattern
+- [Phase 03]: Object URLs tracked in module-level array and revoked on re-render to prevent memory leaks
 
 ### Pending Todos
 
@@ -99,6 +101,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-03-29T11:28:24.601Z
+Last session: 2026-03-29T11:42:33.074Z
-Stopped at: Phase 3 context gathered (assumptions mode)
+Stopped at: Completed 03-03-PLAN.md
-Resume file: .planning/phases/03-komplettes-spielerlebnis/03-CONTEXT.md
+Resume file: None

.planning/phases/03-komplettes-spielerlebnis/03-03-SUMMARY.md

@@ -0,0 +1,97 @@
+---
+phase: 03-komplettes-spielerlebnis
+plan: 03
+subsystem: ui
+tags: [svg, css-grid, indexeddb, animation, forest-scene]
+
+requires:
+  - phase: 01-grundgeruest
+    provides: "IndexedDB schema with forestElements store"
+provides:
+  - "Visual forest scene with SVG woodland background"
+  - "4x3 CSS grid overlay for forest element images"
+  - "renderForestScene() function loading elements from IndexedDB"
+  - "Fade-in + scale-up animation for new elements"
+affects: [03-04, reward-flow, forest-display]
+
+tech-stack:
+  added: []
+  patterns: ["Object URL lifecycle management (create/revoke)", "SVG layered background with CSS grid overlay"]
+
+key-files:
+  created: []
+  modified: ["index.html", "src/styles/main.css", "src/forest/scene.ts"]
+
+key-decisions:
+  - "SVG element order: sky first (back), then clouds/sun, trees, hills, ground (front) for correct layering"
+  - "Object URLs tracked in module-level array and revoked on re-render to prevent memory leaks"
+  - "Random offset +-10-20px on element images for natural (non-grid-like) placement"
+
+patterns-established:
+  - "Object URL lifecycle: track in module array, revoke all before re-render"
+
+requirements-completed: [FRST-01, FRST-02, FRST-03]
+
+duration: 2min
+completed: 2026-03-29
+---
+
+# Phase 03 Plan 03: Forest Scene Summary
+
+**SVG woodland background with 4x3 CSS grid overlay rendering IndexedDB forest elements with fade-in animation**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-03-29T11:40:00Z
+- **Completed:** 2026-03-29T11:42:00Z
+- **Tasks:** 2
+- **Files modified:** 3
+
+## Accomplishments
+- SVG forest background with sky gradient, clouds, sun, background trees, hills, and ground
+- 4x3 CSS grid overlay positioned absolutely over SVG for element placement
+- renderForestScene() loads all ForestElements from IndexedDB and renders as images with random offset
+- New element animation (fade-in + scale-up, 1.2s ease-out) via CSS class
+- Object URL memory leak prevention with tracked revocation on re-render
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: SVG forest background and grid HTML structure** - `c9abc9e` (feat)
+2. **Task 2: Render forest elements from IndexedDB** - `e1fc5eb` (feat)
+
+## Files Created/Modified
+- `index.html` - Added forest scene container with SVG background and grid overlay in forest screen
+- `src/styles/main.css` - Added forest scene CSS: grid layout, element styling, appear animation keyframes
+- `src/forest/scene.ts` - Added renderForestScene() with IDB loading, Object URL management, animation class
+
+## Decisions Made
+- SVG element order: sky rect painted first (background), then clouds/sun, trees, hills, ground on top for correct visual layering
+- Object URLs stored in module-level array and revoked before each re-render to prevent memory leaks
+- Random offset of +-10-20px applied to each element image for natural, non-rigid placement within grid cells
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+None
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- Forest scene ready for Plan 04 (reward flow) to call renderForestScene(db, newElementId) after generating new elements
+- Level map still renders alongside the forest scene as expected
+
+## Self-Check: PASSED
+
+- All 3 modified files exist on disk
+- Both task commits verified in git log (c9abc9e, e1fc5eb)
+- SUMMARY.md created successfully
+
+---
+*Phase: 03-komplettes-spielerlebnis*
+*Completed: 2026-03-29*