# 🧹 Curator Journal: Domain-Driven Naming & Connectivity Fix

**Datum:** 18. April 2026
**Agent:** 🧹 [Curator] & 🏗️ [Lead Architect]

## 🎯 Fokus der Session

Die Session konzentrierte sich auf die Implementierung aussagekräftigerer Namen für unsere Navigations-Routen (
Domain-Driven Naming) und die Behebung eines kritischen Zugriffsproblems auf den Ping-Service (jetzt
`ConnectivityCheck`).

## 🛠️ Erledigte Aufgaben

### 1. Domain-Driven Naming Refactoring

In der `AppScreen.kt` wurden generische oder technische Namen durch fachlich präzisere Begriffe ersetzt:

- `Ping` → `ConnectivityCheck` (Konnektivitäts-Diagnose)
- `Landing` → `PortalDashboard`
- `Nennung` → `EntryManagement`
- `Onboarding` → `DeviceInitialization`

**Auswirkung:** Alle Referenzen im Projekt (Navigation, Layouts, Screens) wurden automatisch via `rename_element`
synchronisiert. Dies erhöht die fachliche Lesbarkeit des Codes massiv.

### 2. Connectivity-Service Bugfix (Login-Gate)

Ein Fehler verhinderte das Öffnen des Ping-Screens, da dieser im Login-Gate der `DesktopApp.kt` nicht als Ausnahme
definiert war. Nicht-authentifizierte Nutzer wurden daher sofort zurück zum Onboarding-Screen geleitet.

**Lösung:**

- `AppScreen.ConnectivityCheck` wurde zur Whitelist der öffentlichen Screens in `DesktopApp.kt` hinzugefügt.
- Der Zugriff ist nun auch ohne aktiven Keycloak-Login möglich, um die Verbindung überhaupt erst testen zu können.

### 3. UI/UX Polishing

- Die Labels in der Sidebar und die Breadcrumbs wurden an die neuen Namen angepasst.
- "ConnectivityCheck Service" wurde in der UI zu "Konnektivitäts-Diagnose" (deutsch) geändert.

## 📜 ADR Update

Das Architektur-Prinzip aus **ADR-0024** (Plug-and-Play Architektur) wurde durch diese Session weiter gefestigt, da die
Komponenten nun noch klarer über ihre fachlichen Namen adressiert werden.

## 🧐 QA & Stabilität

- Alle Pfade wurden manuell geprüft.
- Die Navigation `Ping` -> `Onboarding` (Loop) wurde erfolgreich durchbrochen.
- Die Kompiliermöglichkeit wurde durch die Nutzung des `rename_element` Tools und anschließende Code-Inspektion
  sichergestellt.

**Status:** ✅ Abgeschlossen. Die Basis für den weiteren Aufbau der Plug-and-Play Komponenten ist gelegt.