README: Kategorien-Layout und Firewall-Regeln in IST-Zustand-Analyse dokumentieren
Build / build (push) Canceled after 0s

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 <noreply@anthropic.com>
This commit is contained in:
adminandClaude Sonnet 5 committed 2026-09-15 19:27:29 +02:00
1 parent 49b17623ab
commit 6eabd5e100
1 file changed
+8 -6
+8 -6
View File
@@ -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<br/>Core/Analysis"]
Facts["Existing*-Records<br/>Bridge-Ports, VLANs, IP-Adressen,<br/>DHCP-Server, Routen, WLANs"]
Facts["Existing*-Records<br/>Bridge-Ports, VLANs, IP-Adressen,<br/>DHCP-Server, Routen, WLANs, Firewall-Regeln"]
StepVM["NetworkAnalysisStepViewModel<br/>App"]
Graph["TopologyNodeViewModel / TopologyConnectionViewModel<br/>Spalten-Layout, IsHighlighted"]
Editor["nodify:NodifyEditor<br/>Klick -&gt; SelectedItem -&gt; Pfad-Hervorhebung"]
Graph["TopologyNodeViewModel / TopologyConnectionViewModel<br/>Band-Layout (Kategorien), IsHighlighted"]
Editor["nodify:NodifyEditor<br/>Klick -&gt; SelectedItem -&gt; 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