Left Sidebar / Status Bar — Navigation Guide
Every page of the gateway web UI always shows the left sidebar (vertical icon menu) plus the bottom-left status bar (horizontal quick actions). This document is a navigation index that shows at a glance which icon takes you where.
1. Left Sidebar (vertical) — 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 Purpose of each icon and first action
| # | Icon (fa) | Menu | What do you do here? | Details |
|---|---|---|---|---|
| 1 | fa-plug | Connect Protocol | Register a new connection such as PLC / OPC-UA / MQTT / simulator — choose from 44 protocol cards | Protocol Selection (44 cards) → Add a New PLC Connection |
| 2 | fa-list | Connection List | Start/stop/edit registered OPCs and the tags inside them, and write values — all on one screen | Connection List / Tag List Screen |
| 3 | fa-cubes | Applications | Start/stop Docker-based add-on apps (Grafana / Node-RED / HiveMQ / Cassandra ...) and view logs | Application Management |
| 4 | fa-sitemap | OPC-UA Node Viewer | The gateway's built-in OPC-UA server tree — exactly as an external SCADA sees it, plus live charts | OPC-UA Node Viewer |
| 5 | fa-database | Point Search (NEW) | Query time series data (tm_tag_point) — period + OPC + tag filters → result table + CSV download | Point Search |
| 6 | (custom) | System Log | Search Cassandra pe.app_system_log — period + level filters / unread badge at top right | Viewing the System Log |
| 7 | fa-project-diagram | No-Code Flow | Embedded Node-RED — automation and external system integration using tag read/write nodes | Getting Started with Flows |
| 8 | fa-tachometer-alt | Advanced Dashboard ★ | Opens :3000 in a new window (usually Grafana). May differ from site to site | (external tool) |
| 9 | fa-cog | Configuration | app.properties CodeMirror editor — all settings in one place + 36 system tag indexes | Configuration |
| 10 | fa-book-open | Manual ★ | This document (mkdocs) in a new window | — |
| 11 | fa-retweet | Reload Page | Force reload — bypasses the browser cache (window.location.reload(true)) | — |
| 12 | fa-sign-out-alt | Log Out | Ends the session → goes to /login/form | Login Screen |
1.2 Recommended order for first-time use
- Connect Protocol (1) → choose the type of PLC to register first (e.g. Modbus / OPC-UA / simulator)
- Connection List (2) → press the Start collection button for the registered PLC and check that values are coming in
- OPC-UA Node Viewer (4) → check once how an external SCADA sees it (test with UaExpert, etc.)
- No-Code Flow (7) → build the flow that processes incoming tags and sends them out
- Configuration (9) → fine-tune system policies such as MQTT / Sparkplug / TTL / keys
2. Bottom-Left Status Bar (horizontal) — 7 quick actions + footer
┌─────────────────────────────────────────────────────────────────┐
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | V2026.05.10 │
└─────────────────────────────────────────────────────────────────┘
| # | Icon | Action | Details |
|---|---|---|---|
| 1 | 🎬 fa-projector | System Reboot | The OS itself — 3–5 minutes, PLC collection stops |
| 2 | 🔁 fa-repeat-1-alt | Restart Application | Tomcat only — 30–60 seconds |
| 3 | 🗑 fa-trash | Clean Temporary Files | When disk space is low |
| 4 | ⏱ fa-stopwatch | Backup | Configuration + DB |
| 5 | 📄 fa-file-alt | Download Logs | Diagnostic zip |
| 6 | 🔌 fa-microchip | O/S and Firmware Upgrade | The riskiest one |
| 7 | ☁ fa-cloud-download | S/W Upgrade | New build from the download server |
→ Exact behavior / duration / cautions for each action: Status Bar Quick Actions (common to all pages)
At the right of the footer, the current SW version is shown together with a red Upgrade available! or gray Not connected badge (based on comparison with the download server).
3. Top Left — Logo / Hostname
┌──────────────┐
│ 🌱 플랜트펄스 │
│ 엣지│ (HOSTNAME 뱃지 — 어느 게이트웨이인지 구분)
└──────────────┘
- Click → goes to
/ui/main(view all 30 main screen cards at a glance) - The manual icon in the header area has been changed to
fa-book-open(previouslyfa-book→ now an open book)
4. Additional Navigation per Page
| Page | Additional navigation points |
|---|---|
/ui/main | Click a card → that menu screen. Click the counter (Connection List N) → list. Click the red number in System Errors (Today) → System Log |
/ui/connect/list | OPC row actions ▶ ⏹ 🔧 🗑 / tag row ✏ inline write / 📈 tag-view chart |
/ui/connect/tag-view | Header ← Back → return to list |
/ui/opcua | Click a tree node → details + chart on the right. NodeId copy icon |
/ui/apps | + Deploy new app / click a card port → that app in a new window |
/system/log/list | Search conditions form on the left / 🗑 Delete all at top right (after confirmation) |
/ui/system/config | Header ← Back → main / 💾 Save (restart notice) |
5. Shortcut Patterns
| Intent | Fastest path |
|---|---|
| Quickly view only today's ERRORs | Main screen → click the red number in System Errors (Today) |
| Is the PLC really connected right now? | Main Connection List (N) click → Connection status column in the OPC table on the left |
| A tag value at 13:00 yesterday | Sidebar 🗄 Point Search → period / OPC / tag → search → CSV |
| The node tree an external SCADA sees | Sidebar 🌿 OPC-UA Node Viewer |
| Containers running right now | Main Docker card or sidebar 🧊 Applications |
| Change just one line of an environment variable | Sidebar ⚙ → editor search (Cmd+F) → edit one line → save → 🔁 restart |
| The gateway OS is hung right now | Status bar 🎬 System Reboot (3–5 minutes) |
| Apply a new build | Status bar ☁ S/W Upgrade (only when the badge is red) |
6. Learn More
- Meaning of each card / refresh interval: Home Screen — Complete Guide to Cards / Actions / Refresh Intervals
- The 7 quick actions in detail: Status Bar Quick Actions
- Full manual table of contents: Home