updatet sidebar styling and texts, included statistics in category-filter

Reviewed-on: #1

.env.example

@@ -3,4 +3,6 @@ POSTGRES_HOSTNAME=postgres_host
 POSTGRES_PORT=postgres_port
 POSTGRES_DB=postgres_database
 POSTGRES_USER=postgres_user
-POSTGRES_PASSWORD=
+POSTGRES_PASSWORD=
+ADMIN_PASSWORD=
+MUNICIPALITY_SLUG=lohne

.gitignore

@@ -1,4 +1,7 @@
 .env
 .vscode/
 *.log
-scripts
+scripts
+
+public/uploads/photos/*
+!public/uploads/photos/.gitkeep

legacy/delete_data.php

@@ -1,48 +0,0 @@
-<?php
-
-
-	// ToDo's
-	// Whitelists oder Prepared Statements gegen SQL-Injection hinzufügen
-
-
-    include 'init.php';
-
-    $request = htmlspecialchars($_POST['request'], ENT_QUOTES);
-
-    if ($request=='buildings') {
-        $webgis_id = htmlspecialchars($_POST['webgis_id'], ENT_QUOTES);
-
-        try {
-
-            $pdo -> query("DELETE FROM buildings WHERE webgis_id = '$webgis_id'");
-
-        } catch (PDOException $e) {
-            echo "ERROR ".$e->getMessage();
-        }
-    }
-
-    if ($request == 'pipelines') {
-		$webgis_id = htmlspecialchars($_POST['webgis_id'], ENT_QUOTES);
-
-		try {
-
-			$pdo -> query("DELETE from pipelines where webgis_id= '$webgis_id' ");
-
-		} catch(PDOException $e) {
-			echo "ERROR ".$e->getMessage();
-		}
-	}
-
-    if ($request == 'valves') {
-		$webgis_id = htmlspecialchars($_POST['webgis_id'], ENT_QUOTES);
-
-		try {
-
-			$pdo -> query("DELETE from valves where webgis_id= '$webgis_id' ");
-
-		} catch(PDOException $e) {
-			echo "ERROR ".$e->getMessage();
-		}
-	}
-
-?>

legacy/find_data.php

@@ -1,52 +0,0 @@
-<?php
-
-	// ToDo's
-	// Whitelists oder Prepared Statements gegen SQL-Injection hinzufügen
-
-    // PostgreSQL-Serververbindung
-    include 'init.php';
-
-    // HTTP-POST-Methode für Formulardaten
-    $table = htmlspecialchars($_POST['table'], ENT_QUOTES);
-    $field = htmlspecialchars($_POST['field'], ENT_QUOTES);
-    $value = htmlspecialchars($_POST['value'], ENT_QUOTES);
-    
-    try {
-        // Datenbankabfrage
-        $result = $pdo -> query("SELECT *, ST_AsGeoJSON(geom) as geojson FROM $table WHERE $field = '$value'");
-
-        $features = [];
-
-        foreach($result as $row) {
-            // PHP-Objekt erstellen
-            $geometry = json_decode($row['geojson']);
-            
-            // PHP-Objekt bereinigen 
-            unset($row['geom']);
-            unset($row['geojson']);
-            
-            // JSON-Feature hinzufügen
-            $feature = [
-                "type"=>"Feature", 
-                "geometry"=>$geometry, 
-                "properties"=>$row
-            ];
-
-            array_push($features, $feature);
-        };
-
-        // Feature-Collection hinzufügen
-        $featureCollection = [
-            "type"=>"FeatureCollection",
-            "features"=>$features
-        ];
-
-        echo json_encode($featureCollection);
-
-    // Fehlernachricht ausgeben
-    } catch(PDOException $e) {
-        echo "ERROR ".$e->getMessage();
-
-    }
-
-?>

legacy/insert_data.php

@@ -1,73 +0,0 @@
-<?php
-
-	// ToDo's
-	// Whitelists oder Prepared Statements gegen SQL-Injection hinzufügen
-
-    // PostgreSQL-Serververbindung
-    include 'init.php';
-
-    $request = htmlspecialchars($_POST['request'], ENT_QUOTES);
-
-    if ($request == 'valves') {
-        $valve_id = htmlspecialchars($_POST['valve_id'], ENT_QUOTES);
-        $valve_type = htmlspecialchars($_POST['valve_type'], ENT_QUOTES);
-        $valve_dma_id = htmlspecialchars($_POST['valve_dma_id'], ENT_QUOTES);
-        $valve_diameter = htmlspecialchars($_POST['valve_diameter'], ENT_QUOTES);
-        $valve_visibility = htmlspecialchars($_POST['valve_visibility'], ENT_QUOTES);
-        $valve_location = htmlspecialchars($_POST['valve_location'], ENT_QUOTES);
-        $valve_geometry = $_POST['valve_geometry'];
-
-        $result = $pdo -> query("SELECT * FROM valves WHERE valve_id = '$valve_id'");
-
-        if ($result->rowCount()>0) {
-            echo "ERROR: Valve ID already exists. Please type in another ID!";
-        } else {
-        // Datenbankabfrage
-            $result = $pdo -> query("INSERT INTO valves(valve_id, valve_type, valve_dma_id, valve_diameter, valve_location, valve_visibility,  geom) VALUES ('$valve_id', '$valve_type', '$valve_dma_id', '$valve_diameter', '$valve_location', '$valve_visibility',  ST_SetSRID(ST_GeomFromGeoJSON('$valve_geometry'), 4326))");
-        }
-    }
-
-    if ($request == 'pipelines') {
-        $pipeline_id = htmlspecialchars($_POST['pipeline_id'], ENT_QUOTES);
-        $pipeline_category = htmlspecialchars($_POST['pipeline_category'], ENT_QUOTES);
-        $pipeline_dma_id = htmlspecialchars($_POST['pipeline_dma_id'], ENT_QUOTES);
-        $pipeline_diameter = htmlspecialchars($_POST['pipeline_diameter'], ENT_QUOTES);
-        $pipeline_method = htmlspecialchars($_POST['pipeline_method'], ENT_QUOTES);
-        $pipeline_location = htmlspecialchars($_POST['pipeline_location'], ENT_QUOTES);
-        $pipeline_geometry = $_POST['pipeline_geometry'];
-
-        $result = $pdo -> query("SELECT * FROM pipelines WHERE pipeline_id = '$pipeline_id'");
-
-        if ($result->rowCount()>0) {
-            echo "ERROR: Pipeline ID already exists. Please type in another ID!";
-        } else {
-        // Datenbankabfrage
-            $result = $pdo -> query("INSERT INTO pipelines(pipeline_id, pipeline_category, pipeline_dma_id, pipeline_diameter, pipeline_method, pipeline_location,  geom) VALUES ('$pipeline_id', '$pipeline_category', '$pipeline_dma_id', '$pipeline_diameter', '$pipeline_method', '$pipeline_location',  ST_SetSRID(ST_GeomFromGeoJSON('$pipeline_geometry'), 4326))");
-        }
-    }
-
-    if ($request == 'buildings') {
-
-		$account_no = htmlspecialchars($_POST['account_no'], ENT_QUOTES);
-		$building_category = htmlspecialchars($_POST['building_category'], ENT_QUOTES);
-		$building_dma_id = htmlspecialchars($_POST['building_dma_id'], ENT_QUOTES);
-		$building_storey = htmlspecialchars($_POST['building_storey'], ENT_QUOTES);
-		$building_population = htmlspecialchars($_POST['building_population'], ENT_QUOTES);
-		$building_location = htmlspecialchars($_POST['building_location'], ENT_QUOTES);
-		$building_geometry = $_POST['building_geometry'];
-
-		$result = $pdo -> query("SELECT *from buildings where account_no= '$account_no'");
-
-		if ($result->rowCount()>0) {
-			echo "ERROR: Building ID already exists. Please type in another ID!";
-		} else {
-			$sql = $pdo -> query("INSERT INTO buildings(account_no, building_category, building_dma_id, building_storey, building_population, building_location, geom) VALUES ('$account_no', '$building_category', '$building_dma_id', '$building_storey', '$building_population', '$building_location', ST_Force3DZ(ST_SetSRID(ST_GeomFromGeoJSON('$building_geometry'), 4326)))");
-		}
-	}
-        
-
-
-
-
-
-    ?>

legacy/load_data.php

@@ -1,63 +0,0 @@
-<?php
-
-	// ToDo's
-	// Whitelists oder Prepared Statements gegen SQL-Injection hinzufügen
-
-    // PostgreSQL-Serververbindung
-    include 'init.php';
-
-    // HTTP-POST-Methode für Formulardaten
-    $table = htmlspecialchars($_POST['table'], ENT_QUOTES);
-    $dma_id = htmlspecialchars($_POST['dma_id'], ENT_QUOTES);
-
-    if($table == 'valves') {
-        $dma_id_field = "valve_dma_id";
-    }
-
-    if($table == 'buildings') {
-        $dma_id_field = "building_dma_id";
-    }
-
-    if($table == 'pipelines') {
-        $dma_id_field = "pipeline_dma_id";
-    }
-    
-    try {
-        // Datenbankabfrage
-        $result = $pdo -> query("SELECT *, ST_AsGeoJSON(geom) as geojson FROM $table WHERE $dma_id_field = '$dma_id'");
-
-        $features = [];
-
-        foreach($result as $row) {
-            // PHP-Objekt erstellen
-            $geometry = json_decode($row['geojson']);
-            
-            // PHP-Objekt bereinigen 
-            unset($row['geom']);
-            unset($row['geojson']);
-            
-            // JSON-Feature hinzufügen
-            $feature = [
-                "type"=>"Feature", 
-                "geometry"=>$geometry, 
-                "properties"=>$row
-            ];
-
-            array_push($features, $feature);
-        };
-
-        // Feature-Collection hinzufügen
-        $featureCollection = [
-            "type"=>"FeatureCollection",
-            "features"=>$features
-        ];
-
-        echo json_encode($featureCollection);
-
-    // Fehlernachricht ausgeben
-    } catch(PDOException $e) {
-        echo "ERROR ".$e->getMessage();
-
-    }
-
-?>

legacy/test.html

@@ -1,97 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Document</title>
-
-    <!-- jQuery UI -->
-    <link rel="stylesheet" href="source/jquery-ui.min.css">
-    <script src="source/jquery-ui.min.js"></script>
-
-    <!-- Bootstrap Stylesheet & Skript -->
-    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.4.1/css/bootstrap.min.css">
-    <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.4.1/js/bootstrap.min.js"></script>
-
-    <link rel="stylesheet" href="styles.css">
-
-    <!-- Sidebar Plugin -->
-    <link rel="stylesheet" href="plugins/sidebar/leaflet-sidebar.css">
-    <script src="plugins/sidebar/leaflet-sidebar.js"></script>
-     
-
-    <!-- Button Plugin -->
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/leaflet-easybutton@2/src/easy-button.css">
-    <script src="https://cdn.jsdelivr.net/npm/leaflet-easybutton@2/src/easy-button.js"></script>
-
-    <!-- Font Plugin -->
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.0.1/css/all.min.css">
-
-    <!-- PolylineMeasure Plugin -->
-    <link rel="stylesheet" href="https://ppete2.github.io/Leaflet.PolylineMeasure/Leaflet.PolylineMeasure.css">
-    <script src="https://ppete2.github.io/Leaflet.PolylineMeasure/Leaflet.PolylineMeasure.js"></script>
-
-    <!-- MousePosition Plugin -->
-    <link rel="stylesheet" href="plugins/mouseposition/L.Control.MousePosition.css">
-    <script src="plugins/mouseposition/L.Control.MousePosition.js"></script>
-
-    <!-- Geoman Plugin -->
-    <link rel="stylesheet" href="https://unpkg.com/@geoman-io/leaflet-geoman-free@latest/dist/leaflet-geoman.css">
-    <script src="https://unpkg.com/@geoman-io/leaflet-geoman-free@latest/dist/leaflet-geoman.js"></script>
-
-    <!-- Minimap Plugin -->
-    <link rel="stylesheet" href="plugins/minimap/Control.MiniMap.min.css">
-    <script src="plugins/minimap/Control.MiniMap.min.js"></script>
-
-    <!-- ajax Plugin -->
-    <script src="plugins/ajax/leaflet.ajax.js"></script>
-</head>
-
-<body>
-
-    <div class="popup-container">
-        
-        <input type="hidden" name="building_database_id" class="updateBuilding" value="something">
-        <input type="hidden" name="account_no_old" class="updateBuilding" value="something">
-
-        
-        <div class="popup-form-group">
-            <label class="control-label popup-label">Building ID</label>
-            <input type="text" class="form-control popup-input text-center updateBuilding" value="something" name="account_no">
-        </div>
-
-        <div class="popup-form-group">
-            <label class="control-label popup-label">Category</label>
-            <input type="text" class="form-control popup-input text-center updateBuilding" value="something" name="building_category">
-        </div>
-
-        <div class="popup-form-group">
-            <label class="control-label popup-label">Storey</label>
-            <input type="number" class="form-control popup-input text-center updateBuilding" value="something" name="building_storey">
-        </div>
-
-        <div class="popup-form-group">
-            <label class="control-label popup-label">Population</label>
-            <input type="number" class="form-control popup-input text-center updateBuilding" value="something" name="building_population">
-        </div>
-
-        <div class="popup-form-group">
-            <label class="control-label popup-label">Location</label>
-            <input type="text" class="form-control popup-input text-center updateBuilding" value="something" name="building_locationn">
-        </div>
-
-        <div class="popup-button-group">
-            <button type="submit" class="btn btn-success popup-button">Update</button>
-            <button type="submit" class="btn btn-danger popup-button">Delete</button>
-
-        </div>
-
-    </div>
-    
-
-
-
-
-</body>
-
-</html>

legacy/update_data.php

@@ -1,98 +0,0 @@
-<?php
-    include 'init.php';
-
-    $request = htmlspecialchars($_POST['request'], ENT_QUOTES);
-
-    if ($request=='buildings') {
-        $webgis_id = htmlspecialchars($_POST['webgis_id'], ENT_QUOTES);
-        $account_no_old = htmlspecialchars($_POST['account_no_old'], ENT_QUOTES);
-        $account_no = htmlspecialchars($_POST['account_no'], ENT_QUOTES);
-        $building_category = htmlspecialchars($_POST['building_category'], ENT_QUOTES);
-        $building_storey = htmlspecialchars($_POST['building_storey'], ENT_QUOTES);
-        $building_population = htmlspecialchars($_POST['building_population'], ENT_QUOTES);
-        $building_location = htmlspecialchars($_POST['building_location'], ENT_QUOTES);
-        $building_dma_id = htmlspecialchars($_POST['building_dma_id'], ENT_QUOTES);
-
-
-        try {
-            
-            if ($account_no_old != $account_no) {
-                $result = $pdo -> query("SELECT * FROM buildings WHERE account_no = '$account_no'");
-
-                if ($result -> rowCount()>0) {
-                    echo "ERROR: Account Number already exists. Pleas type in another Account Number!";
-                } else {
-                    $pdo -> query("UPDATE buildings SET account_no = '$account_no', building_category = '$building_category', building_storey = '$building_storey', building_population = '$building_population', building_location = '$building_location', building_dma_id = '$building_dma_id' WHERE webgis_id = '$webgis_id'");
-                }
-
-            } else { $pdo -> query("UPDATE buildings SET account_no = '$account_no', building_category = '$building_category', building_storey = '$building_storey', building_population = '$building_population', building_location = '$building_location', building_dma_id = '$building_dma_id' WHERE webgis_id = '$webgis_id'");
-            }
-
-        } catch (PDOException $e) {
-            echo "ERROR ".$e->getMessage();
-        }
-    }
-
-
-    if ($request == 'pipelines') {
-		$webgis_id = htmlspecialchars($_POST['webgis_id'], ENT_QUOTES);
-		$pipeline_id_old = htmlspecialchars($_POST['pipeline_id_old'], ENT_QUOTES);
-		$pipeline_id = htmlspecialchars($_POST['pipeline_id'], ENT_QUOTES);
-		$pipeline_dma_id = htmlspecialchars($_POST['pipeline_dma_id'], ENT_QUOTES);
-		$pipeline_diameter = htmlspecialchars($_POST['pipeline_diameter'], ENT_QUOTES);
-		$pipeline_location = htmlspecialchars($_POST['pipeline_location'], ENT_QUOTES);
-		$pipeline_category = htmlspecialchars($_POST['pipeline_category'], ENT_QUOTES);
-		$pipeline_length = htmlspecialchars($_POST['pipeline_length'], ENT_QUOTES);
-
-
-		try {
-
-			if ($pipeline_id_old != $pipeline_id) {
-				$result = $pdo -> query("SELECT *from pipelines where pipeline_id = '$pipeline_id' ");
-
-				if ($result -> rowCount()>0) {
-					echo "ERROR: Pipeline ID already exists. Please choose a new ID";
-				} else {
-					$pdo -> query("UPDATE pipelines set pipeline_id = '$pipeline_id', pipeline_dma_id = '$pipeline_dma_id', pipeline_diameter = '$pipeline_diameter', pipeline_location = '$pipeline_location', pipeline_category='$pipeline_category', pipeline_length='$pipeline_length' where webgis_id = '$webgis_id'");
-				}
-			} else {
-				$pdo -> query("UPDATE pipelines set pipeline_id = '$pipeline_id', pipeline_dma_id = '$pipeline_dma_id', pipeline_diameter = '$pipeline_diameter', pipeline_location = '$pipeline_location', pipeline_category='$pipeline_category', pipeline_length='$pipeline_length' where webgis_id = '$webgis_id'");
-			}
-
-		} catch(PDOException $e) {
-			echo "ERROR ".$e->getMessage();
-		}
-	}
-
-
-    if ($request == 'valves') {
-		$webgis_id = htmlspecialchars($_POST['webgis_id'], ENT_QUOTES);
-		$valve_id_old = htmlspecialchars($_POST['valve_id_old'], ENT_QUOTES);
-		$valve_id = htmlspecialchars($_POST['valve_id'], ENT_QUOTES);
-		$valve_dma_id = htmlspecialchars($_POST['valve_dma_id'], ENT_QUOTES);
-		$valve_type = htmlspecialchars($_POST['valve_type'], ENT_QUOTES);
-		$valve_diameter = htmlspecialchars($_POST['valve_diameter'], ENT_QUOTES);
-		$valve_location = htmlspecialchars($_POST['valve_location'], ENT_QUOTES);
-		$valve_visibility = htmlspecialchars($_POST['valve_visibility'], ENT_QUOTES);
-
-
-		try {
-
-			if ($valve_id_old != $valve_id) {
-				$result = $pdo -> query("SELECT *from valves where valve_id = '$valve_id' ");
-
-				if ($result -> rowCount()>0) {
-					echo "ERROR: Valve ID already exists. Please choose a new ID";
-				} else {
-					$pdo -> query("UPDATE valves set valve_id = '$valve_id', valve_dma_id = '$valve_dma_id', valve_type = '$valve_type', valve_diameter = '$valve_diameter', valve_location = '$valve_location', valve_visibility = '$valve_visibility' where webgis_id = '$webgis_id' ");
-				}
-			} else {
-				$pdo -> query("UPDATE valves set valve_id = '$valve_id', valve_dma_id = '$valve_dma_id', valve_type = '$valve_type', valve_diameter = '$valve_diameter', valve_location = '$valve_location', valve_visibility = '$valve_visibility' where webgis_id = '$webgis_id' ");
-			}
-
-		} catch(PDOException $e) {
-			echo "ERROR ".$e->getMessage();
-		}
-	}
-
-?>

migrations/003_news_table.sql

@@ -0,0 +1,44 @@
+-- =====================================================================
+-- Migration 004: Creates News Table for Municipality Announcements
+-- =====================================================================
+
+
+-- ---------------------------------------------------------------------
+-- Block 1: Creates Table "news"
+-- ---------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS news (
+    news_id         SERIAL PRIMARY KEY,
+    municipality_id INTEGER NOT NULL REFERENCES municipalities(municipality_id) ON DELETE CASCADE,
+    title           VARCHAR(255) NOT NULL,
+    content         TEXT NOT NULL,
+    author_name     VARCHAR(100) NOT NULL DEFAULT 'Stadtverwaltung',
+    published_at    TIMESTAMP NOT NULL DEFAULT NOW(),
+    created_at      TIMESTAMP NOT NULL DEFAULT NOW(),
+    updated_at      TIMESTAMP NOT NULL DEFAULT NOW()
+);
+
+
+-- ---------------------------------------------------------------------
+-- Block 2: Trigger Functions
+-- ---------------------------------------------------------------------
+
+-- Automatically Refresh updated_at on every UPDATE.
+CREATE TRIGGER set_news_updated_at
+    BEFORE UPDATE ON news
+    FOR EACH ROW
+    EXECUTE FUNCTION set_updated_at();
+
+
+-- ---------------------------------------------------------------------
+-- Block 3 Indexes for fast Queries
+-- ---------------------------------------------------------------------
+CREATE INDEX idx_news_municipality ON news(municipality_id);
+
+
+-- ---------------------------------------------------------------------
+-- Block 4: Seed Data — Initial News Article
+-- ---------------------------------------------------------------------
+INSERT INTO news (municipality_id, title, content)
+SELECT municipality_id, 'Mitmachkarte gestartet', 
+       'Die Mitmachkarte als Bürgerbeteiligungsportal der Stadt Lohne (Oldenburg) wird nun freigeschaltet. Wir freuen uns auf Ihre Hinweise und Vorschläge!'
+FROM municipalities WHERE slug = 'lohne';

migrations/004_reverse_geocoding.sql

@@ -0,0 +1,8 @@
+-- =====================================================================
+-- Migration 004: Adds Address Column for Reverse Geocoding
+-- =====================================================================
+
+ALTER TABLE contributions
+    ADD COLUMN address VARCHAR(255) DEFAULT NULL;
+
+COMMENT ON COLUMN contributions.address IS 'Reverse geocoded Address, stored automatically on Creation.';

migrations/005_browser_id.sql

@@ -0,0 +1,27 @@
+-- =====================================================================
+-- Migration 005: Adds Browser ID for anonymous User Identification
+-- =====================================================================
+
+-- Adds browser_id Column to Contributions
+ALTER TABLE contributions
+    ADD COLUMN browser_id VARCHAR(36) DEFAULT NULL;
+
+-- Adds browser_id Column to Votes
+-- Replaces voter_name for Identification
+ALTER TABLE votes
+    ADD COLUMN browser_id VARCHAR(36) DEFAULT NULL;
+
+-- Index for fast Vote Lookup by Browser
+CREATE INDEX idx_votes_browser ON votes(browser_id);
+
+
+-- New UNIQUE Constraint: One Vote per Browser per Contribution
+
+-- Drops old Constraint voter_name based
+ALTER TABLE votes
+    DROP CONSTRAINT IF EXISTS votes_unique_per_voter;
+
+-- Creates new Constraint browser_id based
+ALTER TABLE votes
+    ADD CONSTRAINT votes_contribution_browser_unique
+    UNIQUE (contribution_id, browser_id);

migrations/006_comments_and_photos.sql

@@ -0,0 +1,35 @@
+-- =====================================================================
+-- Migration 006: Comments Table and Photo Support
+-- =====================================================================
+
+
+-- ---------------------------------------------------------------------
+-- Block 1: Creates Table "comments"
+-- Stores Comments on Contributions. Comments is linked to
+-- Contributions and identified by browser_id.
+-- ---------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS comments (
+    comment_id      SERIAL PRIMARY KEY,
+    contribution_id INTEGER NOT NULL REFERENCES contributions(contribution_id) ON DELETE CASCADE,
+    author_name     VARCHAR(100) NOT NULL,
+    browser_id      VARCHAR(36) DEFAULT NULL,
+    content         TEXT NOT NULL,
+    created_at      TIMESTAMP NOT NULL DEFAULT NOW()
+);
+
+
+-- ---------------------------------------------------------------------
+-- Block 2: Indexes for fast Comment Queries
+-- ---------------------------------------------------------------------
+CREATE INDEX idx_comments_contribution ON comments(contribution_id);
+CREATE INDEX idx_comments_browser ON comments(browser_id);
+
+
+-- ---------------------------------------------------------------------
+-- Block 3: Adds Photo Path Column to Contributions
+-- Stores relative Path to uploaded Photo File.
+-- ---------------------------------------------------------------------
+ALTER TABLE contributions
+    ADD COLUMN photo_path VARCHAR(255) DEFAULT NULL;
+
+COMMENT ON COLUMN contributions.photo_path IS 'Relative Path to uploaded Photo. NULL = no Photo.';

migrations/007_comment_moderation.sql

@@ -0,0 +1,14 @@
+-- =====================================================================
+-- Migration 007: Adds Status Column to Comments for Moderation
+-- =====================================================================
+
+-- Adds Status Column with Default 'pending'
+ALTER TABLE comments
+    ADD COLUMN status VARCHAR(20) NOT NULL DEFAULT 'pending'
+    CHECK (status IN ('pending', 'approved', 'rejected'));
+
+-- Index for fast Status Filtering
+CREATE INDEX idx_comments_status ON comments(status);
+
+-- Approves existing Comments
+UPDATE comments SET status = 'approved';

migrations/008_comment_count_trigger.sql

@@ -0,0 +1,65 @@
+-- =====================================================================
+-- Migration 008: Adds comment_count Column with automatic Trigger
+-- Mirrors Pattern from likes_count and dislikes_count.
+-- =====================================================================
+
+
+-- ---------------------------------------------------------------------
+-- Block 1: Adds comment_count Column to Contributions
+-- ---------------------------------------------------------------------
+ALTER TABLE contributions
+    ADD COLUMN comment_count INTEGER NOT NULL DEFAULT 0;
+
+
+-- ---------------------------------------------------------------------
+-- Block 2: Backfills existing Comment Counts
+-- ---------------------------------------------------------------------
+UPDATE contributions c
+SET comment_count = (
+    SELECT COUNT(*)
+    FROM comments cm
+    WHERE cm.contribution_id = c.contribution_id
+      AND cm.status = 'approved'
+);
+
+
+-- ---------------------------------------------------------------------
+-- Block 3: Trigger Function to update comment_count
+-- Fires on Status Change on comments. Only counts approved Comments
+-- ---------------------------------------------------------------------
+CREATE OR REPLACE FUNCTION update_comment_count()
+RETURNS TRIGGER AS $$
+BEGIN
+    IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
+        UPDATE contributions
+        SET comment_count = (
+            SELECT COUNT(*) FROM comments
+            WHERE contribution_id = NEW.contribution_id
+              AND status = 'approved'
+        )
+        WHERE contribution_id = NEW.contribution_id;
+    END IF;
+
+    IF TG_OP = 'DELETE' OR (TG_OP = 'UPDATE' AND OLD.contribution_id != NEW.contribution_id) THEN
+        UPDATE contributions
+        SET comment_count = (
+            SELECT COUNT(*) FROM comments
+            WHERE contribution_id = OLD.contribution_id
+              AND status = 'approved'
+        )
+        WHERE contribution_id = OLD.contribution_id;
+    END IF;
+
+    RETURN NULL;
+END;
+$$ LANGUAGE plpgsql;
+
+
+-- ---------------------------------------------------------------------
+-- Block 4: Attaches Trigger to comments Table
+-- ---------------------------------------------------------------------
+CREATE TRIGGER trigger_update_comment_count
+    AFTER INSERT OR DELETE OR UPDATE OF status
+    ON comments
+    FOR EACH ROW
+    EXECUTE FUNCTION update_comment_count();

public/admin.php

@@ -0,0 +1,586 @@
+<?php
+// =====================================================================
+// Moderation Page
+// Lists Contributions for Review. Moderators can approve, reject,
+// edit and delete Contributions. Includes Map Preview and Filtering.
+// =====================================================================
+
+// Reads Environment Configfile
+$envFile = __DIR__ . '/../../.env';
+if (file_exists($envFile)) {
+    $lines = file($envFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
+    foreach ($lines as $line) {
+        if (strpos(trim($line), '#') === 0) continue;
+        list($key, $value) = array_map('trim', explode('=', $line, 2));
+        putenv("$key=$value");
+    }
+}
+
+require_once __DIR__ . '/api/db.php';
+require_once __DIR__ . '/api/auth.php';
+
+
+// -----------------------------------------------------------------
+// Routing: Login, Logout, or Main Page
+// -----------------------------------------------------------------
+$page = $_GET['page'] ?? 'main';
+
+// Handles Login
+if ($page === 'login' && $_SERVER['REQUEST_METHOD'] === 'POST') {
+    $password = $_POST['password'] ?? '';
+    if (admin_login($password)) {
+        header('Location: admin.php');
+        exit;
+    } else {
+        $login_error = 'Falsches Passwort.';
+    }
+}
+
+// Handles Logout
+if ($page === 'logout') {
+    admin_logout();
+    header('Location: admin.php?page=login');
+    exit;
+}
+
+// -----------------------------------------------------------------
+// Loads Municipality Configuration for Theming
+// -----------------------------------------------------------------
+$pdo = get_db();
+$stmt = $pdo->prepare("SELECT * FROM municipalities WHERE slug = :slug");
+$stmt->execute([':slug' => getenv('MUNICIPALITY_SLUG')]);
+$municipality = $stmt->fetch();
+
+
+// Loads News for Moderation
+$stmt = $pdo->prepare("
+    SELECT news_id, title, content, author_name, published_at, created_at
+    FROM news
+    WHERE municipality_id = :mid
+    ORDER BY published_at DESC
+");
+$stmt->execute([':mid' => $municipality['municipality_id']]);
+$news_items = $stmt->fetchAll();
+
+
+// Loads all Comments with Contribution Titles for Moderation
+$stmt = $pdo->prepare("
+    SELECT cm.comment_id, cm.contribution_id, cm.author_name, cm.browser_id,
+           cm.content, cm.status, cm.created_at,
+           co.title AS contribution_title, co.category AS contribution_category
+    FROM comments cm
+    JOIN contributions co ON cm.contribution_id = co.contribution_id
+    WHERE co.municipality_id = :mid
+    ORDER BY cm.created_at DESC
+");
+$stmt->execute([':mid' => $municipality['municipality_id']]);
+$all_comments = $stmt->fetchAll();
+
+// Counts Comments per Status
+$comment_counts = ['pending' => 0, 'approved' => 0, 'rejected' => 0];
+foreach ($all_comments as $c) {
+    if (isset($comment_counts[$c['status']])) {
+        $comment_counts[$c['status']]++;
+    }
+}
+$comment_counts['total'] = count($all_comments);
+
+
+// Shows Login Page if not authenticated
+if ($page === 'login' || !is_admin()) {
+    show_login_page($municipality, $login_error ?? null);
+    exit;
+}
+
+// -----------------------------------------------------------------
+// Loads shared Category Definitions
+// -----------------------------------------------------------------
+$categories = get_categories();
+
+// -----------------------------------------------------------------
+// Loads Contributions and Statistics
+// -----------------------------------------------------------------
+
+// Loads all Contributions for Municipality
+$stmt = $pdo->prepare("
+    SELECT contribution_id, title, category, description, author_name, photo_path,
+           geom_type, status, likes_count, dislikes_count, comment_count, created_at, updated_at
+    FROM contributions
+    WHERE municipality_id = :mid
+    ORDER BY created_at DESC
+");
+$stmt->execute([':mid' => $municipality['municipality_id']]);
+$all_contributions = $stmt->fetchAll();
+
+// Counts per Status
+$counts = ['pending' => 0, 'approved' => 0, 'rejected' => 0];
+foreach ($all_contributions as $item) {
+    if (isset($counts[$item['status']])) {
+        $counts[$item['status']]++;
+    }
+}
+$counts['total'] = count($all_contributions);
+
+// -----------------------------------------------------------------
+// Renders Main Page
+// -----------------------------------------------------------------
+?>
+<!DOCTYPE html>
+<html lang="de">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Moderation — <?= htmlspecialchars($municipality['name']) ?></title>
+    <link rel="icon" href="assets/shield-halved-solid-off-black.png" type="image/png">
+
+    <!-- Loads CSS Dependencies -->
+
+    <!-- Font Awesome for Icons -->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    
+    <!-- Leaflet -->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.9.4/leaflet.min.css">
+    
+    <!-- Application Styles -->
+    <link rel="stylesheet" href="styles.css">
+
+
+    <!-- Loads JavaScript Dependencies -->
+    
+    <!-- SweetAlert2 -->
+    <script src="https://cdn.jsdelivr.net/npm/sweetalert2@11.14.0/dist/sweetalert2.all.min.js"></script>
+
+
+    <!-- Loads Municipality Theme from Database -->
+    <style>:root { --color-primary: <?= htmlspecialchars($municipality['primary_color']) ?>; }</style>
+</head>
+<body>
+
+    <!-- ============================================================= -->
+    <!-- Header                                                        -->
+    <!-- ============================================================= -->
+    <div class="page-header">
+        <div class="page-header-inner">
+            <h1><i class="fa-solid fa-shield-halved"></i> Moderationsportal <?= htmlspecialchars($municipality['name']) ?></h1>
+            <div class="page-header-nav">
+                <a href="index.php"><i class="fa-solid fa-map"></i> Bürgerportal</a>
+                <a href="admin.php?page=logout"><i class="fa-solid fa-right-from-bracket"></i> Abmelden</a>
+            </div>
+        </div>
+    </div>
+
+    <div class="page-container">
+
+        <!-- ========================================================= -->
+        <!-- Page Navigation Tabs                                      -->
+        <!-- ========================================================= -->
+        <div class="page-tabs">
+            <button class="page-tab active" onclick="showPageTab('contributions')">
+                <i class="fa-solid fa-list-check"></i> Beiträge
+            </button>
+            <button class="page-tab" onclick="showPageTab('comments')">
+                <i class="fa-solid fa-comments"></i> Kommentare
+            </button>
+            <button class="page-tab" onclick="showPageTab('news')">
+                <i class="fa-solid fa-newspaper"></i> Neuigkeiten
+            </button>
+            <button class="page-tab" onclick="showPageTab('stats')">
+                <i class="fa-solid fa-chart-bar"></i> Statistik
+            </button>
+            <button class="page-tab" onclick="showPageTab('users')">
+                <i class="fa-solid fa-users"></i> Benutzer
+            </button>
+        </div>
+
+
+        <!-- ========================================================= -->
+        <!-- Contributions Tab                                         -->
+        <!-- ========================================================= -->
+        <div id="tab-contributions" class="page-tab-content">
+
+            <!-- Status Filter Tabs -->
+            <div class="filter-tabs">
+                <button class="filter-tab active" onclick="filterByStatus('all', this)">
+                    Alle <span class="tab-count"><?= $counts['total'] ?></span>
+                </button>
+                <button class="filter-tab" onclick="filterByStatus('pending', this)">
+                    Ausstehend <span class="tab-count"><?= $counts['pending'] ?></span>
+                </button>
+                <button class="filter-tab" onclick="filterByStatus('approved', this)">
+                    Akzeptiert <span class="tab-count"><?= $counts['approved'] ?></span>
+                </button>
+                <button class="filter-tab" onclick="filterByStatus('rejected', this)">
+                    Abgelehnt <span class="tab-count"><?= $counts['rejected'] ?></span>
+                </button>
+            </div>
+
+            <!-- Sort Controls -->
+            <div class="sort-controls">
+                <span id="visible-count"><?= $counts['total'] ?> Beiträge</span>
+                <select onchange="sortContributions(this.value)">
+                    <option value="date-desc">Neueste zuerst</option>
+                    <option value="date-asc">Älteste zuerst</option>
+                    <option value="category">Nach Kategorie</option>
+                </select>
+            </div>
+
+            <!-- Contribution List -->
+            <div id="contributions-container">
+                <?php if (empty($all_contributions)): ?>
+                    <div class="empty-state">
+                        <i class="fa-solid fa-inbox" style="font-size:2rem;margin-bottom:8px;display:block;"></i>
+                        Noch keine Beiträge vorhanden.
+                    </div>
+                <?php else: ?>
+                    <?php foreach ($all_contributions as $item):
+                        $cat = $categories[$item['category']] ?? ['label' => $item['category'], 'faIcon' => 'fa-question', 'color' => '#999'];
+                        $status_label = ['pending' => 'Ausstehend', 'approved' => 'Akzeptiert', 'rejected' => 'Abgelehnt'];
+                    ?>
+                        <div class="contribution-row"
+                             data-status="<?= $item['status'] ?>"
+                             data-category="<?= htmlspecialchars($item['category']) ?>"
+                             data-date="<?= $item['created_at'] ?>"
+                             data-id="<?= $item['contribution_id'] ?>">
+
+                            <!-- Collapsed Header: Title + Status -->
+                            <div class="contribution-row-header" onclick="toggleRow(this.parentElement)">
+                                <div class="contribution-row-summary">
+                                    <span class="title"><?= htmlspecialchars($item['title']) ?></span>
+                                    <span class="badge badge-category">
+                                        <i class="fa-solid <?= $cat['faIcon'] ?>"></i>
+                                        <?= $cat['label'] ?>
+                                    </span>
+                                    <span class="badge badge-<?= $item['status'] ?>"><?= $status_label[$item['status']] ?? $item['status'] ?></span>
+                                </div>
+                                <i class="fa-solid fa-chevron-down collapse-icon"></i>
+                            </div>
+
+                            <!-- Expanded Detail -->
+                            <div class="contribution-row-detail">
+                                <div class="detail-layout">
+                                    <!-- Map and Photo Slider -->
+                                    <div class="detail-slider" id="slider-<?= $item['contribution_id'] ?>">
+                                        <!-- Slide 1: Map -->
+                                        <div class="detail-slide active" data-slide="map">
+                                            <div class="detail-map" id="map-<?= $item['contribution_id'] ?>"
+                                                 data-contribution-id="<?= $item['contribution_id'] ?>">
+                                            </div>
+                                        </div>
+                                        <?php if (!empty($item['photo_path'])): ?>
+                                            <!-- Slide 2: Photo -->
+                                            <div class="detail-slide" data-slide="photo" style="display:none;">
+                                                <img src="<?= htmlspecialchars($item['photo_path']) ?>" alt="Foto"
+                                                     class="detail-slide-photo" onclick="window.open('<?= htmlspecialchars($item['photo_path']) ?>', '_blank')">
+                                            </div>
+                                            <!-- Slider Arrows -->
+                                            <button class="slider-arrow slider-arrow-left" onclick="slideDetail(<?= $item['contribution_id'] ?>, -1)">
+                                                <i class="fa-solid fa-chevron-left"></i>
+                                            </button>
+                                            <button class="slider-arrow slider-arrow-right" onclick="slideDetail(<?= $item['contribution_id'] ?>, 1)">
+                                                <i class="fa-solid fa-chevron-right"></i>
+                                            </button>
+                                        <?php endif; ?>
+                                    </div>
+
+                                    <!-- Content -->
+                                    <div class="detail-content">
+                                        <?php if ($item['description']): ?>
+                                            <div class="description"><?= htmlspecialchars($item['description']) ?></div>
+                                        <?php else: ?>
+                                            <div class="description empty">Keine Beschreibung vorhanden.</div>
+                                        <?php endif; ?>
+
+                                        <div class="detail-meta">
+                                            <span><i class="fa-solid fa-user"></i> <?= htmlspecialchars($item['author_name']) ?></span>
+                                            <span><i class="fa-solid fa-calendar"></i> <?= date('d.m.Y, H:i', strtotime($item['created_at'])) ?> Uhr</span>
+                                            <span>
+                                                <i class="fa-solid fa-thumbs-up"></i> <?= $item['likes_count'] ?>
+                                                &middot;
+                                                <i class="fa-solid fa-thumbs-down"></i> <?= $item['dislikes_count'] ?>
+                                                &middot;
+                                                <i class="fa-solid fa-comment"></i> <?= $item['comment_count'] ?? 0 ?>
+
+                                                
+                                            </span>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <!-- Action Buttons -->
+                                <div class="action-buttons">
+                                    <?php if ($item['status'] !== 'approved'): ?>
+                                        <button class="btn btn-approve" onclick="changeStatus(<?= $item['contribution_id'] ?>, 'approved')">
+                                            <i class="fa-solid fa-check"></i> Akzeptieren
+                                        </button>
+                                    <?php endif; ?>
+
+                                    <?php if ($item['status'] !== 'rejected'): ?>
+                                        <button class="btn btn-reject" onclick="changeStatus(<?= $item['contribution_id'] ?>, 'rejected')">
+                                            <i class="fa-solid fa-xmark"></i> Ablehnen
+                                        </button>
+                                    <?php endif; ?>
+
+                                    <?php if ($item['status'] !== 'pending'): ?>
+                                        <button class="btn btn-reset" onclick="changeStatus(<?= $item['contribution_id'] ?>, 'pending')">
+                                            <i class="fa-solid fa-rotate-left"></i> Zurücksetzen
+                                        </button>
+                                    <?php endif; ?>
+
+                                    <button class="btn btn-edit" onclick="editContribution(<?= $item['contribution_id'] ?>, '<?= htmlspecialchars(addslashes($item['title']), ENT_QUOTES) ?>', '<?= htmlspecialchars(addslashes($item['description'] ?? ''), ENT_QUOTES) ?>')">
+                                        <i class="fa-solid fa-pen"></i> Bearbeiten
+                                    </button>
+
+                                    <button class="btn btn-delete" onclick="deleteContribution(<?= $item['contribution_id'] ?>)">
+                                        <i class="fa-solid fa-trash"></i> Löschen
+                                    </button>
+
+                                    <a class="btn btn-map" href="index.php" target="_blank">
+                                        <i class="fa-solid fa-map-location-dot"></i> Karte
+                                    </a>
+                                </div>
+                            </div>
+                        </div>
+                    <?php endforeach; ?>
+                <?php endif; ?>
+            </div>
+        </div>
+
+
+        <!-- ========================================================= -->
+        <!-- Comments Moderation Tab                                   -->
+        <!-- ========================================================= -->
+        <div id="tab-comments" class="page-tab-content" style="display:none;">
+
+            <!-- Status Filter Tabs for Comments -->
+            <div class="filter-tabs" id="comment-filter-tabs">
+                <button class="filter-tab active" onclick="filterCommentsByStatus('all', this)">
+                    Alle <span class="tab-count"><?= $comment_counts['total'] ?></span>
+                </button>
+                <button class="filter-tab" onclick="filterCommentsByStatus('pending', this)">
+                    Ausstehend <span class="tab-count"><?= $comment_counts['pending'] ?></span>
+                </button>
+                <button class="filter-tab" onclick="filterCommentsByStatus('approved', this)">
+                    Akzeptiert <span class="tab-count"><?= $comment_counts['approved'] ?></span>
+                </button>
+                <button class="filter-tab" onclick="filterCommentsByStatus('rejected', this)">
+                    Abgelehnt <span class="tab-count"><?= $comment_counts['rejected'] ?></span>
+                </button>
+            </div>
+
+            <!-- Sort Controls -->
+            <div class="sort-controls">
+                <span id="comment-visible-count"><?= $comment_counts['total'] ?> Kommentare</span>
+                <select onchange="sortCommentRows(this.value)">
+                    <option value="date-desc">Neueste zuerst</option>
+                    <option value="date-asc">Älteste zuerst</option>
+                    <option value="contribution">Nach Beitrag</option>
+                </select>
+            </div>
+
+            <!-- Comments List -->
+            <div id="comments-mod-container">
+                <?php if (empty($all_comments)): ?>
+                    <div class="empty-state">
+                        <i class="fa-solid fa-comments" style="font-size:2rem;margin-bottom:8px;display:block;"></i>
+                        Noch keine Kommentare vorhanden.
+                    </div>
+                <?php else: ?>
+                    <?php foreach ($all_comments as $comment):
+                        $comment_cat = $categories[$comment['contribution_category'] ?? ''] ?? ['label' => 'Unbekannt', 'faIcon' => 'fa-question', 'color' => '#999'];
+                        $comment_status_label = ['pending' => 'Ausstehend', 'approved' => 'Akzeptiert', 'rejected' => 'Abgelehnt'];
+                    ?>
+                        <div class="contribution-row comment-mod-row"
+                             data-status="<?= $comment['status'] ?>"
+                             data-date="<?= $comment['created_at'] ?>"
+                             data-contribution="<?= htmlspecialchars($comment['contribution_title']) ?>">
+
+                            <!-- Collapsed: Contribution Title + Comment Status + Category -->
+                            <div class="contribution-row-header" onclick="toggleRow(this.parentElement)">
+                                <div class="contribution-row-summary">
+                                    <span class="title"><?= htmlspecialchars($comment['contribution_title']) ?></span>
+                                    <span class="badge badge-<?= $comment['status'] ?>"><?= $comment_status_label[$comment['status']] ?? $comment['status'] ?></span>
+                                    <span class="badge badge-category">
+                                        <i class="fa-solid <?= $comment_cat['faIcon'] ?>"></i>
+                                        <?= $comment_cat['label'] ?>
+                                    </span>
+                                </div>
+                                <i class="fa-solid fa-chevron-down collapse-icon"></i>
+                            </div>
+
+                            <!-- Expanded Detail -->
+                            <div class="contribution-row-detail">
+                                <div style="padding:12px 0;">
+                                    <!-- Comment Content -->
+                                    <div style="font-size:0.9rem;line-height:1.6;color:var(--color-text);margin-bottom:12px;">
+                                        <?= nl2br(htmlspecialchars($comment['content'])) ?>
+                                    </div>
+                                    <!-- Meta -->
+                                    <div class="detail-meta">
+                                        <span><i class="fa-solid fa-user"></i> <?= htmlspecialchars($comment['author_name']) ?></span>
+                                        <span><i class="fa-solid fa-calendar"></i> <?= date('d.m.Y, H:i', strtotime($comment['created_at'])) ?> Uhr</span>
+                                    </div>
+                                </div>
+
+                                <!-- Action Buttons -->
+                                <div class="action-buttons">
+                                    <?php if ($comment['status'] !== 'approved'): ?>
+                                        <button class="btn btn-approve" onclick="changeCommentStatus(<?= $comment['comment_id'] ?>, 'approved')">
+                                            <i class="fa-solid fa-check"></i> Akzeptieren
+                                        </button>
+                                    <?php endif; ?>
+                                    <?php if ($comment['status'] !== 'rejected'): ?>
+                                        <button class="btn btn-reject" onclick="changeCommentStatus(<?= $comment['comment_id'] ?>, 'rejected')">
+                                            <i class="fa-solid fa-xmark"></i> Ablehnen
+                                        </button>
+                                    <?php endif; ?>
+                                    <?php if ($comment['status'] !== 'pending'): ?>
+                                        <button class="btn btn-reset" onclick="changeCommentStatus(<?= $comment['comment_id'] ?>, 'pending')">
+                                            <i class="fa-solid fa-rotate-left"></i> Zurücksetzen
+                                        </button>
+                                    <?php endif; ?>
+                                    <button class="btn btn-edit" onclick="editModComment(<?= $comment['comment_id'] ?>, '<?= htmlspecialchars(addslashes($comment['content']), ENT_QUOTES) ?>')">
+                                        <i class="fa-solid fa-pen"></i> Bearbeiten
+                                    </button>
+                                    <button class="btn btn-delete" onclick="deleteModComment(<?= $comment['comment_id'] ?>)">
+                                        <i class="fa-solid fa-trash"></i> Löschen
+                                    </button>
+                                </div>
+                            </div>
+                        </div>
+                    <?php endforeach; ?>
+                <?php endif; ?>
+            </div>
+        </div>
+        
+
+        <!-- ========================================================= -->
+        <!-- News Article Tab                                      -->
+        <!-- ========================================================= -->
+        <div id="tab-news" class="page-tab-content" style="display:none;">
+            <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:20px;">
+                <h2 style="margin:0;border:none;padding:0;"><i class="fa-solid fa-newspaper"></i> Neuigkeiten</h2>
+                <button class="btn btn-approve" onclick="createNews()">
+                    <i class="fa-solid fa-plus"></i> Nachricht hinzufügen
+                </button>
+            </div>
+
+            <?php if (empty($news_items)): ?>
+                <div class="empty-state">
+                    <i class="fa-solid fa-newspaper" style="font-size:2rem;margin-bottom:8px;display:block;"></i>
+                    Noch keine Neuigkeiten veröffentlicht.
+                </div>
+            <?php else: ?>
+                <?php foreach ($news_items as $news): ?>
+                    <div class="contribution-row" data-id="<?= $news['news_id'] ?>">
+                        <div class="contribution-row-header" onclick="toggleRow(this.parentElement)">
+                            <div class="contribution-row-summary">
+                                <span class="title"><?= htmlspecialchars($news['title']) ?></span>
+                                <span style="font-size:0.8rem;color:#999;">
+                                    <?= date('d.m.Y', strtotime($news['published_at'])) ?>
+                                    · <?= htmlspecialchars($news['author_name']) ?>
+                                </span>
+                            </div>
+                            <i class="fa-solid fa-chevron-down collapse-icon"></i>
+                        </div>
+                        <div class="contribution-row-detail">
+                            <div style="padding:12px 0;font-size:0.9rem;line-height:1.6;color:#5a5a7a;">
+                                <?= nl2br(htmlspecialchars($news['content'])) ?>
+                            </div>
+                            <div class="action-buttons">
+                                <button class="btn btn-edit" onclick="editNews(<?= $news['news_id'] ?>, '<?= htmlspecialchars(addslashes($news['title']), ENT_QUOTES) ?>', '<?= htmlspecialchars(addslashes($news['content']), ENT_QUOTES) ?>', '<?= htmlspecialchars(addslashes($news['author_name']), ENT_QUOTES) ?>')">
+                                    <i class="fa-solid fa-pen"></i> Bearbeiten
+                                </button>
+                                <button class="btn btn-delete" onclick="deleteNews(<?= $news['news_id'] ?>)">
+                                    <i class="fa-solid fa-trash"></i> Löschen
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                <?php endforeach; ?>
+            <?php endif; ?>
+        </div>
+
+
+        <!-- ========================================================= -->
+        <!-- Placeholder Tabs for future Features                      -->
+        <!-- ========================================================= -->
+        <div id="tab-stats" class="page-tab-content" style="display:none;">
+            <div class="placeholder-content">
+                <i class="fa-solid fa-chart-bar"></i>
+                <p>Statistiken und Analysen - geplant in zukünftiger Version.</p>
+            </div>
+        </div>
+
+        <div id="tab-users" class="page-tab-content" style="display:none;">
+            <div class="placeholder-content">
+                <i class="fa-solid fa-users"></i>
+                <p>Benutzerverwaltung - geplant in zukünftiger Version.</p>
+            </div>
+        </div>
+
+    </div>
+
+
+    <!-- ============================================================= -->
+    <!-- Loads JavaScript Dependencies                                 -->
+    <!-- ============================================================= -->
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.9.4/leaflet.min.js"></script>
+
+    
+    <!-- ============================================================= -->
+    <!-- Admin Configuration passed to JavaScript                      -->
+    <!-- ============================================================= -->
+    <script>
+        const ADMIN_CONFIG = {
+            id: <?= $municipality['municipality_id'] ?>,
+            name: "<?= htmlspecialchars($municipality['name'], ENT_QUOTES) ?>",
+            slug: "<?= htmlspecialchars($municipality['slug'], ENT_QUOTES) ?>",
+            center: [<?= $municipality['center_lat'] ?>, <?= $municipality['center_lng'] ?>],
+            zoom: <?= $municipality['default_zoom'] ?>,
+            primaryColor: "<?= htmlspecialchars($municipality['primary_color'], ENT_QUOTES) ?>"
+        };
+    </script>
+
+    <!-- Application Logic -->
+    <script src="js/admin.js"></script>
+
+</body>
+</html>
+
+
+<?php
+// -----------------------------------------------------------------
+// Login Page
+// -----------------------------------------------------------------
+function show_login_page($municipality, $error = null) {
+?>
+<!DOCTYPE html>
+<html lang="de">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Moderation - Anmeldung</title>
+    <link rel="icon" href="<?= htmlspecialchars($municipality['logo_path'] ?? 'assets/icon-municipality.png') ?>" type="image/png">    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="styles.css">
+    <style>:root { --color-primary: <?= htmlspecialchars($municipality['primary_color']) ?>; }</style>
+</head>
+<body>
+    <div class="login-wrapper">
+        <div class="login-box">
+            <h1><i class="fa-solid fa-shield-halved"></i> Moderationsportal</h1>
+            <p>Bitte geben Sie das Moderationspasswort ein.</p>
+            <?php if ($error): ?>
+                <div class="login-error"><i class="fa-solid fa-triangle-exclamation"></i> <?= htmlspecialchars($error) ?></div>
+            <?php endif; ?>
+            <form method="POST" action="admin.php?page=login">
+                <input type="password" name="password" placeholder="Passwort" autofocus>
+                <button type="submit"><i class="fa-solid fa-right-to-bracket"></i> Anmelden</button>
+            </form>
+            <div class="back-link"><i class="fa fa-arrow-left"></i> <a href="index.php">Zurück zum Bürgerportal</a></div>
+        </div>
+    </div>
+</body>
+</html>
+<?php
+}
+?>

public/api/auth.php

@@ -0,0 +1,28 @@
+<?php
+// =====================================================================
+// Admin Authentication Helper
+// Provides simple Password-based Session Authentication for the
+// Moderation Page. Reads Password from .env File.
+// ToDo: Replace with full User Authentication in Phase 3-3.
+// =====================================================================
+
+// Checks if current Session is authenticated as Admin
+function is_admin() {
+    return isset($_SESSION['is_admin']) && $_SESSION['is_admin'] === true;
+}
+
+// Authenticates with Password, returns true on Success
+function admin_login($password) {
+    $correct = getenv('ADMIN_PASSWORD');
+    if ($correct && $password === $correct) {
+        $_SESSION['is_admin'] = true;
+        return true;
+    }
+    return false;
+}
+
+// Logs out Admin Session
+function admin_logout() {
+    $_SESSION['is_admin'] = false;
+    session_destroy();
+}

public/api/contributions.php

@@ -38,13 +38,34 @@ switch ($action) {
     case 'vote':
         handle_vote($input);
         break;
+    case 'create_news':
+        handle_create_news($input);
+        break;
+    case 'update_news':
+        handle_update_news($input);
+        break;
+    case 'delete_news':
+        handle_delete_news($input);
+        break;
+    case 'read_comments':
+        handle_read_comments($input);
+        break;
+    case 'create_comment':
+        handle_create_comment($input);
+        break;
+    case 'delete_comment':
+        handle_delete_comment($input);
+        break;
+    case 'update_comment':
+        handle_update_comment($input);
+        break;
     default:
         error_response('Unknown Action. Supported Actions are read, create, update, delete, vote.');
 }
 
 
 // =====================================================================
-// Action Handlers
+// Action Handlers for Contributions
 // =====================================================================
 
 
@@ -65,11 +86,18 @@ function handle_read($input) {
     $municipality_id = $input['municipality_id'];
 
     // Builds SQL Query with Placeholders for prepared Statement
-    $sql = "SELECT *, ST_AsGeoJSON(geom) AS geojson 
-            FROM contributions 
-            WHERE municipality_id = :mid AND status = 'approved'";
+    $sql = "SELECT *, ST_AsGeoJSON(geom) AS geojson
+            FROM contributions
+            WHERE municipality_id = :mid";
     $params = [':mid' => $municipality_id];
 
+    // Optional: Filters by Status (Default: only approved)
+    $status = $input['status'] ?? 'approved';
+    if ($status !== 'all') {
+        $sql .= " AND status = :status";
+        $params[':status'] = $status;
+    }
+
     // Optional: Filters by Category
     if (!empty($input['category'])) {
         $sql .= " AND category = :cat";
@@ -110,6 +138,23 @@ function handle_read($input) {
         'features' => $features
     ];
 
+    // Includes User's Votes for persistent Vote Display
+    // Returns which Contributions the current Browser has voted on
+    $browser_id = $input['browser_id'] ?? '';
+    if ($browser_id !== '') {
+        $stmt = $pdo->prepare("
+            SELECT contribution_id, vote_type 
+            FROM votes 
+            WHERE browser_id = :bid
+        ");
+        $stmt->execute([':bid' => $browser_id]);
+        $user_votes = [];
+        foreach ($stmt->fetchAll() as $v) {
+            $user_votes[$v['contribution_id']] = $v['vote_type'];
+        }
+        $featureCollection['user_votes'] = $user_votes;
+    }
+
     json_response($featureCollection);
 }
 
@@ -119,6 +164,11 @@ function handle_read($input) {
 // Required: municipality_id, geom, geom_type, category, title, author_name
 // Optional: description
 // ---------------------------------------------------------------------
+// ---------------------------------------------------------------------
+// CREATE: Inserts new Contributions with optional Photo Upload
+// Required: municipality_id, geom, geom_type, category, title, author_name
+// Optional: description, browser_id, photo (File Upload)
+// ---------------------------------------------------------------------
 function handle_create($input) {
     $pdo = get_db();
 
@@ -142,14 +192,23 @@ function handle_create($input) {
         error_response('Invalid GeoJSON in Geometry Field.');
     }
 
+    // Handles Photo Upload
+    $photo_path = null;
+    if (isset($_FILES['photo']) && $_FILES['photo']['error'] === UPLOAD_ERR_OK) {
+        $photo_path = handle_photo_upload($_FILES['photo']);
+        if (!$photo_path) {
+            error_response('Photo Upload failed. JPG, PNG, GIF and WebP up to 5 MB are allowed.');
+        }
+    }
+
     // Prepared SQL Statement
     try {
         $stmt = $pdo->prepare("
             INSERT INTO contributions 
-                (municipality_id, geom, geom_type, category, title, description, author_name)
+                (municipality_id, geom, geom_type, category, title, description, author_name, browser_id, photo_path)
             VALUES 
                 (:mid, ST_SetSRID(ST_GeomFromGeoJSON(:geom), 4326), :geom_type, 
-                 :category, :title, :description, :author_name)
+                 :category, :title, :description, :author_name, :browser_id, :photo_path)
         ");
 
         $stmt->execute([
@@ -159,7 +218,9 @@ function handle_create($input) {
             ':category'    => $input['category'],
             ':title'       => $input['title'],
             ':description' => $input['description'] ?? '',
-            ':author_name' => $input['author_name']
+            ':author_name' => $input['author_name'],
+            ':browser_id'  => $input['browser_id'] ?? null,
+            ':photo_path'  => $photo_path
         ]);
 
         json_response([
@@ -198,7 +259,7 @@ function handle_update($input) {
     }
 
     // Builds dynamic SQL Query to only update sent Fields
-    $updatable_fields = ['category', 'title', 'description', 'status'];
+    $updatable_fields = ['category', 'title', 'description', 'status', 'address'];
     $set_clauses = [];
     $params = [':id' => $contribution_id];
 
@@ -303,24 +364,349 @@ function handle_vote($input) {
 
     // Prepared SQL Statement
     try {
+        // Checks if Voter already voted on this Contribution
+        $browser_id = $input['browser_id'] ?? '';
+        if (empty($browser_id)) {
+            error_response('Browser ID required for Voting.');
+        }
+
         $stmt = $pdo->prepare("
-            INSERT INTO votes (contribution_id, voter_name, vote_type)
-            VALUES (:cid, :voter, :vtype)
+            SELECT vote_id, vote_type FROM votes
+            WHERE contribution_id = :cid AND browser_id = :bid
         ");
+        $stmt->execute([':cid' => $input['contribution_id'], ':bid' => $browser_id]);
+        $existing = $stmt->fetch();
 
-        $stmt->execute([
-            ':cid'   => $input['contribution_id'],
-            ':voter' => $input['voter_name'],
-            ':vtype' => $input['vote_type']
-        ]);
+        if ($existing) {
+            if ($existing['vote_type'] === $input['vote_type']) {
+                // Same Vote Type — Removes Vote
+                $stmt = $pdo->prepare("DELETE FROM votes WHERE vote_id = :vid");
+                $stmt->execute([':vid' => $existing['vote_id']]);
+                json_response(['message' => 'Vote removed.', 'action' => 'removed']);
+            } else {
+                // Different Vote Type — Switches Vote
+                $stmt = $pdo->prepare("DELETE FROM votes WHERE vote_id = :vid");
+                $stmt->execute([':vid' => $existing['vote_id']]);
 
-        json_response(['message' => 'Vote recorded successfully.'], 201);
+                $stmt = $pdo->prepare("
+                    INSERT INTO votes (contribution_id, voter_name, vote_type, browser_id)
+                    VALUES (:cid, :voter, :vtype, :bid)
+                ");
+                $stmt->execute([
+                    ':cid'   => $input['contribution_id'],
+                    ':voter' => $input['voter_name'],
+                    ':vtype' => $input['vote_type'],
+                    ':bid'   => $browser_id
+                ]);
+                json_response(['message' => 'Vote changed.', 'action' => 'changed'], 200);
+            }
+        } else {
+            // No existing Vote — Inserts Vote
+            $stmt = $pdo->prepare("
+                    INSERT INTO votes (contribution_id, voter_name, vote_type, browser_id)
+                    VALUES (:cid, :voter, :vtype, :bid)
+                ");
+                $stmt->execute([
+                    ':cid'   => $input['contribution_id'],
+                    ':voter' => $input['voter_name'],
+                    ':vtype' => $input['vote_type'],
+                    ':bid'   => $browser_id
+                ]);
+            json_response(['message' => 'Vote recorded.', 'action' => 'created'], 201);
+        }
 
     } catch (PDOException $e) {
-        // UNIQUE Constraint Violation - Voter already voted on this Contribution
-        if ($e->getCode() == '23505') {
-            error_response('You have already voted on this Contribution.', 409);
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+
+// =====================================================================
+// Action Handlers for News
+// =====================================================================
+
+// ---------------------------------------------------------------------
+// CREATE NEWS: Inserts new News Entry
+// Required: municipality_id, title, content
+// ---------------------------------------------------------------------
+function handle_create_news($input) {
+    $pdo = get_db();
+    $missing = validate_required($input, ['municipality_id', 'title', 'content']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    try {
+        $stmt = $pdo->prepare("
+            INSERT INTO news (municipality_id, title, content, author_name)
+            VALUES (:mid, :title, :content, :author)
+        ");
+        $stmt->execute([
+            ':mid'     => $input['municipality_id'],
+            ':title'   => $input['title'],
+            ':content' => $input['content'],
+            ':author'  => $input['author_name'] ?? 'Stadtverwaltung'
+        ]);
+        json_response(['message' => 'News created successfully.', 'news_id' => (int) $pdo->lastInsertId()], 201);
+    } catch (PDOException $e) {
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+// ---------------------------------------------------------------------
+// UPDATE NEWS: Updates existing News Entry
+// Required: news_id
+// Optional: title, content
+// ---------------------------------------------------------------------
+function handle_update_news($input) {
+    $pdo = get_db();
+    $missing = validate_required($input, ['news_id']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    $set = [];
+    $params = [':id' => $input['news_id']];
+
+    foreach (['title', 'content', 'author_name'] as $field) {
+        if (isset($input[$field]) && $input[$field] !== '') {
+            $set[] = "$field = :$field";
+            $params[":$field"] = $input[$field];
         }
+    }
+
+    if (empty($set)) {
+        error_response('No Fields to update.');
+    }
+
+    try {
+        $stmt = $pdo->prepare("UPDATE news SET " . implode(', ', $set) . " WHERE news_id = :id");
+        $stmt->execute($params);
+        json_response(['message' => 'News updated successfully.']);
+    } catch (PDOException $e) {
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+// ---------------------------------------------------------------------
+// DELETE NEWS: Deletes existing News Entry
+// Required: news_id
+// ---------------------------------------------------------------------
+function handle_delete_news($input) {
+    $pdo = get_db();
+    $missing = validate_required($input, ['news_id']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    try {
+        $stmt = $pdo->prepare("DELETE FROM news WHERE news_id = :id");
+        $stmt->execute([':id' => $input['news_id']]);
+        json_response(['message' => 'News deleted successfully.']);
+    } catch (PDOException $e) {
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+
+// =====================================================================
+// Action Handlers for Photos
+// =====================================================================
+
+// ---------------------------------------------------------------------
+// PHOTO UPLOAD: Validates and Saves uploaded Photo Files
+// Returns relative Path on Success, null on Failure.
+// Allowed: JPG, PNG, GIF, WebP. with maximum Size of 5 MB.
+// ---------------------------------------------------------------------
+function handle_photo_upload($file) {
+    // Validates File Size
+    $max_size = 5 * 1024 * 1024;
+    if ($file['size'] > $max_size) {
+        return null;
+    }
+
+    // Validates MIME Type
+    $allowed_types = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
+    $finfo = finfo_open(FILEINFO_MIME_TYPE);
+    $mime = finfo_file($finfo, $file['tmp_name']);
+    finfo_close($finfo);
+
+    if (!in_array($mime, $allowed_types)) {
+        return null;
+    }
+
+    // Generates unique Filename
+    $ext = [
+        'image/jpeg' => 'jpg',
+        'image/png'  => 'png',
+        'image/gif'  => 'gif',
+        'image/webp' => 'webp'
+    ][$mime];
+
+    $filename = uniqid('photo_', true) . '.' . $ext;
+    $upload_dir = __DIR__ . '/../uploads/photos/';
+    $target_path = $upload_dir . $filename;
+
+    // Creates Upload Directory
+    if (!is_dir($upload_dir)) {
+        mkdir($upload_dir, 0755, true);
+    }
+
+    // Moves uploaded File
+    if (move_uploaded_file($file['tmp_name'], $target_path)) {
+        return 'uploads/photos/' . $filename;
+    }
+
+    return null;
+}
+
+// =====================================================================
+// Action Handlers for Comments
+// =====================================================================
+
+// ---------------------------------------------------------------------
+// READ COMMENTS: Loads Comments for a Contribution
+// Returns Comments sorted by Date (newest first)
+// Required: contribution_id
+// ---------------------------------------------------------------------
+function handle_read_comments($input) {
+    $pdo = get_db();
+
+    $missing = validate_required($input, ['contribution_id']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    try {
+        $stmt = $pdo->prepare("
+            SELECT comment_id, contribution_id, author_name, browser_id, content, status, created_at
+            FROM comments
+            WHERE contribution_id = :cid AND status = 'approved'
+            ORDER BY created_at ASC
+        ");
+        $stmt->execute([':cid' => $input['contribution_id']]);
+        $comments = $stmt->fetchAll();
+
+        json_response(['comments' => $comments, 'count' => count($comments)]);
+
+    } catch (PDOException $e) {
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+
+// ---------------------------------------------------------------------
+// CREATE COMMENT: Adds Comments to Contributions
+// Required: contribution_id, author_name, content
+// Optional: browser_id
+// ---------------------------------------------------------------------
+function handle_create_comment($input) {
+    $pdo = get_db();
+
+    $missing = validate_required($input, ['contribution_id', 'author_name', 'content']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    // Validates Content Length
+    if (strlen($input['content']) > 1000) {
+        error_response('Comment too long. Maximum 1000 Characters.');
+    }
+
+    // Checks if Contribution exists
+    $stmt = $pdo->prepare("SELECT contribution_id FROM contributions WHERE contribution_id = :id");
+    $stmt->execute([':id' => $input['contribution_id']]);
+    if (!$stmt->fetch()) {
+        error_response('Contribution not found.', 404);
+    }
+
+    try {
+        $stmt = $pdo->prepare("
+            INSERT INTO comments (contribution_id, author_name, browser_id, content)
+            VALUES (:cid, :author, :bid, :content)
+        ");
+        $stmt->execute([
+            ':cid'     => $input['contribution_id'],
+            ':author'  => $input['author_name'],
+            ':bid'     => $input['browser_id'] ?? null,
+            ':content' => $input['content']
+        ]);
+
+        json_response([
+            'message'    => 'Comment created successfully.',
+            'comment_id' => (int) $pdo->lastInsertId()
+        ], 201);
+
+    } catch (PDOException $e) {
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+
+// ---------------------------------------------------------------------
+// DELETE COMMENT: Removes a Comment
+// Required: comment_id
+// ---------------------------------------------------------------------
+function handle_delete_comment($input) {
+    $pdo = get_db();
+
+    $missing = validate_required($input, ['comment_id']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    try {
+        $stmt = $pdo->prepare("DELETE FROM comments WHERE comment_id = :id");
+        $stmt->execute([':id' => $input['comment_id']]);
+
+        json_response(['message' => 'Comment deleted successfully.']);
+
+    } catch (PDOException $e) {
+        error_response('Database Error: ' . $e->getMessage(), 500);
+    }
+}
+
+// ---------------------------------------------------------------------
+// UPDATE COMMENT: Changes Comment Status or Content
+// Required: comment_id
+// Optional: status, content
+// ---------------------------------------------------------------------
+function handle_update_comment($input) {
+    $pdo = get_db();
+
+    $missing = validate_required($input, ['comment_id']);
+    if (!empty($missing)) {
+        error_response('Missing Fields: ' . implode(', ', $missing));
+    }
+
+    $set = [];
+    $params = [':id' => $input['comment_id']];
+
+    // Updates Status if provided
+    if (isset($input['status']) && $input['status'] !== '') {
+        $valid = ['pending', 'approved', 'rejected'];
+        if (!in_array($input['status'], $valid)) {
+            error_response('Invalid Status.');
+        }
+        $set[] = "status = :status";
+        $params[':status'] = $input['status'];
+    }
+
+    // Updates Content if provided
+    if (isset($input['content']) && $input['content'] !== '') {
+        $set[] = "content = :content";
+        $params[':content'] = $input['content'];
+    }
+
+    if (empty($set)) {
+        error_response('No Fields to update.');
+    }
+
+    try {
+        $stmt = $pdo->prepare("UPDATE comments SET " . implode(', ', $set) . " WHERE comment_id = :id");
+        $stmt->execute($params);
+        json_response(['message' => 'Comment updated successfully.']);
+    } catch (PDOException $e) {
         error_response('Database Error: ' . $e->getMessage(), 500);
     }
 }

public/api/db.php

@@ -1,8 +1,8 @@
 <?php
 // =====================================================================
-// Database Helper
-// Provides PDO Connection to Database and shared miscellaneous
-// Functions for all API Endpoints.
+// Database Helper Functions
+// Provides PDO Connection, JSON Response Helpers, Category Definitions
+// and shared miscellaneous Functions for all API Endpoints.
 // =====================================================================
 
 require_once __DIR__ . '/init.php';
@@ -91,4 +91,23 @@ function get_db() {
     }
 
     return $pdo;
+}
+
+// ---------------------------------------------------------------------
+// Category Definitions
+// Returns associative Array of Category Keys to Labels, Icons,
+// and Colors. Shared between Citizen Participation Portal and
+// Moderation Page.
+// ToDo: Move to Database Table. 
+// ---------------------------------------------------------------------
+function get_categories() {
+    return [
+        'consumption' => ['label' => 'Geschäfte',   'faIcon' => 'fa-cart-shopping', 'color' => '#C00000'],
+        'building'    => ['label' => 'Bauen',       'faIcon' => 'fa-building',      'color' => '#E65100'],
+        'energy'      => ['label' => 'Energie',     'faIcon' => 'fa-bolt',          'color' => '#FFC000'],
+        'environment' => ['label' => 'Umwelt',      'faIcon' => 'fa-seedling',      'color' => '#92D050'],
+        'mobility'    => ['label' => 'Mobilität',   'faIcon' => 'fa-bus',           'color' => '#0070C0'],
+        'industry'    => ['label' => 'Industrie',   'faIcon' => 'fa-industry',      'color' => '#7030A0'],
+        'other'       => ['label' => 'Sonstiges',   'faIcon' => 'fa-thumbtack',     'color' => '#7F7F7F'],
+    ];
 }

public/api/init.php

@@ -28,24 +28,16 @@ session_start();
 
 // Initializes Database Connection
 try {
-    $opt = [
+    $dsn = "pgsql:host=$host;dbname=$db;port=$port";
+    $pdo = new PDO($dsn, $user, $pass, [
         PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
         PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
         PDO::ATTR_EMULATE_PREPARES   => false
-    ];
-    $dsn = "pgsql:host=$host;dbname=$db;port=$port";
-    $pdo = new PDO($dsn, $user, $pass, $opt);
+    ]);
 
-
-    $pdo = new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
-
-
-
-    
-    
 // Creates Error Message
-} catch(PDOException $e) {
-    echo "Error: ".$e->getMessage();
+} catch (PDOException $e) {
+    echo "Error: " . $e->getMessage();
 }
 
 ?>

public/imprint.php

@@ -0,0 +1,39 @@
+<?php
+require_once __DIR__ . '/api/db.php';
+$pdo = get_db();
+$stmt = $pdo->prepare("SELECT * FROM municipalities WHERE slug = :slug");
+$stmt->execute([':slug' => getenv('MUNICIPALITY_SLUG')]);
+$municipality = $stmt->fetch();
+?>
+<!DOCTYPE html>
+<html lang="de">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Impressum — <?= htmlspecialchars($municipality['name']) ?></title>
+    <link rel="icon" href="assets/scale-balanced-solid-off-black.png" type="image/png">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="styles.css">
+    <style>:root { --color-primary: <?= htmlspecialchars($municipality['primary_color']) ?>; }</style>
+</head>
+<body>
+    <div class="page-header">
+        <div class="page-header-inner">
+            <h1><i class="fa-solid fa-scale-balanced"></i> Impressum</h1>
+            <div class="page-header-nav">
+                <a href="index.php"><i class="fa-solid fa-arrow-left"></i> Zurück zur Karte</a>
+            </div>
+        </div>
+    </div>
+    <div class="page-container">
+        <div class="page-content-box">
+            <div class="dev-notice">
+                <i class="fa-solid fa-triangle-exclamation"></i>
+                Dieses Portal befindet sich in der Entwicklung und wurde nicht offiziell beauftragt. Das Impressum wird mit der offiziellen Inbetriebnahme hier hinzugefügt.
+            </div>
+            <h2>Impressum</h2>
+            <p>Das Impressum wird hier hinzugefügt, sobald das Portal in den Produktivbetrieb geht.</p>
+        </div>
+    </div>
+</body>
+</html>

public/index.php

@@ -6,15 +6,14 @@
 // =====================================================================
 
 require_once __DIR__ . '/api/db.php';
+require_once __DIR__ . '/api/auth.php';
 
 // -----------------------------------------------------------------
 // Loads Municipality Configuration
-// ToDo's: Dynamic Loading via URL Slug once multi-tenant Routing
-// is implemented. Hardcoded Slug for now.
 // -----------------------------------------------------------------
 $pdo = get_db();
 $stmt = $pdo->prepare("SELECT * FROM municipalities WHERE slug = :slug");
-$stmt->execute([':slug' => 'lohne']);
+$stmt->execute([':slug' => getenv('MUNICIPALITY_SLUG')]);
 $municipality = $stmt->fetch();
 
 if (!$municipality) {
@@ -23,14 +22,19 @@ if (!$municipality) {
     exit;
 }
 
+// Loads News for Sidebar
+$stmt = $pdo->prepare("SELECT * FROM news WHERE municipality_id = :mid ORDER BY published_at DESC LIMIT 10");
+$stmt->execute([':mid' => $municipality['municipality_id']]);
+$news_items = $stmt->fetchAll();
+
 ?>
 <!DOCTYPE html>
 <html lang="de">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Bürgerbeteiligungsportal <?= htmlspecialchars($municipality['name']) ?></title>
-    <link rel="icon" href="assets/icon-municipality.png" type="image/png">
+    <title>Mitmachkarte <?= htmlspecialchars($municipality['name']) ?></title>
+    <link rel="icon" href="assets/user-group-solid-off-black.png" type="image/png">
     <meta name="description" content="Bürgerbeteiligungsportal. Hinweise und Vorschläge auf der Karte eintragen.">
 
 
@@ -54,14 +58,18 @@ if (!$municipality) {
     <link rel="stylesheet" href="https://unpkg.com/leaflet-control-geocoder@2.4.0/dist/Control.Geocoder.css">
 
     <!-- Leaflet Polyline Measurement Tool -->
-    <link rel="stylesheet" href="https://ppete2.github.io/Leaflet.PolylineMeasure/Leaflet.PolylineMeasure.css">
+    <!-- <link rel="stylesheet" href="https://ppete2.github.io/Leaflet.PolylineMeasure/Leaflet.PolylineMeasure.css"> -->
 
-    <!-- Font Awesome 6 for Icons -->
+    <!-- Font Awesome for Icons -->
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
 
     <!-- Application Styles -->
     <link rel="stylesheet" href="styles.css">
 
+    <!-- Shepherd.js Onboarding Tour -->
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/shepherd.js@11.2.0/dist/css/shepherd.css">
+
+
     <!-- ============================================================= -->
     <!-- Municipality Theme loaded from Database                       -->
     <!-- ============================================================= -->
@@ -73,15 +81,17 @@ if (!$municipality) {
     </style>
 </head>
 
-<body>
+<body class="portal-page">
 
     <!-- ============================================================= -->
     <!-- Header                                                        -->
     <!-- ============================================================= -->
     <header id="app-header">
         <div class="header-left">
-            <img src="assets/logo-municipality.png" alt="<?= htmlspecialchars($municipality['name']) ?>" class="header-logo" onerror="this.style.display='none'">
-            <h1 class="header-title">Bürgerbeteiligung <?= htmlspecialchars($municipality['name']) ?></h1>
+            <?php if (!empty($municipality['logo_path'])): ?>
+                <img src="assets/user-group-solid-off-white.png" alt="user-group-solid-off-white" class="header-logo" onerror="this.style.display='none'">
+            <?php endif; ?>
+            <h1 class="header-title">Mitmachkarte <?= htmlspecialchars($municipality['name']) ?></h1>
         </div>
 
         <nav class="header-nav">
@@ -89,14 +99,17 @@ if (!$municipality) {
                 <i class="fa-solid fa-circle-info"></i>
                 <span class="nav-label">Informationen</span>
             </button>
-            <button class="nav-btn" onclick="showPrivacyModal()">
+            <a href="privacy.php" class="nav-btn" target="_blank">
                 <i class="fa-solid fa-shield-halved"></i>
                 <span class="nav-label">Datenschutz</span>
-            </button>
-            <button class="nav-btn" onclick="showImprintModal()">
+            </a>
+            <a href="imprint.php" class="nav-btn" target="_blank">
                 <i class="fa-solid fa-scale-balanced"></i>
                 <span class="nav-label">Impressum</span>
-            </button>
+            </a>
+            <a href="admin.php" class="nav-btn nav-btn-admin" title="Moderationsbereich" target="_blank">
+                <i class="fa-solid fa-lock"></i>
+            </a>
         </nav>
 
         <!-- Mobile Hamburger Menu -->
@@ -118,9 +131,9 @@ if (!$municipality) {
             <div class="leaflet-sidebar-tabs">
                 <ul role="tablist">
                     <li><a href="#tab-home" role="tab"><i class="fa-solid fa-house"></i></a></li>
-                    <li><a href="#tab-help" role="tab"><i class="fa-solid fa-circle-question"></i></a></li>
                     <li><a href="#tab-list" role="tab"><i class="fa-solid fa-list"></i></a></li>
                     <li><a href="#tab-news" role="tab"><i class="fa-solid fa-newspaper"></i></a></li>
+                    <li><a href="#tab-help" role="tab"><i class="fa-solid fa-circle-question"></i></a></li>
                 </ul>
             </div>
 
@@ -135,17 +148,12 @@ if (!$municipality) {
                     </h2>
                     <div class="sidebar-body">
                         <p>Willkommen beim Bürgerbeteiligungsportal <strong><?= htmlspecialchars($municipality['name']) ?></strong>.</p>
-                        <p>Verwenden Sie die Karte, um Hinweise und Aufgaben für die Stadtverwaltung hinzuzufügen oder bestehende Beiträge der Bürgerschaft zu betrachten.</p>
+                        <p>Verwenden Sie die Karte, um Hinweise für die Stadtverwaltung hinzuzufügen oder bestehende Beiträge zu betrachten, zu bewerten und zu kommentieren.</p>
 
                         <h3>Kategorien</h3>
                         <div id="category-filter">
                             <!-- Category Filter Checkboxes — populated by app.js -->
                         </div>
-
-                        <h3>Statistik</h3>
-                        <div id="stats-container">
-                            <!-- Contribution Statistics — populated by app.js -->
-                        </div>
                     </div>
                 </div>
 
@@ -163,28 +171,7 @@ if (!$municipality) {
                             <!-- Contribution Cards — populated by app.js -->
                         </div>
                     </div>
-                </div>
-
-                <!-- Help Tab -->
-                <div class="leaflet-sidebar-pane" id="tab-help">
-                    <h2 class="leaflet-sidebar-header">
-                        Hilfe
-                        <span class="leaflet-sidebar-close"><i class="fa-solid fa-xmark"></i></span>
-                    </h2>
-                    <div class="sidebar-body">
-                        <h3><i class="fa-solid fa-map-location-dot"></i> Karte bedienen</h3>
-                        <p>Verschieben Sie die Karte per Mausklick und Ziehen. Zoomen Sie mit dem Mausrad oder den Zoom-Buttons.</p>
-
-                        <h3><i class="fa-solid fa-plus"></i> Beitrag erstellen</h3>
-                        <p>Verwenden Sie die Zeichenwerkzeuge rechts, um Beiträge als Punkte, Linien oder Flächen zu zeichnen. Anschließend können Sie Kategorie und Beschreibung hinzufügen.</p>
-
-                        <h3><i class="fa-solid fa-thumbs-up"></i> Abstimmen</h3>
-                        <p>Klicken Sie auf bestehende Beiträge und nutzen Sie die Like/Dislike Funktion, um Ihre Meinung kundzugeben.</p>
-
-                        <h3><i class="fa-solid fa-magnifying-glass"></i> Suchen</h3>
-                        <p>Verwenden Sie die Adresssuche rechts, um bestimmte Orte auf der Karte zu finden.</p>
-                    </div>
-                </div>
+                </div>            
 
                 <!-- News Tab -->
                 <div class="leaflet-sidebar-pane" id="tab-news">
@@ -193,12 +180,63 @@ if (!$municipality) {
                         <span class="leaflet-sidebar-close"><i class="fa-solid fa-xmark"></i></span>
                     </h2>
                     <div class="sidebar-body">
-                        <div class="news-item">
-                            <span class="news-date">April 2026</span>
-                            <h3>Portal gestartet</h3>
-                            <p>Das Bürgerbeteiligungsportal für <?= htmlspecialchars($municipality['name']) ?> ist online. Wir freuen uns auf Ihre Hinweise und Vorschläge!</p>
+                        <!-- News Search -->
+                        <div class="list-search">
+                            <input type="text" id="news-search-input" placeholder="Neuigkeiten durchsuchen..." class="form-input" oninput="filterNews()">
                         </div>
-                        <!-- News Items can be added or loaded from Database here -->
+
+                        <!-- News Items Container -->
+                        <div id="news-list">
+                            <?php if (empty($news_items)): ?>
+                                <p class="empty-state">Noch keine Neuigkeiten veröffentlicht.</p>
+                            <?php else: ?>
+                                <?php foreach ($news_items as $news): ?>
+                                    <div class="news-item"
+                                         data-title="<?= htmlspecialchars(strtolower($news['title'])) ?>"
+                                         data-content="<?= htmlspecialchars(strtolower($news['content'])) ?>"
+                                         data-author="<?= htmlspecialchars(strtolower($news['author_name'])) ?>">
+                                        <h3><?= htmlspecialchars($news['title']) ?></h3>
+                                        <p><?= nl2br(htmlspecialchars($news['content'])) ?></p>
+                                        <span class="news-date">
+                                            <?= htmlspecialchars($news['author_name']) ?>
+                                            · <?= date('d.m.Y', strtotime($news['published_at'])) ?>
+                                        </span>
+                                    </div>
+                                <?php endforeach; ?>
+                            <?php endif; ?>
+                        </div>
+                    </div>
+                </div>
+
+                    <!-- Help Tab -->
+                <div class="leaflet-sidebar-pane" id="tab-help">
+                    <h2 class="leaflet-sidebar-header">
+                        Hilfe
+                        <span class="leaflet-sidebar-close"><i class="fa-solid fa-xmark"></i></span>
+                    </h2>
+                    <div class="sidebar-body">
+                        <h3><i class="fa-solid fa-book"></i> Interaktive Anleitung</h3>
+                        <p>Klicken Sie unten auf Tutorial starten um Schritt für Schritt durch die Kernfunktionen der Mitmachkarte geführt zu werden.</p>
+                        <p>
+                            <button class="btn btn-primary" onclick="if(typeof restartOnboarding==='function'){sidebar.close();restartOnboarding()}" style="font-size:0.85rem;">
+                                <i class="fa-solid fa-route"></i> Tutorial starten
+                            </button>
+                        </p>
+
+                        <h3><i class="fa-solid fa-map-location-dot"></i> Karte bedienen</h3>
+                        <p>Verschieben Sie die Karte per Mausklick und Ziehen. Zoomen Sie mit dem Mausrad oder den Zoom-Buttons.</p>
+
+                        <h3><i class="fa-solid fa-location-dot"></i> Beitrag hinzufügen</h3>
+                        <p>Verwenden Sie die Zeichenwerkzeuge rechts, um Hinweise, Anregungen und Vorschläge auf der Mitmachkarte als Punkte, Linien oder Flächen hinzuzufügen.</p>
+
+                        <h3><i class="fa-solid fa-thumbs-up"></i> Bewerten</h3>
+                        <p>Klicken Sie auf bestehende Beiträge und nutzen Sie die Bewertungsfunktion, um Ihre Meinung zu äußern.</p>
+
+                        <h3><i class="fa-solid fa-comments"></i> Kommentieren</h3>
+                        <p>Gerne können Sie Ihre Meinung zu bestehenden Beiträgen auch durch die Kommentarfunktion äußern.</p>
+
+                        <h3><i class="fa-solid fa-magnifying-glass"></i> Suchen</h3>
+                        <p>Verwenden Sie die Adresssuche rechts, um schnell den richtigen Ort auf der Mitmachkarte zu finden.</p>         
                     </div>
                 </div>
 
@@ -215,9 +253,11 @@ if (!$municipality) {
     <!-- Footer                                                        -->
     <!-- ============================================================= -->
     <footer id="app-footer">
+        <span class="dev-warning">
+            <i class="fa-solid fa-triangle-exclamation"></i> Demoversion - nicht in Rücksprache mit der Stadt Lohne entwickelt! Alle Beitrage, Kommentare und Personen sind frei erfunden.
+        </span>
         <div class="footer-content">
-            <img src="assets/logo-company.png" alt="Company Logo" class="footer-logo" onerror="this.style.display='none'">
-            <span class="footer-text"> Bürgerbeteiligungsportal <?= htmlspecialchars($municipality['name']) ?> </span>
+            <span class="footer-text">© <a href="https://endex-geodaten.de" target="_blank" style="color:inherit;">endex GmbH</a></span>
         </div>
     </footer>
 
@@ -234,8 +274,10 @@ if (!$municipality) {
                 <li>Hinweise und Verbesserungsvorschläge für die Stadtverwaltung hinzufügen</li>
                 <li>Bestehende Beiträge der Bürgerschaft betrachten und bewerten</li>
             </ul>
-            <p>Zum Hinzufügen von Beiträgen geben Sie bitte zunächst Ihren Namen ein.</p>
-            <div class="modal-actions">
+            <p style="background:#fff3cd;padding:10px;border-radius:6px;border:1px solid #ffc107;font-size:0.85rem;color:#856404;">
+                <i class="fa-solid fa-triangle-exclamation"></i> <strong>Hinweis:</strong> Demoversion - nicht in Rücksprache mit der Stadt Lohne entwickelt! Alle Beitrage, Kommentare und Personen sind frei erfunden.
+            </p>
+            <p>Zum Hinzufügen von Beiträgen geben Sie bitte zunächst Ihren Namen ein.</p>            <div class="modal-actions">
                 <button class="btn btn-primary" onclick="closeWelcomeAndShowLogin()">Loslegen</button>
             </div>
         </div>
@@ -287,6 +329,15 @@ if (!$municipality) {
                 <textarea id="create-description" class="form-input" rows="4" placeholder="Detaillierte Beschreibung (optional)"></textarea>
             </div>
 
+            <!-- Photo Upload -->
+            <div class="form-group">
+                <label for="create-photo"></i> Foto</label>
+                <input type="file" id="create-photo" class="form-input" accept="image/jpeg,image/png,image/gif,image/webp">
+                <div id="photo-preview" style="margin-top:8px;display:none;">
+                    <img id="photo-preview-img" style="max-width:100%;max-height:200px;border-radius:6px;border:1px solid var(--color-border);">
+                </div>
+            </div>
+
             <input type="hidden" id="create-geom">
             <input type="hidden" id="create-geom-type">
 
@@ -299,7 +350,7 @@ if (!$municipality) {
 
 
     <!-- ============================================================= -->
-    <!-- Loads JavaScript Dependencies                                       -->
+    <!-- Loads JavaScript Dependencies                                 -->
     <!-- ============================================================= -->
 
     <!-- Leaflet 1.9.4 -->
@@ -318,17 +369,24 @@ if (!$municipality) {
     <script src="https://unpkg.com/leaflet-control-geocoder@2.4.0/dist/Control.Geocoder.min.js"></script>
 
     <!-- Leaflet PolylineMeasure -->
-    <script src="https://ppete2.github.io/Leaflet.PolylineMeasure/Leaflet.PolylineMeasure.js"></script>
+    <!-- <script src="https://ppete2.github.io/Leaflet.PolylineMeasure/Leaflet.PolylineMeasure.js"></script> -->
 
     <!-- SweetAlert2 -->
-    <script src="https://cdn.jsdelivr.net/npm/sweetalert2@11/dist/sweetalert2.all.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/sweetalert2@11.14.0/dist/sweetalert2.all.min.js"></script>
+
+    <!-- Shepherd.js Library -->
+    <script src="https://cdn.jsdelivr.net/npm/shepherd.js@11.2.0/dist/js/shepherd.min.js"></script>
+
+    <!-- Onboarding Logic -->
+    <script src="js/onboarding.js"></script>
+
 
     <!-- ============================================================= -->
-    <!-- Municipality Configuration (passed to JavaScript)             -->
+    <!-- Municipality Configuration passed to JavaScript               -->
     <!-- ============================================================= -->
     <script>
-        // Municipality Configuration from Database — used by app.js
-        var MUNICIPALITY = {
+        // Municipality Configuration from Database
+        const MUNICIPALITY = {
             id: <?= $municipality['municipality_id'] ?>,
             name: "<?= htmlspecialchars($municipality['name'], ENT_QUOTES) ?>",
             slug: "<?= htmlspecialchars($municipality['slug'], ENT_QUOTES) ?>",
@@ -336,6 +394,12 @@ if (!$municipality) {
             zoom: <?= $municipality['default_zoom'] ?>,
             primaryColor: "<?= htmlspecialchars($municipality['primary_color'], ENT_QUOTES) ?>"
         };
+
+        // Category Definitions from Database
+        const CATEGORIES = <?= json_encode(get_categories(), JSON_UNESCAPED_UNICODE) ?>;
+
+        // Admin Status from PHP Session
+        const IS_ADMIN = <?= (function_exists('is_admin') && is_admin()) ? 'true' : 'false' ?>;
     </script>
 
     <!-- Application Logic -->

public/js/admin.js

@@ -0,0 +1,637 @@
+// =====================================================================
+// WebGIS Moderation Portal — Application Logic
+// Initializes Map Preview, loads Contributions from the API,
+// handles CRUD Workflow, sorting and filtering for Contributions,
+//  Comments and News, and manages all UI Interactions
+//
+// Depends on: ADMIN_CONFIG Object set in Moderation Page
+// =====================================================================
+
+// =====================================================================
+// Block 0: Configuration and Application State
+// =====================================================================
+
+// API Endpoint as relative Path
+const API_URL = 'api/contributions.php';
+
+// =====================================================================
+// Block 1: Page Tab Navigation
+// =====================================================================
+
+// Restores active Tab after Page Reload
+const savedTab = sessionStorage.getItem('admin_active_tab');
+if (savedTab) {
+    // Delays to ensure DOM is ready
+    setTimeout(function () {
+        const tabBtn = document.querySelector('.page-tab[onclick*="' + savedTab + '"]');
+        if (tabBtn) tabBtn.click();
+    }, 100);
+}
+
+
+// Page Tab Navigation
+function showPageTab(tabName) {
+    // Saves active Tab for Persistence after Reload
+    sessionStorage.setItem('admin_active_tab', tabName);
+
+    document.querySelectorAll('.page-tab-content').forEach(function (el) {
+        el.style.display = 'none';
+    });
+
+    // Deactivates all Tab Buttons
+    document.querySelectorAll('.page-tab').forEach(function (el) {
+        el.classList.remove('active');
+    });
+
+    // Shows selected Tab and activates Button
+    document.getElementById('tab-' + tabName).style.display = 'block';
+    event.currentTarget.classList.add('active');
+}
+
+
+// =====================================================================
+// Block 2: Collapsible Rows for Contributions and Comments
+// =====================================================================
+function toggleRow(row) {
+    const wasOpen = row.classList.contains('open');
+
+    // Closes all open Rows
+    document.querySelectorAll('.contribution-row.open').forEach(function (el) {
+        el.classList.remove('open');
+    });
+
+    // Toggles clicked Row
+    if (!wasOpen) {
+        row.classList.add('open');
+
+        // Loads Map Preview if not already loaded
+        const mapDiv = row.querySelector('.detail-map');
+        if (mapDiv && !mapDiv.dataset.loaded) {
+            loadMapPreview(mapDiv);
+        }
+    }
+}
+
+
+// =====================================================================
+// Block 3: Details Slider for Maps and Photos
+// =====================================================================
+function slideDetail(contributionId, direction) {
+    const slider = document.getElementById('slider-' + contributionId);
+    if (!slider) return;
+
+    const slides = slider.querySelectorAll('.detail-slide');
+    let activeIndex = -1;
+
+    // Finds active Slide
+    slides.forEach(function (slide, i) {
+        if (slide.style.display !== 'none') activeIndex = i;
+    });
+
+    // Calculates next Slide Index
+    const nextIndex = (activeIndex + direction + slides.length) % slides.length;
+
+    // Switches Slides
+    slides.forEach(function (slide) { slide.style.display = 'none'; });
+    slides[nextIndex].style.display = 'block';
+
+    // Loads Map if switching to Map Slide
+    if (slides[nextIndex].dataset.slide === 'map') {
+        const mapDiv = slides[nextIndex].querySelector('.detail-map');
+        if (mapDiv && !mapDiv.dataset.loaded) {
+            loadMapPreview(mapDiv);
+        }
+    }
+}
+
+
+// =====================================================================
+// Block 4: Map Preview (Leaflet Mini Map per Contribution)
+// =====================================================================
+
+// Erstellt eine Leaflet-Mini-Map in einem Beitrags-Detail-Container.
+// Lädt alle Beiträge via API und zeigt die Geometrie des entsprechenden Beitrags.
+// Markiert die Map als geladen (data-loaded="true"), um doppeltes Laden zu verhindern.
+function loadMapPreview(mapDiv) {
+    const contributionId = mapDiv.dataset.contributionId;
+    
+    // Fetches all Contributions to find the Geometry
+    const formData = new FormData();
+    formData.append('action', 'read');
+    formData.append('municipality_id', ADMIN_CONFIG.id);
+    formData.append('status', 'all');
+
+    fetch(API_URL, { method: 'POST', body: formData })
+        .then(function (r) { return r.json(); })
+        .then(function (data) {
+            if (!data.features) return;
+            
+            // Finds specific Contribution
+            const feature = data.features.find(function (f) {
+                return f.properties.contribution_id == contributionId;
+            });
+
+            if (!feature) {
+                mapDiv.innerHTML = '<div style="padding:20px;color:#999;text-align:center;font-size:0.8rem;">Geometrie nicht gefunden.</div>';
+                return;
+            }
+
+            // Creates Leaflet Mini Map
+            const miniMap = L.map(mapDiv, {
+                zoomControl: false,
+                attributionControl: false,
+                dragging: true,
+                scrollWheelZoom: false
+            });
+
+            L.tileLayer('https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png', {
+                maxZoom: 20
+            }).addTo(miniMap);
+
+            // Adds Geometry to Mini Map
+            const geojsonLayer = L.geoJSON(feature, {
+                style: {
+                    color: ADMIN_CONFIG.primaryColor,
+                    weight: 3,
+                    fillOpacity: 0.2
+                },
+                pointToLayer: function (f, latlng) {
+                    return L.circleMarker(latlng, {
+                        radius: 8,
+                        color: '#ffffff',
+                        weight: 2,
+                        fillColor: ADMIN_CONFIG.primaryColor,
+                        fillOpacity: 0.9
+                    });
+                }
+            }).addTo(miniMap);
+
+            // Fits Map to Geometry Bounds
+            const bounds = geojsonLayer.getBounds();
+            if (bounds.isValid()) {
+                miniMap.fitBounds(bounds, { padding: [25, 25], maxZoom: 17 });
+            } else {
+                miniMap.setView(ADMIN_CONFIG.center, 15);
+            }
+
+            mapDiv.dataset.loaded = 'true';
+        })
+        .catch(function () {
+            mapDiv.innerHTML = '<div style="padding:20px;color:#999;text-align:center;font-size:0.8rem;">Karte nicht verfügbar.</div>';
+        });
+}
+
+
+// =====================================================================
+// Block 5: Contributions Filter and Sorting
+// =====================================================================
+
+// Filters Contributions
+let currentFilter = 'all';
+function filterByStatus(status, tabButton) {
+    currentFilter = status;
+
+    // Updates active Tab
+    document.querySelectorAll('.filter-tab').forEach(function (el) {
+        el.classList.remove('active');
+    });
+    tabButton.classList.add('active');
+
+    // Shows or Hides Contribution Rows
+    let visibleCount = 0;
+    document.querySelectorAll('#contributions-container .contribution-row').forEach(function (row) {
+        if (status === 'all' || row.dataset.status === status) {
+            row.style.display = '';
+            visibleCount++;
+        } else {
+            row.style.display = 'none';
+        }
+    });
+    
+    // Updates Count Display
+    document.getElementById('visible-count').textContent = visibleCount + ' Beiträge';
+}
+
+
+// Sorts Contributions
+function sortContributions(sortBy) {
+    const container = document.getElementById('contributions-container');
+    const rows = Array.from(container.querySelectorAll('.contribution-row'));
+
+    rows.sort(function (a, b) {
+        if (sortBy === 'date-desc') return new Date(b.dataset.date) - new Date(a.dataset.date);
+        if (sortBy === 'date-asc')  return new Date(a.dataset.date) - new Date(b.dataset.date);
+        if (sortBy === 'category')  return a.dataset.category.localeCompare(b.dataset.category);
+        return 0;
+    });
+
+    // Reappends sorted Rows
+    rows.forEach(function (row) { container.appendChild(row); });
+}
+
+
+// =====================================================================
+// Block 6: Comments Filter and Sorting
+// =====================================================================
+
+// Filters Comments
+function filterCommentsByStatus(status, tabButton) {
+
+    // Updates active Tab
+    document.querySelectorAll('#comment-filter-tabs .filter-tab').forEach(function (el) {
+        el.classList.remove('active');
+    });
+    tabButton.classList.add('active');
+    
+    // Shows or Hides Comments Rows
+    let visibleCount = 0;
+    document.querySelectorAll('.comment-mod-row').forEach(function (row) {
+        if (status === 'all' || row.dataset.status === status) {
+            row.style.display = '';
+            visibleCount++;
+        } else {
+            row.style.display = 'none';
+        }
+    });
+    // Updates Count Display
+    document.getElementById('comment-visible-count').textContent = visibleCount + ' Kommentare';
+}
+
+
+// Sorts Comments
+function sortCommentRows(sortBy) {
+    const container = document.getElementById('comments-mod-container');
+    const rows = Array.from(container.querySelectorAll('.comment-mod-row'));
+
+    rows.sort(function (a, b) {
+        if (sortBy === 'date-desc')   return new Date(b.dataset.date) - new Date(a.dataset.date);
+        if (sortBy === 'date-asc')    return new Date(a.dataset.date) - new Date(b.dataset.date);
+        if (sortBy === 'contribution') return a.dataset.contribution.localeCompare(b.dataset.contribution);
+        return 0;
+    });
+    // Reappends sorted Rows
+    rows.forEach(function (row) { container.appendChild(row); });
+}
+
+
+// =====================================================================
+// Block 7: Helper Functions
+// =====================================================================
+
+// Sends a POST request to API
+// promise-based instead of callback-based
+function apiCall(data) {
+    const formData = new FormData();
+    for (const key in data) {
+        formData.append(key, data[key]);
+    }
+
+    return fetch(API_URL, { method: 'POST', body: formData })
+        .then(function (r) { return r.json(); });
+}
+
+
+// Escapes HTML to prevent Cross-Site Scripting (XSS) in Popups and Lists
+function escapeHtml(text) {
+
+    if (!text) return '';
+    const div = document.createElement('div');
+    div.appendChild(document.createTextNode(text));
+    return div.innerHTML;
+}
+
+// =====================================================================
+// Block 8: CRUD Operations for Contributions
+// =====================================================================
+
+// STATUS: Changes Contribution Status
+function changeStatus(contributionId, newStatus) {
+    const labels = { approved: 'freigeben', rejected: 'ablehnen', pending: 'zurücksetzen' };
+
+    Swal.fire({
+        title: 'Beitrag ' + labels[newStatus] + '?',
+        showCancelButton: true,
+        confirmButtonText: 'Ja',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: ADMIN_CONFIG.primaryColor
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'update',
+            contribution_id: contributionId,
+            status: newStatus
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            // Reloads Page to reflect Changes
+            location.reload();
+        });
+    });
+}
+
+
+// UPDATE: Edits existing Contributions
+function editContribution(contributionId, currentTitle, currentDescription) {
+    Swal.fire({
+        title: 'Beitrag bearbeiten',
+        html:
+            '<div style="text-align:left;">' +
+                '<div style="margin-bottom:12px;">' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Titel</label>' +
+                    '<input id="swal-title" class="swal2-input" style="margin:0;width:100%;" value="' + escapeHtml(currentTitle) + '">' +
+                '</div>' +
+                '<div>' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Beschreibung</label>' +
+                    '<textarea id="swal-description" class="swal2-textarea" style="margin:0;width:100%;">' + escapeHtml(currentDescription) + '</textarea>' +
+                '</div>' +
+            '</div>',
+        showCancelButton: true,
+        confirmButtonText: 'Speichern',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: ADMIN_CONFIG.primaryColor,
+        preConfirm: function () {
+            return {
+                title: document.getElementById('swal-title').value.trim(),
+                description: document.getElementById('swal-description').value.trim()
+            };
+        }
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'update',
+            contribution_id: contributionId,
+            title: result.value.title,
+            description: result.value.description
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Gespeichert!', 'Beitrag wurde aktualisiert.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}
+
+
+// DELETE: Deletes existing Contributions
+function deleteContribution(contributionId) {
+    Swal.fire({
+        title: 'Beitrag löschen?',
+        text: 'Diese Aktion kann nicht rückgängig gemacht werden.',
+        icon: 'warning',
+        showCancelButton: true,
+        confirmButtonText: 'Beitrag löschen',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: '#c62828'
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'delete',
+            contribution_id: contributionId
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Gelöscht!', 'Beitrag wurde gelöscht.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}
+
+// =====================================================================
+// Block 9: CRUD Operations for Comments
+// =====================================================================
+
+// STATUS: Changes Comment Status
+function changeCommentStatus(commentId, newStatus) {
+    const labels = { approved: 'akzeptieren', rejected: 'ablehnen', pending: 'zurücksetzen' };
+
+    Swal.fire({
+        title: 'Kommentar ' + labels[newStatus] + '?',
+        showCancelButton: true,
+        confirmButtonText: 'Ja',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: ADMIN_CONFIG.primaryColor
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'update_comment',
+            comment_id: commentId,
+            status: newStatus
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            location.reload();
+        });
+    });
+}
+
+
+// UPDATE: Edits existing Comments
+function editModComment(commentId, currentContent) {
+    Swal.fire({
+        title: 'Kommentar bearbeiten',
+        html:
+            '<div style="text-align:left;">' +
+                '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Inhalt</label>' +
+                '<textarea id="swal-comment-content" class="swal2-textarea" style="margin:0;width:100%;">' + escapeHtml(currentContent) + '</textarea>' +
+            '</div>',
+        showCancelButton: true,
+        confirmButtonText: 'Speichern',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: ADMIN_CONFIG.primaryColor,
+        preConfirm: function () {
+            return { content: document.getElementById('swal-comment-content').value.trim() };
+        }
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'update_comment',
+            comment_id: commentId,
+            content: result.value.content
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Gespeichert!', 'Kommentar wurde aktualisiert.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}
+
+
+// DELETE: Deletes existing Comments
+function deleteModComment(commentId) {
+    Swal.fire({
+        title: 'Kommentar löschen?',
+        text: 'Diese Aktion kann nicht rückgängig gemacht werden.',
+        icon: 'warning',
+        showCancelButton: true,
+        confirmButtonText: 'Löschen',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: '#c62828'
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'delete_comment',
+            comment_id: commentId
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Gelöscht!', 'Kommentar wurde entfernt.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}
+
+
+// =====================================================================
+// Block 10: CRUD Operations for News
+// =====================================================================
+
+// CREATE: Submits new News Article
+function createNews() {
+    Swal.fire({
+        title: 'Neuigkeit hinzufügen',
+        html:
+            '<div style="text-align:left;">' +
+                '<div style="margin-bottom:12px;">' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Titel</label>' +
+                    '<input id="swal-news-title" class="swal2-input" style="margin:0;width:100%;" placeholder="Titel der Neuigkeit">' +
+                '</div>' +
+                '<div style="margin-bottom:12px;">' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Inhalt</label>' +
+                    '<textarea id="swal-news-content" class="swal2-textarea" style="margin:0;width:100%;" placeholder="Neuigkeit verfassen..."></textarea>' +
+                '</div>' +
+                '<div>' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Autor</label>' +
+                    '<input id="swal-news-author" class="swal2-input" style="margin:0;width:100%;" value="Stadtverwaltung">' +
+                '</div>' +
+            '</div>',
+        showCancelButton: true,
+        confirmButtonText: 'Veröffentlichen',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: ADMIN_CONFIG.primaryColor,
+        preConfirm: function () {
+            const title   = document.getElementById('swal-news-title').value.trim();
+            const content = document.getElementById('swal-news-content').value.trim();
+            const author  = document.getElementById('swal-news-author').value.trim() || 'Stadtverwaltung';
+            if (!title || !content) {
+                Swal.showValidationMessage('Titel und Inhalt sind Pflichtfelder.');
+                return false;
+            }
+            return { title, content, author_name: author };
+        }
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'create_news',
+            municipality_id: ADMIN_CONFIG.id,
+            title: result.value.title,
+            content: result.value.content,
+            author_name: result.value.author_name
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Veröffentlicht!', 'Neuigkeit wurde veröffentlicht.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}
+
+
+// UPDATE: Edits existing News
+function editNews(newsId, currentTitle, currentContent, currentAuthor) {
+    Swal.fire({
+        title: 'Neuigkeit bearbeiten',
+        html:
+            '<div style="text-align:left;">' +
+                '<div style="margin-bottom:12px;">' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Titel</label>' +
+                    '<input id="swal-news-title" class="swal2-input" style="margin:0;width:100%;" value="' + escapeHtml(currentTitle) + '">' +
+                '</div>' +
+                '<div style="margin-bottom:12px;">' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Inhalt</label>' +
+                    '<textarea id="swal-news-content" class="swal2-textarea" style="margin:0;width:100%;">' + escapeHtml(currentContent) + '</textarea>' +
+                '</div>' +
+                '<div>' +
+                    '<label style="display:block;font-weight:600;font-size:1.15rem;margin-bottom:4px;">Autor</label>' +
+                    '<input id="swal-news-author" class="swal2-input" style="margin:0;width:100%;" value="' + escapeHtml(currentAuthor) + '">' +
+                '</div>' +
+            '</div>',
+        showCancelButton: true,
+        confirmButtonText: 'Speichern',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: ADMIN_CONFIG.primaryColor,
+        preConfirm: function () {
+            return {
+                title:       document.getElementById('swal-news-title').value.trim(),
+                content:     document.getElementById('swal-news-content').value.trim(),
+                author_name: document.getElementById('swal-news-author').value.trim() || 'Stadtverwaltung'
+            };
+        }
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'update_news',
+            news_id: newsId,
+            title: result.value.title,
+            content: result.value.content,
+            author_name: result.value.author_name
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Gespeichert!', 'Neuigkeit wurde aktualisiert.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}
+
+
+// DELETE: Deletes existing News
+function deleteNews(newsId) {
+    Swal.fire({
+        title: 'Neuigkeit löschen?',
+        text: 'Diese Aktion kann nicht rückgängig gemacht werden.',
+        icon: 'warning',
+        showCancelButton: true,
+        confirmButtonText: 'Löschen',
+        cancelButtonText: 'Abbrechen',
+        confirmButtonColor: '#c62828'
+    }).then(function (result) {
+        if (!result.isConfirmed) return;
+
+        apiCall({
+            action: 'delete_news',
+            news_id: newsId
+        }).then(function (response) {
+            if (response.error) {
+                Swal.fire('Fehler', response.error, 'error');
+                return;
+            }
+            Swal.fire('Gelöscht!', 'Neuigkeit wurde gelöscht.', 'success')
+                .then(function () { location.reload(); });
+        });
+    });
+}

public/js/onboarding.js

@@ -0,0 +1,277 @@
+// =====================================================================
+// WebGIS Citizen Participation Portal — Onboarding Tour
+// Guides Users through the Participation Portal
+// =====================================================================
+
+
+// =================================================================
+// Block 1: Onboarding Configuration
+// =================================================================
+
+// ONBOARDING_MODE — Controls when the Tutorial is shown:
+const ONBOARDING_MODE = 'once';
+//     'once'    — Shown on first Visit, stored in localStorage
+//     'session' — Shown per Browser Session, stored in sessionStorage
+//     'always'  — Shows always, nothing stored
+
+// Prevents double Initialization
+let onboardingStarted = false;
+
+
+// =================================================================
+// Block 2: Tour Initialization
+// =================================================================
+
+function initOnboardingTour() {
+
+    // Checks if Tutorial should be shown based on Onboarding Mode
+    if (ONBOARDING_MODE === 'once' && localStorage.getItem('webgis_onboarding_done')) {
+        return;
+    }
+    if (ONBOARDING_MODE === 'session' && sessionStorage.getItem('webgis_onboarding_done')) {
+        return;
+    }
+
+    // Waits for Welcome and Login Modals to be closed
+    waitForModalsToClose(function () {
+        setTimeout(startTour, 600);
+    });
+}
+
+
+// =================================================================
+// Block 3: Modal Watcher — Starts Tour other Welcome and Login Modals closed
+// =================================================================
+
+function waitForModalsToClose(callback) {
+    const welcomeModal = document.getElementById('welcome-modal');
+    const loginModal = document.getElementById('login-modal');
+
+    const checkInterval = setInterval(function () {
+        const welcomeHidden = !welcomeModal || welcomeModal.style.display === 'none' || welcomeModal.style.display === '';
+        const loginHidden = !loginModal || loginModal.style.display === 'none' || loginModal.style.display === '';
+
+        if (welcomeHidden && loginHidden) {
+            clearInterval(checkInterval);
+            callback();
+        }
+    }, 300);
+
+    // Safety Timeout
+    setTimeout(function () {
+        clearInterval(checkInterval);
+        callback();
+    }, 30000);
+}
+
+
+// =================================================================
+// Block 4: Tour Definition
+// =================================================================
+
+function startTour() {
+    // Prevents double Start
+    if (onboardingStarted) return;
+    onboardingStarted = true;
+
+    const tour = new Shepherd.Tour({
+        useModalOverlay: true,
+        defaultStepOptions: {
+            cancelIcon: { enabled: true },
+            scrollTo: false,
+            classes: 'onboarding-step',
+            popperOptions: {
+                modifiers: [
+                    { name: 'offset', options: { offset: [0, 14] } }
+                ]
+            }
+        }
+    });
+
+
+    // -----------------------------------------------------------------
+    // Step 1: Welcome
+    // -----------------------------------------------------------------
+    tour.addStep({
+        id: 'welcome',
+        title: '<i class="fa-solid fa-hand-wave"></i> Wilkommen bei der Mitmachkarte!',
+        text: 'Dieses interaktive Tutorial zeigt Ihnen die Kernfunktionen der Mitmachkarte.' +
+              '<br><br><span style="font-size:0.8rem;color:var(--color-text-secondary);">Sie können das Tutorial jederzeit durch den Hilfe-Tab der Seitenleiste wiederholen.</span>',
+        buttons: [
+            {
+                text: 'Überspringen',
+                action: tour.cancel,
+                classes: 'shepherd-button-secondary'
+            },
+            {
+                text: 'Los geht\'s <i class="fa-solid fa-arrow-right"></i>',
+                action: tour.next,
+                classes: 'shepherd-button-primary'
+            }
+        ]
+    });
+
+
+    // -----------------------------------------------------------------
+    // Step 2: Drawing Tools
+    // -----------------------------------------------------------------
+    tour.addStep({
+        id: 'drawing-tools',
+        title: '<i class="fa-solid fa-pencil"></i> Beitrag hinzufügen',
+        text: 'Verwenden Sie die <strong>Zeichenwerkzeuge</strong>, um Hinweise, Anregungen und Vorschläge auf der Mitmachkarte als Punkte, Linien oder Flächen hinzuzufügen.',
+        attachTo: {
+            element: '.leaflet-pm-toolbar',
+            on: 'left'
+        },
+        beforeShowPromise: function () {
+            return new Promise(function (resolve) {
+                sidebar.close();
+                setTimeout(resolve, 300);
+            });
+        },
+        buttons: [
+            {
+                text: '<i class="fa-solid fa-arrow-left"></i> Zurück',
+                action: tour.back,
+                classes: 'shepherd-button-secondary'
+            },
+            {
+                text: 'Weiter <i class="fa-solid fa-arrow-right"></i>',
+                action: tour.next,
+                classes: 'shepherd-button-primary'
+            }
+        ]
+    });
+
+
+    // -----------------------------------------------------------------
+    // Step 3: Address Search
+    // -----------------------------------------------------------------
+    tour.addStep({
+        id: 'address-search',
+        title: '<i class="fa-solid fa-magnifying-glass"></i> Adresssuche',
+        text: 'Verwenden Sie die <strong>Adresssuche</strong>, um schnell den richtigen Ort auf der Mitmachkarte zu finden.',
+        attachTo: {
+            element: '.leaflet-control-geocoder',
+            on: 'left'
+        },
+        buttons: [
+            {
+                text: '<i class="fa-solid fa-arrow-left"></i> Zurück',
+                action: tour.back,
+                classes: 'shepherd-button-secondary'
+            },
+            {
+                text: 'Weiter <i class="fa-solid fa-arrow-right"></i>',
+                action: tour.next,
+                classes: 'shepherd-button-primary'
+            }
+        ]
+    });
+
+
+    // -----------------------------------------------------------------
+    // Step 4: Layer Control
+    // -----------------------------------------------------------------
+    tour.addStep({
+        id: 'layer-control',
+        title: '<i class="fa-solid fa-layer-group"></i> Kartenansicht',
+        text: 'Wechseln Sie zwischen verschiedenen <strong>Hintergrundkarten</strong> und <strong>Satellitenbildern</strong>.',
+        attachTo: {
+            element: '.leaflet-control-layers',
+            on: 'left'
+        },
+        buttons: [
+            {
+                text: '<i class="fa-solid fa-arrow-left"></i> Zurück',
+                action: tour.back,
+                classes: 'shepherd-button-secondary'
+            },
+            {
+                text: 'Weiter <i class="fa-solid fa-arrow-right"></i>',
+                action: tour.next,
+                classes: 'shepherd-button-primary'
+            }
+        ]
+    });
+
+
+    // -----------------------------------------------------------------
+    // Step 5: Sidebar
+    // -----------------------------------------------------------------
+    tour.addStep({
+        id: 'sidebar',
+        title: '<i class="fa-solid fa-bars"></i> Seitenleiste',
+        text: 'In der Seitenleiste finden Sie <strong>Hilfestellungen</strong>, <strong>Listenansichten</strong> und <strong>Neuigkeiten</strong>.',
+        attachTo: {
+            element: '#sidebar',
+            on: 'right'
+        },
+        beforeShowPromise: function () {
+            return new Promise(function (resolve) {
+                sidebar.open('tab-help');
+                setTimeout(resolve, 400);
+            });
+        },
+        buttons: [
+            {
+                text: '<i class="fa-solid fa-arrow-left"></i> Zurück',
+                action: tour.back,
+                classes: 'shepherd-button-secondary'
+            },
+            {
+                text: 'Tutorial abschließen <i class="fa-solid fa-check"></i>',
+                action: tour.next,
+                classes: 'shepherd-button-primary'
+            }
+        ]
+    });
+
+
+    // -----------------------------------------------------------------
+    // Completion and Cancellation
+    // -----------------------------------------------------------------
+    tour.on('complete', function () {
+        markOnboardingDone();
+        onboardingStarted = false;
+    });
+
+    tour.on('cancel', function () {
+        markOnboardingDone();
+        onboardingStarted = false;
+    });
+
+    tour.start();
+}
+
+
+// =================================================================
+// Marks Onboarding as completed
+// =================================================================
+
+function markOnboardingDone() {
+    if (ONBOARDING_MODE === 'once') {
+        localStorage.setItem('webgis_onboarding_done', 'true');
+    } else if (ONBOARDING_MODE === 'session') {
+        sessionStorage.setItem('webgis_onboarding_done', 'true');
+    }
+}
+
+
+// =================================================================
+// Manual Tour Restart
+// =================================================================
+
+function restartOnboarding() {
+    localStorage.removeItem('webgis_onboarding_done');
+    sessionStorage.removeItem('webgis_onboarding_done');
+    onboardingStarted = false;
+    startTour();
+}
+
+
+// =================================================================
+// Auto-Start on Page Load
+// =================================================================
+
+initOnboardingTour();

public/privacy.php

@@ -0,0 +1,39 @@
+<?php
+require_once __DIR__ . '/api/db.php';
+$pdo = get_db();
+$stmt = $pdo->prepare("SELECT * FROM municipalities WHERE slug = :slug");
+$stmt->execute([':slug' => getenv('MUNICIPALITY_SLUG')]);
+$municipality = $stmt->fetch();
+?>
+<!DOCTYPE html>
+<html lang="de">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Datenschutz — <?= htmlspecialchars($municipality['name']) ?></title>
+    <link rel="icon" href="assets/lock-solid-off-black.png" type="image/png">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    <link rel="stylesheet" href="styles.css">
+    <style>:root { --color-primary: <?= htmlspecialchars($municipality['primary_color']) ?>; }</style>
+</head>
+<body>
+    <div class="page-header">
+        <div class="page-header-inner">
+            <h1><i class="fa-solid fa-lock"></i> Datenschutz</h1>
+            <div class="page-header-nav">
+                <a href="index.php"><i class="fa-solid fa-arrow-left"></i> Zurück zur Karte</a>
+            </div>
+        </div>
+    </div>
+    <div class="page-container">
+        <div class="page-content-box">
+            <div class="dev-notice">
+                <i class="fa-solid fa-triangle-exclamation"></i>
+                Dieses Portal befindet sich in der Entwicklung und wurde nicht offiziell beauftragt. Die Datenschutzerklärung wird mit der offiziellen Inbetriebnahme hier hinzugefügt.
+            </div>
+            <h2>Datenschutz</h2>
+            <p>Die Datenschutzerklärung wird hier hinzugefügt, sobald das Portal in den Produktivbetrieb geht.</p>
+        </div>
+    </div>
+</body>
+</html>

public/uploads/.htaccess

@@ -0,0 +1,7 @@
+# Prevents PHP in Upload Directory
+php_flag engine off
+
+# Allows Image Files
+<FilesMatch "\.(?i:jpg|jpeg|png|gif|webp)$">
+    Require all granted
+</FilesMatch>

README.md

@@ -5,10 +5,8 @@ Citizen Participation Portal for Lohne (Oldenburg).
 ## Project Structure
 
 - `migrations/` — versioned SQL Schema Migrations
-- `api/` — Backend (PHP)
 - `public/` — Frontend (HTML, CSS, JS)
 - `scripts/` — Maintenance Scripts (backup, deployment)
-- `legacy/` — Reference Code from Prototype
 
 ## Local Setup