Datenreferenz & Node-Spezifikation

1 · Node-Typen

2 · Node-Felder

Pflichtfelder (alle Node-Typen)

Positionierung – Gebäude-Modell (type: 'building')

Positionierung – Gruben-Modell (type: 'mine')

Optionale Felder

3 · Link-Felder

Tunnel-Rendering: Mine vs. Gebäude

4 · Modell-Konfiguration

Modelle werden in MODEL_PRESETS[] in app.js definiert oder über models.json nachgeladen. Node-/Link-Daten liegen in externen JSON-Dateien und werden per dataUrl referenziert.

Gebäudemodell-Felder (type: 'building')

Grubenmodell-Felder (type: 'mine')

Datacenter-Felder (type: 'datacenter')

Y-Werte der Etagen

5 · Platzierungslogik

Grubenmodell – Geo-Projektion

Lat/Lon wird relativ zum Modell-Referenzpunkt (cfg.lat, cfg.lon) in Meter-Offsets umgerechnet (Mercator-Näherung), dann auf den größten Cluster der Sohle normiert (max. 180 Szeneneinheiten breit). Der Cluster-Schwerpunkt wird auf (0, floor.y, 0) zentriert.

Faustregel: Je weiter Nodes auf einer Sohle geografisch auseinanderliegen, desto größer die Szene auf dieser Sohle. Kleinere Cluster (andere Sohlen) werden proportional kleiner dargestellt.

Gebäudemodell – Statische Koordinaten

X/Y/Z werden direkt als Szeneneinheiten übernommen. Der Empfangskorridor für Etagen-Sichtbarkeit beträgt ±8 Szeneneinheiten um den Etagen-Y-Wert.

Tunnel-Auto-Erkennung (Grubenmodell)

6 · Vollständige Beispiele

Switch – Grubenmodell (Geo)

// Gilt für: mines, Geo-Projektion über lat/lon
{
  id:     'core-sw-s1',
  label:  'CORE-SW-SOHLE1',
  type:   'switch',
  status: 'ok',
  floor:  'SOHLE 1',       // muss exakt mit floors[].label übereinstimmen
  lat: 51.5050,            // WGS84 Breitengrad
  lon: 9.3350,             // WGS84 Längengrad
}

Host – Gebäudemodell (statisch)

// Gilt für: buildings, direkte Szenen-Koordinaten
{
  id:     'ws-2-01',
  label:  'WS-2-01',
  type:   'host',
  status: 'ok',
  floor:  '2. OG',         // buildFloors() → y ≈ +17.5 bei 4 Etagen
  x: -32, y: 18, z: -20,   // y exakt auf Etagen-Y setzen (±8 Toleranz)
}

AccessPoint – mit Heatmap

{
  id:      'ap-og2-01',
  label:   'AP-2OG-01',
  type:    'accesspoint',
  status:  'ok',
  floor:   '2. OG',
  x: 0, y: 18, z: -12,
  wifiDbm: -41,             // −30 (max) … −90 (min) → Radius 48 … 8
}

Link mit Tunnel-Optik (explizit)

{
  source: 'sw-og2',
  target: 'ws-2-01',
  status: 'ok',
  tunnel: true,             // Kabelkanal-Glow (Gebäude) oder Stollen-Glow (Grube)
}

Portal-Node (Modell-Verknüpfung)

// linkedModel verweist auf die id eines anderen Modells.
// → pulsierendes ⇒-Label + "Innenansicht öffnen"-Button im Inspector.
{
  id:           'portal-to-dc',
  label:        'Datacenter-Raum',
  type:         'host',
  status:       'ok',
  floor:        'EG',
  x: -35, y: -52, z: -35,
  linkedModel:  'dc1',       // id des Ziel-Modells
}

Server-Node (Datacenter)

// type:'server' → flaches 1HE-Mesh mit Status-LED.
// Y-Achse: 0 = Rack-Boden, 8 = Rack-Decke (42 HE ≙ 8 Szeneneinheiten)
{
  id:     'web-dc-01',
  label:  'web-dc-01',
  type:   'server',
  status: 'ok',
  floor:  'Datacenter',
  x: -13, y: 1.0, z: 0,   // y ≈ 1–2: unteres Drittel, 4–5: Mitte, 6–7: oben
}

Eigenes Modell-Preset (externe Datei)

// In MODEL_PRESETS[] in app.js eintragen:
{
  id:          'werk-nord',
  name:        'Werk Nord',
  type:        'mine',
  floorHeight: 250,
  lat: 51.48, lon: 9.31,
  floors: [
    { label: 'ÜBERTAGE', sub: 'Schachtanlage' },
    { label: 'SOHLE 1',  sub: '−250 m' },
    { label: 'SOHLE 2',  sub: '−500 m' },
  ],
  dataUrl: 'data/werk-nord.json',  // externe JSON-Datei (gecacht nach erstem Laden)
}

// data/werk-nord.json (Struktur):
{ "nodes": [ /* Node-Objekte */ ], "links": [ /* Link-Objekte */ ] }

7 · WebSocket-Statusupdates

Die Karte kann Live-Statusupdates über WebSocket empfangen. Verbindung herstellen mit:

// In app.js – Zeile am Ende der Datei auskommentieren:
app.connectWS('ws://nagios-server:8008/ws/map/my-map');

Erwartetes Nachrichtenformat (JSON):

{
  "type":  "status_update",
  "hosts": [
    { "id": "core-sw-s1", "status": "ok"       },
    { "id": "web-01",     "status": "critical" },
    { "id": "fw-01",      "status": "down"     }
  ]
}

Bei einem Statuswechsel auf critical oder down werden automatisch Pulsringe um den betroffenen Node gespawnt.

8 · Externe Datendateien & Registry

Alle Node-/Link-Daten liegen als separate JSON-Dateien im Ordner data/. Das ermöglicht beliebig viele Standorte ohne app.js anzufassen.

Dateistruktur

v3/
├── app.js
├── index.html
├── models.json          ← optionale externe Registry
└── data/
    ├── building.json
    ├── dc1.json
    ├── grube1.json
    └── grube2.json

JSON-Dateiformat (data/*.json)

{
  "nodes": [ /* Node-Objekte – identisch zu inline-Daten */ ],
  "links": [ /* Link-Objekte */ ]
}

Modell-Registry (models.json)

Optionale externe Liste aller Modelle. Wird über ModelManager.loadRegistry('models.json') geladen (im Boot-Abschnitt von app.js auskommentiert). Format: Array von Modell-Preset-Objekten mit dataUrl statt inline-data.

[
  {
    "id":       "grube1",
    "name":     "Grube 1 · Heringen",
    "type":     "mine",
    "lat": 50.8922, "lon": 9.8979,
    "dataUrl":  "data/grube1.json",
    "floors": [ /* ... */ ]
  }
]

9 · Tastatur-Shortcuts & UI

HUD-Buttons