From cfe625894d631c0fe0784664f26c78a95e4a6a21 Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sat, 19 Jul 2025 16:58:22 +0200
Subject: [PATCH 01/14] feat(tree): add tree_species table and display
 description on tree detail page

---
 frontend/src/lib/supabase/trees.ts            | 15 ++++++++
 .../src/routes/trees/[treeId]/+page.svelte    | 36 ++++++++++++++-----
 .../20250719141821_create_tree_species.sql    | 13 +++++++
 3 files changed, 56 insertions(+), 8 deletions(-)
 create mode 100644 supabase/migrations/20250719141821_create_tree_species.sql

diff --git a/frontend/src/lib/supabase/trees.ts b/frontend/src/lib/supabase/trees.ts
index 579daf8..ad43f8a 100644
--- a/frontend/src/lib/supabase/trees.ts
+++ b/frontend/src/lib/supabase/trees.ts
@@ -37,4 +37,19 @@ export async function loadSpeciesMap(treeIds: string[]): Promise<Map<string, str
 	);
 
 	return speciesMap;
+}
+
+export async function getTreeSpeciesDescription(treeTypeBotanic: string) {
+	const { data, error } = await supabase
+		.from('tree_species')
+		.select('description')
+		.eq('tree_type_botanic', treeTypeBotanic)
+		.maybeSingle();
+
+	if (error) {
+		console.error('Failed to load species description:', error.message);
+		return null;
+	}
+
+	return data?.description ?? null;
 }
\ No newline at end of file
diff --git a/frontend/src/routes/trees/[treeId]/+page.svelte b/frontend/src/routes/trees/[treeId]/+page.svelte
index 4b75bad..35e0b68 100644
--- a/frontend/src/routes/trees/[treeId]/+page.svelte
+++ b/frontend/src/routes/trees/[treeId]/+page.svelte
@@ -1,8 +1,10 @@
 <script lang="ts">
 	import { page } from '$app/stores';
 	import { supabase } from '$lib/supabase';
+	import { onMount } from 'svelte';
 
 	import type { TreeData } from '$types/tree';
+	import { getTreeSpeciesDescription } from '$lib/supabase';
 
 	import { Accordion } from '$components/ui';
 	import type AccordionType from '$components/ui/Accordion.svelte';
@@ -20,22 +22,35 @@
 	let openAbout = true;
 	let openWater = false;
 	let openHistory = false;
+	let treeDescription: string | null = null;
 
 	$: showInfo = activeTabIndex === 0;
 	$: showChat = activeTabIndex === 1;
 
 	let tree: TreeData;
 
+	async function loadTree(treeId: string) {
+		const { data: treeData, error } = await supabase
+			.from('trees')
+			.select()
+			.eq('uuid', treeId)
+			.maybeSingle();
+
+		if (error) {
+			console.error('Fehler beim Laden des Baums:', error.message);
+			return;
+		}
+
+		tree = treeData;
+
+		if (tree) {
+			treeDescription = await getTreeSpeciesDescription(tree.tree_type_botanic);
+		}
+	}
+
 	// Lädt den Baum neu, sobald sich die treeId in der URL ändert
 	$: if ($page.params.treeId) {
-		(async () => {
-			const { data } = await supabase
-				.from('trees')
-				.select()
-				.eq('uuid', $page.params.treeId)
-				.maybeSingle();
-			tree = data;
-		})();
+		loadTree($page.params.treeId);
 	}
 </script>
 
@@ -88,6 +103,11 @@
 							<p class="text-black font-bold">🌳 Über diesen Baum</p>
 						</div>
 						<div slot="details">
+							<p class="text-sm text-gray-800">
+								{treeDescription
+									? treeDescription
+									: 'Hej, wie mein Name schon verrät komme ich ursprünglich aus dem Norden von Europa. …'}
+							</p>
 							<div class="grid grid-cols-1 sm:grid-cols-3 gap-4 text-sm text-gray-800">
 								<TreeMetric label="Höhe" value={tree.height} unit="m" max={39} position="right" />
 								<TreeMetric
diff --git a/supabase/migrations/20250719141821_create_tree_species.sql b/supabase/migrations/20250719141821_create_tree_species.sql
new file mode 100644
index 0000000..ca141ee
--- /dev/null
+++ b/supabase/migrations/20250719141821_create_tree_species.sql
@@ -0,0 +1,13 @@
+-- Tabelle zur Beschreibung von Baumarten (botanisch: "species")
+create table public.tree_species (
+  id bigint generated by default as identity primary key,
+  created_at timestamp with time zone not null default now(),
+
+  -- Botanischer Name, identisch zu `tree_type_botanic` aus der `trees`-Tabelle
+  tree_type_botanic varchar not null,
+
+  description text
+);
+
+-- Jede Art darf nur einmal vorkommen
+create unique index on public.tree_species (tree_type_botanic);

From 442beb0e0fe44c023b91a9d1aed1db6715c6749c Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sat, 19 Jul 2025 17:04:21 +0200
Subject: [PATCH 02/14] refactor: extract tree loading logic and clean up
 imports

---
 frontend/src/lib/supabase/trees.ts            | 18 ++++++++++++
 .../src/routes/trees/[treeId]/+page.svelte    | 28 ++++++-------------
 2 files changed, 27 insertions(+), 19 deletions(-)

diff --git a/frontend/src/lib/supabase/trees.ts b/frontend/src/lib/supabase/trees.ts
index ad43f8a..67784d8 100644
--- a/frontend/src/lib/supabase/trees.ts
+++ b/frontend/src/lib/supabase/trees.ts
@@ -52,4 +52,22 @@ export async function getTreeSpeciesDescription(treeTypeBotanic: string) {
 	}
 
 	return data?.description ?? null;
+}
+
+/**
+ * Holt alle Baumdaten für eine bestimmte UUID aus der trees-Tabelle.
+ */
+export async function getTreeById(treeId: string) {
+	const { data, error } = await supabase
+		.from('trees')
+		.select()
+		.eq('uuid', treeId)
+		.maybeSingle();
+
+	if (error) {
+		console.error('Failed to load tree:', error.message);
+		return null;
+	}
+
+	return data;
 }
\ No newline at end of file
diff --git a/frontend/src/routes/trees/[treeId]/+page.svelte b/frontend/src/routes/trees/[treeId]/+page.svelte
index 35e0b68..c3d3b1b 100644
--- a/frontend/src/routes/trees/[treeId]/+page.svelte
+++ b/frontend/src/routes/trees/[treeId]/+page.svelte
@@ -1,18 +1,19 @@
 <script lang="ts">
+	// SvelteKit stores
 	import { page } from '$app/stores';
-	import { supabase } from '$lib/supabase';
-	import { onMount } from 'svelte';
 
+	// Typen
 	import type { TreeData } from '$types/tree';
-	import { getTreeSpeciesDescription } from '$lib/supabase';
-
-	import { Accordion } from '$components/ui';
 	import type AccordionType from '$components/ui/Accordion.svelte';
 
+	// Supabase-Funktionen
+	import { getTreeById, getTreeSpeciesDescription } from '$lib/supabase';
+
+	// Komponenten
+	import { Accordion, Notice } from '$components/ui';
 	import { DialogPanel } from '$components/overlay';
 	import { Chat } from '$components/chat';
 	import { AdoptTreeButton, WaterTreeButton, TreeMetric, TreeWaterings } from '$components/trees';
-	import Notice from '$components/ui/Notice.svelte';
 
 	export let activeTabIndex = 0;
 	const handleTabChange = (tab: number) => (activeTabIndex = tab);
@@ -30,25 +31,14 @@
 	let tree: TreeData;
 
 	async function loadTree(treeId: string) {
-		const { data: treeData, error } = await supabase
-			.from('trees')
-			.select()
-			.eq('uuid', treeId)
-			.maybeSingle();
-
-		if (error) {
-			console.error('Fehler beim Laden des Baums:', error.message);
-			return;
-		}
-
-		tree = treeData;
+		tree = await getTreeById(treeId);
 
 		if (tree) {
 			treeDescription = await getTreeSpeciesDescription(tree.tree_type_botanic);
 		}
 	}
 
-	// Lädt den Baum neu, sobald sich die treeId in der URL ändert
+	// Reloads the tree whenever the treeId in the URL changes
 	$: if ($page.params.treeId) {
 		loadTree($page.params.treeId);
 	}

From 6b73c5dc96bd1e3a9d7b654f545ad637282bace5 Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sat, 19 Jul 2025 17:15:27 +0200
Subject: [PATCH 03/14] feat(tree): add accordion for urban climate impact
 section

---
 frontend/src/routes/trees/[treeId]/+page.svelte | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/frontend/src/routes/trees/[treeId]/+page.svelte b/frontend/src/routes/trees/[treeId]/+page.svelte
index c3d3b1b..e03772d 100644
--- a/frontend/src/routes/trees/[treeId]/+page.svelte
+++ b/frontend/src/routes/trees/[treeId]/+page.svelte
@@ -23,6 +23,7 @@
 	let openAbout = true;
 	let openWater = false;
 	let openHistory = false;
+	let openEnvironment = false;
 	let treeDescription: string | null = null;
 
 	$: showInfo = activeTabIndex === 0;
@@ -118,6 +119,19 @@
 						</div>
 					</Accordion>
 					<hr />
+					<Accordion bind:open={openEnvironment}>
+						<div slot="head">
+							<p class="text-black font-bold">🏙️ Wirkung auf das Stadtklima</p>
+						</div>
+						<div slot="details">
+							<Notice tone="info">
+								Dieser Baum beeinflusst seine Umgebung positiv: Er spendet Schatten, reguliert das
+								Mikroklima, verbessert die Luftqualität und bietet Lebensraum für Tiere und
+								Insekten. Weitere Informationen folgen in einem späteren Update.
+							</Notice>
+						</div>
+					</Accordion>
+					<hr />
 					<Accordion bind:open={openWater}>
 						<div slot="head">
 							<p class="text-black font-bold">💦 Wasserbedarf</p>

From 23df6e77b8f5d006bb3cd1641750dd49702da32d Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sat, 19 Jul 2025 17:27:58 +0200
Subject: [PATCH 04/14] feat: add sync_species_metadata.py to import or update
 tree species descriptions

---
 preparation/sync_species_metadata.py | 36 ++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 preparation/sync_species_metadata.py

diff --git a/preparation/sync_species_metadata.py b/preparation/sync_species_metadata.py
new file mode 100644
index 0000000..db3b272
--- /dev/null
+++ b/preparation/sync_species_metadata.py
@@ -0,0 +1,36 @@
+import os
+import sys
+import yaml
+import json
+from supabase import create_client, Client
+from utils.env import load_env
+
+load_env()
+
+url = os.environ.get("VITE_SUPABASE_URL")
+key = os.environ.get("SUPABASE_SERVICE_ROLE_KEY")
+
+if not url or not key:
+    raise ValueError("VITE_SUPABASE_URL und SUPABASE_SERVICE_ROLE_KEY müssen gesetzt sein")
+
+supabase: Client = create_client(url, key)
+
+if len(sys.argv) != 2:
+    raise ValueError("Usage: python import_species.py <path_to_file.yaml|json>")
+
+path_to_file = sys.argv[1]
+
+# 🌐 Datendatei laden
+with open(path_to_file, encoding="utf-8") as f:
+    if path_to_file.endswith((".yaml", ".yml")):
+        if not yaml:
+            raise ImportError("PyYAML is not installed. Run: pip install pyyaml")
+        data = yaml.safe_load(f)
+    elif path_to_file.endswith(".json"):
+        data = json.load(f)
+    else:
+        raise ValueError("File must be .yaml, .yml or .json")
+
+# 📥 Daten in Supabase schreiben
+for item in data:
+    supabase.table("tree_species").upsert(item, on_conflict="tree_type_botanic").execute()

From 3877937c8b443bc322b7fa9b16780efe774ef76a Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sat, 19 Jul 2025 21:22:43 +0200
Subject: [PATCH 05/14] refactor: extract description and metrics into separate
 components

---
 .../components/trees/TreeDescription.svelte   |  21 +++
 .../src/components/trees/TreeMetric.svelte    | 134 +++++++++++-------
 .../components/trees/TreeMetricsView.svelte   |  47 ++++++
 frontend/src/components/trees/index.ts        |   3 +-
 .../src/routes/trees/[treeId]/+page.svelte    |  45 +++---
 5 files changed, 176 insertions(+), 74 deletions(-)
 create mode 100644 frontend/src/components/trees/TreeDescription.svelte
 create mode 100644 frontend/src/components/trees/TreeMetricsView.svelte

diff --git a/frontend/src/components/trees/TreeDescription.svelte b/frontend/src/components/trees/TreeDescription.svelte
new file mode 100644
index 0000000..feacabd
--- /dev/null
+++ b/frontend/src/components/trees/TreeDescription.svelte
@@ -0,0 +1,21 @@
+<script lang="ts">
+	import { Notice, PanelSection } from '$components/ui';
+	import parseMarkdown from '$lib/utils/parseMarkdown';
+	export let description: string | null = null;
+
+	const defaultDescription =
+		'Hej, wie mein Name schon verrät komme ich ursprünglich aus dem Norden von Europa.<br><br>Ich bin **sehr variabel** in meinem Äußeren. Entweder wachse ich bis zu **15m** mit einem geraden Stamm, oder aber du findest mich als **mehrstämmigen großen Strauch**.';
+
+	let renderedDescription = '';
+
+	$: description,
+		(async () => {
+			renderedDescription = await parseMarkdown(description ?? defaultDescription);
+		})();
+</script>
+
+<PanelSection>
+	<Notice tone="info">
+		{@html renderedDescription}
+	</Notice>
+</PanelSection>
diff --git a/frontend/src/components/trees/TreeMetric.svelte b/frontend/src/components/trees/TreeMetric.svelte
index 6ae37e1..aad4dfa 100644
--- a/frontend/src/components/trees/TreeMetric.svelte
+++ b/frontend/src/components/trees/TreeMetric.svelte
@@ -8,56 +8,94 @@
 	$: percent = Math.min(100, Math.max(0, (value / max) * 100));
 </script>
 
-<div class="relative flex flex-col items-center p-3 text-center gap-2">
-	<!-- Baum-Icon mit Strich -->
-	<div class="relative w-14 h-14 text-green-600">
-		<svg
-			xmlns="http://www.w3.org/2000/svg"
-			viewBox="0 0 24 24"
-			fill="none"
-			class="w-full h-full"
-			stroke="currentColor"
-		>
-			<path
-				d="M12 22.25L12 15.25M12 10V14.25M12 15.25L14.5 12.75M12 15.25L12 14.25M12 14.25L9.75 12.5"
-				stroke-width="2"
-				stroke-linecap="round"
-				stroke-linejoin="round"
-			/>
-			<path
-				d="M17.9653 6.50909V6.53612L17.9667 6.56312C18.1359 9.68991 17.6603 12.6963 16.5425 14.8368C15.4492 16.9303 13.8005 18.1265 11.4806 17.9893C10.9592 17.9584 10.3515 17.6981 9.69557 17.1696C9.04588 16.6462 8.4103 15.9076 7.84918 15.0444C6.71093 13.2934 6 11.2225 6 9.76145C6 8.30523 6.70627 6.30887 7.83436 4.65928C8.3906 3.84589 9.01891 3.16298 9.65873 2.69222C10.3021 2.21888 10.9002 2 11.4215 2C12.8361 2 14.5348 2.46694 15.857 3.3114C17.1826 4.15805 17.9653 5.26409 17.9653 6.50909Z"
-				stroke-width="2"
-			/>
-		</svg>
-
-		{#if position === 'right'}
-			<!-- Vertikaler Balken rechts -->
-			<div class="absolute top-0 bottom-0 right-[-14px] w-[6px] bg-black/20 rounded">
-				<div
-					class="absolute bottom-0 left-0 w-full bg-green-600 rounded"
-					style="height: {percent}%;"
+<div class="snap-center shrink-0 w-52 sm:w-56 md:w-auto">
+	<div
+		class="relative grid grid-cols-2 items-center gap-4 p-4 rounded-xl border border-zinc-100 bg-white shadow-sm text-left"
+	>
+		<!-- Linke Spalte: Icon + Balken -->
+		<div class="relative flex justify-center items-center w-full h-14 text-green-600">
+			<svg
+				xmlns="http://www.w3.org/2000/svg"
+				viewBox="0 0 24 24"
+				fill="none"
+				class="w-full h-full animate-pulse-slow"
+				stroke="currentColor"
+			>
+				<path
+					d="M12 22.25L12 15.25M12 10V14.25M12 15.25L14.5 12.75M12 15.25L12 14.25M12 14.25L9.75 12.5"
+					stroke-width="2"
+					stroke-linecap="round"
+					stroke-linejoin="round"
 				/>
-			</div>
-		{:else if position === 'top'}
-			<!-- Horizontaler Balken oben -->
-			<div class="absolute top-[-12px] left-0 right-0 h-[6px] bg-black/20 rounded">
-				<div
-					class="absolute top-0 left-0 h-full bg-green-600 rounded"
-					style="width: {percent}%; left: {50 - percent / 2}%;"
+				<path
+					d="M17.9653 6.50909V6.53612L17.9667 6.56312C18.1359 9.68991 17.6603 12.6963 16.5425 14.8368C15.4492 16.9303 13.8005 18.1265 11.4806 17.9893C10.9592 17.9584 10.3515 17.6981 9.69557 17.1696C9.04588 16.6462 8.4103 15.9076 7.84918 15.0444C6.71093 13.2934 6 11.2225 6 9.76145C6 8.30523 6.70627 6.30887 7.83436 4.65928C8.3906 3.84589 9.01891 3.16298 9.65873 2.69222C10.3021 2.21888 10.9002 2 11.4215 2C12.8361 2 14.5348 2.46694 15.857 3.3114C17.1826 4.15805 17.9653 5.26409 17.9653 6.50909Z"
+					stroke-width="2"
+					stroke-linecap="round"
+					stroke-linejoin="round"
 				/>
-			</div>
-		{:else if position === 'bottom'}
-			<!-- Horizontaler Balken unten (nun volle Breite, wie oben) -->
-			<div class="absolute bottom-[-12px] left-0 right-0 h-[6px] bg-black/20 rounded">
+			</svg>
+
+			<!-- Fortschrittsbalken je nach Position -->
+			{#if position === 'right'}
+				<div class="absolute top-0 bottom-0 right-[10px] w-[5px] h-14 bg-gray-200 rounded">
+					<div
+						class="absolute bottom-0 left-0 w-full bg-green-600 rounded"
+						style="height: {percent}%;"
+					/>
+				</div>
+			{:else if position === 'top'}
 				<div
-					class="absolute top-0 left-0 h-full bg-green-600 rounded"
-					style="width: {percent}%; left: {50 - percent / 2}%;"
-				/>
-			</div>
-		{/if}
-	</div>
+					class="absolute top-[-10px] left-1/2 transform -translate-x-1/2 h-[5px] w-14 bg-gray-200 rounded"
+				>
+					<div
+						class="absolute top-0 left-0 h-full bg-green-600 rounded"
+						style="width: {percent}%; left: {50 - percent / 2}%;"
+					/>
+				</div>
+			{:else if position === 'bottom'}
+				<div
+					class="absolute bottom-[-10px] left-1/2 transform -translate-x-1/2 h-[5px] w-14 bg-gray-200 rounded"
+				>
+					<div
+						class="absolute top-0 left-0 h-full bg-green-600 rounded"
+						style="width: {percent}%; left: {50 - percent / 2}%;"
+					/>
+				</div>
+			{/if}
+		</div>
 
-	<!-- Label + Wert -->
-	<p class="mt-4 text-sm text-gray-600">{label}</p>
-	<p class="text-base font-semibold">{value} {unit}</p>
+		<!-- Rechte Spalte: Text -->
+		<div class="flex flex-col items-center justify-center text-center w-full">
+			<p class="text-sm text-gray-600 leading-tight">
+				{#if label === 'Kronendurchmesser'}
+					Kronen-<br />durchmesser
+				{:else if label === 'Stammdurchmesser'}
+					Stamm-<br />durchmesser
+				{:else}
+					{label}
+				{/if}
+			</p>
+			<p class="text-base font-semibold text-gray-900 mt-1">
+				{value}
+				{unit}
+			</p>
+		</div>
+	</div>
 </div>
+
+<style>
+	@keyframes pulseSlow {
+		0%,
+		100% {
+			transform: scale(1);
+			opacity: 1;
+		}
+		50% {
+			transform: scale(1.06);
+			opacity: 0.85;
+		}
+	}
+	.animate-pulse-slow {
+		animation: pulseSlow 3s ease-in-out infinite;
+	}
+</style>
diff --git a/frontend/src/components/trees/TreeMetricsView.svelte b/frontend/src/components/trees/TreeMetricsView.svelte
new file mode 100644
index 0000000..b3e1873
--- /dev/null
+++ b/frontend/src/components/trees/TreeMetricsView.svelte
@@ -0,0 +1,47 @@
+<script lang="ts">
+	import TreeMetric from './TreeMetric.svelte';
+	import { isMobile } from '$lib/utils/media';
+
+	export let height: number;
+	export let crown_diameter: number;
+	export let trunk_diameter: number;
+</script>
+
+{#if $isMobile}
+	<!-- 📱 Mobile: Carousel -->
+	<div class="relative">
+		<div
+			class="flex gap-4 overflow-x-auto scroll-smooth snap-x snap-mandatory px-1 pb-2"
+			style="scrollbar-width: thin;"
+		>
+			<TreeMetric label="Höhe" value={height} unit="m" max={39} position="right" />
+			<TreeMetric
+				label="Kronendurchmesser"
+				value={crown_diameter}
+				unit="m"
+				max={29}
+				position="top"
+			/>
+			<TreeMetric
+				label="Stammdurchmesser"
+				value={trunk_diameter}
+				unit="cm"
+				max={297}
+				position="bottom"
+			/>
+		</div>
+	</div>
+{:else}
+	<!-- 💻 Desktop: 3-Spalten-Grid -->
+	<div class="grid grid-cols-3 gap-4 text-sm text-gray-800">
+		<TreeMetric label="Höhe" value={height} unit="m" max={39} position="right" />
+		<TreeMetric label="Kronendurchmesser" value={crown_diameter} unit="m" max={29} position="top" />
+		<TreeMetric
+			label="Stammdurchmesser"
+			value={trunk_diameter}
+			unit="cm"
+			max={297}
+			position="bottom"
+		/>
+	</div>
+{/if}
diff --git a/frontend/src/components/trees/index.ts b/frontend/src/components/trees/index.ts
index 0ce23e2..e0fefd5 100644
--- a/frontend/src/components/trees/index.ts
+++ b/frontend/src/components/trees/index.ts
@@ -1,5 +1,6 @@
 export { default as AdoptTreeButton } from './AdoptTreeButton.svelte';
-export { default as TreeMetric } from './TreeMetric.svelte';
+export { default as TreeDescription } from './TreeDescription.svelte';
+export { default as TreeMetricsView } from './TreeMetricsView.svelte';
 export { default as TreeWaterings } from './TreeWaterings.svelte';
 export { default as WaterColumn } from './WaterColumn.svelte';
 export { default as AddWateringForm } from './add-watering/AddWateringForm.svelte';
diff --git a/frontend/src/routes/trees/[treeId]/+page.svelte b/frontend/src/routes/trees/[treeId]/+page.svelte
index e03772d..2154066 100644
--- a/frontend/src/routes/trees/[treeId]/+page.svelte
+++ b/frontend/src/routes/trees/[treeId]/+page.svelte
@@ -13,7 +13,13 @@
 	import { Accordion, Notice } from '$components/ui';
 	import { DialogPanel } from '$components/overlay';
 	import { Chat } from '$components/chat';
-	import { AdoptTreeButton, WaterTreeButton, TreeMetric, TreeWaterings } from '$components/trees';
+	import {
+		AdoptTreeButton,
+		WaterTreeButton,
+		TreeMetricsView,
+		TreeWaterings,
+		TreeDescription
+	} from '$components/trees';
 
 	export let activeTabIndex = 0;
 	const handleTabChange = (tab: number) => (activeTabIndex = tab);
@@ -91,33 +97,22 @@
 				{#if activeTabIndex === 0}
 					<Accordion bind:open={openAbout}>
 						<div slot="head">
-							<p class="text-black font-bold">🌳 Über diesen Baum</p>
-						</div>
-						<div slot="details">
-							<p class="text-sm text-gray-800">
-								{treeDescription
-									? treeDescription
-									: 'Hej, wie mein Name schon verrät komme ich ursprünglich aus dem Norden von Europa. …'}
+							<p class="font-semibold text-black text-base sm:text-lg leading-snug">
+								🌳 Über diesen Baum
 							</p>
-							<div class="grid grid-cols-1 sm:grid-cols-3 gap-4 text-sm text-gray-800">
-								<TreeMetric label="Höhe" value={tree.height} unit="m" max={39} position="right" />
-								<TreeMetric
-									label="Kronendurchmesser"
-									value={tree.crown_diameter}
-									unit="m"
-									max={29}
-									position="top"
-								/>
-								<TreeMetric
-									label="Stammdurchmesser"
-									value={tree.trunk_diameter}
-									unit="cm"
-									max={297}
-									position="bottom"
-								/>
-							</div>
+						</div>
+
+						<div slot="details" class="space-y-4">
+							<TreeDescription description={treeDescription} />
+
+							<TreeMetricsView
+								height={tree.height}
+								crown_diameter={tree.crown_diameter}
+								trunk_diameter={tree.trunk_diameter}
+							/>
 						</div>
 					</Accordion>
+
 					<hr />
 					<Accordion bind:open={openEnvironment}>
 						<div slot="head">

From 22fb93860026479bb47c439664d9672ba2e6996e Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sat, 19 Jul 2025 21:32:13 +0200
Subject: [PATCH 06/14] enhance: add external link to Bielefeld climate
 analysis in info notice

---
 frontend/src/routes/trees/[treeId]/+page.svelte | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/frontend/src/routes/trees/[treeId]/+page.svelte b/frontend/src/routes/trees/[treeId]/+page.svelte
index 2154066..91cd840 100644
--- a/frontend/src/routes/trees/[treeId]/+page.svelte
+++ b/frontend/src/routes/trees/[treeId]/+page.svelte
@@ -122,7 +122,17 @@
 							<Notice tone="info">
 								Dieser Baum beeinflusst seine Umgebung positiv: Er spendet Schatten, reguliert das
 								Mikroklima, verbessert die Luftqualität und bietet Lebensraum für Tiere und
-								Insekten. Weitere Informationen folgen in einem späteren Update.
+								Insekten. Weitere Informationen folgen in einem späteren Update. <br /><br />Bis
+								dahin kannst du dir die
+								<a
+									href="https://www.bielefeld.de/node/7433"
+									target="_blank"
+									class="text-green-600 underline"
+									rel="noopener noreferrer"
+								>
+									Stadtklimaanalyse Bielefeld
+								</a> durchlesen, um zu erfahren, warum du dank der Stadtbäume in Bielefeld im Sommer
+								besser schlafen kannst. 🤓
 							</Notice>
 						</div>
 					</Accordion>

From 1d3aff22b14b622c3e05d74088ee751fa7bd52d2 Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sun, 20 Jul 2025 22:02:40 +0200
Subject: [PATCH 07/14] refactor(Accordion): use ResizeObserver to solve UI bug
 in description section, remove dispatcher

---
 .../src/components/trees/TreeMetric.svelte    |  6 ++---
 .../src/components/trees/TreeWaterings.svelte |  5 +---
 frontend/src/components/ui/Accordion.svelte   | 24 ++++++++++++++-----
 frontend/src/lib/supabase/waterings.ts        | 12 ++++++++++
 .../src/routes/trees/[treeId]/+page.svelte    |  5 +---
 5 files changed, 35 insertions(+), 17 deletions(-)

diff --git a/frontend/src/components/trees/TreeMetric.svelte b/frontend/src/components/trees/TreeMetric.svelte
index aad4dfa..b3526a9 100644
--- a/frontend/src/components/trees/TreeMetric.svelte
+++ b/frontend/src/components/trees/TreeMetric.svelte
@@ -10,7 +10,7 @@
 
 <div class="snap-center shrink-0 w-52 sm:w-56 md:w-auto">
 	<div
-		class="relative grid grid-cols-2 items-center gap-4 p-4 rounded-xl border border-zinc-100 bg-white shadow-sm text-left"
+		class="relative grid grid-cols-2 items-center gap-4 px-4 py-5 rounded-xl border border-zinc-200 bg-white text-left shadow-sm"
 	>
 		<!-- Linke Spalte: Icon + Balken -->
 		<div class="relative flex justify-center items-center w-full h-14 text-green-600">
@@ -66,7 +66,7 @@
 
 		<!-- Rechte Spalte: Text -->
 		<div class="flex flex-col items-center justify-center text-center w-full">
-			<p class="text-sm text-gray-600 leading-tight">
+			<p class="text-xs text-gray-500 leading-tight">
 				{#if label === 'Kronendurchmesser'}
 					Kronen-<br />durchmesser
 				{:else if label === 'Stammdurchmesser'}
@@ -75,7 +75,7 @@
 					{label}
 				{/if}
 			</p>
-			<p class="text-base font-semibold text-gray-900 mt-1">
+			<p class="text-sm font-semibold text-gray-800 mt-1">
 				{value}
 				{unit}
 			</p>
diff --git a/frontend/src/components/trees/TreeWaterings.svelte b/frontend/src/components/trees/TreeWaterings.svelte
index 7fa194f..b687773 100644
--- a/frontend/src/components/trees/TreeWaterings.svelte
+++ b/frontend/src/components/trees/TreeWaterings.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { onMount, createEventDispatcher } from 'svelte';
+	import { onMount } from 'svelte';
 	import { getWateringsForTree, getCurrentUser } from '$lib/supabase';
 	import { WateringHistory } from '$components/waterings';
 	import { Notice } from '$components/ui';
@@ -7,8 +7,6 @@
 
 	export let treeId: string;
 
-	const dispatch = createEventDispatcher();
-
 	let currentUserId: string | null = null;
 	let waterings: Watering[] = [];
 	let loading = true;
@@ -24,7 +22,6 @@
 			error = 'Fehler beim Laden der Gießungen.';
 		} finally {
 			loading = false;
-			dispatch('contentChanged');
 		}
 	}
 
diff --git a/frontend/src/components/ui/Accordion.svelte b/frontend/src/components/ui/Accordion.svelte
index 3ede3e6..bcd0de0 100644
--- a/frontend/src/components/ui/Accordion.svelte
+++ b/frontend/src/components/ui/Accordion.svelte
@@ -1,6 +1,5 @@
-<!--Übernommen aus https://svelte.dev/playground/c109f83f3c114cb7829f04fe2440ef94?version=5.28.2, dann modifiziert ⚒️-->
 <script lang="ts">
-	import { onMount, afterUpdate, tick, createEventDispatcher } from 'svelte';
+	import { onMount, onDestroy, tick, createEventDispatcher } from 'svelte';
 
 	export let open = false;
 	const dispatch = createEventDispatcher();
@@ -9,24 +8,37 @@
 	let contentEl: HTMLDivElement;
 	let contentHeight = 0;
 
+	let resizeObserver: ResizeObserver;
+
 	const handleClick = () => (open = !open);
 
 	const updateHeight = async () => {
 		if (contentEl) {
-			await tick(); // DOM muss aktualisiert sein
+			await tick();
 			contentHeight = contentEl.scrollHeight;
 			dispatch('heightchange', { height: contentHeight });
 		}
 	};
 
-	onMount(updateHeight);
-	afterUpdate(updateHeight);
+	onMount(() => {
+		updateHeight();
+
+		if (contentEl) {
+			resizeObserver = new ResizeObserver(() => {
+				updateHeight();
+			});
+			resizeObserver.observe(contentEl);
+		}
+	});
+
+	onDestroy(() => {
+		resizeObserver?.disconnect();
+	});
 
 	$: if (open) {
 		updateHeight();
 	}
 
-	// Optional: von außen triggerbar
 	export function updateHeightExternally() {
 		updateHeight();
 	}
diff --git a/frontend/src/lib/supabase/waterings.ts b/frontend/src/lib/supabase/waterings.ts
index 144f54c..2165023 100644
--- a/frontend/src/lib/supabase/waterings.ts
+++ b/frontend/src/lib/supabase/waterings.ts
@@ -32,6 +32,16 @@ export async function getWateringsForTree(tree_uuid: string): Promise<Watering[]
 	return data ?? [];
 }
 
+export async function loadWateringsForTree(tree_uuid: string): Promise<{ data: Watering[]; error: string | null }> {
+	try {
+		const waterings = await getWateringsForTree(tree_uuid);
+		return { data: waterings, error: null };
+	} catch (err) {
+		console.error('Fehler beim Abrufen der Gießungen:', err);
+		return { data: [], error: 'Fehler beim Laden der Gießungen.' };
+	}
+}
+
 export async function getWateringsForUser(user_uuid: string): Promise<Watering[]> {
 	const { data, error } = await supabase
 		.from('waterings')
@@ -55,3 +65,5 @@ export async function deleteWatering(uuid: string): Promise<void> {
 		throw new Error(`Fehler beim Löschen: ${error.message}`);
 	}
 }
+
+
diff --git a/frontend/src/routes/trees/[treeId]/+page.svelte b/frontend/src/routes/trees/[treeId]/+page.svelte
index 91cd840..8815901 100644
--- a/frontend/src/routes/trees/[treeId]/+page.svelte
+++ b/frontend/src/routes/trees/[treeId]/+page.svelte
@@ -154,10 +154,7 @@
 							<p class="text-black font-bold">🚿 Gießungen</p>
 						</div>
 						<div slot="details">
-							<TreeWaterings
-								treeId={tree.uuid}
-								on:contentChanged={() => historyAccordionRef?.updateHeightExternally()}
-							/>
+							<TreeWaterings treeId={tree.uuid} />
 						</div>
 					</Accordion>
 

From 6c3e1a811d1c04adce22fa727778d9a0ca0ca4aa Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sun, 20 Jul 2025 23:00:05 +0200
Subject: [PATCH 08/14] feat: randomly display either emotional or neutral tree
 species description

---
 frontend/src/components/trees/TreeDescription.svelte      | 2 +-
 frontend/src/lib/supabase/trees.ts                        | 8 ++++++--
 preparation/sync_species_metadata.py                      | 3 +--
 ...species.sql => 20250720202345_create-tree-species.sql} | 5 +++--
 4 files changed, 11 insertions(+), 7 deletions(-)
 rename supabase/migrations/{20250719141821_create_tree_species.sql => 20250720202345_create-tree-species.sql} (76%)

diff --git a/frontend/src/components/trees/TreeDescription.svelte b/frontend/src/components/trees/TreeDescription.svelte
index feacabd..35e4148 100644
--- a/frontend/src/components/trees/TreeDescription.svelte
+++ b/frontend/src/components/trees/TreeDescription.svelte
@@ -4,7 +4,7 @@
 	export let description: string | null = null;
 
 	const defaultDescription =
-		'Hej, wie mein Name schon verrät komme ich ursprünglich aus dem Norden von Europa.<br><br>Ich bin **sehr variabel** in meinem Äußeren. Entweder wachse ich bis zu **15m** mit einem geraden Stamm, oder aber du findest mich als **mehrstämmigen großen Strauch**.';
+		'**Wow – du hast einen von ganz wenigen entdeckt!**<br><br>Ich bin eine echte *Rarität* in Bielefeld. Aber wer mich einmal sieht, erinnert sich.<br><br>Vielleicht entdeckst du ja noch mehr meiner Art?';
 
 	let renderedDescription = '';
 
diff --git a/frontend/src/lib/supabase/trees.ts b/frontend/src/lib/supabase/trees.ts
index 67784d8..cf15035 100644
--- a/frontend/src/lib/supabase/trees.ts
+++ b/frontend/src/lib/supabase/trees.ts
@@ -1,5 +1,6 @@
 import { supabase } from './client';
 
+
 /**
  * Holt den deutschen Baumtyp eines Baumes anhand seiner UUID.
  */
@@ -40,9 +41,12 @@ export async function loadSpeciesMap(treeIds: string[]): Promise<Map<string, str
 }
 
 export async function getTreeSpeciesDescription(treeTypeBotanic: string) {
+	const field = Math.random() < 0.5 ? 'description_emotional' : 'description_neutral';
+
+
 	const { data, error } = await supabase
 		.from('tree_species')
-		.select('description')
+		.select(field)
 		.eq('tree_type_botanic', treeTypeBotanic)
 		.maybeSingle();
 
@@ -51,7 +55,7 @@ export async function getTreeSpeciesDescription(treeTypeBotanic: string) {
 		return null;
 	}
 
-	return data?.description ?? null;
+	return (data as Record<string, string | null>)?.[field] ?? null;
 }
 
 /**
diff --git a/preparation/sync_species_metadata.py b/preparation/sync_species_metadata.py
index db3b272..5a5486f 100644
--- a/preparation/sync_species_metadata.py
+++ b/preparation/sync_species_metadata.py
@@ -23,8 +23,6 @@
 # 🌐 Datendatei laden
 with open(path_to_file, encoding="utf-8") as f:
     if path_to_file.endswith((".yaml", ".yml")):
-        if not yaml:
-            raise ImportError("PyYAML is not installed. Run: pip install pyyaml")
         data = yaml.safe_load(f)
     elif path_to_file.endswith(".json"):
         data = json.load(f)
@@ -34,3 +32,4 @@
 # 📥 Daten in Supabase schreiben
 for item in data:
     supabase.table("tree_species").upsert(item, on_conflict="tree_type_botanic").execute()
+    print(f"{item['tree_type_botanic']} ✔")
diff --git a/supabase/migrations/20250719141821_create_tree_species.sql b/supabase/migrations/20250720202345_create-tree-species.sql
similarity index 76%
rename from supabase/migrations/20250719141821_create_tree_species.sql
rename to supabase/migrations/20250720202345_create-tree-species.sql
index ca141ee..29077c2 100644
--- a/supabase/migrations/20250719141821_create_tree_species.sql
+++ b/supabase/migrations/20250720202345_create-tree-species.sql
@@ -6,8 +6,9 @@ create table public.tree_species (
   -- Botanischer Name, identisch zu `tree_type_botanic` aus der `trees`-Tabelle
   tree_type_botanic varchar not null,
 
-  description text
+  description_emotional text,
+  description_neutral text
 );
 
 -- Jede Art darf nur einmal vorkommen
-create unique index on public.tree_species (tree_type_botanic);
+create unique index on public.tree_species (tree_type_botanic);
\ No newline at end of file

From ec1a568c679566c3d5e644d25013db091e5a13ef Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sun, 20 Jul 2025 23:38:46 +0200
Subject: [PATCH 09/14] chore: add templates for tree species descriptions
 (YAML and JSON)

---
 .../tree_species.template.json                | 17 +++++++++++
 .../tree_species.template.yaml                | 28 +++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 preparation/input_templates/tree_species.template.json
 create mode 100644 preparation/input_templates/tree_species.template.yaml

diff --git a/preparation/input_templates/tree_species.template.json b/preparation/input_templates/tree_species.template.json
new file mode 100644
index 0000000..fb2ca1e
--- /dev/null
+++ b/preparation/input_templates/tree_species.template.json
@@ -0,0 +1,17 @@
+[
+  {
+    "tree_type_botanic": "Ulmus glabra",
+    "description_emotional": "Ich bin die Berg-Ulme – standfest und elegant zugleich!  \nMeine breite Krone spendet Schatten an steilen Hängen, und mein Laub raschelt besonders schön im Wind.  \nWer einmal unter mir sitzt, spürt die Ruhe des Waldes ganz besonders.",
+    "description_neutral": "Die Berg-Ulme ist ein mitteleuropäischer Laubbaum mit asymmetrischen, grob gezähnten Blättern.  \nSie bevorzugt feuchte, kühle Standorte und ist eine typische Baumart in Schlucht- und Hangwäldern."
+  },
+  {
+    "tree_type_botanic": "Sorbus aria",
+    "description_emotional": "Schau mich an – mit meinen weißen Blattunterseiten glänze ich im Sonnenlicht!  \nIch komme gut mit Hitze klar und wachse selbst dort, wo andere längst aufgegeben haben.",
+    "description_neutral": "Die Mehlbeere ist ein trockenheitsresistenter Baum mit ovalen, filzig-weiß behaarten Blättern.  \nSie wächst häufig auf mageren Standorten und trägt orange-rote Beeren, die für viele Vögel eine wichtige Nahrungsquelle sind."
+  },
+  {
+    "tree_type_botanic": "Fagus sylvatica",
+    "description_emotional": "Ich bin die Buche – Mutter des Waldes, tief verwurzelt und voller Geschichten.",
+    "description_neutral": "Die Rotbuche ist die häufigste Laubbaumart Mitteleuropas und bildet dichte, schattige Buchenwälder."
+  }
+]
diff --git a/preparation/input_templates/tree_species.template.yaml b/preparation/input_templates/tree_species.template.yaml
new file mode 100644
index 0000000..30eda8d
--- /dev/null
+++ b/preparation/input_templates/tree_species.template.yaml
@@ -0,0 +1,28 @@
+# YAML-Vorlage für Baumarten-Beschreibungen
+# Jeder Eintrag enthält genau eine botanische Bezeichnung.
+# Die Reihenfolge ist beliebig, Duplikate sind nicht erlaubt.
+# Mindestens eine der beiden Beschreibungsspalten sollte ausgefüllt sein.
+
+- tree_type_botanic: Ulmus glabra  # Botanischer Name (muss exakt mit 'trees.tree_type_botanic' übereinstimmen)
+  description_emotional: >
+    Ich bin die Berg-Ulme – standfest und elegant zugleich!  
+    Meine breite Krone spendet Schatten an steilen Hängen, und mein Laub raschelt besonders schön im Wind.  
+    Wer einmal unter mir sitzt, spürt die Ruhe des Waldes ganz besonders.
+  description_neutral: >
+    Die Berg-Ulme ist ein mitteleuropäischer Laubbaum mit asymmetrischen, grob gezähnten Blättern.  
+    Sie bevorzugt feuchte, kühle Standorte und ist eine typische Baumart in Schlucht- und Hangwäldern.
+
+- tree_type_botanic: Sorbus aria
+  description_emotional: >
+    Schau mich an – mit meinen weißen Blattunterseiten glänze ich im Sonnenlicht!  
+    Ich komme gut mit Hitze klar und wachse selbst dort, wo andere längst aufgegeben haben.
+  description_neutral: >
+    Die Mehlbeere ist ein trockenheitsresistenter Baum mit ovalen, filzig-weiß behaarten Blättern.  
+    Sie wächst häufig auf mageren Standorten und trägt orange-rote Beeren, die für viele Vögel eine wichtige Nahrungsquelle sind.
+
+# Weitere Einträge …
+# - tree_type_botanic: Fagus sylvatica
+#   description_emotional: >
+#     Ich bin die Buche – Mutter des Waldes, tief verwurzelt und voller Geschichten.
+#   description_neutral: >
+#     Die Rotbuche ist die häufigste Laubbaumart Mitteleuropas und bildet dichte, schattige Buchenwälder.
\ No newline at end of file

From 53b7da1c66cbff5acf5a20d1f8f693b0e728db36 Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Sun, 20 Jul 2025 23:43:17 +0200
Subject: [PATCH 10/14] docs: revise comments in YAML template

---
 preparation/input_templates/tree_species.template.yaml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/preparation/input_templates/tree_species.template.yaml b/preparation/input_templates/tree_species.template.yaml
index 30eda8d..aea8c37 100644
--- a/preparation/input_templates/tree_species.template.yaml
+++ b/preparation/input_templates/tree_species.template.yaml
@@ -1,7 +1,8 @@
 # YAML-Vorlage für Baumarten-Beschreibungen
-# Jeder Eintrag enthält genau eine botanische Bezeichnung.
+# Jeder Eintrag wird eindeutig durch den botanischen Namen (tree_type_botanic) identifiziert.
+# Für jede Baumart müssen beide Felder – description_emotional und description_neutral – ausgefüllt werden.
+# Für mehrzeiligen Fließtext wird der YAML-Operator > verwendet.
 # Die Reihenfolge ist beliebig, Duplikate sind nicht erlaubt.
-# Mindestens eine der beiden Beschreibungsspalten sollte ausgefüllt sein.
 
 - tree_type_botanic: Ulmus glabra  # Botanischer Name (muss exakt mit 'trees.tree_type_botanic' übereinstimmen)
   description_emotional: >

From cac8741d9817c76a3630d1b6bf73bc6cd01d8f5a Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Mon, 21 Jul 2025 16:39:14 +0200
Subject: [PATCH 11/14] =?UTF-8?q?rename:=20sync=5Fspecies=5Fmetadata.py=20?=
 =?UTF-8?q?=E2=86=92=20update=5Ftree=5Fspecies.py?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 preparation/update_tree_species.py | 35 ++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 preparation/update_tree_species.py

diff --git a/preparation/update_tree_species.py b/preparation/update_tree_species.py
new file mode 100644
index 0000000..4e86fc3
--- /dev/null
+++ b/preparation/update_tree_species.py
@@ -0,0 +1,35 @@
+import os
+import sys
+import yaml
+import json
+from supabase import create_client, Client
+from utils.env import load_env
+
+load_env()
+
+url = os.environ.get("VITE_SUPABASE_URL")
+key = os.environ.get("SUPABASE_SERVICE_ROLE_KEY")
+
+if not url or not key:
+    raise ValueError("VITE_SUPABASE_URL und SUPABASE_SERVICE_ROLE_KEY müssen gesetzt sein")
+
+supabase: Client = create_client(url, key)
+
+if len(sys.argv) != 2:
+    raise ValueError("Usage: python import_species.py <path_to_file.yaml|json>")
+
+path_to_file = sys.argv[1]
+
+# 🌐 Datendatei laden
+with open(path_to_file, encoding="utf-8") as f:
+    if path_to_file.endswith((".yaml", ".yml")):
+        data = yaml.safe_load(f)
+    elif path_to_file.endswith(".json"):
+        data = json.load(f)
+    else:
+        raise ValueError("File must be .yaml, .yml or .json")
+
+# 📥 Daten in Supabase schreiben
+for item in data:
+    supabase.table("tree_species").upsert(item, on_conflict="tree_type_botanic").execute()
+    print(f"{item['tree_type_botanic']} ✔")
\ No newline at end of file

From 06eb3c61c06940c983c1bf9e541ecfb9e7227b55 Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Mon, 21 Jul 2025 16:41:41 +0200
Subject: [PATCH 12/14] =?UTF-8?q?rename:=20sync=5Fspecies=5Fmetadata.py=20?=
 =?UTF-8?q?=E2=86=92=20update=5Ftree=5Fspecies.py?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 preparation/sync_species_metadata.py | 35 ----------------------------
 1 file changed, 35 deletions(-)
 delete mode 100644 preparation/sync_species_metadata.py

diff --git a/preparation/sync_species_metadata.py b/preparation/sync_species_metadata.py
deleted file mode 100644
index 5a5486f..0000000
--- a/preparation/sync_species_metadata.py
+++ /dev/null
@@ -1,35 +0,0 @@
-import os
-import sys
-import yaml
-import json
-from supabase import create_client, Client
-from utils.env import load_env
-
-load_env()
-
-url = os.environ.get("VITE_SUPABASE_URL")
-key = os.environ.get("SUPABASE_SERVICE_ROLE_KEY")
-
-if not url or not key:
-    raise ValueError("VITE_SUPABASE_URL und SUPABASE_SERVICE_ROLE_KEY müssen gesetzt sein")
-
-supabase: Client = create_client(url, key)
-
-if len(sys.argv) != 2:
-    raise ValueError("Usage: python import_species.py <path_to_file.yaml|json>")
-
-path_to_file = sys.argv[1]
-
-# 🌐 Datendatei laden
-with open(path_to_file, encoding="utf-8") as f:
-    if path_to_file.endswith((".yaml", ".yml")):
-        data = yaml.safe_load(f)
-    elif path_to_file.endswith(".json"):
-        data = json.load(f)
-    else:
-        raise ValueError("File must be .yaml, .yml or .json")
-
-# 📥 Daten in Supabase schreiben
-for item in data:
-    supabase.table("tree_species").upsert(item, on_conflict="tree_type_botanic").execute()
-    print(f"{item['tree_type_botanic']} ✔")

From 0abc4fa923e1a2c237e985367fb9f2a8e435123f Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Mon, 21 Jul 2025 16:43:26 +0200
Subject: [PATCH 13/14] =?UTF-8?q?rename:=20sync=5Fspecies=5Fmetadata.py=20?=
 =?UTF-8?q?=E2=86=92=20update=5Ftree=5Fspecies.py?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 preparation/update_tree_species.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/preparation/update_tree_species.py b/preparation/update_tree_species.py
index 4e86fc3..ba7fd01 100644
--- a/preparation/update_tree_species.py
+++ b/preparation/update_tree_species.py
@@ -11,12 +11,12 @@
 key = os.environ.get("SUPABASE_SERVICE_ROLE_KEY")
 
 if not url or not key:
-    raise ValueError("VITE_SUPABASE_URL und SUPABASE_SERVICE_ROLE_KEY müssen gesetzt sein")
+    raise ValueError("VITE_SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY must be set")
 
 supabase: Client = create_client(url, key)
 
 if len(sys.argv) != 2:
-    raise ValueError("Usage: python import_species.py <path_to_file.yaml|json>")
+    raise ValueError("Usage: python update_tree_species.py <path_to_file.yaml|json>")
 
 path_to_file = sys.argv[1]
 

From 1f0301711241cc223a3f32d82f60591c32c4de2a Mon Sep 17 00:00:00 2001
From: andreasCanSee <andreas.kansy@gmail.com>
Date: Mon, 21 Jul 2025 16:46:45 +0200
Subject: [PATCH 14/14] refactor: unify comments in update_tree_species.py

---
 preparation/update_tree_species.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/preparation/update_tree_species.py b/preparation/update_tree_species.py
index ba7fd01..4980499 100644
--- a/preparation/update_tree_species.py
+++ b/preparation/update_tree_species.py
@@ -5,22 +5,26 @@
 from supabase import create_client, Client
 from utils.env import load_env
 
+# Load environment variables from .env.local (if available), otherwise .env – relative to project root
 load_env()
 
+# Get Supabase URL and service role key from environment
 url = os.environ.get("VITE_SUPABASE_URL")
 key = os.environ.get("SUPABASE_SERVICE_ROLE_KEY")
 
 if not url or not key:
     raise ValueError("VITE_SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY must be set")
 
+# Create Supabase client
 supabase: Client = create_client(url, key)
 
+# Ensure a file path was passed as argument
 if len(sys.argv) != 2:
     raise ValueError("Usage: python update_tree_species.py <path_to_file.yaml|json>")
 
 path_to_file = sys.argv[1]
 
-# 🌐 Datendatei laden
+# Load data file (YAML or JSON)
 with open(path_to_file, encoding="utf-8") as f:
     if path_to_file.endswith((".yaml", ".yml")):
         data = yaml.safe_load(f)
@@ -29,7 +33,7 @@
     else:
         raise ValueError("File must be .yaml, .yml or .json")
 
-# 📥 Daten in Supabase schreiben
+# Upsert records into the 'tree_species' table using 'tree_type_botanic' as unique key
 for item in data:
     supabase.table("tree_species").upsert(item, on_conflict="tree_type_botanic").execute()
     print(f"{item['tree_type_botanic']} ✔")
\ No newline at end of file