feat: Implement API for managing network connections, device types, and uploads

app/lib/helpers.php

@@ -1,2 +1,169 @@
 <?php
-// Hilfsfunktionen (Escaping, Redirects, Formatierungen)
+/**
+ * app/lib/helpers.php
+ *
+ * Zentrale Hilfsfunktionen
+ * - Output-Escaping
+ * - Redirects
+ * - Flash-Messages
+ * - Request-Helper
+ * - Allgemeine Utilities
+ *
+ * KEINE Business-Logik
+ */
+
+/* =========================
+ * Output / Sicherheit
+ * ========================= */
+
+/**
+ * HTML-Escaping
+ *
+ * @param string|null $value
+ * @return string
+ */
+function e(?string $value): string
+{
+    // TODO: htmlspecialchars mit ENT_QUOTES + UTF-8
+    return '';
+}
+
+/* =========================
+ * Redirects
+ * ========================= */
+
+/**
+ * HTTP Redirect
+ *
+ * @param string $url
+ * @param int $code
+ */
+function redirect(string $url, int $code = 302): void
+{
+    // TODO: header("Location: ...")
+    exit;
+}
+
+/* =========================
+ * Flash Messages
+ * ========================= */
+
+/**
+ * Flash-Message setzen
+ *
+ * @param string $type (success, error, info)
+ * @param string $message
+ */
+function flash(string $type, string $message): void
+{
+    // TODO: In $_SESSION speichern
+}
+
+/**
+ * Flash-Messages abrufen & löschen
+ *
+ * @return array
+ */
+function getFlashes(): array
+{
+    // TODO: Aus Session lesen und löschen
+    return [];
+}
+
+/* =========================
+ * Request Helper
+ * ========================= */
+
+/**
+ * POST-Wert holen
+ *
+ * @param string $key
+ * @param mixed $default
+ * @return mixed
+ */
+function post(string $key, $default = null)
+{
+    // TODO: $_POST prüfen
+    return $default;
+}
+
+/**
+ * GET-Wert holen
+ *
+ * @param string $key
+ * @param mixed $default
+ * @return mixed
+ */
+function get(string $key, $default = null)
+{
+    // TODO: $_GET prüfen
+    return $default;
+}
+
+/**
+ * Prüfen, ob Request POST ist
+ *
+ * @return bool
+ */
+function isPost(): bool
+{
+    // TODO: $_SERVER['REQUEST_METHOD']
+    return false;
+}
+
+/* =========================
+ * Validierung
+ * ========================= */
+
+/**
+ * Prüft auf leeren Wert
+ *
+ * @param mixed $value
+ * @return bool
+ */
+function isEmpty($value): bool
+{
+    // TODO: trim + empty
+    return false;
+}
+
+/* =========================
+ * Pfade / URLs
+ * ========================= */
+
+/**
+ * Baut eine URL zur App
+ *
+ * @param string $path
+ * @return string
+ */
+function url(string $path = ''): string
+{
+    // TODO: Base-URL aus config.php
+    return $path;
+}
+
+/* =========================
+ * Debug / Entwicklung
+ * ========================= */
+
+/**
+ * Dump & Die (nur Dev)
+ *
+ * @param mixed $value
+ */
+function dd($value): void
+{
+    // TODO: var_dump / print_r + exit
+    exit;
+}
+
+/* =========================
+ * Sonstiges
+ * ========================= */
+
+// TODO: Weitere Helfer nach Bedarf
+// - Datum formatieren
+// - Bytes → MB
+// - UUID erzeugen
+// - SVG-Koordinaten normalisieren