From d008a17735a41a62e454f01ccf79ca2b3d7b893a Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 11:33:52 +0200
Subject: [PATCH 01/30] feat(planner): replace simulatedScore with scoreDelta +
 hasConflict in SuggestionItem
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

SuggestionItem now exposes scoreDelta (simulatedScore − currentScore) and
hasConflict (scoreDelta ≤ 0) so the frontend can render badges without
needing to pass currentVarietyScore as a separate prop.

PlanningService.getSuggestions() computes currentScore once per request
and derives scoreDelta + hasConflict per candidate. Sorting is unchanged
(scoreDelta desc = simulatedScore desc since currentScore is constant).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../recipeapp/planning/PlanningService.java   |  14 +-
 .../planning/dto/SuggestionResponse.java      |   3 +-
 .../recipeapp/planning/SuggestionsTest.java   | 182 ++++++++++++++----
 .../planning/WeekPlanControllerTest.java      |   5 +-
 4 files changed, 165 insertions(+), 39 deletions(-)

diff --git a/backend/src/main/java/com/recipeapp/planning/PlanningService.java b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
index 0e39c54..356c694 100644
--- a/backend/src/main/java/com/recipeapp/planning/PlanningService.java
+++ b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
@@ -135,6 +135,12 @@ public class PlanningService {
                 .map(cl -> cl.getRecipe().getId())
                 .collect(Collectors.toSet());
 
+        List<SimulatedSlot> currentSlots = plan.getSlots().stream()
+                .map(s -> new SimulatedSlot(s.getRecipe(), s.getSlotDate()))
+                .toList();
+        double currentScore = currentSlots.isEmpty() ? 10.0
+                : scoreFromSimulatedSlots(currentSlots, config, recentlyCookedIds);
+
         List<Recipe> allRecipes = recipeRepository.findByHouseholdIdAndDeletedAtIsNull(householdId);
 
         Set<String> lowerTagFilters = tagFilters.stream()
@@ -145,11 +151,13 @@ public class PlanningService {
                 .filter(r -> !usedRecipeIds.contains(r.getId()))
                 .filter(r -> matchesAllTags(r, lowerTagFilters))
                 .map(candidate -> {
-                    double score = simulateVarietyScore(
+                    double simulatedScore = simulateVarietyScore(
                             plan, candidate, slotDate, config, recentlyCookedIds);
-                    return new SuggestionResponse.SuggestionItem(toSlotRecipe(candidate), score);
+                    double scoreDelta = simulatedScore - currentScore;
+                    boolean hasConflict = scoreDelta <= 0;
+                    return new SuggestionResponse.SuggestionItem(toSlotRecipe(candidate), scoreDelta, hasConflict);
                 })
-                .sorted((a, b) -> Double.compare(b.simulatedScore(), a.simulatedScore()))
+                .sorted((a, b) -> Double.compare(b.scoreDelta(), a.scoreDelta()))
                 .limit(limit)
                 .toList();
 
diff --git a/backend/src/main/java/com/recipeapp/planning/dto/SuggestionResponse.java b/backend/src/main/java/com/recipeapp/planning/dto/SuggestionResponse.java
index 7c0f4ed..1844fcc 100644
--- a/backend/src/main/java/com/recipeapp/planning/dto/SuggestionResponse.java
+++ b/backend/src/main/java/com/recipeapp/planning/dto/SuggestionResponse.java
@@ -6,6 +6,7 @@ public record SuggestionResponse(List<SuggestionItem> suggestions) {
 
     public record SuggestionItem(
             SlotResponse.SlotRecipe recipe,
-            double simulatedScore
+            double scoreDelta,
+            boolean hasConflict
     ) {}
 }
diff --git a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
index 3e7495f..97eecb2 100644
--- a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
+++ b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
@@ -165,7 +165,7 @@ class SuggestionsTest {
         }
 
         @Test
-        void emptyPlanWithRecipesShouldReturnAllWithPerfectScore() {
+        void emptyPlanWithRecipesShouldReturnAllWithZeroDelta() {
             var plan = createPlan();
             var r1 = createRecipe("Pasta");
             var r2 = createRecipe("Salad");
@@ -179,8 +179,9 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(3);
+            // Empty plan → currentScore = 10.0; no conflicts → scoreDelta = 0.0 for all
             assertThat(result.suggestions()).allSatisfy(s ->
-                    assertThat(s.simulatedScore()).isEqualTo(10.0));
+                    assertThat(s.scoreDelta()).isEqualTo(0.0));
         }
 
         @Test
@@ -221,6 +222,117 @@ class SuggestionsTest {
         }
     }
 
+    // ═══════════════════════════════════════════════════════════
+    // Category 1b: scoreDelta and hasConflict
+    // ═══════════════════════════════════════════════════════════
+
+    @Nested
+    class ScoreDeltaAndHasConflict {
+
+        @Test
+        void recipeWithNoConflictsOnEmptyPlanShouldHaveZeroDeltaAndHasConflict() {
+            // Empty plan → currentScore = 10.0. Clean recipe → simulatedScore = 10.0.
+            // scoreDelta = 0.0, hasConflict = (0.0 <= 0) = true
+            var plan = createPlan();
+            var recipe = createRecipe("Clean Recipe");
+            stubPlan(plan);
+            stubDefaultConfig();
+            stubRecipes(recipe);
+            stubNoCookingLogs();
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 5);
+
+            assertThat(result.suggestions()).hasSize(1);
+            var item = result.suggestions().getFirst();
+            assertThat(item.scoreDelta()).isEqualTo(0.0);
+            assertThat(item.hasConflict()).isTrue();
+        }
+
+        @Test
+        void recipeWithTagConflictShouldHaveNegativeDeltaAndHasConflict() {
+            // Existing slot Mon=Monday Pasta (cuisine tag). Adding Tue=More Pasta → tag repeat penalty (-1.5).
+            // currentScore = 10.0 (1 slot, no consecutive). simulatedScore = 10.0 - 1.5 = 8.5.
+            // scoreDelta = -1.5, hasConflict = true.
+            var plan = createPlan();
+            var pastaTag = createTag("Pasta", "cuisine");
+            var existingRecipe = createRecipe("Monday Pasta");
+            addTag(existingRecipe, pastaTag);
+            addSlot(plan, existingRecipe, MONDAY);
+
+            var candidate = createRecipe("More Pasta");
+            addTag(candidate, pastaTag);
+
+            stubPlan(plan);
+            stubDefaultConfig();
+            stubRecipes(existingRecipe, candidate);
+            stubNoCookingLogs();
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
+
+            assertThat(result.suggestions()).hasSize(1);
+            var item = result.suggestions().getFirst();
+            assertThat(item.scoreDelta()).isEqualTo(-1.5);
+            assertThat(item.hasConflict()).isTrue();
+        }
+
+        @Test
+        void recipeWithIngredientConflictShouldHaveNegativeDeltaAndHasConflict() {
+            // Existing slot Mon=Tomato Soup (tomato ingredient). Adding Tue=Tomato Pasta → overlap (-0.3).
+            // currentScore = 10.0, simulatedScore = 9.7, scoreDelta = -0.3, hasConflict = true.
+            var plan = createPlan();
+            var tomato = createIngredient("Tomatoes", false);
+            var existingRecipe = createRecipe("Tomato Soup");
+            addIngredient(existingRecipe, tomato);
+            addSlot(plan, existingRecipe, MONDAY);
+
+            var candidate = createRecipe("Tomato Pasta");
+            addIngredient(candidate, tomato);
+
+            stubPlan(plan);
+            stubDefaultConfig();
+            stubRecipes(existingRecipe, candidate);
+            stubNoCookingLogs();
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
+
+            assertThat(result.suggestions()).hasSize(1);
+            var item = result.suggestions().getFirst();
+            assertThat(item.scoreDelta()).isCloseTo(-0.3, within(0.001));
+            assertThat(item.hasConflict()).isTrue();
+        }
+
+        @Test
+        void scoreDeltaIsSortedDescendingCleanBeforeConflicting() {
+            // Clean recipe (scoreDelta = 0.0) should rank above conflicting (scoreDelta < 0).
+            var plan = createPlan();
+            var pastaTag = createTag("Pasta", "cuisine");
+            var existingRecipe = createRecipe("Monday Pasta");
+            addTag(existingRecipe, pastaTag);
+            addSlot(plan, existingRecipe, MONDAY);
+
+            var cleanRecipe = createRecipe("Plain Rice");
+            var conflictingRecipe = createRecipe("More Pasta");
+            addTag(conflictingRecipe, pastaTag);
+
+            stubPlan(plan);
+            stubDefaultConfig();
+            stubRecipes(existingRecipe, cleanRecipe, conflictingRecipe);
+            stubNoCookingLogs();
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
+
+            assertThat(result.suggestions()).hasSize(2);
+            assertThat(result.suggestions().get(0).recipe().name()).isEqualTo("Plain Rice");
+            assertThat(result.suggestions().get(0).scoreDelta()).isEqualTo(0.0);
+            assertThat(result.suggestions().get(1).recipe().name()).isEqualTo("More Pasta");
+            assertThat(result.suggestions().get(1).scoreDelta()).isEqualTo(-1.5);
+        }
+    }
+
     // ═══════════════════════════════════════════════════════════
     // Category 2: Exclusion of In-Plan Recipes
     // ═══════════════════════════════════════════════════════════
@@ -402,8 +514,8 @@ class SuggestionsTest {
             assertThat(result.suggestions()).hasSize(2);
             // B should rank higher (no tag penalty)
             assertThat(result.suggestions().get(0).recipe().name()).isEqualTo("Plain Rice");
-            assertThat(result.suggestions().get(0).simulatedScore())
-                    .isGreaterThan(result.suggestions().get(1).simulatedScore());
+            assertThat(result.suggestions().get(0).scoreDelta())
+                    .isGreaterThan(result.suggestions().get(1).scoreDelta());
         }
 
         @Test
@@ -428,8 +540,8 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(2);
-            assertThat(result.suggestions().get(0).simulatedScore())
-                    .isEqualTo(result.suggestions().get(1).simulatedScore());
+            assertThat(result.suggestions().get(0).scoreDelta())
+                    .isEqualTo(result.suggestions().get(1).scoreDelta());
         }
 
         @Test
@@ -453,8 +565,8 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(1);
-            // No penalty — dietary not tracked
-            assertThat(result.suggestions().getFirst().simulatedScore()).isEqualTo(10.0);
+            // No penalty — dietary not tracked → scoreDelta = 0.0
+            assertThat(result.suggestions().getFirst().scoreDelta()).isEqualTo(0.0);
         }
     }
 
@@ -492,8 +604,8 @@ class SuggestionsTest {
 
             assertThat(result.suggestions()).hasSize(2);
             assertThat(result.suggestions().get(0).recipe().name()).isEqualTo("Mushroom Risotto");
-            assertThat(result.suggestions().get(0).simulatedScore())
-                    .isGreaterThan(result.suggestions().get(1).simulatedScore());
+            assertThat(result.suggestions().get(0).scoreDelta())
+                    .isGreaterThan(result.suggestions().get(1).scoreDelta());
         }
 
         @Test
@@ -519,7 +631,8 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(1);
-            assertThat(result.suggestions().getFirst().simulatedScore()).isEqualTo(10.0);
+            // Staples ignored → scoreDelta = 0.0
+            assertThat(result.suggestions().getFirst().scoreDelta()).isEqualTo(0.0);
         }
     }
 
@@ -547,8 +660,8 @@ class SuggestionsTest {
 
             assertThat(result.suggestions()).hasSize(2);
             assertThat(result.suggestions().get(0).recipe().name()).isEqualTo("Stir Fry");
-            assertThat(result.suggestions().get(0).simulatedScore())
-                    .isGreaterThan(result.suggestions().get(1).simulatedScore());
+            assertThat(result.suggestions().get(0).scoreDelta())
+                    .isGreaterThan(result.suggestions().get(1).scoreDelta());
         }
 
         @Test
@@ -566,7 +679,8 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(1);
-            assertThat(result.suggestions().getFirst().simulatedScore()).isEqualTo(10.0);
+            // No penalty → scoreDelta = 0.0
+            assertThat(result.suggestions().getFirst().scoreDelta()).isEqualTo(0.0);
         }
     }
 
@@ -631,7 +745,7 @@ class SuggestionsTest {
         }
 
         @Test
-        void rankingOrderShouldBeBySimulatedScoreDescending() {
+        void rankingOrderShouldBeByScoreDeltaDescending() {
             var plan = createPlan();
             var pastaTag = createTag("Pasta", "cuisine");
             var tomato = createIngredient("Tomatoes", false);
@@ -666,11 +780,11 @@ class SuggestionsTest {
             assertThat(result.suggestions().get(1).recipe().name()).isEqualTo("Dry Pasta");
             assertThat(result.suggestions().get(2).recipe().name()).isEqualTo("Tomato Pasta");
 
-            // Verify scores are strictly descending
-            assertThat(result.suggestions().get(0).simulatedScore())
-                    .isGreaterThan(result.suggestions().get(1).simulatedScore());
-            assertThat(result.suggestions().get(1).simulatedScore())
-                    .isGreaterThan(result.suggestions().get(2).simulatedScore());
+            // Verify scoreDelta is strictly descending
+            assertThat(result.suggestions().get(0).scoreDelta())
+                    .isGreaterThan(result.suggestions().get(1).scoreDelta());
+            assertThat(result.suggestions().get(1).scoreDelta())
+                    .isGreaterThan(result.suggestions().get(2).scoreDelta());
         }
 
         @Test
@@ -688,8 +802,8 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(2);
-            assertThat(result.suggestions().get(0).simulatedScore())
-                    .isEqualTo(result.suggestions().get(1).simulatedScore());
+            assertThat(result.suggestions().get(0).scoreDelta())
+                    .isEqualTo(result.suggestions().get(1).scoreDelta());
         }
     }
 
@@ -726,7 +840,7 @@ class SuggestionsTest {
             addTag(c1, pastaTag);
             addIngredient(c1, tomato);
 
-            // Candidate 2: Chicken only → protein repeat with Mon
+            // Candidate 2: Chicken only → protein repeat with Mon (Mon→Wed not consecutive)
             var c2 = createRecipe("Chicken Salad");
             addTag(c2, chickenTag);
 
@@ -745,7 +859,7 @@ class SuggestionsTest {
             stubPlan(plan);
             stubDefaultConfig();
             stubRecipes(monRecipe, tueRecipe, c1, c2, c3, c4, c5);
-            // c1 was cooked recently
+            // c1 was cooked recently (within 14-day window)
             stubCookingLogs(createCookingLog(c1, MONDAY.minusDays(3)));
 
             // Slot date = Wednesday (adjacent to Tuesday)
@@ -754,19 +868,20 @@ class SuggestionsTest {
 
             assertThat(result.suggestions()).hasSize(5);
 
-            // c2, c4, c5 all score 10.0 (no penalties — Chicken Mon→Wed not consecutive)
+            // currentScore = 10.0 (Mon+Tue plan: no consecutive conflicts between just those 2 slots)
+            // c2, c4, c5: no additional conflicts → scoreDelta = 0.0
             var topThree = result.suggestions().subList(0, 3);
             assertThat(topThree).extracting(s -> s.recipe().name())
                     .containsExactlyInAnyOrder("Chicken Salad", "Mushroom Risotto", "Lentil Soup");
-            assertThat(topThree).allSatisfy(s -> assertThat(s.simulatedScore()).isEqualTo(10.0));
+            assertThat(topThree).allSatisfy(s -> assertThat(s.scoreDelta()).isEqualTo(0.0));
 
-            // c3 (Cheese Omelette) has ingredient overlap Tue→Wed: -0.3
+            // c3 (Cheese Omelette) has ingredient overlap Tue→Wed: scoreDelta = -0.3
             assertThat(result.suggestions().get(3).recipe().name()).isEqualTo("Cheese Omelette");
-            assertThat(result.suggestions().get(3).simulatedScore()).isCloseTo(9.7, within(0.001));
+            assertThat(result.suggestions().get(3).scoreDelta()).isCloseTo(-0.3, within(0.001));
 
-            // c1 (Tomato Spaghetti) has recent repeat: -1.0
+            // c1 (Tomato Spaghetti) has recent repeat: scoreDelta = -1.0
             assertThat(result.suggestions().get(4).recipe().name()).isEqualTo("Tomato Spaghetti");
-            assertThat(result.suggestions().get(4).simulatedScore()).isEqualTo(9.0);
+            assertThat(result.suggestions().get(4).scoreDelta()).isEqualTo(-1.0);
         }
 
         @Test
@@ -800,7 +915,7 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1),
                     List.of("Quick meal"), 5);
 
-            // Only quick recipes, ranked by variety
+            // Only quick recipes, ranked by scoreDelta desc
             assertThat(result.suggestions()).hasSize(2);
             assertThat(result.suggestions().get(0).recipe().name()).isEqualTo("Quick Salad");
             assertThat(result.suggestions().get(1).recipe().name()).isEqualTo("Quick Pasta");
@@ -815,7 +930,7 @@ class SuggestionsTest {
     class EdgeCases {
 
         @Test
-        void recipeWithNoTagsOrIngredientsShouldGetPerfectScore() {
+        void recipeWithNoTagsOrIngredientsShouldGetZeroDelta() {
             var plan = createPlan();
             var existingRecipe = createRecipe("Existing");
             addSlot(plan, existingRecipe, MONDAY);
@@ -832,7 +947,8 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY.plusDays(1), List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(1);
-            assertThat(result.suggestions().getFirst().simulatedScore()).isEqualTo(10.0);
+            // No conflicts → scoreDelta = 0.0
+            assertThat(result.suggestions().getFirst().scoreDelta()).isEqualTo(0.0);
         }
 
         @Test
diff --git a/backend/src/test/java/com/recipeapp/planning/WeekPlanControllerTest.java b/backend/src/test/java/com/recipeapp/planning/WeekPlanControllerTest.java
index e827493..77cd512 100644
--- a/backend/src/test/java/com/recipeapp/planning/WeekPlanControllerTest.java
+++ b/backend/src/test/java/com/recipeapp/planning/WeekPlanControllerTest.java
@@ -162,7 +162,7 @@ class WeekPlanControllerTest {
     @Test
     void getSuggestionsShouldReturn200() throws Exception {
         var recipe = new SlotResponse.SlotRecipe(UUID.randomUUID(), "Stir Fry", "easy", (short) 15, null);
-        var item = new SuggestionResponse.SuggestionItem(recipe, 9.5);
+        var item = new SuggestionResponse.SuggestionItem(recipe, 1.5, false);
         var response = new SuggestionResponse(List.of(item));
 
         when(householdResolver.resolve("sarah@example.com")).thenReturn(HOUSEHOLD_ID);
@@ -175,7 +175,8 @@ class WeekPlanControllerTest {
                         .param("slotDate", "2026-04-08"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.suggestions[0].recipe.name").value("Stir Fry"))
-                .andExpect(jsonPath("$.suggestions[0].simulatedScore").value(9.5));
+                .andExpect(jsonPath("$.suggestions[0].scoreDelta").value(1.5))
+                .andExpect(jsonPath("$.suggestions[0].hasConflict").value(false));
     }
 
     @Test
-- 
2.49.1


From 7e97d2dc5805edd1a0e36d3deb69dfedce0a6cb0 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 11:35:33 +0200
Subject: [PATCH 02/30] chore(planner): delete orphaned SuggestionCard
 component and test

Unused since the suggestions route was removed (commit 4333dc0).
RecipePicker.test.ts is the active coverage for suggestion rendering.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../src/lib/planner/SuggestionCard.svelte     | 83 -------------------
 .../src/lib/planner/SuggestionCard.test.ts    | 60 --------------
 2 files changed, 143 deletions(-)
 delete mode 100644 frontend/src/lib/planner/SuggestionCard.svelte
 delete mode 100644 frontend/src/lib/planner/SuggestionCard.test.ts

diff --git a/frontend/src/lib/planner/SuggestionCard.svelte b/frontend/src/lib/planner/SuggestionCard.svelte
deleted file mode 100644
index 3d3f85e..0000000
--- a/frontend/src/lib/planner/SuggestionCard.svelte
+++ /dev/null
@@ -1,83 +0,0 @@
-<script lang="ts">
-	interface SlotRecipe {
-		id?: string;
-		name?: string;
-		effort?: string;
-		cookTimeMin?: number;
-	}
-
-	interface Suggestion {
-		recipe?: SlotRecipe;
-		simulatedScore?: number;
-		reasoningType?: 'good' | 'warning';
-		reasoningLabel?: string;
-	}
-
-	let {
-		suggestion,
-		rank,
-		planId,
-		slotDate,
-		weekStart
-	}: {
-		suggestion: Suggestion;
-		rank: number;
-		planId: string;
-		slotDate: string;
-		weekStart: string;
-	} = $props();
-
-	let metadata = $derived(
-		[
-			suggestion.recipe?.cookTimeMin != null ? `${suggestion.recipe.cookTimeMin} Min` : null,
-			suggestion.recipe?.effort ?? null
-		]
-			.filter(Boolean)
-			.join(' · ')
-	);
-</script>
-
-<div class="flex items-start gap-3 rounded-[var(--radius-md)] border border-[var(--color-border)] bg-[var(--color-surface)] px-4 py-3 shadow-[var(--shadow-card)]">
-	<!-- Rank number -->
-	<div class="w-10 flex-shrink-0 self-start text-right">
-		<span class="font-[var(--font-display)] text-[32px] font-[300] leading-none text-[var(--color-text-muted)]">{rank}</span>
-	</div>
-
-	<!-- Card content -->
-	<div class="flex-1 min-w-0">
-		<p class="font-[var(--font-sans)] text-[15px] font-medium text-[var(--color-text)] line-clamp-2">
-			{suggestion.recipe?.name ?? 'Unbekanntes Rezept'}
-		</p>
-		{#if metadata}
-			<p class="mt-0.5 font-[var(--font-sans)] text-[12px] text-[var(--color-text-muted)]">{metadata}</p>
-		{/if}
-
-		<!-- Reasoning badge -->
-		{#if suggestion.reasoningType && suggestion.reasoningLabel}
-			<div
-				data-testid="reasoning-badge"
-				data-type={suggestion.reasoningType}
-				class="mt-2 inline-flex items-center rounded-full px-2 py-0.5 font-[var(--font-sans)] text-[11px] font-medium
-					{suggestion.reasoningType === 'good'
-						? 'bg-[var(--green-tint)] text-[var(--green-dark)]'
-						: 'bg-[var(--yellow-tint)] text-[var(--yellow-text)]'}"
-			>
-				{suggestion.reasoningType === 'good' ? '✓' : '⚠'} {suggestion.reasoningLabel}
-			</div>
-		{/if}
-	</div>
-
-	<!-- Pick action -->
-	<form method="POST" action="?/pickSuggestion" class="flex-shrink-0">
-		<input type="hidden" name="planId" value={planId} />
-		<input type="hidden" name="recipeId" value={suggestion.recipe?.id} />
-		<input type="hidden" name="slotDate" value={slotDate} />
-		<input type="hidden" name="weekStart" value={weekStart} />
-		<button
-			type="submit"
-			class="font-[var(--font-sans)] text-[13px] font-medium tracking-[0.04em] text-[var(--green-dark)] hover:underline"
-		>
-			Wählen
-		</button>
-	</form>
-</div>
diff --git a/frontend/src/lib/planner/SuggestionCard.test.ts b/frontend/src/lib/planner/SuggestionCard.test.ts
deleted file mode 100644
index 48ad994..0000000
--- a/frontend/src/lib/planner/SuggestionCard.test.ts
+++ /dev/null
@@ -1,60 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { render, screen } from '@testing-library/svelte';
-import SuggestionCard from './SuggestionCard.svelte';
-
-const goodSuggestion = {
-	recipe: { id: 'r1', name: 'Pasta al Limone', effort: 'Easy', cookTimeMin: 25 },
-	simulatedScore: 9.2,
-	reasoningType: 'good' as const,
-	reasoningLabel: 'Frisches Protein · Aufwandsbalance'
-};
-
-const warningSuggestion = {
-	recipe: { id: 'r2', name: 'Hühnchen Curry', effort: 'Medium', cookTimeMin: 45 },
-	simulatedScore: 6.1,
-	reasoningType: 'warning' as const,
-	reasoningLabel: 'Hähnchen schon 2 Tage dabei'
-};
-
-describe('SuggestionCard', () => {
-	it('renders recipe name', () => {
-		render(SuggestionCard, { props: { suggestion: goodSuggestion, rank: 1, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		expect(screen.getByText('Pasta al Limone')).toBeTruthy();
-	});
-
-	it('renders rank number', () => {
-		render(SuggestionCard, { props: { suggestion: goodSuggestion, rank: 1, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		expect(screen.getByText('1')).toBeTruthy();
-	});
-
-	it('renders cook time and effort metadata', () => {
-		render(SuggestionCard, { props: { suggestion: goodSuggestion, rank: 1, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		expect(screen.getByText(/25 Min/)).toBeTruthy();
-		expect(screen.getByText(/Easy/)).toBeTruthy();
-	});
-
-	it('renders green reasoning badge for good suggestions', () => {
-		render(SuggestionCard, { props: { suggestion: goodSuggestion, rank: 1, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		const badge = screen.getByTestId('reasoning-badge');
-		expect(badge.getAttribute('data-type')).toBe('good');
-		expect(badge.textContent).toContain('Frisches Protein');
-	});
-
-	it('renders yellow reasoning badge for warnings', () => {
-		render(SuggestionCard, { props: { suggestion: warningSuggestion, rank: 2, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		const badge = screen.getByTestId('reasoning-badge');
-		expect(badge.getAttribute('data-type')).toBe('warning');
-		expect(badge.textContent).toContain('Hähnchen');
-	});
-
-	it('renders a pick button/form', () => {
-		render(SuggestionCard, { props: { suggestion: goodSuggestion, rank: 1, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		expect(screen.getByRole('button', { name: /Wählen/i })).toBeTruthy();
-	});
-
-	it('card without reasoning renders without crashing', () => {
-		const noReasoning = { ...goodSuggestion, reasoningType: undefined, reasoningLabel: undefined };
-		render(SuggestionCard, { props: { suggestion: noReasoning, rank: 1, planId: 'p1', slotDate: '2026-04-01', weekStart: '2026-03-30' } });
-		expect(screen.getByText('Pasta al Limone')).toBeTruthy();
-	});
-});
-- 
2.49.1


From b6ad64ea534788f25ff723cf749f2c4c5db22040 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 11:35:57 +0200
Subject: [PATCH 03/30] =?UTF-8?q?chore(api):=20update=20SuggestionItem=20s?=
 =?UTF-8?q?chema=20=E2=80=94=20scoreDelta=20+=20hasConflict=20replace=20si?=
 =?UTF-8?q?mulatedScore?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/api/openapi.json | 2 +-
 frontend/src/lib/api/schema.d.ts  | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/frontend/src/lib/api/openapi.json b/frontend/src/lib/api/openapi.json
index 0b6b1ec..91b09db 100644
--- a/frontend/src/lib/api/openapi.json
+++ b/frontend/src/lib/api/openapi.json
@@ -1 +1 @@
-{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost:8080","description":"Generated server url"}],"paths":{"/v1/recipes/{id}":{"get":{"tags":["recipe-controller"],"operationId":"getRecipe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecipeDetailResponse"}}}}}},"put":{"tags":["recipe-controller"],"operationId":"updateRecipe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipeCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecipeDetailResponse"}}}}}},"delete":{"tags":["recipe-controller"],"operationId":"deleteRecipe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/v1/week-plans":{"get":{"tags":["week-plan-controller"],"operationId":"getWeekPlan","parameters":[{"name":"weekStart","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WeekPlanResponse"}}}}}},"post":{"tags":["week-plan-controller"],"operationId":"createWeekPlan","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWeekPlanRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WeekPlanResponse"}}}}}}},"/v1/week-plans/{id}/slots":{"post":{"tags":["week-plan-controller"],"operationId":"addSlot","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSlotRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SlotResponse"}}}}}}},"/v1/week-plans/{id}/shopping-list":{"post":{"tags":["shopping-list-controller"],"operationId":"generateFromPlan","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListResponse"}}}}}}},"/v1/week-plans/{id}/confirm":{"post":{"tags":["week-plan-controller"],"operationId":"confirmPlan","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WeekPlanResponse"}}}}}}},"/v1/tags":{"get":{"tags":["tag-controller"],"operationId":"listTags","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TagResponse"}}}}}}},"post":{"tags":["tag-controller"],"operationId":"createTag","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TagResponse"}}}}}}},"/v1/shopping-lists/{id}/items":{"post":{"tags":["shopping-list-controller"],"operationId":"addItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddItemRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListItemResponse"}}}}}}},"/v1/recipes":{"get":{"tags":["recipe-controller"],"operationId":"listRecipes","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"effort","in":"query","required":false,"schema":{"type":"string"}},{"name":"isChildFriendly","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"cookTimeMin.lte","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListRecipeSummaryResponse"}}}}}},"post":{"tags":["recipe-controller"],"operationId":"createRecipe","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipeCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecipeDetailResponse"}}}}}}},"/v1/pantry-items":{"get":{"tags":["pantry-controller"],"operationId":"listItems","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PantryItemResponse"}}}}}}},"post":{"tags":["pantry-controller"],"operationId":"createItem","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePantryItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PantryItemResponse"}}}}}}},"/v1/invites/{code}/accept":{"post":{"tags":["household-controller"],"operationId":"acceptInvite","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAcceptInviteResponse"}}}}}}},"/v1/ingredient-categories":{"get":{"tags":["ingredient-category-controller"],"operationId":"listCategories","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IngredientCategoryResponse"}}}}}}},"post":{"tags":["ingredient-category-controller"],"operationId":"createCategory","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngredientCategoryCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IngredientCategoryResponse"}}}}}}},"/v1/households":{"post":{"tags":["household-controller"],"operationId":"createHousehold","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateHouseholdRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseHouseholdResponse"}}}}}}},"/v1/households/mine/invites":{"post":{"tags":["household-controller"],"operationId":"createInvite","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseInviteResponse"}}}}}}},"/v1/cooking-logs":{"get":{"tags":["cooking-log-controller"],"operationId":"listCookingLogs","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":30}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CookingLogResponse"}}}}}}},"post":{"tags":["cooking-log-controller"],"operationId":"createCookingLog","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCookingLogRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CookingLogResponse"}}}}}}},"/v1/auth/signup":{"post":{"tags":["auth-controller"],"operationId":"signup","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}}},"/v1/auth/logout":{"post":{"tags":["auth-controller"],"operationId":"logout","responses":{"200":{"description":"OK"}}}},"/v1/auth/login":{"post":{"tags":["auth-controller"],"operationId":"login","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}}},"/v1/admin/users":{"get":{"tags":["admin-controller"],"operationId":"listUsers","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"isActive","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAdminUserResponse"}}}}}},"post":{"tags":["admin-controller"],"operationId":"createUser","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminUserResponse"}}}}}}},"/v1/admin/users/{id}/reset-password":{"post":{"tags":["admin-controller"],"operationId":"resetPassword","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseResetPasswordResponse"}}}}}}},"/v1/week-plans/{planId}/slots/{slotId}":{"delete":{"tags":["week-plan-controller"],"operationId":"deleteSlot","parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["week-plan-controller"],"operationId":"updateSlot","parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSlotRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SlotResponse"}}}}}}},"/v1/shopping-lists/{listId}/items/{itemId}":{"delete":{"tags":["shopping-list-controller"],"operationId":"deleteItem","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["shopping-list-controller"],"operationId":"checkItem","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListItemResponse"}}}}}}},"/v1/pantry-items/{id}":{"delete":{"tags":["pantry-controller"],"operationId":"deleteItem_1","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["pantry-controller"],"operationId":"updateItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePantryItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PantryItemResponse"}}}}}}},"/v1/ingredients/{id}":{"patch":{"tags":["ingredient-controller"],"operationId":"patchIngredient","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngredientPatchRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IngredientResponse"}}}}}}},"/v1/auth/me":{"get":{"tags":["auth-controller"],"operationId":"me","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}},"patch":{"tags":["auth-controller"],"operationId":"updateProfile","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}}},"/v1/admin/users/{id}":{"patch":{"tags":["admin-controller"],"operationId":"updateUser","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminUserResponse"}}}}}}},"/v1/week-plans/{id}/variety-score":{"get":{"tags":["week-plan-controller"],"operationId":"getVarietyScore","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/VarietyScoreResponse"}}}}}}},"/v1/week-plans/{id}/suggestions":{"get":{"tags":["week-plan-controller"],"operationId":"getSuggestions","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slotDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"tags","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"topN","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SuggestionResponse"}}}}}}},"/v1/shopping-lists/{id}":{"get":{"tags":["shopping-list-controller"],"operationId":"getShoppingList","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListResponse"}}}}}}},"/v1/shopping-list":{"get":{"tags":["shopping-list-controller"],"operationId":"getByWeekStart","parameters":[{"name":"weekStart","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListResponse"}}}}}}},"/v1/ingredients":{"get":{"tags":["ingredient-controller"],"operationId":"searchIngredients","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"isStaple","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IngredientResponse"}}}}}}}},"/v1/households/mine":{"get":{"tags":["household-controller"],"operationId":"getMyHousehold","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseHouseholdResponse"}}}}}}},"/v1/households/mine/members":{"get":{"tags":["household-controller"],"operationId":"getMembers","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberResponse"}}}}}}}},"/v1/admin/audit-log":{"get":{"tags":["admin-controller"],"operationId":"listAuditLog","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"targetUserId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAuditLogResponse"}}}}}}}},"components":{"schemas":{"IngredientEntry":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"newIngredientName":{"type":"string","maxLength":200,"minLength":0},"quantity":{"type":"number","minimum":0.01},"unit":{"type":"string","maxLength":20,"minLength":0},"sortOrder":{"type":"integer","format":"int32"}},"required":["quantity","unit"]},"RecipeCreateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"minLength":0},"serves":{"type":"integer","format":"int32","maximum":20,"minimum":1},"cookTimeMin":{"type":"integer","format":"int32","minimum":0},"effort":{"type":"string","minLength":1,"pattern":"easy|medium|hard"},"isChildFriendly":{"type":"boolean"},"heroImageUrl":{"type":"string","maxLength":500,"minLength":0},"ingredients":{"type":"array","items":{"$ref":"#/components/schemas/IngredientEntry"},"minItems":1},"steps":{"type":"array","items":{"$ref":"#/components/schemas/StepEntry"}},"tagIds":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1}},"required":["effort","ingredients","name","tagIds"]},"StepEntry":{"type":"object","properties":{"stepNumber":{"type":"integer","format":"int32","minimum":1},"instruction":{"type":"string","minLength":1}},"required":["instruction"]},"CategoryRef":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"IngredientItem":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"quantity":{"type":"number"},"unit":{"type":"string"},"sortOrder":{"type":"integer","format":"int32"}}},"RecipeDetailResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"serves":{"type":"integer","format":"int32"},"cookTimeMin":{"type":"integer","format":"int32"},"effort":{"type":"string"},"isChildFriendly":{"type":"boolean"},"heroImageUrl":{"type":"string"},"ingredients":{"type":"array","items":{"$ref":"#/components/schemas/IngredientItem"}},"steps":{"type":"array","items":{"$ref":"#/components/schemas/StepItem"}},"tags":{"type":"array","items":{"$ref":"#/components/schemas/TagItem"}}}},"StepItem":{"type":"object","properties":{"stepNumber":{"type":"integer","format":"int32"},"instruction":{"type":"string"}}},"TagItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"tagType":{"type":"string"}}},"CreateWeekPlanRequest":{"type":"object","properties":{"weekStart":{"type":"string","format":"date"}},"required":["weekStart"]},"SlotRecipe":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"effort":{"type":"string"},"cookTimeMin":{"type":"integer","format":"int32"},"heroImageUrl":{"type":"string"}}},"SlotResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slotDate":{"type":"string","format":"date"},"recipe":{"$ref":"#/components/schemas/SlotRecipe"}}},"WeekPlanResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"weekStart":{"type":"string","format":"date"},"status":{"type":"string"},"confirmedAt":{"type":"string","format":"date-time"},"slots":{"type":"array","items":{"$ref":"#/components/schemas/SlotResponse"}}}},"CreateSlotRequest":{"type":"object","properties":{"slotDate":{"type":"string","format":"date"},"recipeId":{"type":"string","format":"uuid"}},"required":["recipeId","slotDate"]},"RecipeRef":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"ShoppingListItemResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ingredientId":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"quantity":{"type":"number"},"unit":{"type":"string"},"isChecked":{"type":"boolean"},"checkedBy":{"type":"string","format":"uuid"},"sourceRecipes":{"type":"array","items":{"$ref":"#/components/schemas/RecipeRef"}}}},"ShoppingListResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"weekPlanId":{"type":"string","format":"uuid"},"generatedAt":{"type":"string","format":"date-time"},"filteredStaplesCount":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ShoppingListItemResponse"}}}},"TagCreateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"minLength":0},"tagType":{"type":"string","minLength":1,"pattern":"protein|dietary|cuisine|other"}},"required":["name","tagType"]},"TagResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"tagType":{"type":"string"}}},"AddItemRequest":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"customName":{"type":"string"},"quantity":{"type":"number"},"unit":{"type":"string"}}},"CreatePantryItemRequest":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"customName":{"type":"string"},"quantity":{"type":"number"},"unit":{"type":"string"},"bestBefore":{"type":"string","format":"date"},"openedOn":{"type":"string","format":"date"}}},"PantryItemResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ingredientId":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"quantity":{"type":"number"},"unit":{"type":"string"},"bestBefore":{"type":"string","format":"date"},"openedOn":{"type":"string","format":"date"}}},"AcceptInviteResponse":{"type":"object","properties":{"householdId":{"type":"string","format":"uuid"},"householdName":{"type":"string"},"role":{"type":"string"}}},"ApiResponseAcceptInviteResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/AcceptInviteResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"Meta":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Pagination":{"type":"object","properties":{"total":{"type":"integer","format":"int64"},"limit":{"type":"integer","format":"int32"},"offset":{"type":"integer","format":"int32"},"hasMore":{"type":"boolean"}}},"IngredientCategoryCreateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"minLength":0}},"required":["name"]},"IngredientCategoryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"CreateHouseholdRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"minLength":0}},"required":["name"]},"ApiResponseHouseholdResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/HouseholdResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"HouseholdResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"members":{"type":"array","items":{"$ref":"#/components/schemas/MemberResponse"}}}},"MemberResponse":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"displayName":{"type":"string"},"role":{"type":"string"},"joinedAt":{"type":"string","format":"date-time"}}},"ApiResponseInviteResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/InviteResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"InviteResponse":{"type":"object","properties":{"inviteCode":{"type":"string"},"shareUrl":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateCookingLogRequest":{"type":"object","properties":{"recipeId":{"type":"string","format":"uuid"},"cookedOn":{"type":"string","format":"date"}},"required":["recipeId"]},"CookingLogResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"recipeId":{"type":"string","format":"uuid"},"recipeName":{"type":"string"},"cookedOn":{"type":"string","format":"date"},"cookedBy":{"type":"string","format":"uuid"}}},"SignupRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1},"password":{"type":"string","maxLength":2147483647,"minLength":8},"displayName":{"type":"string","maxLength":100,"minLength":0}},"required":["displayName","email","password"]},"ApiResponseUserResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/UserResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"UserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"displayName":{"type":"string"},"householdId":{"type":"string","format":"uuid"},"householdName":{"type":"string"},"householdRole":{"type":"string"},"systemRole":{"type":"string"}}},"LoginRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1},"password":{"type":"string","minLength":1}},"required":["email","password"]},"CreateUserRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1},"displayName":{"type":"string","maxLength":100,"minLength":0},"tempPassword":{"type":"string","maxLength":2147483647,"minLength":8},"systemRole":{"type":"string"}},"required":["displayName","email","tempPassword"]},"AdminUserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"displayName":{"type":"string"},"systemRole":{"type":"string"},"isActive":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}}},"ApiResponseAdminUserResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/AdminUserResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ResetPasswordRequest":{"type":"object","properties":{"tempPassword":{"type":"string","maxLength":2147483647,"minLength":8},"reason":{"type":"string"}},"required":["tempPassword"]},"ApiResponseResetPasswordResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/ResetPasswordResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ResetPasswordResponse":{"type":"object","properties":{"message":{"type":"string"},"mustChangePassword":{"type":"boolean"}}},"UpdateSlotRequest":{"type":"object","properties":{"recipeId":{"type":"string","format":"uuid"}},"required":["recipeId"]},"CheckItemRequest":{"type":"object","properties":{"isChecked":{"type":"boolean"}}},"UpdatePantryItemRequest":{"type":"object","properties":{"quantity":{"type":"number"},"unit":{"type":"string"},"bestBefore":{"type":"string","format":"date"},"openedOn":{"type":"string","format":"date"}}},"IngredientPatchRequest":{"type":"object","properties":{"name":{"type":"string"},"isStaple":{"type":"boolean"},"categoryId":{"type":"string","format":"uuid"}}},"IngredientResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"isStaple":{"type":"boolean"}}},"UpdateProfileRequest":{"type":"object","properties":{"displayName":{"type":"string","maxLength":100,"minLength":0},"currentPassword":{"type":"string"},"newPassword":{"type":"string","maxLength":2147483647,"minLength":8}}},"UpdateUserRequest":{"type":"object","properties":{"displayName":{"type":"string"},"email":{"type":"string"},"systemRole":{"type":"string"},"isActive":{"type":"boolean"}}},"IngredientOverlap":{"type":"object","properties":{"ingredientName":{"type":"string"},"days":{"type":"array","items":{"type":"string","format":"date"}}}},"TagRepeat":{"type":"object","properties":{"tagName":{"type":"string"},"tagType":{"type":"string"},"days":{"type":"array","items":{"type":"string","format":"date"}}}},"VarietyScoreResponse":{"type":"object","properties":{"score":{"type":"number","format":"double"},"tagRepeats":{"type":"array","items":{"$ref":"#/components/schemas/TagRepeat"}},"ingredientOverlaps":{"type":"array","items":{"$ref":"#/components/schemas/IngredientOverlap"}},"recentRepeats":{"type":"array","items":{"type":"string"}},"duplicatesInPlan":{"type":"array","items":{"type":"string"}}}},"SuggestionItem":{"type":"object","properties":{"recipe":{"$ref":"#/components/schemas/SlotRecipe"},"simulatedScore":{"type":"number","format":"double"}}},"SuggestionResponse":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/SuggestionItem"}}}},"ApiResponseListRecipeSummaryResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/RecipeSummaryResponse"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"RecipeSummaryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"serves":{"type":"integer","format":"int32"},"cookTimeMin":{"type":"integer","format":"int32"},"effort":{"type":"string"},"isChildFriendly":{"type":"boolean"},"heroImageUrl":{"type":"string"}}},"ApiResponseListAdminUserResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserResponse"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"ApiResponseListAuditLogResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AuditLogResponse"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"AuditLogResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"adminId":{"type":"string","format":"uuid"},"adminEmail":{"type":"string"},"targetUserId":{"type":"string","format":"uuid"},"targetEmail":{"type":"string"},"action":{"type":"string"},"detail":{"type":"object","additionalProperties":{}},"performedAt":{"type":"string","format":"date-time"}}}}}}
\ No newline at end of file
+{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost:8080","description":"Generated server url"}],"paths":{"/v1/recipes/{id}":{"get":{"tags":["recipe-controller"],"operationId":"getRecipe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecipeDetailResponse"}}}}}},"put":{"tags":["recipe-controller"],"operationId":"updateRecipe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipeCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecipeDetailResponse"}}}}}},"delete":{"tags":["recipe-controller"],"operationId":"deleteRecipe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/v1/week-plans":{"get":{"tags":["week-plan-controller"],"operationId":"getWeekPlan","parameters":[{"name":"weekStart","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WeekPlanResponse"}}}}}},"post":{"tags":["week-plan-controller"],"operationId":"createWeekPlan","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWeekPlanRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WeekPlanResponse"}}}}}}},"/v1/week-plans/{id}/slots":{"post":{"tags":["week-plan-controller"],"operationId":"addSlot","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSlotRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SlotResponse"}}}}}}},"/v1/week-plans/{id}/shopping-list":{"post":{"tags":["shopping-list-controller"],"operationId":"generateFromPlan","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListResponse"}}}}}}},"/v1/week-plans/{id}/confirm":{"post":{"tags":["week-plan-controller"],"operationId":"confirmPlan","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WeekPlanResponse"}}}}}}},"/v1/tags":{"get":{"tags":["tag-controller"],"operationId":"listTags","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TagResponse"}}}}}}},"post":{"tags":["tag-controller"],"operationId":"createTag","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TagResponse"}}}}}}},"/v1/shopping-lists/{id}/items":{"post":{"tags":["shopping-list-controller"],"operationId":"addItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddItemRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListItemResponse"}}}}}}},"/v1/recipes":{"get":{"tags":["recipe-controller"],"operationId":"listRecipes","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"effort","in":"query","required":false,"schema":{"type":"string"}},{"name":"isChildFriendly","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"cookTimeMin.lte","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListRecipeSummaryResponse"}}}}}},"post":{"tags":["recipe-controller"],"operationId":"createRecipe","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipeCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecipeDetailResponse"}}}}}}},"/v1/pantry-items":{"get":{"tags":["pantry-controller"],"operationId":"listItems","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PantryItemResponse"}}}}}}},"post":{"tags":["pantry-controller"],"operationId":"createItem","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePantryItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PantryItemResponse"}}}}}}},"/v1/invites/{code}/accept":{"post":{"tags":["household-controller"],"operationId":"acceptInvite","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAcceptInviteResponse"}}}}}}},"/v1/ingredient-categories":{"get":{"tags":["ingredient-category-controller"],"operationId":"listCategories","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IngredientCategoryResponse"}}}}}}},"post":{"tags":["ingredient-category-controller"],"operationId":"createCategory","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngredientCategoryCreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IngredientCategoryResponse"}}}}}}},"/v1/households":{"post":{"tags":["household-controller"],"operationId":"createHousehold","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateHouseholdRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseHouseholdResponse"}}}}}}},"/v1/households/mine/invites":{"post":{"tags":["household-controller"],"operationId":"createInvite","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseInviteResponse"}}}}}}},"/v1/cooking-logs":{"get":{"tags":["cooking-log-controller"],"operationId":"listCookingLogs","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":30}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CookingLogResponse"}}}}}}},"post":{"tags":["cooking-log-controller"],"operationId":"createCookingLog","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCookingLogRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CookingLogResponse"}}}}}}},"/v1/auth/signup":{"post":{"tags":["auth-controller"],"operationId":"signup","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}}},"/v1/auth/logout":{"post":{"tags":["auth-controller"],"operationId":"logout","responses":{"200":{"description":"OK"}}}},"/v1/auth/login":{"post":{"tags":["auth-controller"],"operationId":"login","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}}},"/v1/admin/users":{"get":{"tags":["admin-controller"],"operationId":"listUsers","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"isActive","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAdminUserResponse"}}}}}},"post":{"tags":["admin-controller"],"operationId":"createUser","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminUserResponse"}}}}}}},"/v1/admin/users/{id}/reset-password":{"post":{"tags":["admin-controller"],"operationId":"resetPassword","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseResetPasswordResponse"}}}}}}},"/v1/week-plans/{planId}/slots/{slotId}":{"delete":{"tags":["week-plan-controller"],"operationId":"deleteSlot","parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["week-plan-controller"],"operationId":"updateSlot","parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSlotRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SlotResponse"}}}}}}},"/v1/shopping-lists/{listId}/items/{itemId}":{"delete":{"tags":["shopping-list-controller"],"operationId":"deleteItem","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["shopping-list-controller"],"operationId":"checkItem","parameters":[{"name":"listId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListItemResponse"}}}}}}},"/v1/pantry-items/{id}":{"delete":{"tags":["pantry-controller"],"operationId":"deleteItem_1","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["pantry-controller"],"operationId":"updateItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePantryItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PantryItemResponse"}}}}}}},"/v1/ingredients/{id}":{"patch":{"tags":["ingredient-controller"],"operationId":"patchIngredient","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngredientPatchRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IngredientResponse"}}}}}}},"/v1/auth/me":{"get":{"tags":["auth-controller"],"operationId":"me","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}},"patch":{"tags":["auth-controller"],"operationId":"updateProfile","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserResponse"}}}}}}},"/v1/admin/users/{id}":{"patch":{"tags":["admin-controller"],"operationId":"updateUser","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminUserResponse"}}}}}}},"/v1/week-plans/{id}/variety-score":{"get":{"tags":["week-plan-controller"],"operationId":"getVarietyScore","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/VarietyScoreResponse"}}}}}}},"/v1/week-plans/{id}/suggestions":{"get":{"tags":["week-plan-controller"],"operationId":"getSuggestions","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slotDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"tags","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"topN","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SuggestionResponse"}}}}}}},"/v1/shopping-lists/{id}":{"get":{"tags":["shopping-list-controller"],"operationId":"getShoppingList","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListResponse"}}}}}}},"/v1/shopping-list":{"get":{"tags":["shopping-list-controller"],"operationId":"getByWeekStart","parameters":[{"name":"weekStart","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ShoppingListResponse"}}}}}}},"/v1/ingredients":{"get":{"tags":["ingredient-controller"],"operationId":"searchIngredients","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"isStaple","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IngredientResponse"}}}}}}}},"/v1/households/mine":{"get":{"tags":["household-controller"],"operationId":"getMyHousehold","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseHouseholdResponse"}}}}}}},"/v1/households/mine/members":{"get":{"tags":["household-controller"],"operationId":"getMembers","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberResponse"}}}}}}}},"/v1/admin/audit-log":{"get":{"tags":["admin-controller"],"operationId":"listAuditLog","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"targetUserId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAuditLogResponse"}}}}}}}},"components":{"schemas":{"IngredientEntry":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"newIngredientName":{"type":"string","maxLength":200,"minLength":0},"quantity":{"type":"number","minimum":0.01},"unit":{"type":"string","maxLength":20,"minLength":0},"sortOrder":{"type":"integer","format":"int32"}},"required":["quantity","unit"]},"RecipeCreateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"minLength":0},"serves":{"type":"integer","format":"int32","maximum":20,"minimum":1},"cookTimeMin":{"type":"integer","format":"int32","minimum":0},"effort":{"type":"string","minLength":1,"pattern":"easy|medium|hard"},"isChildFriendly":{"type":"boolean"},"heroImageUrl":{"type":"string","maxLength":500,"minLength":0},"ingredients":{"type":"array","items":{"$ref":"#/components/schemas/IngredientEntry"},"minItems":1},"steps":{"type":"array","items":{"$ref":"#/components/schemas/StepEntry"}},"tagIds":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1}},"required":["effort","ingredients","name","tagIds"]},"StepEntry":{"type":"object","properties":{"stepNumber":{"type":"integer","format":"int32","minimum":1},"instruction":{"type":"string","minLength":1}},"required":["instruction"]},"CategoryRef":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"IngredientItem":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"quantity":{"type":"number"},"unit":{"type":"string"},"sortOrder":{"type":"integer","format":"int32"}}},"RecipeDetailResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"serves":{"type":"integer","format":"int32"},"cookTimeMin":{"type":"integer","format":"int32"},"effort":{"type":"string"},"isChildFriendly":{"type":"boolean"},"heroImageUrl":{"type":"string"},"ingredients":{"type":"array","items":{"$ref":"#/components/schemas/IngredientItem"}},"steps":{"type":"array","items":{"$ref":"#/components/schemas/StepItem"}},"tags":{"type":"array","items":{"$ref":"#/components/schemas/TagItem"}}}},"StepItem":{"type":"object","properties":{"stepNumber":{"type":"integer","format":"int32"},"instruction":{"type":"string"}}},"TagItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"tagType":{"type":"string"}}},"CreateWeekPlanRequest":{"type":"object","properties":{"weekStart":{"type":"string","format":"date"}},"required":["weekStart"]},"SlotRecipe":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"effort":{"type":"string"},"cookTimeMin":{"type":"integer","format":"int32"},"heroImageUrl":{"type":"string"}}},"SlotResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slotDate":{"type":"string","format":"date"},"recipe":{"$ref":"#/components/schemas/SlotRecipe"}}},"WeekPlanResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"weekStart":{"type":"string","format":"date"},"status":{"type":"string"},"confirmedAt":{"type":"string","format":"date-time"},"slots":{"type":"array","items":{"$ref":"#/components/schemas/SlotResponse"}}}},"CreateSlotRequest":{"type":"object","properties":{"slotDate":{"type":"string","format":"date"},"recipeId":{"type":"string","format":"uuid"}},"required":["recipeId","slotDate"]},"RecipeRef":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"ShoppingListItemResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ingredientId":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"quantity":{"type":"number"},"unit":{"type":"string"},"isChecked":{"type":"boolean"},"checkedBy":{"type":"string","format":"uuid"},"sourceRecipes":{"type":"array","items":{"$ref":"#/components/schemas/RecipeRef"}}}},"ShoppingListResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"weekPlanId":{"type":"string","format":"uuid"},"generatedAt":{"type":"string","format":"date-time"},"filteredStaplesCount":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ShoppingListItemResponse"}}}},"TagCreateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"minLength":0},"tagType":{"type":"string","minLength":1,"pattern":"protein|dietary|cuisine|other"}},"required":["name","tagType"]},"TagResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"tagType":{"type":"string"}}},"AddItemRequest":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"customName":{"type":"string"},"quantity":{"type":"number"},"unit":{"type":"string"}}},"CreatePantryItemRequest":{"type":"object","properties":{"ingredientId":{"type":"string","format":"uuid"},"customName":{"type":"string"},"quantity":{"type":"number"},"unit":{"type":"string"},"bestBefore":{"type":"string","format":"date"},"openedOn":{"type":"string","format":"date"}}},"PantryItemResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ingredientId":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"quantity":{"type":"number"},"unit":{"type":"string"},"bestBefore":{"type":"string","format":"date"},"openedOn":{"type":"string","format":"date"}}},"AcceptInviteResponse":{"type":"object","properties":{"householdId":{"type":"string","format":"uuid"},"householdName":{"type":"string"},"role":{"type":"string"}}},"ApiResponseAcceptInviteResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/AcceptInviteResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"Meta":{"type":"object","properties":{"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Pagination":{"type":"object","properties":{"total":{"type":"integer","format":"int64"},"limit":{"type":"integer","format":"int32"},"offset":{"type":"integer","format":"int32"},"hasMore":{"type":"boolean"}}},"IngredientCategoryCreateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"minLength":0}},"required":["name"]},"IngredientCategoryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"CreateHouseholdRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"minLength":0}},"required":["name"]},"ApiResponseHouseholdResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/HouseholdResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"HouseholdResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"members":{"type":"array","items":{"$ref":"#/components/schemas/MemberResponse"}}}},"MemberResponse":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"displayName":{"type":"string"},"role":{"type":"string"},"joinedAt":{"type":"string","format":"date-time"}}},"ApiResponseInviteResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/InviteResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"InviteResponse":{"type":"object","properties":{"inviteCode":{"type":"string"},"shareUrl":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateCookingLogRequest":{"type":"object","properties":{"recipeId":{"type":"string","format":"uuid"},"cookedOn":{"type":"string","format":"date"}},"required":["recipeId"]},"CookingLogResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"recipeId":{"type":"string","format":"uuid"},"recipeName":{"type":"string"},"cookedOn":{"type":"string","format":"date"},"cookedBy":{"type":"string","format":"uuid"}}},"SignupRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1},"password":{"type":"string","maxLength":2147483647,"minLength":8},"displayName":{"type":"string","maxLength":100,"minLength":0}},"required":["displayName","email","password"]},"ApiResponseUserResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/UserResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"UserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"displayName":{"type":"string"},"householdId":{"type":"string","format":"uuid"},"householdName":{"type":"string"},"householdRole":{"type":"string"},"systemRole":{"type":"string"}}},"LoginRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1},"password":{"type":"string","minLength":1}},"required":["email","password"]},"CreateUserRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1},"displayName":{"type":"string","maxLength":100,"minLength":0},"tempPassword":{"type":"string","maxLength":2147483647,"minLength":8},"systemRole":{"type":"string"}},"required":["displayName","email","tempPassword"]},"AdminUserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"displayName":{"type":"string"},"systemRole":{"type":"string"},"isActive":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}}},"ApiResponseAdminUserResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/AdminUserResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ResetPasswordRequest":{"type":"object","properties":{"tempPassword":{"type":"string","maxLength":2147483647,"minLength":8},"reason":{"type":"string"}},"required":["tempPassword"]},"ApiResponseResetPasswordResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"$ref":"#/components/schemas/ResetPasswordResponse"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ResetPasswordResponse":{"type":"object","properties":{"message":{"type":"string"},"mustChangePassword":{"type":"boolean"}}},"UpdateSlotRequest":{"type":"object","properties":{"recipeId":{"type":"string","format":"uuid"}},"required":["recipeId"]},"CheckItemRequest":{"type":"object","properties":{"isChecked":{"type":"boolean"}}},"UpdatePantryItemRequest":{"type":"object","properties":{"quantity":{"type":"number"},"unit":{"type":"string"},"bestBefore":{"type":"string","format":"date"},"openedOn":{"type":"string","format":"date"}}},"IngredientPatchRequest":{"type":"object","properties":{"name":{"type":"string"},"isStaple":{"type":"boolean"},"categoryId":{"type":"string","format":"uuid"}}},"IngredientResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryRef"},"isStaple":{"type":"boolean"}}},"UpdateProfileRequest":{"type":"object","properties":{"displayName":{"type":"string","maxLength":100,"minLength":0},"currentPassword":{"type":"string"},"newPassword":{"type":"string","maxLength":2147483647,"minLength":8}}},"UpdateUserRequest":{"type":"object","properties":{"displayName":{"type":"string"},"email":{"type":"string"},"systemRole":{"type":"string"},"isActive":{"type":"boolean"}}},"IngredientOverlap":{"type":"object","properties":{"ingredientName":{"type":"string"},"days":{"type":"array","items":{"type":"string","format":"date"}}}},"TagRepeat":{"type":"object","properties":{"tagName":{"type":"string"},"tagType":{"type":"string"},"days":{"type":"array","items":{"type":"string","format":"date"}}}},"VarietyScoreResponse":{"type":"object","properties":{"score":{"type":"number","format":"double"},"tagRepeats":{"type":"array","items":{"$ref":"#/components/schemas/TagRepeat"}},"ingredientOverlaps":{"type":"array","items":{"$ref":"#/components/schemas/IngredientOverlap"}},"recentRepeats":{"type":"array","items":{"type":"string"}},"duplicatesInPlan":{"type":"array","items":{"type":"string"}}}},"SuggestionItem":{"type":"object","properties":{"recipe":{"$ref":"#/components/schemas/SlotRecipe"},"scoreDelta":{"type":"number","format":"double"},"hasConflict":{"type":"boolean"}}},"SuggestionResponse":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/SuggestionItem"}}}},"ApiResponseListRecipeSummaryResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/RecipeSummaryResponse"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"RecipeSummaryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"serves":{"type":"integer","format":"int32"},"cookTimeMin":{"type":"integer","format":"int32"},"effort":{"type":"string"},"isChildFriendly":{"type":"boolean"},"heroImageUrl":{"type":"string"}}},"ApiResponseListAdminUserResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserResponse"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"ApiResponseListAuditLogResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AuditLogResponse"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"AuditLogResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"adminId":{"type":"string","format":"uuid"},"adminEmail":{"type":"string"},"targetUserId":{"type":"string","format":"uuid"},"targetEmail":{"type":"string"},"action":{"type":"string"},"detail":{"type":"object","additionalProperties":{}},"performedAt":{"type":"string","format":"date-time"}}}}}}
\ No newline at end of file
diff --git a/frontend/src/lib/api/schema.d.ts b/frontend/src/lib/api/schema.d.ts
index 74d1952..9ee4ede 100644
--- a/frontend/src/lib/api/schema.d.ts
+++ b/frontend/src/lib/api/schema.d.ts
@@ -914,7 +914,8 @@ export interface components {
         SuggestionItem: {
             recipe?: components["schemas"]["SlotRecipe"];
             /** Format: double */
-            simulatedScore?: number;
+            scoreDelta?: number;
+            hasConflict?: boolean;
         };
         SuggestionResponse: {
             suggestions?: components["schemas"]["SuggestionItem"][];
-- 
2.49.1


From 4549e9a7fdba996140a265e8a61bd377ec3b674e Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 11:38:47 +0200
Subject: [PATCH 04/30] feat(planner): RecipePicker uses
 scoreDelta/hasConflict, drop currentVarietyScore, add isLoading
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Suggestion interface: { recipe, scoreDelta, hasConflict } (no simulatedScore)
- Badge renders from hasConflict directly — no client-side delta computation needed
- New isLoading prop shows skeleton rows while suggestions fetch is in flight
- currentVarietyScore prop removed from component and both call sites follow in next commit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 34 +++++++++++++++----
 frontend/src/lib/planner/RecipePicker.test.ts | 25 ++++++++++----
 2 files changed, 45 insertions(+), 14 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 1d2ffde..51940ac 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -8,24 +8,25 @@
 
 	interface Suggestion {
 		recipe: Recipe;
-		simulatedScore: number;
+		scoreDelta: number;
+		hasConflict: boolean;
 	}
 
 	let {
 		planId,
 		date,
 		dateLabel,
-		currentVarietyScore = 0,
 		suggestions = [],
 		allRecipes = [],
+		isLoading = false,
 		onpick
 	}: {
 		planId: string;
 		date: string;
 		dateLabel: string;
-		currentVarietyScore?: number;
 		suggestions: Suggestion[];
 		allRecipes: Recipe[];
+		isLoading?: boolean;
 		onpick: (recipeId: string, recipeName: string) => void;
 	} = $props();
 
@@ -71,7 +72,27 @@
 	</div>
 
 	<!-- Empfohlen section -->
-	{#if suggestions.length > 0}
+	{#if isLoading}
+		<div data-testid="suggestions-loading">
+			{#each [1, 2, 3] as i (i)}
+				<div
+					style="padding: 7px 12px; border-bottom: 1px solid var(--color-subtle); display: flex; align-items: center; gap: 8px;"
+				>
+					<div style="flex: 1; min-width: 0;">
+						<div
+							style="height: 12px; width: 60%; border-radius: 3px; background: var(--color-subtle); animation: pulse 1.5s ease-in-out infinite;"
+						></div>
+						<div
+							style="height: 9px; width: 35%; border-radius: 3px; background: var(--color-subtle); margin-top: 4px; animation: pulse 1.5s ease-in-out infinite;"
+						></div>
+					</div>
+					<div
+						style="height: 26px; width: 56px; border-radius: var(--radius-md); background: var(--color-subtle); animation: pulse 1.5s ease-in-out infinite;"
+					></div>
+				</div>
+			{/each}
+		</div>
+	{:else if suggestions.length > 0}
 		<div
 			style="font-size: 11px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-muted); padding: 5px 12px 3px; background: var(--color-subtle);"
 		>
@@ -79,7 +100,6 @@
 		</div>
 
 		{#each suggestions as suggestion (suggestion.recipe.id)}
-			{@const delta = suggestion.simulatedScore - currentVarietyScore}
 			{@const meta = recipeMetadata(suggestion.recipe)}
 			<div
 				style="padding: 7px 12px; border-bottom: 1px solid var(--color-subtle); display: flex; align-items: center; gap: 8px;"
@@ -95,13 +115,13 @@
 							{meta}
 						</p>
 					{/if}
-					{#if delta > 0}
+					{#if !suggestion.hasConflict}
 						<span
 							data-testid="badge-{suggestion.recipe.id}"
 							data-type="good"
 							style="display: inline-block; margin-top: 3px; font-size: 8px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--green-tint); color: var(--green-dark);"
 						>
-							↑ +{delta.toFixed(0)} Punkte
+							↑ +{suggestion.scoreDelta.toFixed(0)} Punkte
 						</span>
 					{:else}
 						<span
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index 4ef320b..ac362c3 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -4,8 +4,8 @@ import userEvent from '@testing-library/user-event';
 import RecipePicker from './RecipePicker.svelte';
 
 const suggestions = [
-	{ recipe: { id: 's1', name: 'Lachsfilet', effort: 'easy', cookTimeMin: 25 }, simulatedScore: 9.5 },
-	{ recipe: { id: 's2', name: 'Hähnchen-Curry', effort: 'easy', cookTimeMin: 35 }, simulatedScore: 6.0 }
+	{ recipe: { id: 's1', name: 'Lachsfilet', effort: 'easy', cookTimeMin: 25 }, scoreDelta: 1.5, hasConflict: false },
+	{ recipe: { id: 's2', name: 'Hähnchen-Curry', effort: 'easy', cookTimeMin: 35 }, scoreDelta: -1.5, hasConflict: true }
 ];
 
 const allRecipes = [
@@ -18,7 +18,6 @@ const baseProps = {
 	planId: 'plan-1',
 	date: '2026-04-05',
 	dateLabel: 'Samstag, 5. April',
-	currentVarietyScore: 7.5,
 	suggestions,
 	allRecipes,
 	onpick: vi.fn()
@@ -41,16 +40,16 @@ describe('RecipePicker', () => {
 		expect(screen.getByText('Hähnchen-Curry')).toBeTruthy();
 	});
 
-	it('shows green badge for suggestions with positive delta', () => {
+	it('shows green badge when hasConflict is false', () => {
 		render(RecipePicker, { props: baseProps });
-		// Lachsfilet: simulatedScore 9.5 - currentVarietyScore 7.5 = +2 → green badge
+		// Lachsfilet: hasConflict = false → green badge
 		const badge = screen.getByTestId('badge-s1');
 		expect(badge.getAttribute('data-type')).toBe('good');
 	});
 
-	it('shows yellow badge for suggestions with zero or negative delta', () => {
+	it('shows yellow badge when hasConflict is true', () => {
 		render(RecipePicker, { props: baseProps });
-		// Hähnchen-Curry: 6.0 - 7.5 = -1.5 → yellow badge
+		// Hähnchen-Curry: hasConflict = true → yellow badge
 		const badge = screen.getByTestId('badge-s2');
 		expect(badge.getAttribute('data-type')).toBe('warning');
 	});
@@ -98,4 +97,16 @@ describe('RecipePicker', () => {
 		await userEvent.type(input, 'xyznotfound');
 		expect(screen.getByText(/Keine Treffer/i)).toBeTruthy();
 	});
+
+	it('shows loading skeleton instead of Empfohlen section when isLoading is true', () => {
+		render(RecipePicker, { props: { ...baseProps, isLoading: true } });
+		expect(screen.getByTestId('suggestions-loading')).toBeTruthy();
+		expect(screen.queryByText(/Empfohlen/i)).toBeNull();
+	});
+
+	it('hides loading skeleton when isLoading is false and suggestions are present', () => {
+		render(RecipePicker, { props: { ...baseProps, isLoading: false } });
+		expect(screen.queryByTestId('suggestions-loading')).toBeNull();
+		expect(screen.getByText(/Empfohlen/i)).toBeTruthy();
+	});
 });
-- 
2.49.1


From 59366b6e9c5983b88ff8c7f842c18d09da8bed7d Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 11:39:50 +0200
Subject: [PATCH 05/30] feat(planner): add server.test.ts for GET /planner, fix
 sort + add error handling

- Sort uses scoreDelta instead of removed simulatedScore
- try/catch degrades gracefully to suggestions=[] on backend errors
- 6 tests cover: missing params, success, backend error, network throw, empty result

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/routes/(app)/planner/+server.ts  | 20 ++--
 .../src/routes/(app)/planner/server.test.ts   | 91 +++++++++++++++++++
 2 files changed, 103 insertions(+), 8 deletions(-)
 create mode 100644 frontend/src/routes/(app)/planner/server.test.ts

diff --git a/frontend/src/routes/(app)/planner/+server.ts b/frontend/src/routes/(app)/planner/+server.ts
index 910efc5..af3aa80 100644
--- a/frontend/src/routes/(app)/planner/+server.ts
+++ b/frontend/src/routes/(app)/planner/+server.ts
@@ -11,14 +11,18 @@ export const GET: RequestHandler = async ({ fetch, url }) => {
 		return json({ suggestions: [] });
 	}
 
-	const api = apiClient(fetch);
-	const { data } = await api.GET('/v1/week-plans/{id}/suggestions', {
-		params: { path: { id: planId }, query: { slotDate: date } }
-	});
+	try {
+		const api = apiClient(fetch);
+		const { data } = await api.GET('/v1/week-plans/{id}/suggestions', {
+			params: { path: { id: planId }, query: { slotDate: date } }
+		});
 
-	const suggestions = (data?.suggestions ?? []).sort(
-		(a: any, b: any) => (b.simulatedScore ?? 0) - (a.simulatedScore ?? 0)
-	);
+		const suggestions = (data?.suggestions ?? []).sort(
+			(a: any, b: any) => (b.scoreDelta ?? 0) - (a.scoreDelta ?? 0)
+		);
 
-	return json({ suggestions });
+		return json({ suggestions });
+	} catch {
+		return json({ suggestions: [] });
+	}
 };
diff --git a/frontend/src/routes/(app)/planner/server.test.ts b/frontend/src/routes/(app)/planner/server.test.ts
new file mode 100644
index 0000000..023d0fd
--- /dev/null
+++ b/frontend/src/routes/(app)/planner/server.test.ts
@@ -0,0 +1,91 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+vi.mock('$env/dynamic/private', () => ({
+	env: { BACKEND_URL: 'http://localhost:8080' }
+}));
+
+const mockGet = vi.fn();
+vi.mock('$lib/server/api', () => ({
+	apiClient: () => ({ GET: mockGet })
+}));
+
+const PLAN_UUID = '11111111-1111-1111-1111-111111111111';
+const DATE = '2026-04-09';
+
+const mockSuggestions = [
+	{ recipe: { id: 'r1', name: 'Lachsfilet', effort: 'easy', cookTimeMin: 25 }, scoreDelta: 0.0, hasConflict: true },
+	{ recipe: { id: 'r2', name: 'Nudeln', effort: 'easy', cookTimeMin: 20 }, scoreDelta: -1.5, hasConflict: true }
+];
+
+describe('GET /planner — suggestions route handler', () => {
+	let GET: any;
+
+	beforeEach(async () => {
+		mockGet.mockReset();
+		vi.resetModules();
+		const mod = await import('./+server');
+		GET = mod.GET;
+	});
+
+	it('returns { suggestions: [] } when planId is missing', async () => {
+		const url = new URL('http://localhost/planner?date=' + DATE);
+		const response = await GET({ fetch: vi.fn(), url });
+		const body = await response.json();
+		expect(body).toEqual({ suggestions: [] });
+		expect(mockGet).not.toHaveBeenCalled();
+	});
+
+	it('returns { suggestions: [] } when date is missing', async () => {
+		const url = new URL('http://localhost/planner?planId=' + PLAN_UUID);
+		const response = await GET({ fetch: vi.fn(), url });
+		const body = await response.json();
+		expect(body).toEqual({ suggestions: [] });
+		expect(mockGet).not.toHaveBeenCalled();
+	});
+
+	it('returns sorted suggestions from backend on success', async () => {
+		mockGet.mockResolvedValueOnce({ data: { suggestions: mockSuggestions }, error: undefined });
+
+		const url = new URL(`http://localhost/planner?planId=${PLAN_UUID}&date=${DATE}`);
+		const response = await GET({ fetch: vi.fn(), url });
+		const body = await response.json();
+
+		expect(mockGet).toHaveBeenCalledWith('/v1/week-plans/{id}/suggestions', expect.objectContaining({
+			params: { path: { id: PLAN_UUID }, query: { slotDate: DATE } }
+		}));
+		expect(body.suggestions).toHaveLength(2);
+		// sorted by scoreDelta desc: 0.0 before -1.5
+		expect(body.suggestions[0].recipe.name).toBe('Lachsfilet');
+		expect(body.suggestions[1].recipe.name).toBe('Nudeln');
+	});
+
+	it('returns { suggestions: [] } when backend returns error', async () => {
+		mockGet.mockResolvedValueOnce({ data: undefined, error: { status: 500 } });
+
+		const url = new URL(`http://localhost/planner?planId=${PLAN_UUID}&date=${DATE}`);
+		const response = await GET({ fetch: vi.fn(), url });
+		const body = await response.json();
+
+		expect(body).toEqual({ suggestions: [] });
+	});
+
+	it('returns { suggestions: [] } when backend throws (network error)', async () => {
+		mockGet.mockRejectedValueOnce(new Error('Network error'));
+
+		const url = new URL(`http://localhost/planner?planId=${PLAN_UUID}&date=${DATE}`);
+		const response = await GET({ fetch: vi.fn(), url });
+		const body = await response.json();
+
+		expect(body).toEqual({ suggestions: [] });
+	});
+
+	it('returns empty suggestions when backend returns empty array', async () => {
+		mockGet.mockResolvedValueOnce({ data: { suggestions: [] }, error: undefined });
+
+		const url = new URL(`http://localhost/planner?planId=${PLAN_UUID}&date=${DATE}`);
+		const response = await GET({ fetch: vi.fn(), url });
+		const body = await response.json();
+
+		expect(body).toEqual({ suggestions: [] });
+	});
+});
-- 
2.49.1


From ab662691312e83eb289d2d3de8a760bcda983aed Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 11:46:25 +0200
Subject: [PATCH 06/30] feat(planner): lazy-fetch variety suggestions in
 RecipePicker for empty slots
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Derives activePickerDate from mobile pickerOpen/selectedDay and desktop
recipe-picker panel state, then uses $effect to fetch /planner?planId&date
on demand — wires suggestions and isLoading into both RecipePicker instances.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../src/routes/(app)/planner/+page.svelte     | 31 ++++++++++++++++---
 1 file changed, 27 insertions(+), 4 deletions(-)

diff --git a/frontend/src/routes/(app)/planner/+page.svelte b/frontend/src/routes/(app)/planner/+page.svelte
index ba03be8..bf055d1 100644
--- a/frontend/src/routes/(app)/planner/+page.svelte
+++ b/frontend/src/routes/(app)/planner/+page.svelte
@@ -63,6 +63,15 @@
 	let swapSheetOpen = $state(false);
 	let swapLoading = $state(false);
 
+	const activePickerDate = $derived(
+		pickerOpen ? selectedDay
+		: panelState.kind === 'recipe-picker' ? panelState.date
+		: null
+	);
+
+	let suggestions: any[] = $state([]);
+	let isLoadingSuggestions = $state(false);
+
 	// Recipes already in any slot this week — used for ⚠ overlap warnings
 	let currentWeekRecipeIds = $derived(
 		new Set<string>(slots.filter((s: any) => s.recipe?.id).map((s: any) => s.recipe.id))
@@ -91,6 +100,20 @@
 	let undoVisible = $state(false);
 	let undoMessage = $state('');
 
+	$effect(() => {
+		if (!activePickerDate || !weekPlan?.id) {
+			suggestions = [];
+			isLoadingSuggestions = false;
+			return;
+		}
+		isLoadingSuggestions = true;
+		fetch(`/planner?planId=${weekPlan.id}&date=${activePickerDate}`)
+			.then((r) => r.json())
+			.then((d) => { suggestions = d.suggestions ?? []; })
+			.catch(() => { suggestions = []; })
+			.finally(() => { isLoadingSuggestions = false; });
+	});
+
 	function handleSelectDay(day: string) {
 		selectedDay = day;
 		panelState = { kind: 'day-detail', date: day };
@@ -282,9 +305,9 @@
 			planId={weekPlan?.id ?? ''}
 			date={selectedDay}
 			dateLabel={formatDayLabel(selectedDay)}
-			currentVarietyScore={varietyScore?.score ?? 0}
-			suggestions={[]}
+			suggestions={suggestions}
 			allRecipes={data.recipes}
+			isLoading={isLoadingSuggestions}
 			onpick={handleRecipePick}
 		/>
 	</BottomSheet>
@@ -560,9 +583,9 @@
 							planId={weekPlan?.id ?? ''}
 							date={pickerDate}
 							dateLabel={formatDayLabel(pickerDate)}
-							currentVarietyScore={varietyScore?.score ?? 0}
-							suggestions={[]}
+							suggestions={suggestions}
 							allRecipes={data.recipes}
+							isLoading={isLoadingSuggestions}
 							onpick={handleRecipePick}
 						/>
 					</div>
-- 
2.49.1


From 387d0705a4846f09a174929e4e6a90396b224331 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:00:37 +0200
Subject: [PATCH 07/30] fix(planner): guard scoreDelta against undefined in
 RecipePicker badge

Defensive null-coalescing prevents crash when suggestion data arrives
without scoreDelta (e.g. stale backend or mismatched schema).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 51940ac..ec3fd69 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -121,7 +121,7 @@
 							data-type="good"
 							style="display: inline-block; margin-top: 3px; font-size: 8px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--green-tint); color: var(--green-dark);"
 						>
-							↑ +{suggestion.scoreDelta.toFixed(0)} Punkte
+							↑ +{(suggestion.scoreDelta ?? 0).toFixed(0)} Punkte
 						</span>
 					{:else}
 						<span
-- 
2.49.1


From 482597bb6a41e86041ec409ca9343d18ad89f4fa Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:09:08 +0200
Subject: [PATCH 08/30] refactor(planner): extract MAX_VARIETY_SCORE constant
 in PlanningService

Replaces magic literal 10.0 with a named constant in all four
scoring sites: getSuggestions, getVarietyPreview, scoreFromSimulatedSlots,
and getVarietyScore.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../com/recipeapp/planning/PlanningService.java    | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/backend/src/main/java/com/recipeapp/planning/PlanningService.java b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
index 356c694..04fcf11 100644
--- a/backend/src/main/java/com/recipeapp/planning/PlanningService.java
+++ b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
@@ -26,6 +26,8 @@ import java.util.stream.Collectors;
 @Service
 public class PlanningService {
 
+    private static final double MAX_VARIETY_SCORE = 10.0;
+
     private final WeekPlanRepository weekPlanRepository;
     private final WeekPlanSlotRepository weekPlanSlotRepository;
     private final CookingLogRepository cookingLogRepository;
@@ -138,7 +140,7 @@ public class PlanningService {
         List<SimulatedSlot> currentSlots = plan.getSlots().stream()
                 .map(s -> new SimulatedSlot(s.getRecipe(), s.getSlotDate()))
                 .toList();
-        double currentScore = currentSlots.isEmpty() ? 10.0
+        double currentScore = currentSlots.isEmpty() ? MAX_VARIETY_SCORE
                 : scoreFromSimulatedSlots(currentSlots, config, recentlyCookedIds);
 
         List<Recipe> allRecipes = recipeRepository.findByHouseholdIdAndDeletedAtIsNull(householdId);
@@ -202,7 +204,7 @@ public class PlanningService {
         List<SimulatedSlot> currentSlots = plan.getSlots().stream()
                 .map(s -> new SimulatedSlot(s.getRecipe(), s.getSlotDate()))
                 .toList();
-        double currentScore = currentSlots.isEmpty() ? 10.0
+        double currentScore = currentSlots.isEmpty() ? MAX_VARIETY_SCORE
                 : scoreFromSimulatedSlots(currentSlots, config, recentlyCookedIds);
         double projectedScore = simulateVarietyScore(plan, candidate, date, config, recentlyCookedIds);
 
@@ -255,12 +257,12 @@ public class PlanningService {
                 .mapToLong(c -> c - 1)
                 .sum();
 
-        double score = 10.0;
+        double score = MAX_VARIETY_SCORE;
         score -= tagRepeatCount * wTagRepeat;
         score -= ingredientOverlapCount * wIngredientOverlap;
         score -= recentRepeatCount * wRecentRepeat;
         score -= duplicatePenaltyCount * wPlanDuplicate;
-        return Math.max(0, Math.min(10, score));
+        return Math.max(0, Math.min(MAX_VARIETY_SCORE, score));
     }
 
     @Transactional(readOnly = true)
@@ -349,12 +351,12 @@ public class PlanningService {
         }
 
         // Calculate score
-        double score = 10.0;
+        double score = MAX_VARIETY_SCORE;
         score -= tagRepeats.size() * wTagRepeat;
         score -= overlaps.size() * wIngredientOverlap;
         score -= recentRepeats.size() * wRecentRepeat;
         score -= duplicatePenaltyCount * wPlanDuplicate;
-        score = Math.max(0, Math.min(10, score));
+        score = Math.max(0, Math.min(MAX_VARIETY_SCORE, score));
 
         return new VarietyScoreResponse(score, tagRepeats, overlaps, recentRepeats, duplicatesInPlan);
     }
-- 
2.49.1


From e17e8d4630d95f91bf2b056a96356fd3f5993176 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:10:33 +0200
Subject: [PATCH 09/30] test(planner): cover topN=0 and topN=-1 boundary in
 SuggestionsTest

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../recipeapp/planning/SuggestionsTest.java   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
index 97eecb2..333193d 100644
--- a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
+++ b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
@@ -205,6 +205,28 @@ class SuggestionsTest {
                     .isInstanceOf(ResourceNotFoundException.class);
         }
 
+        @Test
+        void topNZeroShouldReturnEmptyList() {
+            var plan = createPlan();
+            stubPlan(plan);
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 0);
+
+            assertThat(result.suggestions()).isEmpty();
+        }
+
+        @Test
+        void topNNegativeShouldReturnEmptyList() {
+            var plan = createPlan();
+            stubPlan(plan);
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), -1);
+
+            assertThat(result.suggestions()).isEmpty();
+        }
+
         @Test
         void singleCandidateShouldReturnOne() {
             var plan = createPlan();
-- 
2.49.1


From f84a647b8d0dc6b5d3763bf7dbd1c700ec01d3d4 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:11:00 +0200
Subject: [PATCH 10/30] test(planner): assert hasConflict=true for neutral
 scoreDelta on empty plan

Documents the surprising-but-correct behavior: recipes on an empty plan
get scoreDelta=0.0, which satisfies scoreDelta<=0, so hasConflict=true.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../java/com/recipeapp/planning/SuggestionsTest.java     | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
index 333193d..b461ffb 100644
--- a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
+++ b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
@@ -179,9 +179,12 @@ class SuggestionsTest {
                     HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 5);
 
             assertThat(result.suggestions()).hasSize(3);
-            // Empty plan → currentScore = 10.0; no conflicts → scoreDelta = 0.0 for all
-            assertThat(result.suggestions()).allSatisfy(s ->
-                    assertThat(s.scoreDelta()).isEqualTo(0.0));
+            // Empty plan → currentScore = 10.0; no penalties → scoreDelta = 0.0 for all
+            // hasConflict = (scoreDelta <= 0) = true even for neutral recipes
+            assertThat(result.suggestions()).allSatisfy(s -> {
+                assertThat(s.scoreDelta()).isEqualTo(0.0);
+                assertThat(s.hasConflict()).isTrue();
+            });
         }
 
         @Test
-- 
2.49.1


From 0a9e8032cf5f73a856b575b7ad774c522e47c02d Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:11:44 +0200
Subject: [PATCH 11/30] refactor(planner): extract computeCurrentScore helper
 in PlanningService
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Eliminates duplicated currentSlots→score pattern that appeared in both
getSuggestions and getVarietyPreview.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../recipeapp/planning/PlanningService.java   | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/backend/src/main/java/com/recipeapp/planning/PlanningService.java b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
index 04fcf11..c85dcc1 100644
--- a/backend/src/main/java/com/recipeapp/planning/PlanningService.java
+++ b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
@@ -137,11 +137,7 @@ public class PlanningService {
                 .map(cl -> cl.getRecipe().getId())
                 .collect(Collectors.toSet());
 
-        List<SimulatedSlot> currentSlots = plan.getSlots().stream()
-                .map(s -> new SimulatedSlot(s.getRecipe(), s.getSlotDate()))
-                .toList();
-        double currentScore = currentSlots.isEmpty() ? MAX_VARIETY_SCORE
-                : scoreFromSimulatedSlots(currentSlots, config, recentlyCookedIds);
+        double currentScore = computeCurrentScore(plan, config, recentlyCookedIds);
 
         List<Recipe> allRecipes = recipeRepository.findByHouseholdIdAndDeletedAtIsNull(householdId);
 
@@ -184,6 +180,14 @@ public class PlanningService {
         return scoreFromSimulatedSlots(simulatedSlots, config, recentlyCookedIds);
     }
 
+    private double computeCurrentScore(WeekPlan plan, VarietyScoreConfig config, Set<UUID> recentlyCookedIds) {
+        List<SimulatedSlot> currentSlots = plan.getSlots().stream()
+                .map(s -> new SimulatedSlot(s.getRecipe(), s.getSlotDate()))
+                .toList();
+        return currentSlots.isEmpty() ? MAX_VARIETY_SCORE
+                : scoreFromSimulatedSlots(currentSlots, config, recentlyCookedIds);
+    }
+
     private record SimulatedSlot(Recipe recipe, LocalDate date) {}
 
     @Transactional(readOnly = true)
@@ -201,11 +205,7 @@ public class PlanningService {
                 .map(cl -> cl.getRecipe().getId())
                 .collect(Collectors.toSet());
 
-        List<SimulatedSlot> currentSlots = plan.getSlots().stream()
-                .map(s -> new SimulatedSlot(s.getRecipe(), s.getSlotDate()))
-                .toList();
-        double currentScore = currentSlots.isEmpty() ? MAX_VARIETY_SCORE
-                : scoreFromSimulatedSlots(currentSlots, config, recentlyCookedIds);
+        double currentScore = computeCurrentScore(plan, config, recentlyCookedIds);
         double projectedScore = simulateVarietyScore(plan, candidate, date, config, recentlyCookedIds);
 
         return new VarietyPreviewResponse(currentScore, projectedScore, projectedScore - currentScore);
-- 
2.49.1


From 539ca5d231f0da7a835deda9ed323f91a7e9360e Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:15:17 +0200
Subject: [PATCH 12/30] feat(planner): add AbortController to suggestion fetch
 $effect

Cancels the inflight request when activePickerDate changes or picker
closes, preventing stale responses from overwriting suggestions.
Adds page.test.ts covering fetch trigger, suggestion rendering,
and AbortSignal presence.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../src/routes/(app)/planner/+page.svelte     |  6 +-
 .../src/routes/(app)/planner/page.test.ts     | 84 +++++++++++++++++++
 2 files changed, 88 insertions(+), 2 deletions(-)
 create mode 100644 frontend/src/routes/(app)/planner/page.test.ts

diff --git a/frontend/src/routes/(app)/planner/+page.svelte b/frontend/src/routes/(app)/planner/+page.svelte
index bf055d1..b6f5e4d 100644
--- a/frontend/src/routes/(app)/planner/+page.svelte
+++ b/frontend/src/routes/(app)/planner/+page.svelte
@@ -106,12 +106,14 @@
 			isLoadingSuggestions = false;
 			return;
 		}
+		const controller = new AbortController();
 		isLoadingSuggestions = true;
-		fetch(`/planner?planId=${weekPlan.id}&date=${activePickerDate}`)
+		fetch(`/planner?planId=${weekPlan.id}&date=${activePickerDate}`, { signal: controller.signal })
 			.then((r) => r.json())
 			.then((d) => { suggestions = d.suggestions ?? []; })
-			.catch(() => { suggestions = []; })
+			.catch((e) => { if (e.name !== 'AbortError') suggestions = []; })
 			.finally(() => { isLoadingSuggestions = false; });
+		return () => controller.abort();
 	});
 
 	function handleSelectDay(day: string) {
diff --git a/frontend/src/routes/(app)/planner/page.test.ts b/frontend/src/routes/(app)/planner/page.test.ts
new file mode 100644
index 0000000..c400a88
--- /dev/null
+++ b/frontend/src/routes/(app)/planner/page.test.ts
@@ -0,0 +1,84 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import Page from './+page.svelte';
+
+vi.mock('$app/navigation', () => ({ goto: vi.fn(), invalidateAll: vi.fn() }));
+vi.mock('$app/forms', () => ({
+	enhance: () => () => ({ destroy: () => {} })
+}));
+
+const PLAN_ID = 'plan-00000000-0000-0000-0000-000000000001';
+// Use a past week so "today" is never in this range — selectedDay defaults to weekStart (Monday)
+const DATE = '2025-01-06'; // Monday, January 6 2025
+
+const mockData = {
+	weekPlan: { id: PLAN_ID, weekStart: DATE, status: 'draft', slots: [] },
+	varietyScore: null,
+	weekStart: DATE,
+	recipes: [{ id: 'r1', name: 'Beef Bourguignon', effort: 'hard', cookTimeMin: 150 }],
+	benutzer: { rolle: 'planer' }
+};
+
+const mockSuggestions = [
+	{
+		recipe: { id: 's1', name: 'Lachsfilet', effort: 'easy', cookTimeMin: 20 },
+		scoreDelta: 1.5,
+		hasConflict: false
+	}
+];
+
+describe('+page.svelte — $effect suggestion fetch', () => {
+	afterEach(() => {
+		vi.restoreAllMocks();
+	});
+
+	it('calls fetch when picker opens with correct planId and date', async () => {
+		vi.stubGlobal(
+			'fetch',
+			vi.fn().mockResolvedValueOnce({
+				json: () => Promise.resolve({ suggestions: mockSuggestions })
+			})
+		);
+
+		render(Page, { props: { data: mockData } });
+
+		await userEvent.click(screen.getAllByRole('button', { name: /Gericht/i })[0]);
+
+		await waitFor(() => expect(fetch).toHaveBeenCalledTimes(1));
+		expect((fetch as any).mock.calls[0][0]).toContain(`planId=${PLAN_ID}`);
+		expect((fetch as any).mock.calls[0][0]).toContain(`date=${DATE}`);
+	});
+
+	it('shows suggestions in RecipePicker after fetch resolves', async () => {
+		vi.stubGlobal(
+			'fetch',
+			vi.fn().mockResolvedValueOnce({
+				json: () => Promise.resolve({ suggestions: mockSuggestions })
+			})
+		);
+
+		render(Page, { props: { data: mockData } });
+
+		await userEvent.click(screen.getAllByRole('button', { name: /Gericht/i })[0]);
+
+		expect(await screen.findByText('Lachsfilet')).toBeTruthy();
+	});
+
+	it('passes AbortSignal to fetch so inflight requests can be cancelled', async () => {
+		vi.stubGlobal(
+			'fetch',
+			vi.fn().mockResolvedValueOnce({
+				json: () => Promise.resolve({ suggestions: [] })
+			})
+		);
+
+		render(Page, { props: { data: mockData } });
+
+		await userEvent.click(screen.getAllByRole('button', { name: /Gericht/i })[0]);
+
+		await waitFor(() => expect(fetch).toHaveBeenCalledTimes(1));
+		const fetchOptions = (fetch as any).mock.calls[0][1];
+		expect(fetchOptions?.signal).toBeInstanceOf(AbortSignal);
+	});
+});
-- 
2.49.1


From f7a239655a8983f1721749c3f32801c1820ebfc6 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:16:02 +0200
Subject: [PATCH 13/30] refactor(planner): extract Suggestion type to
 $lib/planner/types.ts
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Removes the inline interface from RecipePicker.svelte and replaces
any[] in +page.svelte with Suggestion[] — compile-time safety.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte   | 13 +------------
 frontend/src/lib/planner/types.ts              | 12 ++++++++++++
 frontend/src/routes/(app)/planner/+page.svelte |  3 ++-
 3 files changed, 15 insertions(+), 13 deletions(-)
 create mode 100644 frontend/src/lib/planner/types.ts

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index ec3fd69..41544f2 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -1,16 +1,5 @@
 <script lang="ts">
-	interface Recipe {
-		id: string;
-		name: string;
-		effort?: string;
-		cookTimeMin?: number;
-	}
-
-	interface Suggestion {
-		recipe: Recipe;
-		scoreDelta: number;
-		hasConflict: boolean;
-	}
+	import type { Recipe, Suggestion } from '$lib/planner/types';
 
 	let {
 		planId,
diff --git a/frontend/src/lib/planner/types.ts b/frontend/src/lib/planner/types.ts
new file mode 100644
index 0000000..1dae0f5
--- /dev/null
+++ b/frontend/src/lib/planner/types.ts
@@ -0,0 +1,12 @@
+export interface Recipe {
+	id: string;
+	name: string;
+	effort?: string;
+	cookTimeMin?: number;
+}
+
+export interface Suggestion {
+	recipe: Recipe;
+	scoreDelta: number;
+	hasConflict: boolean;
+}
diff --git a/frontend/src/routes/(app)/planner/+page.svelte b/frontend/src/routes/(app)/planner/+page.svelte
index b6f5e4d..d281247 100644
--- a/frontend/src/routes/(app)/planner/+page.svelte
+++ b/frontend/src/routes/(app)/planner/+page.svelte
@@ -11,6 +11,7 @@
 	import BottomSheet from '$lib/components/BottomSheet.svelte';
 	import UndoBar from '$lib/planner/UndoBar.svelte';
 	import { prevWeek, nextWeek, getWeekStart, weekDays, formatDayLabel, formatDayAbbr, formatWeekRange, sortEasiestFirst } from '$lib/planner/week';
+	import type { Suggestion } from '$lib/planner/types';
 
 	let { data, form = null }: { data: { weekPlan: any; varietyScore: any; weekStart: string; recipes: any[] }; form?: any } = $props();
 
@@ -69,7 +70,7 @@
 		: null
 	);
 
-	let suggestions: any[] = $state([]);
+	let suggestions: Suggestion[] = $state([]);
 	let isLoadingSuggestions = $state(false);
 
 	// Recipes already in any slot this week — used for ⚠ overlap warnings
-- 
2.49.1


From 8686f9eb9f1177e501d88056d40ddfb118ef0a48 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:16:29 +0200
Subject: [PATCH 14/30] test(planner): clarify server.test.ts error-branch test
 name
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

"when backend returns error" → "when data is undefined (error response
without data)" — documents that the guard is data?.suggestions ?? [],
not error field inspection.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/routes/(app)/planner/server.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/src/routes/(app)/planner/server.test.ts b/frontend/src/routes/(app)/planner/server.test.ts
index 023d0fd..cd5bbd2 100644
--- a/frontend/src/routes/(app)/planner/server.test.ts
+++ b/frontend/src/routes/(app)/planner/server.test.ts
@@ -59,7 +59,7 @@ describe('GET /planner — suggestions route handler', () => {
 		expect(body.suggestions[1].recipe.name).toBe('Nudeln');
 	});
 
-	it('returns { suggestions: [] } when backend returns error', async () => {
+	it('returns { suggestions: [] } when data is undefined (error response without data)', async () => {
 		mockGet.mockResolvedValueOnce({ data: undefined, error: { status: 500 } });
 
 		const url = new URL(`http://localhost/planner?planId=${PLAN_UUID}&date=${DATE}`);
-- 
2.49.1


From cb921b3c0fb4af7c03151f341bbb21acea185a67 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:17:09 +0200
Subject: [PATCH 15/30] fix(planner): RecipePicker UI polish from review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Badge font-size 8px → 9px (WCAG minimum)
- Score badge toFixed(1) to avoid misleading "+0 Punkte"
- Self-contain @keyframes pulse in component <style> block
- Wählen buttons use var(--green-dark) per design system

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 41544f2..1488b2e 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -108,15 +108,15 @@
 						<span
 							data-testid="badge-{suggestion.recipe.id}"
 							data-type="good"
-							style="display: inline-block; margin-top: 3px; font-size: 8px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--green-tint); color: var(--green-dark);"
+							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--green-tint); color: var(--green-dark);"
 						>
-							↑ +{(suggestion.scoreDelta ?? 0).toFixed(0)} Punkte
+							↑ +{(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
 						</span>
 					{:else}
 						<span
 							data-testid="badge-{suggestion.recipe.id}"
 							data-type="warning"
-							style="display: inline-block; margin-top: 3px; font-size: 8px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
+							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
 						>
 							⚠ Variationskonflikt
 						</span>
@@ -126,7 +126,7 @@
 					type="button"
 					aria-label="Wählen"
 					onclick={() => onpick(suggestion.recipe.id, suggestion.recipe.name)}
-					style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green); color: #fff; border: none; cursor: pointer;"
+					style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
 				>
 					+ Wählen
 				</button>
@@ -167,7 +167,7 @@
 					type="button"
 					aria-label="Wählen"
 					onclick={() => onpick(recipe.id, recipe.name)}
-					style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green); color: #fff; border: none; cursor: pointer;"
+					style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
 				>
 					+ Wählen
 				</button>
@@ -175,3 +175,10 @@
 		{/each}
 	{/if}
 </div>
+
+<style>
+	@keyframes pulse {
+		0%, 100% { opacity: 1; }
+		50% { opacity: 0.4; }
+	}
+</style>
-- 
2.49.1


From f55d938b320570bdfc162c32556e625576d3f1eb Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:25:22 +0200
Subject: [PATCH 16/30] feat(planner): add onremove prop and Entfernen button
 to MealActionSheet

Button only renders when onremove callback is provided, keeping the
component usable in read-only contexts without the destructive action.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../src/lib/planner/MealActionSheet.svelte    | 13 +++++++++++-
 .../src/lib/planner/MealActionSheet.test.ts   | 20 +++++++++++++++++--
 2 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/frontend/src/lib/planner/MealActionSheet.svelte b/frontend/src/lib/planner/MealActionSheet.svelte
index d0b6fde..d5a5d44 100644
--- a/frontend/src/lib/planner/MealActionSheet.svelte
+++ b/frontend/src/lib/planner/MealActionSheet.svelte
@@ -17,9 +17,10 @@
     slot: Slot;
     onswap: () => void;
     oncancel: () => void;
+    onremove?: () => void;
   }
 
-  let { open, slot, onswap, oncancel }: Props = $props();
+  let { open, slot, onswap, oncancel, onremove }: Props = $props();
 
   const meta = $derived.by(() => {
     const parts: string[] = [];
@@ -82,6 +83,16 @@
           ↻ Gericht tauschen
         </button>
 
+        {#if onremove}
+          <button
+            type="button"
+            style="width:100%;background:var(--color-error, #d9534f);border:1px solid var(--color-error, #d9534f);color:#fff;font-family:var(--font-sans);font-size:13px;font-weight:500;border-radius:var(--radius-lg);padding:12px;text-align:center;cursor:pointer"
+            onclick={onremove}
+          >
+            ✕ Gericht entfernen
+          </button>
+        {/if}
+
         {#if slot.recipe}
           <a
             href="/recipes/{slot.recipe.id}/cook"
diff --git a/frontend/src/lib/planner/MealActionSheet.test.ts b/frontend/src/lib/planner/MealActionSheet.test.ts
index 6307790..9e83a80 100644
--- a/frontend/src/lib/planner/MealActionSheet.test.ts
+++ b/frontend/src/lib/planner/MealActionSheet.test.ts
@@ -13,7 +13,8 @@ const baseProps = {
 	open: true,
 	slot,
 	onswap: vi.fn(),
-	oncancel: vi.fn()
+	oncancel: vi.fn(),
+	onremove: vi.fn()
 };
 
 describe('MealActionSheet', () => {
@@ -28,14 +29,29 @@ describe('MealActionSheet', () => {
 		expect(screen.getByText(/easy/i)).toBeTruthy();
 	});
 
-	it('renders all 4 action buttons', () => {
+	it('renders all 5 action buttons', () => {
 		render(MealActionSheet, { props: baseProps });
 		expect(screen.getByRole('button', { name: /Gericht tauschen/i })).toBeTruthy();
 		expect(screen.getByRole('link', { name: /Jetzt kochen/i })).toBeTruthy();
 		expect(screen.getByRole('link', { name: /Rezept ansehen/i })).toBeTruthy();
+		expect(screen.getByRole('button', { name: /Entfernen/i })).toBeTruthy();
 		expect(screen.getByRole('button', { name: /Abbrechen/i })).toBeTruthy();
 	});
 
+	it('clicking Entfernen calls onremove', async () => {
+		const onremove = vi.fn();
+		const user = userEvent.setup();
+		render(MealActionSheet, { props: { ...baseProps, onremove } });
+		await user.click(screen.getByRole('button', { name: /Entfernen/i }));
+		expect(onremove).toHaveBeenCalledOnce();
+	});
+
+	it('does not render Entfernen button when onremove is not provided', () => {
+		const { onremove: _, ...propsWithoutRemove } = baseProps;
+		render(MealActionSheet, { props: propsWithoutRemove });
+		expect(screen.queryByRole('button', { name: /Entfernen/i })).toBeNull();
+	});
+
 	it('Jetzt kochen links to the cook route', () => {
 		render(MealActionSheet, { props: baseProps });
 		const link = screen.getByRole('link', { name: /Jetzt kochen/i });
-- 
2.49.1


From 1611ddabf65dc5b7b8664d1f92651b9f0037c943 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:31:24 +0200
Subject: [PATCH 17/30] fix(planning): replace existing slot in simulation
 instead of appending

simulateVarietyScore was adding the candidate recipe on top of the
existing slot for slotDate, keeping the old recipe's tag-repeat penalty
in the score. Now the existing slot is excluded before simulating, so
swapping a recipe for one with better variety correctly shows positive
scoreDelta and hasConflict=false.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../recipeapp/planning/PlanningService.java   |  4 ++-
 .../recipeapp/planning/SuggestionsTest.java   | 31 +++++++++++++++++++
 2 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/backend/src/main/java/com/recipeapp/planning/PlanningService.java b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
index c85dcc1..ab13e33 100644
--- a/backend/src/main/java/com/recipeapp/planning/PlanningService.java
+++ b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
@@ -174,7 +174,9 @@ public class PlanningService {
                                          VarietyScoreConfig config, Set<UUID> recentlyCookedIds) {
         List<SimulatedSlot> simulatedSlots = new ArrayList<>();
         for (WeekPlanSlot slot : plan.getSlots()) {
-            simulatedSlots.add(new SimulatedSlot(slot.getRecipe(), slot.getSlotDate()));
+            if (!slot.getSlotDate().equals(slotDate)) {
+                simulatedSlots.add(new SimulatedSlot(slot.getRecipe(), slot.getSlotDate()));
+            }
         }
         simulatedSlots.add(new SimulatedSlot(candidate, slotDate));
         return scoreFromSimulatedSlots(simulatedSlots, config, recentlyCookedIds);
diff --git a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
index b461ffb..da4c673 100644
--- a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
+++ b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
@@ -329,6 +329,37 @@ class SuggestionsTest {
             assertThat(item.hasConflict()).isTrue();
         }
 
+        @Test
+        void swappingExistingSlotForCleanRecipeShouldHavePositiveDelta() {
+            // Plan has Mon=ItalianA, Tue=ItalianB → consecutive cuisine tag repeat → currentScore = 8.5
+            // Asking for suggestions for Mon (swap scenario).
+            // CleanRecipe (no Italian tag) → correct simulation: [Mon:CleanRecipe, Tue:ItalianB] → no repeat → 10.0
+            // scoreDelta = +1.5 → hasConflict = false
+            var plan = createPlan();
+            var italianTag = createTag("Italienisch", "cuisine");
+            var italianA = createRecipe("Spaghetti Carbonara");
+            addTag(italianA, italianTag);
+            addSlot(plan, italianA, MONDAY);
+            var italianB = createRecipe("Penne Arrabiata");
+            addTag(italianB, italianTag);
+            addSlot(plan, italianB, MONDAY.plusDays(1));
+            var cleanRecipe = createRecipe("Grillhähnchen");
+
+            stubPlan(plan);
+            stubDefaultConfig();
+            stubRecipes(italianA, italianB, cleanRecipe);
+            stubNoCookingLogs();
+
+            SuggestionResponse result = planningService.getSuggestions(
+                    HOUSEHOLD_ID, plan.getId(), MONDAY, List.of(), 5);
+
+            assertThat(result.suggestions()).hasSize(1);
+            var item = result.suggestions().getFirst();
+            assertThat(item.recipe().name()).isEqualTo("Grillhähnchen");
+            assertThat(item.scoreDelta()).isCloseTo(1.5, within(0.001));
+            assertThat(item.hasConflict()).isFalse();
+        }
+
         @Test
         void scoreDeltaIsSortedDescendingCleanBeforeConflicting() {
             // Clean recipe (scoreDelta = 0.0) should rank above conflicting (scoreDelta < 0).
-- 
2.49.1


From 77cdccb26ccc8ed1daf1e033be2ce306c868c708 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:47:41 +0200
Subject: [PATCH 18/30] fix(planning): hasConflict only when scoreDelta
 strictly negative
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Neutral suggestions (scoreDelta = 0) are not conflicts — they simply
don't improve variety. Changing scoreDelta <= 0 to scoreDelta < 0
lets empty-plan additions and quality-neutral swaps show without a
misleading ⚠ Variationskonflikt warning.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../java/com/recipeapp/planning/PlanningService.java   |  2 +-
 .../java/com/recipeapp/planning/SuggestionsTest.java   | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/backend/src/main/java/com/recipeapp/planning/PlanningService.java b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
index ab13e33..aeff635 100644
--- a/backend/src/main/java/com/recipeapp/planning/PlanningService.java
+++ b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
@@ -152,7 +152,7 @@ public class PlanningService {
                     double simulatedScore = simulateVarietyScore(
                             plan, candidate, slotDate, config, recentlyCookedIds);
                     double scoreDelta = simulatedScore - currentScore;
-                    boolean hasConflict = scoreDelta <= 0;
+                    boolean hasConflict = scoreDelta < 0;
                     return new SuggestionResponse.SuggestionItem(toSlotRecipe(candidate), scoreDelta, hasConflict);
                 })
                 .sorted((a, b) -> Double.compare(b.scoreDelta(), a.scoreDelta()))
diff --git a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
index da4c673..e86ff86 100644
--- a/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
+++ b/backend/src/test/java/com/recipeapp/planning/SuggestionsTest.java
@@ -180,10 +180,10 @@ class SuggestionsTest {
 
             assertThat(result.suggestions()).hasSize(3);
             // Empty plan → currentScore = 10.0; no penalties → scoreDelta = 0.0 for all
-            // hasConflict = (scoreDelta <= 0) = true even for neutral recipes
+            // hasConflict = (scoreDelta < 0) = false for neutral recipes
             assertThat(result.suggestions()).allSatisfy(s -> {
                 assertThat(s.scoreDelta()).isEqualTo(0.0);
-                assertThat(s.hasConflict()).isTrue();
+                assertThat(s.hasConflict()).isFalse();
             });
         }
 
@@ -255,9 +255,9 @@ class SuggestionsTest {
     class ScoreDeltaAndHasConflict {
 
         @Test
-        void recipeWithNoConflictsOnEmptyPlanShouldHaveZeroDeltaAndHasConflict() {
+        void recipeWithZeroDeltaOnEmptyPlanShouldNotHaveConflict() {
             // Empty plan → currentScore = 10.0. Clean recipe → simulatedScore = 10.0.
-            // scoreDelta = 0.0, hasConflict = (0.0 <= 0) = true
+            // scoreDelta = 0.0. No worsening → hasConflict = false.
             var plan = createPlan();
             var recipe = createRecipe("Clean Recipe");
             stubPlan(plan);
@@ -271,7 +271,7 @@ class SuggestionsTest {
             assertThat(result.suggestions()).hasSize(1);
             var item = result.suggestions().getFirst();
             assertThat(item.scoreDelta()).isEqualTo(0.0);
-            assertThat(item.hasConflict()).isTrue();
+            assertThat(item.hasConflict()).isFalse();
         }
 
         @Test
-- 
2.49.1


From 1de9dfc31428e32f84c4864c484aae8bc495c0ba Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:47:53 +0200
Subject: [PATCH 19/30] feat(planner): add remove meal with undo; fix
 RecipePicker badge for neutral delta
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- MealActionSheet: new onremove prop + Entfernen button (guarded by #if)
- +page.svelte: handleRemoveMeal submits delete form, shows undo bar;
  undo re-adds via addSlot form; refactored handleUndo to undoCallback
  pattern; desktop day-detail panel also gets Entfernen button
- RecipePicker: only show green +delta badge when scoreDelta > 0;
  neutral (scoreDelta = 0) shows no badge instead of ⚠ Variationskonflikt
- Tests: page.test.ts remove-meal describe, RecipePicker neutral badge test

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  |  4 +-
 frontend/src/lib/planner/RecipePicker.test.ts |  8 ++++
 .../src/routes/(app)/planner/+page.svelte     | 44 +++++++++++++++++-
 .../src/routes/(app)/planner/page.test.ts     | 46 ++++++++++++++++++-
 4 files changed, 96 insertions(+), 6 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 1488b2e..ec9196d 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -104,7 +104,7 @@
 							{meta}
 						</p>
 					{/if}
-					{#if !suggestion.hasConflict}
+					{#if (suggestion.scoreDelta ?? 0) > 0}
 						<span
 							data-testid="badge-{suggestion.recipe.id}"
 							data-type="good"
@@ -112,7 +112,7 @@
 						>
 							↑ +{(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
 						</span>
-					{:else}
+					{:else if suggestion.hasConflict}
 						<span
 							data-testid="badge-{suggestion.recipe.id}"
 							data-type="warning"
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index ac362c3..d34476b 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -98,6 +98,14 @@ describe('RecipePicker', () => {
 		expect(screen.getByText(/Keine Treffer/i)).toBeTruthy();
 	});
 
+	it('shows no badge when scoreDelta is zero (neutral, no improvement)', () => {
+		const neutralSuggestions = [
+			{ recipe: { id: 'sn', name: 'Neutrales Rezept', effort: 'easy', cookTimeMin: 20 }, scoreDelta: 0.0, hasConflict: false }
+		];
+		render(RecipePicker, { props: { ...baseProps, suggestions: neutralSuggestions } });
+		expect(screen.queryByTestId('badge-sn')).toBeNull();
+	});
+
 	it('shows loading skeleton instead of Empfohlen section when isLoading is true', () => {
 		render(RecipePicker, { props: { ...baseProps, isLoading: true } });
 		expect(screen.getByTestId('suggestions-loading')).toBeTruthy();
diff --git a/frontend/src/routes/(app)/planner/+page.svelte b/frontend/src/routes/(app)/planner/+page.svelte
index d281247..5fa8284 100644
--- a/frontend/src/routes/(app)/planner/+page.svelte
+++ b/frontend/src/routes/(app)/planner/+page.svelte
@@ -100,6 +100,7 @@
 	// UndoBar
 	let undoVisible = $state(false);
 	let undoMessage = $state('');
+	let undoCallback = $state<(() => void) | null>(null);
 
 	$effect(() => {
 		if (!activePickerDate || !weekPlan?.id) {
@@ -162,7 +163,33 @@
 
 	function handleUndo() {
 		undoVisible = false;
+		undoCallback?.();
+	}
+
+	async function handleRemoveMeal(slot: { id: string; slotDate: string; recipe: { id: string; name: string } | null }) {
+		// Capture primitive values immediately — slot may be a reactive proxy that
+		// becomes stale after the first await (tick flushes state + re-render).
+		const slotId = slot.id;
+		const slotDate = slot.slotDate;
+		const recipeName = slot.recipe?.name ?? '';
+		const recipeId = slot.recipe?.id ?? '';
+		if (!slotId || !recipeId) return;
+
+		actionSheetOpen = false;
+		undoCallback = async () => {
+			addPlanId = weekPlan!.id;
+			addSlotDate = slotDate;
+			addRecipeId = recipeId;
+			addRecipeName = recipeName;
+			await tick();
+			addSlotFormEl.requestSubmit();
+		};
+		delPlanId = weekPlan!.id;
+		delSlotId = slotId;
+		await tick();
 		deleteSlotFormEl.requestSubmit();
+		undoMessage = `${recipeName} entfernt`;
+		undoVisible = true;
 	}
 
 	async function handleSwapPick(recipeId: string, recipeName: string) {
@@ -315,12 +342,13 @@
 		/>
 	</BottomSheet>
 
-	<!-- Mobile: meal exists → action sheet (Swap / Cook / View / Cancel) -->
+	<!-- Mobile: meal exists → action sheet (Swap / Cook / View / Remove / Cancel) -->
 	<MealActionSheet
 		open={actionSheetOpen}
 		slot={selectedSlot}
 		onswap={() => { actionSheetOpen = false; swapSheetOpen = true; }}
 		oncancel={() => (actionSheetOpen = false)}
+		onremove={isPlanner && selectedSlot.id ? () => handleRemoveMeal(selectedSlot as any) : undefined}
 	/>
 
 	<!-- Mobile: swap suggestions sheet -->
@@ -530,6 +558,15 @@
 							>
 								Gericht tauschen
 							</button>
+							{#if detailSlot.id}
+								<button
+									type="button"
+									onclick={() => { handleRemoveMeal(detailSlot as any); panelState = { kind: 'idle' }; }}
+									class="block w-full rounded-[var(--radius-md)] border border-[var(--color-error,#d9534f)] px-3 py-2 text-center text-[13px] font-medium tracking-[0.04em] font-[var(--font-sans)] text-[var(--color-error,#d9534f)] hover:bg-[var(--color-surface)]"
+								>
+									Entfernen
+								</button>
+							{/if}
 						{/if}
 					</div>
 				{:else}
@@ -611,8 +648,10 @@
 			formData.set('recipeId', addRecipeId);
 			return async ({ result, update }) => {
 				if (result.type === 'success' && result.data?.success) {
+					const slotId = (result.data as any)?.slot?.id ?? '';
 					delPlanId = addPlanId;
-					delSlotId = (result.data as any)?.slot?.id ?? '';
+					delSlotId = slotId;
+					undoCallback = () => deleteSlotFormEl.requestSubmit();
 					undoMessage = `${addRecipeName} hinzugefügt`;
 					undoVisible = true;
 				}
@@ -639,6 +678,7 @@
 				if (result.type === 'success' && result.data?.success) {
 					delPlanId = updPlanId;
 					delSlotId = (result.data as any)?.slot?.id ?? '';
+					undoCallback = () => deleteSlotFormEl.requestSubmit();
 					undoMessage = `${updRecipeName} eingetragen`;
 					undoVisible = true;
 				}
diff --git a/frontend/src/routes/(app)/planner/page.test.ts b/frontend/src/routes/(app)/planner/page.test.ts
index c400a88..fb2d181 100644
--- a/frontend/src/routes/(app)/planner/page.test.ts
+++ b/frontend/src/routes/(app)/planner/page.test.ts
@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, afterEach } from 'vitest';
-import { render, screen, waitFor } from '@testing-library/svelte';
+import { render, screen, waitFor, within } from '@testing-library/svelte';
 import userEvent from '@testing-library/user-event';
 import Page from './+page.svelte';
 
@@ -13,13 +13,23 @@ const PLAN_ID = 'plan-00000000-0000-0000-0000-000000000001';
 const DATE = '2025-01-06'; // Monday, January 6 2025
 
 const mockData = {
-	weekPlan: { id: PLAN_ID, weekStart: DATE, status: 'draft', slots: [] },
+	weekPlan: { id: PLAN_ID, weekStart: DATE, status: 'draft', slots: [] as any[] },
 	varietyScore: null,
 	weekStart: DATE,
 	recipes: [{ id: 'r1', name: 'Beef Bourguignon', effort: 'hard', cookTimeMin: 150 }],
 	benutzer: { rolle: 'planer' }
 };
 
+const mockDataWithSlot = {
+	...mockData,
+	weekPlan: {
+		id: PLAN_ID,
+		weekStart: DATE,
+		status: 'draft',
+		slots: [{ id: 'slot-1', slotDate: DATE, recipe: { id: 'r1', name: 'Beef Bourguignon', effort: 'hard', cookTimeMin: 150 } }]
+	}
+};
+
 const mockSuggestions = [
 	{
 		recipe: { id: 's1', name: 'Lachsfilet', effort: 'easy', cookTimeMin: 20 },
@@ -82,3 +92,35 @@ describe('+page.svelte — $effect suggestion fetch', () => {
 		expect(fetchOptions?.signal).toBeInstanceOf(AbortSignal);
 	});
 });
+
+describe('+page.svelte — remove meal', () => {
+	afterEach(() => {
+		vi.restoreAllMocks();
+	});
+
+	it('clicking Entfernen in MealActionSheet shows undo bar with recipe name', async () => {
+		vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ json: () => Promise.resolve({ suggestions: [] }) }));
+
+		render(Page, { props: { data: mockDataWithSlot } });
+
+		await userEvent.click(screen.getByTestId('day-meal-card'));
+		await userEvent.click(await screen.findByRole('button', { name: /Entfernen/i }));
+
+		const undoBar = screen.getByTestId('undo-bar');
+		expect(undoBar).toBeTruthy();
+		expect(within(undoBar).getByText(/Beef Bourguignon/)).toBeTruthy();
+	});
+
+	it('clicking Rückgängig after remove hides the undo bar', async () => {
+		vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ json: () => Promise.resolve({ suggestions: [] }) }));
+
+		render(Page, { props: { data: mockDataWithSlot } });
+
+		await userEvent.click(screen.getByTestId('day-meal-card'));
+		await userEvent.click(await screen.findByRole('button', { name: /Entfernen/i }));
+
+		await userEvent.click(screen.getByRole('button', { name: /Rückgängig/i }));
+
+		expect(screen.queryByTestId('undo-bar')).toBeNull();
+	});
+});
-- 
2.49.1


From 06bf567b9093f9e9d8b3cc761a4b7e28210dbcbf Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:50:03 +0200
Subject: [PATCH 20/30] feat(planner): replace Variationskonflikt with red
 delta badge
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Shows the actual score delta (e.g. "↓ -1.5 Punkte") in red instead of a
generic ⚠ Variationskonflikt label, letting users compare the cost of each
recipe to make an informed swap decision.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 6 +++---
 frontend/src/lib/planner/RecipePicker.test.ts | 7 ++++---
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index ec9196d..5f3f90e 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -115,10 +115,10 @@
 					{:else if suggestion.hasConflict}
 						<span
 							data-testid="badge-{suggestion.recipe.id}"
-							data-type="warning"
-							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
+							data-type="bad"
+							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--red-tint, #fdecea); color: var(--color-error, #d9534f);"
 						>
-							⚠ Variationskonflikt
+							↓ {(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
 						</span>
 					{/if}
 				</div>
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index d34476b..7e44fe3 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -47,11 +47,12 @@ describe('RecipePicker', () => {
 		expect(badge.getAttribute('data-type')).toBe('good');
 	});
 
-	it('shows yellow badge when hasConflict is true', () => {
+	it('shows red delta badge when hasConflict is true', () => {
 		render(RecipePicker, { props: baseProps });
-		// Hähnchen-Curry: hasConflict = true → yellow badge
+		// Hähnchen-Curry: hasConflict = true, scoreDelta = -1.5 → red badge with delta
 		const badge = screen.getByTestId('badge-s2');
-		expect(badge.getAttribute('data-type')).toBe('warning');
+		expect(badge.getAttribute('data-type')).toBe('bad');
+		expect(badge.textContent).toContain('-1.5');
 	});
 
 	it('shows Alle Rezepte section', () => {
-- 
2.49.1


From f33302e0125b6eec2546cbba2a8952520bf104c5 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:52:56 +0200
Subject: [PATCH 21/30] fix(planner): format variety score to one decimal place

Avoids floating-point display like 6.199999999999999 by using
score.toFixed(1) in VarietyScoreCard.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/VarietyScoreCard.svelte  | 2 +-
 frontend/src/lib/planner/VarietyScoreCard.test.ts | 8 +++++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/frontend/src/lib/planner/VarietyScoreCard.svelte b/frontend/src/lib/planner/VarietyScoreCard.svelte
index 27dc086..68144c0 100644
--- a/frontend/src/lib/planner/VarietyScoreCard.svelte
+++ b/frontend/src/lib/planner/VarietyScoreCard.svelte
@@ -20,7 +20,7 @@
 <div class="rounded-[var(--radius-lg)] border border-[var(--yellow-light)] bg-[var(--yellow-tint)] p-4">
 	<div class="flex items-baseline gap-1">
 		<span class="font-[var(--font-display)] text-[28px] font-[300] text-[var(--color-text)] md:text-[40px]">
-			{score}
+			{score.toFixed(1)}
 		</span>
 		<span class="font-[var(--font-sans)] text-[13px] text-[var(--color-text-muted)]">/10</span>
 		<span class="ml-1 font-[var(--font-sans)] text-[12px] text-[var(--color-text-muted)]">Abwechslungs-Score</span>
diff --git a/frontend/src/lib/planner/VarietyScoreCard.test.ts b/frontend/src/lib/planner/VarietyScoreCard.test.ts
index 2bfbdd1..fbe50c7 100644
--- a/frontend/src/lib/planner/VarietyScoreCard.test.ts
+++ b/frontend/src/lib/planner/VarietyScoreCard.test.ts
@@ -51,7 +51,13 @@ describe('VarietyScoreCard', () => {
 
 	it('renders with score 0', () => {
 		render(VarietyScoreCard, { props: { ...baseProps, score: 0 } });
-		expect(screen.getByText('0')).toBeTruthy();
+		expect(screen.getByText('0.0')).toBeTruthy();
+	});
+
+	it('rounds floating-point scores to one decimal place', () => {
+		render(VarietyScoreCard, { props: { ...baseProps, score: 6.199999999999999 } });
+		expect(screen.getByText('6.2')).toBeTruthy();
+		expect(screen.queryByText('6.199999999999999')).toBeNull();
 	});
 
 	it('renders multiple ingredient overlap warnings', () => {
-- 
2.49.1


From 081b8dcaf01ac7e47721f9952cf646c462ae2c64 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 12:54:31 +0200
Subject: [PATCH 22/30] feat(planner): show yellow neutral badge for scoreDelta
 = 0 in RecipePicker

Neutral suggestions (no variety impact) now show "= 0.0 Punkte" in yellow
instead of no badge, making the three states explicit: green (improves),
yellow (neutral), red (worsens).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 8 ++++++++
 frontend/src/lib/planner/RecipePicker.test.ts | 6 ++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 5f3f90e..1b73409 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -120,6 +120,14 @@
 						>
 							↓ {(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
 						</span>
+					{:else}
+						<span
+							data-testid="badge-{suggestion.recipe.id}"
+							data-type="neutral"
+							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
+						>
+							= {(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
+						</span>
 					{/if}
 				</div>
 				<button
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index 7e44fe3..6bdfbca 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -99,12 +99,14 @@ describe('RecipePicker', () => {
 		expect(screen.getByText(/Keine Treffer/i)).toBeTruthy();
 	});
 
-	it('shows no badge when scoreDelta is zero (neutral, no improvement)', () => {
+	it('shows yellow neutral badge when scoreDelta is zero', () => {
 		const neutralSuggestions = [
 			{ recipe: { id: 'sn', name: 'Neutrales Rezept', effort: 'easy', cookTimeMin: 20 }, scoreDelta: 0.0, hasConflict: false }
 		];
 		render(RecipePicker, { props: { ...baseProps, suggestions: neutralSuggestions } });
-		expect(screen.queryByTestId('badge-sn')).toBeNull();
+		const badge = screen.getByTestId('badge-sn');
+		expect(badge.getAttribute('data-type')).toBe('neutral');
+		expect(badge.textContent).toContain('0.0');
 	});
 
 	it('shows loading skeleton instead of Empfohlen section when isLoading is true', () => {
-- 
2.49.1


From f4648cc38273ac524332c0819f43905c8f22447a Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 13:03:10 +0200
Subject: [PATCH 23/30] feat(planner): show score badges for all recipes in
 RecipePicker

- +server.ts: pass topN=100 so all recipes are scored in one request
- RecipePicker: Empfohlen keeps top 5 with scoreDelta > 0; builds a
  scoreMap from all suggestions; shows green/yellow/red delta badge on
  every recipe in Alle Rezepte that has a score entry
- Extracted scoreBadge snippet to avoid duplication between sections

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 206 ++++++++++--------
 frontend/src/lib/planner/RecipePicker.test.ts |  78 ++++++-
 frontend/src/routes/(app)/planner/+server.ts  |   2 +-
 .../src/routes/(app)/planner/server.test.ts   |   2 +-
 4 files changed, 181 insertions(+), 107 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 1b73409..47546b0 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -21,6 +21,14 @@
 
 	let searchQuery = $state('');
 
+	let topRecommendations = $derived(
+		suggestions.filter((s) => s.scoreDelta > 0).slice(0, 5)
+	);
+
+	let scoreMap = $derived(
+		new Map(suggestions.map((s) => [s.recipe.id, s]))
+	);
+
 	let filteredRecipes = $derived(
 		searchQuery.trim() === ''
 			? allRecipes
@@ -39,6 +47,34 @@
 	}
 </script>
 
+{#snippet scoreBadge(recipeId: string, delta: number, hasConflict: boolean)}
+	{#if delta > 0}
+		<span
+			data-testid="badge-{recipeId}"
+			data-type="good"
+			style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--green-tint); color: var(--green-dark);"
+		>
+			↑ +{delta.toFixed(1)} Punkte
+		</span>
+	{:else if hasConflict}
+		<span
+			data-testid="badge-{recipeId}"
+			data-type="bad"
+			style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--red-tint, #fdecea); color: var(--color-error, #d9534f);"
+		>
+			↓ {delta.toFixed(1)} Punkte
+		</span>
+	{:else}
+		<span
+			data-testid="badge-{recipeId}"
+			data-type="neutral"
+			style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
+		>
+			= {delta.toFixed(1)} Punkte
+		</span>
+	{/if}
+{/snippet}
+
 <div style="background: var(--color-page); font-family: var(--font-sans);">
 	<!-- Header -->
 	<div style="padding: 10px 12px 6px; border-bottom: 1px solid var(--color-border);">
@@ -81,107 +117,91 @@
 				</div>
 			{/each}
 		</div>
-	{:else if suggestions.length > 0}
-		<div
-			style="font-size: 11px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-muted); padding: 5px 12px 3px; background: var(--color-subtle);"
-		>
-			Empfohlen · Beste Abwechslung
-		</div>
-
-		{#each suggestions as suggestion (suggestion.recipe.id)}
-			{@const meta = recipeMetadata(suggestion.recipe)}
+	{:else if topRecommendations.length > 0}
+		<div data-testid="empfohlen-section">
 			<div
-				style="padding: 7px 12px; border-bottom: 1px solid var(--color-subtle); display: flex; align-items: center; gap: 8px;"
+				style="font-size: 11px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-muted); padding: 5px 12px 3px; background: var(--color-subtle);"
 			>
-				<div style="flex: 1; min-width: 0;">
-					<p
-						style="font-family: var(--font-display); font-size: 12px; font-weight: 400; color: var(--color-text); margin: 0;"
-					>
-						{suggestion.recipe.name}
-					</p>
-					{#if meta}
-						<p style="font-size: 9px; color: var(--color-text-muted); margin: 1px 0 0;">
-							{meta}
-						</p>
-					{/if}
-					{#if (suggestion.scoreDelta ?? 0) > 0}
-						<span
-							data-testid="badge-{suggestion.recipe.id}"
-							data-type="good"
-							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--green-tint); color: var(--green-dark);"
-						>
-							↑ +{(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
-						</span>
-					{:else if suggestion.hasConflict}
-						<span
-							data-testid="badge-{suggestion.recipe.id}"
-							data-type="bad"
-							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--red-tint, #fdecea); color: var(--color-error, #d9534f);"
-						>
-							↓ {(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
-						</span>
-					{:else}
-						<span
-							data-testid="badge-{suggestion.recipe.id}"
-							data-type="neutral"
-							style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
-						>
-							= {(suggestion.scoreDelta ?? 0).toFixed(1)} Punkte
-						</span>
-					{/if}
-				</div>
-				<button
-					type="button"
-					aria-label="Wählen"
-					onclick={() => onpick(suggestion.recipe.id, suggestion.recipe.name)}
-					style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
-				>
-					+ Wählen
-				</button>
+				Empfohlen · Beste Abwechslung
 			</div>
-		{/each}
+
+			{#each topRecommendations as suggestion (suggestion.recipe.id)}
+				{@const meta = recipeMetadata(suggestion.recipe)}
+				<div
+					style="padding: 7px 12px; border-bottom: 1px solid var(--color-subtle); display: flex; align-items: center; gap: 8px;"
+				>
+					<div style="flex: 1; min-width: 0;">
+						<p
+							style="font-family: var(--font-display); font-size: 12px; font-weight: 400; color: var(--color-text); margin: 0;"
+						>
+							{suggestion.recipe.name}
+						</p>
+						{#if meta}
+							<p style="font-size: 9px; color: var(--color-text-muted); margin: 1px 0 0;">
+								{meta}
+							</p>
+						{/if}
+						{@render scoreBadge(suggestion.recipe.id, suggestion.scoreDelta ?? 0, suggestion.hasConflict)}
+					</div>
+					<button
+						type="button"
+						aria-label="Wählen"
+						onclick={() => onpick(suggestion.recipe.id, suggestion.recipe.name)}
+						style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
+					>
+						+ Wählen
+					</button>
+				</div>
+			{/each}
+		</div>
 	{/if}
 
 	<!-- Alle Rezepte section -->
-	<div
-		style="font-size: 11px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-muted); padding: 5px 12px 3px; background: var(--color-subtle);"
-	>
-		Alle Rezepte
-	</div>
+	<div data-testid="alle-rezepte-section">
+		<div
+			style="font-size: 11px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-muted); padding: 5px 12px 3px; background: var(--color-subtle);"
+		>
+			Alle Rezepte
+		</div>
 
-	{#if filteredRecipes.length === 0}
-		<p style="padding: 10px 12px; font-size: 11px; color: var(--color-text-muted); margin: 0;">
-			Keine Treffer
-		</p>
-	{:else}
-		{#each filteredRecipes as recipe (recipe.id)}
-			{@const meta = recipeMetadata(recipe)}
-			<div
-				style="padding: 7px 12px; border-bottom: 1px solid var(--color-subtle); display: flex; align-items: center; gap: 8px;"
-			>
-				<div style="flex: 1; min-width: 0;">
-					<p
-						style="font-family: var(--font-display); font-size: 12px; font-weight: 400; color: var(--color-text); margin: 0;"
-					>
-						{recipe.name}
-					</p>
-					{#if meta}
-						<p style="font-size: 9px; color: var(--color-text-muted); margin: 1px 0 0;">
-							{meta}
-						</p>
-					{/if}
-				</div>
-				<button
-					type="button"
-					aria-label="Wählen"
-					onclick={() => onpick(recipe.id, recipe.name)}
-					style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
+		{#if filteredRecipes.length === 0}
+			<p style="padding: 10px 12px; font-size: 11px; color: var(--color-text-muted); margin: 0;">
+				Keine Treffer
+			</p>
+		{:else}
+			{#each filteredRecipes as recipe (recipe.id)}
+				{@const meta = recipeMetadata(recipe)}
+				{@const score = scoreMap.get(recipe.id)}
+				<div
+					style="padding: 7px 12px; border-bottom: 1px solid var(--color-subtle); display: flex; align-items: center; gap: 8px;"
 				>
-					+ Wählen
-				</button>
-			</div>
-		{/each}
-	{/if}
+					<div style="flex: 1; min-width: 0;">
+						<p
+							style="font-family: var(--font-display); font-size: 12px; font-weight: 400; color: var(--color-text); margin: 0;"
+						>
+							{recipe.name}
+						</p>
+						{#if meta}
+							<p style="font-size: 9px; color: var(--color-text-muted); margin: 1px 0 0;">
+								{meta}
+							</p>
+						{/if}
+						{#if score}
+							{@render scoreBadge(recipe.id, score.scoreDelta ?? 0, score.hasConflict)}
+						{/if}
+					</div>
+					<button
+						type="button"
+						aria-label="Wählen"
+						onclick={() => onpick(recipe.id, recipe.name)}
+						style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
+					>
+						+ Wählen
+					</button>
+				</div>
+			{/each}
+		{/if}
+	</div>
 </div>
 
 <style>
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index 6bdfbca..3036488 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -1,5 +1,5 @@
 import { describe, it, expect, vi } from 'vitest';
-import { render, screen } from '@testing-library/svelte';
+import { render, screen, within } from '@testing-library/svelte';
 import userEvent from '@testing-library/user-event';
 import RecipePicker from './RecipePicker.svelte';
 
@@ -34,10 +34,12 @@ describe('RecipePicker', () => {
 		expect(screen.getByText(/Empfohlen/i)).toBeTruthy();
 	});
 
-	it('shows all suggestion recipe names', () => {
+	it('shows only positive-delta suggestions in Empfohlen', () => {
 		render(RecipePicker, { props: baseProps });
+		// s1 (scoreDelta=1.5) appears in Empfohlen
 		expect(screen.getByText('Lachsfilet')).toBeTruthy();
-		expect(screen.getByText('Hähnchen-Curry')).toBeTruthy();
+		// s2 (scoreDelta=-1.5) is excluded from Empfohlen; not in allRecipes either → absent
+		expect(screen.queryByText('Hähnchen-Curry')).toBeNull();
 	});
 
 	it('shows green badge when hasConflict is false', () => {
@@ -47,10 +49,15 @@ describe('RecipePicker', () => {
 		expect(badge.getAttribute('data-type')).toBe('good');
 	});
 
-	it('shows red delta badge when hasConflict is true', () => {
-		render(RecipePicker, { props: baseProps });
-		// Hähnchen-Curry: hasConflict = true, scoreDelta = -1.5 → red badge with delta
-		const badge = screen.getByTestId('badge-s2');
+	it('shows red delta badge in Alle Rezepte when hasConflict is true', () => {
+		// r2 is in allRecipes; scoring it negative via suggestions → red badge in Alle Rezepte
+		const withR2Scored = [
+			...suggestions,
+			{ recipe: { id: 'r2', name: 'Spaghetti Carbonara', effort: 'easy' as const, cookTimeMin: 20 }, scoreDelta: -1.5, hasConflict: true }
+		];
+		render(RecipePicker, { props: { ...baseProps, suggestions: withR2Scored } });
+		const alleRezepte = screen.getByTestId('alle-rezepte-section');
+		const badge = within(alleRezepte).getByTestId('badge-r2');
 		expect(badge.getAttribute('data-type')).toBe('bad');
 		expect(badge.textContent).toContain('-1.5');
 	});
@@ -87,8 +94,8 @@ describe('RecipePicker', () => {
 		const onpick = vi.fn();
 		render(RecipePicker, { props: { ...baseProps, onpick } });
 		const buttons = screen.getAllByRole('button', { name: /Wählen/i });
-		// First 2 are suggestions, rest are allRecipes
-		await userEvent.click(buttons[2]);
+		// First 1 is the positive-delta suggestion (s1), rest are allRecipes
+		await userEvent.click(buttons[1]);
 		expect(onpick).toHaveBeenCalledWith('r1', 'Beef Bourguignon');
 	});
 
@@ -99,16 +106,63 @@ describe('RecipePicker', () => {
 		expect(screen.getByText(/Keine Treffer/i)).toBeTruthy();
 	});
 
-	it('shows yellow neutral badge when scoreDelta is zero', () => {
+	it('shows yellow neutral badge in Alle Rezepte when scoreDelta is zero', () => {
+		// r1 is in allRecipes; scoring it neutral via suggestions → yellow badge in Alle Rezepte
 		const neutralSuggestions = [
-			{ recipe: { id: 'sn', name: 'Neutrales Rezept', effort: 'easy', cookTimeMin: 20 }, scoreDelta: 0.0, hasConflict: false }
+			{ recipe: { id: 'r1', name: 'Beef Bourguignon', effort: 'hard' as const, cookTimeMin: 150 }, scoreDelta: 0.0, hasConflict: false }
 		];
 		render(RecipePicker, { props: { ...baseProps, suggestions: neutralSuggestions } });
-		const badge = screen.getByTestId('badge-sn');
+		const alleRezepte = screen.getByTestId('alle-rezepte-section');
+		const badge = within(alleRezepte).getByTestId('badge-r1');
 		expect(badge.getAttribute('data-type')).toBe('neutral');
 		expect(badge.textContent).toContain('0.0');
 	});
 
+	it('Empfohlen shows only positive-delta suggestions, capped at 5', () => {
+		const sixImproving = Array.from({ length: 6 }, (_, i) => ({
+			recipe: { id: `imp${i}`, name: `Improving ${i}`, effort: 'easy' as const, cookTimeMin: 20 },
+			scoreDelta: 1.0,
+			hasConflict: false
+		}));
+		render(RecipePicker, { props: { ...baseProps, suggestions: sixImproving } });
+		const empfohlen = screen.getByTestId('empfohlen-section');
+		const buttons = empfohlen.querySelectorAll('button');
+		expect(buttons).toHaveLength(5);
+	});
+
+	it('Empfohlen excludes neutral and negative suggestions', () => {
+		const mixed = [
+			{ recipe: { id: 'pos', name: 'Positiv', effort: 'easy' as const, cookTimeMin: 20 }, scoreDelta: 1.0, hasConflict: false },
+			{ recipe: { id: 'neu', name: 'Neutral', effort: 'easy' as const, cookTimeMin: 20 }, scoreDelta: 0.0, hasConflict: false },
+			{ recipe: { id: 'neg', name: 'Negativ', effort: 'easy' as const, cookTimeMin: 20 }, scoreDelta: -1.0, hasConflict: true }
+		];
+		render(RecipePicker, { props: { ...baseProps, suggestions: mixed } });
+		const empfohlen = screen.getByTestId('empfohlen-section');
+		expect(empfohlen.textContent).toContain('Positiv');
+		expect(empfohlen.textContent).not.toContain('Neutral');
+		expect(empfohlen.textContent).not.toContain('Negativ');
+	});
+
+	it('shows score badge inside Alle Rezepte for a recipe that has a matching suggestion', () => {
+		// r1 is in allRecipes; scoreDelta=-0.3 → not in Empfohlen (needs >0), but scoreMap provides badge
+		const withR1Scored = [
+			...suggestions,
+			{ recipe: { id: 'r1', name: 'Beef Bourguignon', effort: 'hard' as const, cookTimeMin: 150 }, scoreDelta: -0.3, hasConflict: true }
+		];
+		render(RecipePicker, { props: { ...baseProps, suggestions: withR1Scored } });
+		const alleRezepte = screen.getByTestId('alle-rezepte-section');
+		const badge = within(alleRezepte).getByTestId('badge-r1');
+		expect(badge.getAttribute('data-type')).toBe('bad');
+	});
+
+	it('shows no badge in Alle Rezepte for recipes with no suggestion score', () => {
+		// r2 and r3 have no suggestion entry
+		render(RecipePicker, { props: baseProps });
+		const alleRezepte = screen.getByTestId('alle-rezepte-section');
+		expect(within(alleRezepte).queryByTestId('badge-r2')).toBeNull();
+		expect(within(alleRezepte).queryByTestId('badge-r3')).toBeNull();
+	});
+
 	it('shows loading skeleton instead of Empfohlen section when isLoading is true', () => {
 		render(RecipePicker, { props: { ...baseProps, isLoading: true } });
 		expect(screen.getByTestId('suggestions-loading')).toBeTruthy();
diff --git a/frontend/src/routes/(app)/planner/+server.ts b/frontend/src/routes/(app)/planner/+server.ts
index af3aa80..8a116f1 100644
--- a/frontend/src/routes/(app)/planner/+server.ts
+++ b/frontend/src/routes/(app)/planner/+server.ts
@@ -14,7 +14,7 @@ export const GET: RequestHandler = async ({ fetch, url }) => {
 	try {
 		const api = apiClient(fetch);
 		const { data } = await api.GET('/v1/week-plans/{id}/suggestions', {
-			params: { path: { id: planId }, query: { slotDate: date } }
+			params: { path: { id: planId }, query: { slotDate: date, topN: 100 } }
 		});
 
 		const suggestions = (data?.suggestions ?? []).sort(
diff --git a/frontend/src/routes/(app)/planner/server.test.ts b/frontend/src/routes/(app)/planner/server.test.ts
index cd5bbd2..bd98219 100644
--- a/frontend/src/routes/(app)/planner/server.test.ts
+++ b/frontend/src/routes/(app)/planner/server.test.ts
@@ -51,7 +51,7 @@ describe('GET /planner — suggestions route handler', () => {
 		const body = await response.json();
 
 		expect(mockGet).toHaveBeenCalledWith('/v1/week-plans/{id}/suggestions', expect.objectContaining({
-			params: { path: { id: PLAN_UUID }, query: { slotDate: DATE } }
+			params: { path: { id: PLAN_UUID }, query: { slotDate: DATE, topN: 100 } }
 		}));
 		expect(body.suggestions).toHaveLength(2);
 		// sorted by scoreDelta desc: 0.0 before -1.5
-- 
2.49.1


From f4503b0220c88c6e74affb2f6226a74b9d6ed47b Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 13:40:17 +0200
Subject: [PATCH 24/30] feat(planner): show variety score in swap menu via
 RecipePicker

Replace SwapSuggestionList with RecipePicker in both mobile and desktop
swap contexts. RecipePicker now accepts excludeRecipeId, replacingRecipe,
and isDisabled props. Mobile swap sheet also triggers suggestion fetch
via activePickerDate so green/yellow/red score badges appear during swap.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 40 ++++++++++++++++---
 frontend/src/lib/planner/RecipePicker.test.ts | 36 +++++++++++++++++
 .../src/routes/(app)/planner/+page.svelte     | 40 ++++++++++---------
 3 files changed, 93 insertions(+), 23 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 47546b0..185f2bd 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -8,6 +8,9 @@
 		suggestions = [],
 		allRecipes = [],
 		isLoading = false,
+		isDisabled = false,
+		excludeRecipeId,
+		replacingRecipe,
 		onpick
 	}: {
 		planId: string;
@@ -16,23 +19,32 @@
 		suggestions: Suggestion[];
 		allRecipes: Recipe[];
 		isLoading?: boolean;
+		isDisabled?: boolean;
+		excludeRecipeId?: string;
+		replacingRecipe?: { name: string; meta?: string };
 		onpick: (recipeId: string, recipeName: string) => void;
 	} = $props();
 
 	let searchQuery = $state('');
 
 	let topRecommendations = $derived(
-		suggestions.filter((s) => s.scoreDelta > 0).slice(0, 5)
+		suggestions
+			.filter((s) => s.scoreDelta > 0 && s.recipe.id !== excludeRecipeId)
+			.slice(0, 5)
 	);
 
 	let scoreMap = $derived(
 		new Map(suggestions.map((s) => [s.recipe.id, s]))
 	);
 
+	let baseRecipes = $derived(
+		excludeRecipeId ? allRecipes.filter((r) => r.id !== excludeRecipeId) : allRecipes
+	);
+
 	let filteredRecipes = $derived(
 		searchQuery.trim() === ''
-			? allRecipes
-			: allRecipes.filter((r) =>
+			? baseRecipes
+			: baseRecipes.filter((r) =>
 					r.name.toLowerCase().includes(searchQuery.toLowerCase())
 				)
 	);
@@ -86,6 +98,22 @@
 		</p>
 	</div>
 
+	<!-- Wird ersetzt banner (swap context) -->
+	{#if replacingRecipe}
+		<div style="background: var(--orange-tint); border-bottom: 1px solid #FBCDA4; padding: 8px 12px;">
+			<p style="font-size: 10px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--orange-dark); margin: 0 0 2px 0; font-family: var(--font-sans);">
+				Wird ersetzt
+			</p>
+			<span
+				data-testid="replacing-name"
+				title={replacingRecipe.name}
+				style="display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-family: var(--font-display); font-size: 13px; text-decoration: line-through; opacity: 0.6; color: var(--color-text);"
+			>
+				{replacingRecipe.name}{#if replacingRecipe.meta} · {replacingRecipe.meta}{/if}
+			</span>
+		</div>
+	{/if}
+
 	<!-- Search -->
 	<div style="padding: 8px 12px; border-bottom: 1px solid var(--color-border);">
 		<input
@@ -147,7 +175,8 @@
 						type="button"
 						aria-label="Wählen"
 						onclick={() => onpick(suggestion.recipe.id, suggestion.recipe.name)}
-						style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
+						disabled={isDisabled}
+						style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: {isDisabled ? 'default' : 'pointer'}; opacity: {isDisabled ? '0.4' : '1'};"
 					>
 						+ Wählen
 					</button>
@@ -194,7 +223,8 @@
 						type="button"
 						aria-label="Wählen"
 						onclick={() => onpick(recipe.id, recipe.name)}
-						style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: pointer;"
+						disabled={isDisabled}
+						style="flex-shrink: 0; font-family: var(--font-sans); font-size: 10px; font-weight: 500; padding: 4px 8px; border-radius: var(--radius-md); background: var(--green-dark); color: #fff; border: none; cursor: {isDisabled ? 'default' : 'pointer'}; opacity: {isDisabled ? '0.4' : '1'};"
 					>
 						+ Wählen
 					</button>
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index 3036488..1100469 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -174,4 +174,40 @@ describe('RecipePicker', () => {
 		expect(screen.queryByTestId('suggestions-loading')).toBeNull();
 		expect(screen.getByText(/Empfohlen/i)).toBeTruthy();
 	});
+
+	it('shows Wird ersetzt banner when replacingRecipe is provided', () => {
+		render(RecipePicker, { props: { ...baseProps, replacingRecipe: { name: 'Pasta', meta: '20 Min · easy' } } });
+		expect(screen.getByText(/Wird ersetzt/i)).toBeTruthy();
+		expect(screen.getByTestId('replacing-name').textContent).toContain('Pasta');
+	});
+
+	it('hides Wird ersetzt banner when replacingRecipe is not provided', () => {
+		render(RecipePicker, { props: baseProps });
+		expect(screen.queryByText(/Wird ersetzt/i)).toBeNull();
+	});
+
+	it('excludes recipe from Alle Rezepte when excludeRecipeId is set', () => {
+		render(RecipePicker, { props: { ...baseProps, excludeRecipeId: 'r2' } });
+		expect(screen.queryByText('Spaghetti Carbonara')).toBeNull();
+		expect(screen.getByText('Beef Bourguignon')).toBeTruthy();
+		expect(screen.getByText('Tomatensuppe')).toBeTruthy();
+	});
+
+	it('excludes recipe from Empfohlen when excludeRecipeId matches a positive-delta suggestion', () => {
+		// s1 (Lachsfilet, scoreDelta=1.5) would normally appear in Empfohlen
+		render(RecipePicker, { props: { ...baseProps, excludeRecipeId: 's1' } });
+		expect(screen.queryByText('Lachsfilet')).toBeNull();
+	});
+
+	it('disables Wählen buttons when isDisabled is true', () => {
+		render(RecipePicker, { props: { ...baseProps, isDisabled: true } });
+		const buttons = screen.getAllByRole('button', { name: /Wählen/i });
+		buttons.forEach((btn) => expect((btn as HTMLButtonElement).disabled).toBe(true));
+	});
+
+	it('enables Wählen buttons when isDisabled is false', () => {
+		render(RecipePicker, { props: { ...baseProps, isDisabled: false } });
+		const buttons = screen.getAllByRole('button', { name: /Wählen/i });
+		buttons.forEach((btn) => expect((btn as HTMLButtonElement).disabled).toBe(false));
+	});
 });
diff --git a/frontend/src/routes/(app)/planner/+page.svelte b/frontend/src/routes/(app)/planner/+page.svelte
index 5fa8284..0070032 100644
--- a/frontend/src/routes/(app)/planner/+page.svelte
+++ b/frontend/src/routes/(app)/planner/+page.svelte
@@ -66,6 +66,7 @@
 
 	const activePickerDate = $derived(
 		pickerOpen ? selectedDay
+		: swapSheetOpen ? selectedDay
 		: panelState.kind === 'recipe-picker' ? panelState.date
 		: null
 	);
@@ -357,18 +358,18 @@
 			selectedSlot.recipe?.cookTimeMin ? `${selectedSlot.recipe.cookTimeMin} Min` : null,
 			selectedSlot.recipe?.effort ?? null
 		].filter(Boolean).join(' · ')}
-		<div style="padding: 16px;">
-			<SwapSuggestionList
-				replacingName={selectedSlot.recipe?.name ?? ''}
-				replacingMeta={replacingMeta || undefined}
-				recipes={sortedRecipes}
-				{currentWeekRecipeIds}
-				excludeRecipeId={selectedSlot.recipe?.id}
-				isLoading={swapLoading}
-				onpick={handleSwapPick}
-				oncancel={() => (swapSheetOpen = false)}
-			/>
-		</div>
+		<RecipePicker
+			planId={weekPlan?.id ?? ''}
+			date={selectedDay}
+			dateLabel={formatDayLabel(selectedDay)}
+			suggestions={suggestions}
+			allRecipes={data.recipes}
+			isLoading={isLoadingSuggestions}
+			isDisabled={swapLoading}
+			excludeRecipeId={selectedSlot.recipe?.id}
+			replacingRecipe={selectedSlot.recipe ? { name: selectedSlot.recipe.name, meta: replacingMeta || undefined } : undefined}
+			onpick={handleSwapPick}
+		/>
 	</BottomSheet>
 </div>
 
@@ -607,13 +608,16 @@
 						pickerSlot.recipe.cookTimeMin ? `${pickerSlot.recipe.cookTimeMin} Min` : null,
 						pickerSlot.recipe.effort ?? null
 					].filter(Boolean).join(' · ')}
-					<div class="flex-1 overflow-y-auto -mx-4 -mb-4 px-4">
-						<SwapSuggestionList
-							replacingName={pickerSlot.recipe.name}
-							replacingMeta={replacingMeta || undefined}
-							recipes={sortedRecipes}
-							{currentWeekRecipeIds}
+					<div class="flex-1 overflow-y-auto -mx-4 -mb-4">
+						<RecipePicker
+							planId={weekPlan?.id ?? ''}
+							date={pickerDate}
+							dateLabel={formatDayLabel(pickerDate)}
+							suggestions={suggestions}
+							allRecipes={data.recipes}
+							isLoading={isLoadingSuggestions}
 							excludeRecipeId={pickerSlot.recipe.id}
+							replacingRecipe={{ name: pickerSlot.recipe.name, meta: replacingMeta || undefined }}
 							onpick={handleRecipePick}
 						/>
 					</div>
-- 
2.49.1


From 148f6a7b5b490dd94ae1f0d552dfa122449b0cd4 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 15:01:37 +0200
Subject: [PATCH 25/30] refactor(planner): remove dead SwapSuggestionList
 import and sortedRecipes derived

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/routes/(app)/planner/+page.svelte | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/frontend/src/routes/(app)/planner/+page.svelte b/frontend/src/routes/(app)/planner/+page.svelte
index 0070032..a64bccd 100644
--- a/frontend/src/routes/(app)/planner/+page.svelte
+++ b/frontend/src/routes/(app)/planner/+page.svelte
@@ -7,10 +7,9 @@
 	import DayMealCard from '$lib/planner/DayMealCard.svelte';
 	import RecipePicker from '$lib/planner/RecipePicker.svelte';
 	import MealActionSheet from '$lib/planner/MealActionSheet.svelte';
-	import SwapSuggestionList from '$lib/planner/SwapSuggestionList.svelte';
 	import BottomSheet from '$lib/components/BottomSheet.svelte';
 	import UndoBar from '$lib/planner/UndoBar.svelte';
-	import { prevWeek, nextWeek, getWeekStart, weekDays, formatDayLabel, formatDayAbbr, formatWeekRange, sortEasiestFirst } from '$lib/planner/week';
+	import { prevWeek, nextWeek, getWeekStart, weekDays, formatDayLabel, formatDayAbbr, formatWeekRange } from '$lib/planner/week';
 	import type { Suggestion } from '$lib/planner/types';
 
 	let { data, form = null }: { data: { weekPlan: any; varietyScore: any; weekStart: string; recipes: any[] }; form?: any } = $props();
@@ -79,9 +78,6 @@
 		new Set<string>(slots.filter((s: any) => s.recipe?.id).map((s: any) => s.recipe.id))
 	);
 
-	// Recipes sorted easiest-first for the swap suggestion list
-	let sortedRecipes = $derived(sortEasiestFirst(data.recipes));
-
 	// Hidden form field bindings
 	let addPlanId = $state('');
 	let addSlotDate = $state('');
-- 
2.49.1


From 16162d80f45ff0abee49853395ff40d684a549b3 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 15:02:07 +0200
Subject: [PATCH 26/30] refactor(planner): delete orphaned SwapSuggestionList
 component and tests

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../src/lib/planner/SwapSuggestionList.svelte | 126 ------------------
 .../lib/planner/SwapSuggestionList.test.ts    | 120 -----------------
 2 files changed, 246 deletions(-)
 delete mode 100644 frontend/src/lib/planner/SwapSuggestionList.svelte
 delete mode 100644 frontend/src/lib/planner/SwapSuggestionList.test.ts

diff --git a/frontend/src/lib/planner/SwapSuggestionList.svelte b/frontend/src/lib/planner/SwapSuggestionList.svelte
deleted file mode 100644
index 98ee619..0000000
--- a/frontend/src/lib/planner/SwapSuggestionList.svelte
+++ /dev/null
@@ -1,126 +0,0 @@
-<script lang="ts">
-	interface Recipe {
-		id: string;
-		name: string;
-		effort?: string | null;
-		cookTimeMin?: number | null;
-	}
-
-	let {
-		replacingName,
-		replacingMeta,
-		recipes,
-		currentWeekRecipeIds,
-		excludeRecipeId,
-		isLoading = false,
-		onpick,
-		oncancel
-	}: {
-		replacingName: string;
-		replacingMeta?: string;
-		recipes: Recipe[];
-		currentWeekRecipeIds: Set<string>;
-		excludeRecipeId?: string;
-		isLoading?: boolean;
-		onpick: (recipeId: string, recipeName: string) => void;
-		oncancel?: () => void;
-	} = $props();
-
-	let visibleRecipes = $derived(
-		excludeRecipeId ? recipes.filter((r) => r.id !== excludeRecipeId) : recipes
-	);
-
-	function recipeMeta(recipe: Recipe): string {
-		return [
-			recipe.cookTimeMin != null ? `${recipe.cookTimeMin} min` : null,
-			recipe.effort ?? null
-		]
-			.filter(Boolean)
-			.join(' · ');
-	}
-</script>
-
-<!-- Replacing banner -->
-<div
-	style="background: var(--orange-tint); border: 1px solid #FBCDA4; border-radius: var(--radius-lg); padding: 10px 12px; margin-bottom: 14px;"
->
-	<p
-		style="font-size: 10px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--orange-dark); margin: 0 0 4px 0; font-family: var(--font-sans);"
-	>
-		Wird ersetzt
-	</p>
-	<span
-		data-testid="replacing-name"
-		title={replacingName}
-		style="display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-family: var(--font-display); font-size: 14px; text-decoration: line-through; opacity: 0.6; color: var(--color-text);"
-	>
-		{replacingName}{#if replacingMeta} · {replacingMeta}{/if}
-	</span>
-</div>
-
-<!-- Eyebrow label -->
-<p
-	style="font-size: 10px; font-weight: 500; letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-muted); margin: 0 0 6px 0; font-family: var(--font-sans);"
->
-	Ersetzen durch (einfachste zuerst)
-</p>
-
-<!-- Recipe list -->
-{#if visibleRecipes.length === 0}
-	<p
-		data-testid="swap-empty-state"
-		style="text-align: center; color: var(--color-text-muted); font-family: var(--font-sans); margin: 0;"
-	>
-		Keine Rezepte verfügbar.
-	</p>
-{:else}
-	{#each visibleRecipes as recipe (recipe.id)}
-		{@const meta = recipeMeta(recipe)}
-		{@const alreadyPlanned = currentWeekRecipeIds.has(recipe.id)}
-		<div
-			style="background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-lg); padding: 10px 12px; margin-bottom: 6px; display: flex; align-items: center; gap: 8px;"
-		>
-			<div style="flex: 1; min-width: 0;">
-				<p
-					style="font-family: var(--font-display); font-size: 13px; color: var(--color-text); margin: 0;"
-				>
-					{recipe.name}
-				</p>
-				{#if meta}
-					<p
-						style="font-size: 9px; color: var(--color-text-muted); font-family: var(--font-sans); margin: 1px 0 0;"
-					>
-						{meta}
-					</p>
-				{/if}
-				{#if alreadyPlanned}
-					<p
-						data-testid="already-planned-{recipe.id}"
-						style="font-size: 9px; color: var(--yellow-text); font-family: var(--font-sans); margin: 1px 0 0;"
-					>
-						⚠ Bereits diese Woche
-					</p>
-				{/if}
-			</div>
-			<button
-				type="button"
-				onclick={() => onpick(recipe.id, recipe.name)}
-				disabled={isLoading}
-				style="background: none; border: none; cursor: {isLoading ? 'default' : 'pointer'}; font-size: 11px; font-weight: 500; color: var(--green); font-family: var(--font-sans); flex-shrink: 0; opacity: {isLoading ? '0.4' : '1'};"
-			>
-				Wählen
-			</button>
-		</div>
-	{/each}
-{/if}
-
-<!-- Cancel button (optional) -->
-{#if oncancel}
-	<button
-		type="button"
-		onclick={oncancel}
-		style="width: 100%; background: none; border: none; cursor: pointer; color: var(--color-text-muted); font-size: 13px; text-align: center; padding: 8px 0; font-family: var(--font-sans);"
-	>
-		Abbrechen
-	</button>
-{/if}
diff --git a/frontend/src/lib/planner/SwapSuggestionList.test.ts b/frontend/src/lib/planner/SwapSuggestionList.test.ts
deleted file mode 100644
index 755f2cd..0000000
--- a/frontend/src/lib/planner/SwapSuggestionList.test.ts
+++ /dev/null
@@ -1,120 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-import { render, screen } from '@testing-library/svelte';
-import { userEvent } from '@testing-library/user-event';
-import SwapSuggestionList from './SwapSuggestionList.svelte';
-
-const recipes = [
-	{ id: 'r1', name: 'Quick carbonara', effort: 'easy', cookTimeMin: 20 },
-	{ id: 'r2', name: 'Chicken stir-fry', effort: 'easy', cookTimeMin: 25 },
-	{ id: 'r3', name: 'Mushroom risotto', effort: 'medium', cookTimeMin: 50 }
-];
-
-const baseProps = {
-	replacingName: 'Tomato pasta',
-	replacingMeta: '45 min · Easy',
-	recipes,
-	currentWeekRecipeIds: new Set<string>(),
-	onpick: vi.fn()
-};
-
-describe('SwapSuggestionList', () => {
-	it('renders the Replacing banner', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		expect(screen.getByText(/Wird ersetzt/i)).toBeTruthy();
-	});
-
-	it('renders old meal name with strikethrough', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		const struck = screen.getByTestId('replacing-name');
-		expect(struck.textContent).toContain('Tomato pasta');
-		expect(getComputedStyle(struck).textDecoration || struck.style.textDecoration).toContain('line-through');
-	});
-
-	it('replacing-name span has title attribute for full name', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		const struck = screen.getByTestId('replacing-name');
-		expect(struck.getAttribute('title')).toBe('Tomato pasta');
-	});
-
-	it('renders the easiest-first eyebrow label', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		expect(screen.getByText(/einfachste zuerst/i)).toBeTruthy();
-	});
-
-	it('renders all recipe names', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		expect(screen.getByText('Quick carbonara')).toBeTruthy();
-		expect(screen.getByText('Chicken stir-fry')).toBeTruthy();
-		expect(screen.getByText('Mushroom risotto')).toBeTruthy();
-	});
-
-	it('clicking Wählen calls onpick with recipeId and name', async () => {
-		const onpick = vi.fn();
-		const user = userEvent.setup();
-		render(SwapSuggestionList, { props: { ...baseProps, onpick } });
-		const buttons = screen.getAllByRole('button', { name: /Wählen/i });
-		await user.click(buttons[0]);
-		expect(onpick).toHaveBeenCalledWith('r1', 'Quick carbonara');
-	});
-
-	it('shows already-planned warning for recipes in currentWeekRecipeIds', () => {
-		render(SwapSuggestionList, {
-			props: { ...baseProps, currentWeekRecipeIds: new Set(['r2']) }
-		});
-		expect(screen.getByTestId('already-planned-r2')).toBeTruthy();
-	});
-
-	it('does not show already-planned warning for recipes not in currentWeekRecipeIds', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		expect(screen.queryByTestId('already-planned-r1')).toBeNull();
-	});
-
-	it('shows empty state when no recipes', () => {
-		render(SwapSuggestionList, { props: { ...baseProps, recipes: [] } });
-		expect(screen.getByTestId('swap-empty-state')).toBeTruthy();
-	});
-
-	it('excludes the recipe being replaced when excludeRecipeId is provided', () => {
-		render(SwapSuggestionList, { props: { ...baseProps, excludeRecipeId: 'r2' } });
-		expect(screen.queryByText('Chicken stir-fry')).toBeNull();
-		expect(screen.getByText('Quick carbonara')).toBeTruthy();
-		expect(screen.getByText('Mushroom risotto')).toBeTruthy();
-	});
-
-	it('shows all recipes when excludeRecipeId is not provided', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		expect(screen.getByText('Quick carbonara')).toBeTruthy();
-		expect(screen.getByText('Chicken stir-fry')).toBeTruthy();
-		expect(screen.getByText('Mushroom risotto')).toBeTruthy();
-	});
-
-	it('disables all Wählen buttons when isLoading is true', () => {
-		render(SwapSuggestionList, { props: { ...baseProps, isLoading: true } });
-		const buttons = screen.getAllByRole('button', { name: /Wählen/i });
-		buttons.forEach((btn) => expect((btn as HTMLButtonElement).disabled).toBe(true));
-	});
-
-	it('Wählen buttons are enabled when isLoading is false', () => {
-		render(SwapSuggestionList, { props: { ...baseProps, isLoading: false } });
-		const buttons = screen.getAllByRole('button', { name: /Wählen/i });
-		buttons.forEach((btn) => expect((btn as HTMLButtonElement).disabled).toBe(false));
-	});
-
-	it('renders optional Abbrechen button when oncancel provided', () => {
-		render(SwapSuggestionList, { props: { ...baseProps, oncancel: vi.fn() } });
-		expect(screen.getByRole('button', { name: /Abbrechen/i })).toBeTruthy();
-	});
-
-	it('does not render Abbrechen button when oncancel not provided', () => {
-		render(SwapSuggestionList, { props: baseProps });
-		expect(screen.queryByRole('button', { name: /Abbrechen/i })).toBeNull();
-	});
-
-	it('clicking Abbrechen calls oncancel', async () => {
-		const oncancel = vi.fn();
-		const user = userEvent.setup();
-		render(SwapSuggestionList, { props: { ...baseProps, oncancel } });
-		await user.click(screen.getByRole('button', { name: /Abbrechen/i }));
-		expect(oncancel).toHaveBeenCalledOnce();
-	});
-});
-- 
2.49.1


From 7359eba9463ee88644cf06abead61ff1db95b2f2 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 15:02:56 +0200
Subject: [PATCH 27/30] feat(planner): hide RecipePicker inner header in swap
 context

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 20 ++++++++++---------
 frontend/src/lib/planner/RecipePicker.test.ts | 10 ++++++++++
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index 185f2bd..eef1074 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -88,15 +88,17 @@
 {/snippet}
 
 <div style="background: var(--color-page); font-family: var(--font-sans);">
-	<!-- Header -->
-	<div style="padding: 10px 12px 6px; border-bottom: 1px solid var(--color-border);">
-		<p style="font-family: var(--font-display); font-size: 14px; font-weight: 500; color: var(--color-text); margin: 0;">
-			Rezept wählen
-		</p>
-		<p style="font-size: 11px; color: var(--color-text-muted); margin: 2px 0 0;">
-			{dateLabel}
-		</p>
-	</div>
+	<!-- Header (hidden in swap context — the panel/sheet title already provides context) -->
+	{#if !replacingRecipe}
+		<div style="padding: 10px 12px 6px; border-bottom: 1px solid var(--color-border);">
+			<p style="font-family: var(--font-display); font-size: 14px; font-weight: 500; color: var(--color-text); margin: 0;">
+				Rezept wählen
+			</p>
+			<p style="font-size: 11px; color: var(--color-text-muted); margin: 2px 0 0;">
+				{dateLabel}
+			</p>
+		</div>
+	{/if}
 
 	<!-- Wird ersetzt banner (swap context) -->
 	{#if replacingRecipe}
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index 1100469..f323541 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -186,6 +186,16 @@ describe('RecipePicker', () => {
 		expect(screen.queryByText(/Wird ersetzt/i)).toBeNull();
 	});
 
+	it('hides Rezept wählen header when replacingRecipe is set', () => {
+		render(RecipePicker, { props: { ...baseProps, replacingRecipe: { name: 'Pasta' } } });
+		expect(screen.queryByText(/Rezept wählen/i)).toBeNull();
+	});
+
+	it('shows Rezept wählen header when replacingRecipe is not set', () => {
+		render(RecipePicker, { props: baseProps });
+		expect(screen.getByText(/Rezept wählen/i)).toBeTruthy();
+	});
+
 	it('excludes recipe from Alle Rezepte when excludeRecipeId is set', () => {
 		render(RecipePicker, { props: { ...baseProps, excludeRecipeId: 'r2' } });
 		expect(screen.queryByText('Spaghetti Carbonara')).toBeNull();
-- 
2.49.1


From 813ddf8214ca28838fd59524a873a3f4061c0c76 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 15:03:39 +0200
Subject: [PATCH 28/30] feat(planner): change neutral badge copy to Kein
 Einfluss

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 frontend/src/lib/planner/RecipePicker.svelte  | 2 +-
 frontend/src/lib/planner/RecipePicker.test.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/src/lib/planner/RecipePicker.svelte b/frontend/src/lib/planner/RecipePicker.svelte
index eef1074..e55de14 100644
--- a/frontend/src/lib/planner/RecipePicker.svelte
+++ b/frontend/src/lib/planner/RecipePicker.svelte
@@ -82,7 +82,7 @@
 			data-type="neutral"
 			style="display: inline-block; margin-top: 3px; font-size: 9px; font-weight: 500; padding: 1px 5px; border-radius: 3px; background: var(--yellow-tint); color: var(--yellow-text);"
 		>
-			= {delta.toFixed(1)} Punkte
+			Kein Einfluss
 		</span>
 	{/if}
 {/snippet}
diff --git a/frontend/src/lib/planner/RecipePicker.test.ts b/frontend/src/lib/planner/RecipePicker.test.ts
index f323541..8b513d8 100644
--- a/frontend/src/lib/planner/RecipePicker.test.ts
+++ b/frontend/src/lib/planner/RecipePicker.test.ts
@@ -115,7 +115,7 @@ describe('RecipePicker', () => {
 		const alleRezepte = screen.getByTestId('alle-rezepte-section');
 		const badge = within(alleRezepte).getByTestId('badge-r1');
 		expect(badge.getAttribute('data-type')).toBe('neutral');
-		expect(badge.textContent).toContain('0.0');
+		expect(badge.textContent).toContain('Kein Einfluss');
 	});
 
 	it('Empfohlen shows only positive-delta suggestions, capped at 5', () => {
-- 
2.49.1


From 49ed75a989c77361c6f292667473a4f548dab5f8 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 15:04:20 +0200
Subject: [PATCH 29/30] test(planner): verify mobile swap sheet triggers
 suggestion fetch

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../src/routes/(app)/planner/page.test.ts     | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/frontend/src/routes/(app)/planner/page.test.ts b/frontend/src/routes/(app)/planner/page.test.ts
index fb2d181..674d96b 100644
--- a/frontend/src/routes/(app)/planner/page.test.ts
+++ b/frontend/src/routes/(app)/planner/page.test.ts
@@ -93,6 +93,26 @@ describe('+page.svelte — $effect suggestion fetch', () => {
 	});
 });
 
+describe('+page.svelte — swap sheet suggestion fetch', () => {
+	afterEach(() => {
+		vi.restoreAllMocks();
+	});
+
+	it('opening mobile swap sheet triggers fetch with planId and date', async () => {
+		vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ json: () => Promise.resolve({ suggestions: [] }) }));
+
+		render(Page, { props: { data: mockDataWithSlot } });
+
+		// Open action sheet, then swap sheet
+		await userEvent.click(screen.getByTestId('day-meal-card'));
+		await userEvent.click(await screen.findByRole('button', { name: /Gericht tauschen/i }));
+
+		await waitFor(() => expect(fetch).toHaveBeenCalledTimes(1));
+		expect((fetch as any).mock.calls[0][0]).toContain(`planId=${PLAN_ID}`);
+		expect((fetch as any).mock.calls[0][0]).toContain(`date=${DATE}`);
+	});
+});
+
 describe('+page.svelte — remove meal', () => {
 	afterEach(() => {
 		vi.restoreAllMocks();
-- 
2.49.1


From 116e400a91d58ac5bd774802511cd43ffc4a7370 Mon Sep 17 00:00:00 2001
From: Marcel Raddatz <marcel@raddatz.cloud>
Date: Thu, 9 Apr 2026 15:08:49 +0200
Subject: [PATCH 30/30] refactor(planning): extract applyPenalties helper to
 unify score formula

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../recipeapp/planning/PlanningService.java   | 29 +++++++------------
 1 file changed, 10 insertions(+), 19 deletions(-)

diff --git a/backend/src/main/java/com/recipeapp/planning/PlanningService.java b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
index aeff635..4a4ae85 100644
--- a/backend/src/main/java/com/recipeapp/planning/PlanningService.java
+++ b/backend/src/main/java/com/recipeapp/planning/PlanningService.java
@@ -216,10 +216,6 @@ public class PlanningService {
     private double scoreFromSimulatedSlots(List<SimulatedSlot> slots, VarietyScoreConfig config,
                                             Set<UUID> recentlyCookedIds) {
         List<String> checkedTagTypes = config.getRepeatTagTypes();
-        double wTagRepeat = config.getWTagRepeat().doubleValue();
-        double wIngredientOverlap = config.getWIngredientOverlap().doubleValue();
-        double wRecentRepeat = config.getWRecentRepeat().doubleValue();
-        double wPlanDuplicate = config.getWPlanDuplicate().doubleValue();
 
         // 1. Tag-type repeats on consecutive days
         Map<String, List<LocalDate>> tagDays = new LinkedHashMap<>();
@@ -259,11 +255,16 @@ public class PlanningService {
                 .mapToLong(c -> c - 1)
                 .sum();
 
+        return applyPenalties(tagRepeatCount, ingredientOverlapCount, recentRepeatCount, duplicatePenaltyCount, config);
+    }
+
+    private double applyPenalties(long tagRepeats, long ingredientOverlaps, long recentRepeats,
+                                  long duplicates, VarietyScoreConfig config) {
         double score = MAX_VARIETY_SCORE;
-        score -= tagRepeatCount * wTagRepeat;
-        score -= ingredientOverlapCount * wIngredientOverlap;
-        score -= recentRepeatCount * wRecentRepeat;
-        score -= duplicatePenaltyCount * wPlanDuplicate;
+        score -= tagRepeats * config.getWTagRepeat().doubleValue();
+        score -= ingredientOverlaps * config.getWIngredientOverlap().doubleValue();
+        score -= recentRepeats * config.getWRecentRepeat().doubleValue();
+        score -= duplicates * config.getWPlanDuplicate().doubleValue();
         return Math.max(0, Math.min(MAX_VARIETY_SCORE, score));
     }
 
@@ -281,10 +282,6 @@ public class PlanningService {
                 .orElse(VarietyScoreConfig.defaults(plan.getHousehold()));
 
         List<String> checkedTagTypes = config.getRepeatTagTypes();
-        double wTagRepeat = config.getWTagRepeat().doubleValue();
-        double wIngredientOverlap = config.getWIngredientOverlap().doubleValue();
-        double wRecentRepeat = config.getWRecentRepeat().doubleValue();
-        double wPlanDuplicate = config.getWPlanDuplicate().doubleValue();
         int historyDays = config.getHistoryDays();
 
         // 1. Tag-type repeats on consecutive days
@@ -352,13 +349,7 @@ public class PlanningService {
             }
         }
 
-        // Calculate score
-        double score = MAX_VARIETY_SCORE;
-        score -= tagRepeats.size() * wTagRepeat;
-        score -= overlaps.size() * wIngredientOverlap;
-        score -= recentRepeats.size() * wRecentRepeat;
-        score -= duplicatePenaltyCount * wPlanDuplicate;
-        score = Math.max(0, Math.min(MAX_VARIETY_SCORE, score));
+        double score = applyPenalties(tagRepeats.size(), overlaps.size(), recentRepeats.size(), duplicatePenaltyCount, config);
 
         return new VarietyScoreResponse(score, tagRepeats, overlaps, recentRepeats, duplicatesInPlan);
     }
-- 
2.49.1