From a82893d4ff71071fc8ada0c7a3fd4fdbed7fb4ca Mon Sep 17 00:00:00 2001
From: Lars Gebhardt-Kusche <lars@kusche.berlin>
Date: Mon, 4 May 2026 01:40:03 +0200
Subject: [PATCH] adsad

---
 PROJECT_CONTEXT.md                      | 22 +++++++++++++++++++---
 README.md                               | 21 +++++++++++++++++++++
 partials/landingpages/modules/index.php |  8 ++++----
 3 files changed, 44 insertions(+), 7 deletions(-)

diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md
index 03fbe7a..6f688a0 100644
--- a/PROJECT_CONTEXT.md
+++ b/PROJECT_CONTEXT.md
@@ -55,17 +55,33 @@ Modulspezifische Assets:
 - Globale Layouts: /partials/structure und /public/assets/css/app.css.
 - Konfigurationslogik: nur wenn nötig /config/ und /src/.
 
-7) Sicherheits-/Netzwerk-Constraints
+7) UI-Naming und Seitenaufbau
+- `Seitenheader-Box`: oberste globale Header-Box mit Seitentitel, Login und Farbschema.
+- `Submenü-Box`: Box direkt unter der Seitenheader-Box für modul- oder seitenbezogene Aktionen.
+- `Bereichs-Box`: größere Inhaltsbox für einen zusammenhängenden Seitenbereich.
+- `Karten-Box`: kleinere Karte auf derselben Ebene wie Bereichs-Boxen, meist in Grids.
+- Modulseiten sollen diesem Muster folgen:
+  - zuerst Seitenheader-Box
+  - danach Submenü-Box
+  - danach Bereichs-Boxen und/oder Karten-Boxen je nach Modul
+- `Setup` gehört in Modulen grundsätzlich in die Submenü-Box.
+- Beispielstruktur:
+  - Börsenchecker: Seitenheader-Box, Submenü-Box, Bereichs-Box, Karten-Boxen, Bereichs-Box
+  - FX-Rates: Seitenheader-Box, Submenü-Box, danach Bereichs-Boxen
+  - Mining-Checker: Seitenheader-Box, Submenü-Box, Bereichs-Box, Karten-Boxen, Karten-Boxen, Bereichs-Box
+  - Modulverwaltung: Seitenheader-Box, Submenü-Box, danach Karten-Boxen
+
+8) Sicherheits-/Netzwerk-Constraints
 - Zugriff im Heimnetz (192.168.178.0/24) per Nginx begrenzt.
 - SSH-Hosts nur Heimnetz.
 
-8) Pi Control Besonderheiten (konkret)
+9) Pi Control Besonderheiten (konkret)
 - Worker/Jobs unter /tools/pi_control/
 - Check-Updates & Cron nutzen die gleichen SSH-Routinen.
 - Host-Karten, Befehle und Konsole sind UI im Modul.
 - Update/Upgrade-Checks liefern Debug-Ausgaben, die als Tooltip oder Debugzeile angezeigt werden.
 
-9) Zusammenfassung (kurz)
+10) Zusammenfassung (kurz)
 Nexus ist modular, mit strikter Trennung zwischen globalem Layout und modulspezifischem Code.
 Staging/Live haben eigene /app/<env>/config-Strukturen; /config/<env> im Repo wird beim Deployment kopiert.
 Modul-Assets gehören ausschließlich in den Modul-Ordner und werden dort geladen.
diff --git a/README.md b/README.md
index 049aa62..a26c392 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,27 @@
 # Nexus
 # Comment by Lars
 
+## UI-Naming
+
+Für die Oberfläche gilt projektweit dieses Naming:
+
+- `Seitenheader-Box`: globaler Header mit Seitentitel, Login und Farbschema
+- `Submenü-Box`: zusätzliche modul- oder seitenbezogene Aktionen direkt unter dem Seitenheader; `Setup` soll in Modulen immer vorhanden sein
+- `Bereichs-Box`: größere Inhaltsbox für einen zusammenhängenden Bereich; davon können beliebig viele untereinander folgen
+- `Karten-Box`: kleinere Inhaltskarte auf derselben Ebene wie Bereichs-Boxen, typischerweise innerhalb eines Grids für Kennzahlen, Statistiken oder Modulübersichten
+
+Beispiele:
+
+- `Börsenchecker`: Seitenheader-Box, Submenü-Box, Bereichs-Box, Karten-Boxen, Bereichs-Box
+- `FX-Rates`: Seitenheader-Box, Submenü-Box, danach Bereichs-Boxen
+- `Mining-Checker`: Seitenheader-Box, Submenü-Box, Bereichs-Box, Karten-Boxen, Karten-Boxen, Bereichs-Box
+- `Modulverwaltung`: Seitenheader-Box, Submenü-Box, danach Karten-Boxen
+
+Technisch:
+
+- globale Shell und Header in `partials/structure/` und `public/assets/css/app.css`
+- modulbezogene Inhalte und Assets ausschließlich unter `modules/<modul>/`
+
 
 ## Getting started
 
diff --git a/partials/landingpages/modules/index.php b/partials/landingpages/modules/index.php
index c33be2b..e02bb1a 100644
--- a/partials/landingpages/modules/index.php
+++ b/partials/landingpages/modules/index.php
@@ -47,14 +47,14 @@ if ($_SERVER['REQUEST_METHOD'] === 'POST') {
     }
 }
 ?>
-<div class="card">
-  <?php require_auth(); ?>
+<?php require_auth(); ?>
+<div class="module-flow">
   <?php if ($error): ?>
-    <div class="bg-red-900 border-l-4 border-red-500 text-red-100 p-4 mb-6" role="alert">
+    <div class="module-box-soft bg-red-900 border-l-4 border-red-500 text-red-100" role="alert">
       <?= e($error) ?>
     </div>
   <?php elseif ($notice): ?>
-    <div class="card" style="margin-top:1rem; border-color:var(--accent-2);">
+    <div class="module-box-soft" style="border-color:var(--accent-2);">
       <?= e($notice) ?>
     </div>
   <?php endif; ?>