Linke Seitenleiste / Statusleiste — Navigationsleitfaden
Auf allen Seiten der Gateway-Weboberfläche sind die linke Seitenleiste (vertikales Icon-Menü) und die Statusleiste unten links (horizontale Schnellaktionen) permanent sichtbar. Dieses Dokument ist ein Navigationsindex, der auf einen Blick zeigt, welches Icon wohin führt.
1. Linke Seitenleiste (vertikal) — 11 Icons + Logo
┌──────┐
│ 🌱 │ PlantPulse 로고 → /ui/main (홈)
├──────┤
│ 🔌 │ 프로토콜 연결하기 → /ui/connect/connect
│ 📋 │ 연결된 목록 → /ui/connect/list
│ 🧊 │ 애플리케이션 → /ui/apps
│ 🌿 │ OPC-UA 노드 뷰어 → /ui/opcua
│ 🗄 │ 포인트 검색 (NEW) → /ui/point
│ 📑 │ 시스템 로그 → /system/log/list
│ 🔀 │ 노-코드 플로우 → /ui/flow
│ 📊 │ 고급 대시보드 ★ → http://게이트웨이:3000
│ ⚙ │ 환경 설정 → /ui/system/config
│ 📖 │ 매뉴얼 ★ (이 문서) → /public/docs/index.html
│ ↻ │ 페이지 새로고침 → window.location.reload()
│ 🚪 │ 로그아웃 → /login/logout
└──────┘
(★ 가 붙은 항목은 새 창으로 열립니다.)
1.1 Zweck und erste Aktion je Icon
| # | Icon (fa) | Menü | Wofür ist die Seite da? | Details |
|---|---|---|---|---|
| 1 | fa-plug | Protokoll verbinden | Neue Verbindung für PLC / OPC-UA / MQTT / Simulator usw. registrieren — Auswahl aus 44 Protokollkarten | Protokollauswahl (44 Karten) → Neue PLC-Verbindung hinzufügen |
| 2 | fa-list | Verbindungsliste | Registrierte OPC und die darin enthaltenen Tags in einem Bildschirm starten/stoppen/bearbeiten/Werte schreiben | Verbindungsliste / Tag-Liste |
| 3 | fa-cubes | Anwendungen | Docker-basierte Zusatz-Apps (Grafana / Node-RED / HiveMQ / Cassandra ...) starten/stoppen/Logs | Anwendungsverwaltung |
| 4 | fa-sitemap | OPC-UA Node-Viewer | Baum des integrierten OPC-UA-Servers des Gateways — genau die Ansicht, die ein externes SCADA sieht, plus Live-Chart | OPC-UA Node-Viewer |
| 5 | fa-database | Punktsuche (NEU) | Abfrage von Zeitreihendaten (tm_tag_point) — Zeitraum + OPC + Tag-Filter → Ergebnistabelle + CSV-Download | Punktsuche |
| 6 | (custom) | Systemlog | Cassandra-pe.app_system_log-Suche — Zeitraum- + Level-Filter / Unread-Badge oben rechts | Systemlog anzeigen |
| 7 | fa-project-diagram | No-Code-Flow | Node-RED eingebettet — Automatisierung / Anbindung externer Systeme über Tag-Lese-/Schreibknoten | Flow starten |
| 8 | fa-tachometer-alt | Erweitertes Dashboard ★ | Öffnet :3000 in neuem Fenster (meist Grafana). Kann je Standort abweichen | (externes Werkzeug) |
| 9 | fa-cog | Konfiguration | app.properties CodeMirror-Editor — alle Einstellungen an einem Ort + Index der 36 System-Tags | Konfiguration |
| 10 | fa-book-open | Handbuch ★ | Dieses Dokument (mkdocs) in neuem Fenster | — |
| 11 | fa-retweet | Seite neu laden | Erzwungenes Reload — umgeht den Browser-Cache (window.location.reload(true)) | — |
| 12 | fa-sign-out-alt | Abmelden | Sitzung beenden → weiter zu /login/form | Anmeldebildschirm |
1.2 Empfohlene Reihenfolge bei der ersten Nutzung
- Protokoll verbinden (1) → Typ der zuerst zu registrierenden PLC wählen (z. B. Modbus / OPC-UA / Simulator)
- Verbindungsliste (2) → Bei der registrierten PLC Erfassung starten drücken und prüfen, ob Werte eintreffen
- OPC-UA Node-Viewer (4) → Einmal prüfen, wie ein externes SCADA die Daten sieht (Test z. B. mit UaExpert)
- No-Code-Flow (7) → Ablauf erstellen, wie die eingehenden Tags verarbeitet / nach außen gesendet werden
- Konfiguration (9) → Systemrichtlinien wie MQTT / Sparkplug / TTL / Schlüssel feinjustieren
2. Statusleiste unten links (horizontal) — 7 Schnellaktionen + Footer
┌─────────────────────────────────────────────────────────────────┐
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | V2026.05.10 │
└─────────────────────────────────────────────────────────────────┘
| # | Icon | Aktion | Details |
|---|---|---|---|
| 1 | 🎬 fa-projector | System-Reboot | Betriebssystem selbst — 3–5 Min., PLC-Erfassung unterbrochen |
| 2 | 🔁 fa-repeat-1-alt | Anwendung neu starten | Nur Tomcat — 30–60 Sek. |
| 3 | 🗑 fa-trash | Temporäre Dateien bereinigen | Bei knappem Speicherplatz |
| 4 | ⏱ fa-stopwatch | Backup | Konfiguration + DB |
| 5 | 📄 fa-file-alt | Logs herunterladen | ZIP zur Diagnose |
| 6 | 🔌 fa-microchip | O/S- und Firmware-Upgrade | Am risikoreichsten |
| 7 | ☁ fa-cloud-download | S/W-Upgrade | Neuer Build vom Download-Server |
→ Genaue Funktion / Dauer / Hinweise zu jeder Aktion: Schnellaktionen der Statusleiste (auf allen Seiten)
Rechts im Footer werden die aktuelle SW-Version sowie (als Ergebnis des Abgleichs mit dem Download-Server) ein rotes Upgrade verfügbar! oder graues Nicht verbunden Badge angezeigt.
3. Oben links — Logo / Hostname
┌──────────────┐
│ 🌱 플랜트펄스 │
│ 엣지│ (HOSTNAME 뱃지 — 어느 게이트웨이인지 구분)
└──────────────┘
- Klick → weiter zu
/ui/main(Hauptbildschirm mit 30 Karten auf einen Blick) - Das Handbuch-Icon im Kopfbereich wurde zu
fa-book-opengeändert (vorherfa-book→ aufgeschlagenes Buch)
4. Zusätzliche Navigation je Seite
| Seite | Weitere Navigationspunkte |
|---|---|
/ui/main | Klick auf Karte → zugehöriger Menübildschirm. Klick auf Zähler (Verbindungsliste N) → Liste. Klick auf die rote Zahl bei Systemfehler (heute) → Systemlog |
/ui/connect/list | OPC-Zeilenaktionen ▶ ⏹ 🔧 🗑 / Tag-Zeile ✏ Inline-Schreiben / 📈 Tag-View-Chart |
/ui/connect/tag-view | Kopfzeile ← Zurück → zurück zur Liste |
/ui/opcua | Klick auf Baumknoten → Details rechts + Chart. Icon zum Kopieren der NodeId |
/ui/apps | + Neue App bereitstellen / Klick auf Kartenport → App in neuem Fenster |
/system/log/list | Formular Suchkriterien links / oben rechts 🗑 Alle löschen (nach Bestätigung) |
/ui/system/config | Kopfzeile ← Zurück → Hauptseite / 💾 Speichern (Hinweis zum Neustart) |
5. Abkürzungsmuster
| Ziel | Schnellster Weg |
|---|---|
| Nur die heutigen ERROR schnell sehen | Hauptbildschirm → Klick auf die rote Zahl bei Systemfehler (heute) |
| Ist die PLC gerade wirklich verbunden? | Hauptbildschirm Verbindungsliste (N) anklicken → in der linken OPC-Tabelle Spalte Verbindungsstatus |
| Ein bestimmter Tag-Wert von gestern 13:00 | Seitenleiste 🗄 Punktsuche → Zeitraum / OPC / Tag → Suchen → CSV |
| Node-Baum, den ein externes SCADA sieht | Seitenleiste 🌿 OPC-UA Node-Viewer |
| Aktuell laufende Container | Karte Docker auf der Hauptseite oder Seitenleiste 🧊 Anwendungen |
| Nur eine Zeile einer Umgebungsvariable ändern | Seitenleiste ⚙ → Suche im Editor (Cmd+F) → Zeile ändern → Speichern → 🔁 Neustart |
| Das Gateway-OS hängt gerade | Statusleiste 🎬 System-Reboot (3–5 Min.) |
| Neuen Build einspielen | Statusleiste ☁ S/W-Upgrade (nur wenn das Badge rot ist) |
6. Weiterführende Informationen
- Bedeutung der einzelnen Karten / Aktualisierungsintervalle: Startbildschirm — Vollständiger Leitfaden zu Karten / Aktionen / Aktualisierungsintervallen
- Die 7 Schnellaktionen im Detail: Schnellaktionen der Statusleiste
- Gesamtes Inhaltsverzeichnis des Handbuchs: Start