From 6eabd5e100091c8af744ce80de5e6fe163f807ba Mon Sep 17 00:00:00 2001 From: neodk2004 Date: Tue, 15 Sep 2026 19:27:29 +0200 Subject: [PATCH] README: Kategorien-Layout und Firewall-Regeln in IST-Zustand-Analyse dokumentieren Aktualisiert die Beschreibung des dritten Wizard-Schritts, das Architektur- Flowdiagramm (neue RouterOS-Endpunkte, Band-Layout, Teilbaum-Hervorhebung statt reiner Pfad-Hervorhebung) auf den aktuellen Code-Stand. Co-Authored-By: Claude Sonnet 5 --- README.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 2dbcf0c..b4b57eb 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ Schritt für Schritt, mit Erklär-Tooltips (ⓘ) bei jedem Fachbegriff: 1. **Verbindung** – IP-Adresse, Benutzername, Passwort 2. **Geräte-Erkennung** – liest Modell, RouterOS-Version und Schnittstellen aus -3. **Vorhandene Netzwerke** – bei einem Bestandsgerät: anklickbare Grafik der bereits eingerichteten Bridges, VLANs, IP-Adressen, DHCP-Server, Routen und WLANs (siehe unten); bei werksneuen Geräten erscheint nur ein kurzer Hinweis +3. **Vorhandene Netzwerke** – bei einem Bestandsgerät: nach Kategorien gruppierte, anklickbare Grafik der bereits eingerichteten Bridges, VLANs, IP-Adressen, DHCP-Server, WLANs und IP-gebundenen Firewall-/NAT-Regeln (siehe unten); bei werksneuen Geräten erscheint nur ein kurzer Hinweis 4. **Modus wählen** – geführter Assistent (Standard) oder **Experten-Modus**: Letzterer blendet in den folgenden Schritten zusätzliche, technischere RouterOS-Optionen ein (siehe unten) 5. **Internet-Zugang** – WAN-Schnittstelle, DHCP oder feste IP, NAT 6. **Heimnetzwerk (DHCP)** – Bridge, IP-Bereich, DHCP-Server, DNS @@ -29,7 +29,7 @@ Nichts wird am Gerät verändert, bevor der Nutzer in der Zusammenfassung ausdr ### Vorhandene Netzwerke (IST-Zustand-Analyse) -Bei einem bereits konfigurierten Bestandsgerät liest der dritte Schritt automatisch aus, was dort schon eingerichtet ist, und zeichnet es als Diagramm: jeder Knoten ist eine Bridge, ein VLAN, eine IP-Adresse, ein DHCP-Server, ein WLAN oder der Internet-Zugang. Ein Klick auf einen Knoten hebt seinen kompletten Weg („Hops") bis zum Internet-Zugang hervor. Rein informativ — verändert nichts am Gerät und fließt nicht in die vom Assistenten geplante Konfiguration ein. Bei einem werksneuen Gerät ohne bestehende Konfiguration erscheint statt der Grafik nur ein kurzer Hinweis. +Bei einem bereits konfigurierten Bestandsgerät liest der dritte Schritt automatisch aus, was dort schon eingerichtet ist, und zeichnet es als Diagramm: jeder Knoten ist eine Bridge, ein VLAN, eine IP-Adresse, ein DHCP-Server, ein WLAN, eine IP-gebundene Firewall-/NAT-Regel oder der Internet-Zugang. Die Grafik ist in Kategorie-Bänder gruppiert (Internet, Netzwerk-Schnittstellen, IP-Adressen, DHCP-Server, Firewall-Regeln) für eine klare Übersicht statt eines einzelnen unübersichtlichen Baums. Ein Klick auf einen Knoten hebt alles hervor, was mit ihm verbunden ist — sowohl den Weg („Hops") bis zum Internet-Zugang als auch alles, was von diesem Knoten abhängt (z. B. zeigt ein Klick auf eine Bridge alle angeschlossenen Ports, VLANs, IP-Adressen und DHCP-Server). Rein informativ — verändert nichts am Gerät und fließt nicht in die vom Assistenten geplante Konfiguration ein. Bei einem werksneuen Gerät ohne bestehende Konfiguration erscheint statt der Grafik nur ein kurzer Hinweis. ### Experten-Modus @@ -147,15 +147,17 @@ Der `ModeSelectionStepViewModel`-Schritt setzt lediglich `WizardSession.IsExpert ```mermaid flowchart LR Service["NetworkAnalysisService
Core/Analysis"] - Facts["Existing*-Records
Bridge-Ports, VLANs, IP-Adressen,
DHCP-Server, Routen, WLANs"] + Facts["Existing*-Records
Bridge-Ports, VLANs, IP-Adressen,
DHCP-Server, Routen, WLANs, Firewall-Regeln"] StepVM["NetworkAnalysisStepViewModel
App"] - Graph["TopologyNodeViewModel / TopologyConnectionViewModel
Spalten-Layout, IsHighlighted"] - Editor["nodify:NodifyEditor
Klick -> SelectedItem -> Pfad-Hervorhebung"] + Graph["TopologyNodeViewModel / TopologyConnectionViewModel
Band-Layout (Kategorien), IsHighlighted"] + Editor["nodify:NodifyEditor
Klick -> SelectedItem -> Teilbaum-Hervorhebung"] Service --> Facts --> StepVM --> Graph --> Editor ``` -`NetworkAnalysisService` fragt (fehlertolerant pro Endpunkt) `/interface/bridge/port`, `/interface/vlan`, `/ip/address`, `/ip/pool`, `/ip/dhcp-server`, `/ip/route` und `/interface/wireless` ab und liefert reine Fakten — keine Positions-/Grafik-Konzepte, Core bleibt UI-frei. Der Step-ViewModel (App) baut daraus einen Baum: jeder Knoten hat höchstens einen `ParentNodeId` (Bridge-Port → Bridge, VLAN → Eltern-Interface, IP/DHCP → ihr Interface, WAN-Interface → synthetischer „Internet"-Knoten anhand der Standardroute). Das macht Pfad-Hervorhebung trivial (Eltern-Kette hochlaufen) und ein eigenes Auto-Layout überflüssig (Spalte = Tiefe im Baum). Die Grafik selbst nutzt [Nodify](https://github.com/miroiu/nodify) (reines, abhängigkeitsfreies WPF-Steuerelement für MVVM-Node-Editoren) — Klicks laufen über dessen eingebautes `SelectedItem`-Binding, nicht über eigene Maus-Behandlung. +`NetworkAnalysisService` fragt (fehlertolerant pro Endpunkt) `/interface/bridge/port`, `/interface/vlan`, `/ip/address`, `/ip/pool`, `/ip/dhcp-server`, `/ip/route`, `/interface/wireless`, `/ip/firewall/nat` und `/ip/firewall/filter` ab und liefert reine Fakten — keine Positions-/Grafik-Konzepte, Core bleibt UI-frei. Firewall-/NAT-Regeln werden nur aufgenommen, wenn sie eine konkrete Adresse binden (`to-addresses` bzw. `dst-address`/`src-address`) — generische, nur interface-basierte Basisregeln bleiben bewusst außen vor. + +Der Step-ViewModel (App) baut daraus einen Baum: jeder Knoten hat höchstens einen `ParentNodeId` (Bridge-Port → Bridge, VLAN → Eltern-Interface, IP/DHCP → ihr Interface, Firewall-Regel → die IP-Adresse, deren Subnetz die gebundene Adresse enthält, WAN-Interface → synthetischer „Internet"-Knoten anhand der Standardroute). Positioniert wird in Kategorie-Bändern (`TopologyLayout.Bands`): X bleibt die Baum-Tiefe (Sprung-Reihenfolge zum Internet-Zugang bleibt sichtbar), Y ordnet zusätzlich nach Kategorie — Kategorie-Beschriftungen sind eigene, nicht anklickbare Einträge im selben Nodify-Item-Raum wie die Knoten, damit sie beim Pan/Zoom exakt mitwandern statt als Overlay zu driften. Ein Klick hebt den kompletten verbundenen Teilbaum hervor (Vorfahren *und* Nachfahren), nicht nur den Weg nach oben. Die Grafik selbst nutzt [Nodify](https://github.com/miroiu/nodify) (reines, abhängigkeitsfreies WPF-Steuerelement für MVVM-Node-Editoren) — Klicks laufen über dessen eingebautes `SelectedItem`-Binding, nicht über eigene Maus-Behandlung. ### Datenstruktur