infrastruktur

doc/DATABASE.md

@@ -95,6 +95,41 @@ Einzelne Ports einer Netzwerkdose.
 
 ---
 
+### Patchpanel-Objekte im Floorplan
+Patchpanels haben eine Sonderstellung: Sie sind fest verkabelte Bündel von Ports und werden **nicht** wie normale `devices` im Rack verschoben, sondern als eigene Floorplan-Objekte fest auf einem Stockwerk positioniert.
+
+**Verwendung**
+- Repräsentieren physische Patchfelder auf dem Stockwerksplan.
+- Werden im SVG mit festen `x`/`y`-Koordinaten verankert und symbolisieren deren reale Position.
+- Ermöglichen die Dokumentation der dauerhaften Verbindungen zu anderen Patchpanels, Netzwerkdosen oder Geräteports ohne Rack-Neuanlage.
+
+**Grafische Attribute**
+- `x`, `y`, `width`, `height` für die Visualisierung im Floorplan.
+- `name`/`label` und `port_count` für die eindeutige Kennzeichnung.
+- Optional: `connection_group` oder `cross_connect_id`, um zusammengehörige Patchfelder zu bündeln.
+
+**Verbindungen**
+- Jeder Patchpanel-Port wird über `connections` mit passenden Gegenstellen verbunden (andere Patchpanels, Dosen, Geräteports, Module).
+- Da sie Teil der Floorplan-Grafik sind, lassen sich die permanenten Kabelverbindungen direkt auf der Stockwerkskarte darstellen.
+
+### Tabellenstruktur `floor_patchpanels`
+Die Bühne für Patchpanel-Objekte auf dem Stockwerkplan.
+- `floor_id` referenziert das Stockwerk, in dem das Panel liegt.
+- `pos_x`, `pos_y`, `width`, `height` definieren das feste Rechteck auf der SVG.
+- `port_count` und `comment` beschreiben die Kapazität und zusätzliche Hinweise.
+
+### Tabellenstruktur `floor_patchpanel_ports`
+- Jeder Eintrag ist ein physischer Port eines Patchpanels.
+- Attributes: Panel-Referenz, `name`, `port_type_id`, optionale VLAN- bzw. Status-Attribute.
+- Ports werden über `connections` sowohl mit anderen Patchpanels als auch mit Netzwerkbuchsen (`network_outlet_ports`) oder Gerätports verbunden; dadurch lassen sich Router-Kabel grafisch darstellen.
+
+**TODO**
+- [ ] Floorplan- und CRUD-Module so erweitern, dass Patchpanels als Floor-Objekte verwaltet und deren Ports gepflegt werden können (`floor_patchpanels`, `floor_patchpanel_ports`).
+- [ ] Verbindungen zwischen Patchpanel ↔ Patchpanel und Patchpanel ↔ Netzwerkbuchse standardisiert in der `connections`-Logik abbilden.
+- [ ] UI/CSV/Export/Dokumentation nachziehen, damit Planer sofort sehen, wo die permanent installierten Kabel verlaufen.
+
+---
+
 ## 3. Racks & physische Infrastruktur
 
 ### `racks`