mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3b4e3db51d
meldestelle/docs/99_Journal/2026-04-18_Session_Abschluss_Domain-Naming-Connectivity-Fix.md
Stefan Mogeritsch 7bbb991e69 refactor(desktop, core): Onboarding zu DeviceInitialization umbenannt, Navigation und Screens angepasst 
Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-04-18 11:10:05 +02:00

2.2 KiB
Raw Blame History

🧹 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.