본문으로 건너뛰기

좌측 사이드바 / 상태바 — 네비게이션 가이드

게이트웨이 웹 UI 의 모든 페이지에는 좌측 사이드바 (세로 아이콘 메뉴) + 좌하단 상태바 (가로 빠른 액션) 가 항상 보입니다. 이 문서는 어떤 아이콘이 어디로 가는지 한눈에 정리한 네비게이션 인덱스입니다.

1. 좌측 사이드바 (세로) — 11 아이콘 + 로고​

┌──────┐
│  🌱  │  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 각 아이콘의 용도와 첫 행동​

#아이콘 (fa)메뉴어떤 일을 하는 곳?자세히
1fa-plug프로토콜 연결하기새 PLC / OPC-UA / MQTT / 시뮬레이터 등 연결 을 등록 — 44개 프로토콜 카드에서 선택프로토콜 선택 (44개 카드) → 새 PLC 연결 추가
2fa-list연결된 목록등록된 OPC + 그 안의 태그를 한 화면에서 시작/중지/편집/값쓰기연결 목록 / 태그 목록 화면
3fa-cubes애플리케이션도커 기반 부속 앱(Grafana / Node-RED / HiveMQ / Cassandra ...) 띄우기/내리기/로그애플리케이션 관리
4fa-sitemapOPC-UA 노드 뷰어게이트웨이 내장 OPC-UA 서버 트리 — 외부 SCADA 가 보는 그 모습 그대로 + 라이브 차트OPC-UA 노드 뷰어
5fa-database포인트 검색 (NEW)시계열 데이터(tm_tag_point) 조회 — 기간 + OPC + 태그 필터 → 결과 표 + CSV 다운로드포인트 검색
6(custom)시스템 로그Cassandra pe.app_system_log 검색 — 기간 + 레벨 필터 / 우상단 unread 뱃지시스템 로그 보기
7fa-project-diagram노-코드 플로우Node-RED 임베드 — 태그 읽기/쓰기 노드로 자동화 / 외부 시스템 연동플로우 시작하기
8fa-tachometer-alt고급 대시보드 ★새 창에서 :3000 오픈 (보통 Grafana). 사이트마다 다를 수 있음(외부 도구)
9fa-cog환경 설정app.properties CodeMirror 에디터 — 모든 설정 한 곳에서 + 시스템 태그 인덱스 36 종환경 설정
10fa-book-open매뉴얼 ★이 문서 (mkdocs) 새 창—
11fa-retweet페이지 새로고침강제 reload — 브라우저 캐시 우회 (window.location.reload(true))—
12fa-sign-out-alt로그아웃세션 종료 → /login/form 으로 이동로그인 화면

1.2 처음 사용할 때 추천 순서​

  1. 프로토콜 연결하기 (1) → 처음 등록할 PLC 종류 선택 (예: Modbus / OPC-UA / 시뮬레이터)
  2. 연결된 목록 (2) → 등록된 PLC 의 수집 시작 버튼 누르고 값이 들어오는지 확인
  3. OPC-UA 노드 뷰어 (4) → 외부 SCADA 가 어떻게 보는지 한 번 확인 (UaExpert 등으로 테스트)
  4. 노-코드 플로우 (7) → 들어온 태그를 어떻게 가공/외부로 보낼지 흐름 작성
  5. 환경 설정 (9) → MQTT / Sparkplug / TTL / 키 등 시스템 정책 미세 조정

2. 좌하단 상태바 (가로) — 7 빠른 액션 + 푸터​

┌─────────────────────────────────────────────────────────────────┐
│ KOPENS Edge     | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ |     V2026.05.10  │
└─────────────────────────────────────────────────────────────────┘
#아이콘동작자세히
1🎬 fa-projector시스템 리부트OS 자체 — 3-5 분, PLC 수집 중단
2🔁 fa-repeat-1-alt애플리케이션 재시작Tomcat 만 — 30-60 초
3🗑 fa-trash임시 파일 청소디스크 부족 시
4⏱ fa-stopwatch백업설정 + DB
5📄 fa-file-alt로그 다운로드진단용 zip
6🔌 fa-microchipO/S 및 펌웨어 업그레이드가장 위험
7☁ fa-cloud-downloadS/W 업그레이드다운로드 서버에서 새 빌드

→ 각 액션의 정확한 동작 / 소요 시간 / 주의사항: 상태바 빠른 액션 (모든 페이지 공통)

푸터 우측에는 현재 SW 버전 + (다운로드 서버 비교 결과) 빨간 업그레이드 가능! 또는 회색 연결 안됨 뱃지가 함께 떠있습니다.

3. 좌상단 — 로고 / 호스트명​

┌──────────────┐
│ 🌱 플랜트펄스   │
│   엣지│   (HOSTNAME 뱃지 — 어느 게이트웨이인지 구분)
└──────────────┘
  • 클릭 → /ui/main 으로 이동 (메인 화면 카드 30개 한눈에 보기)
  • 헤더 영역의 매뉴얼 아이콘 은 fa-book-open 으로 변경됨 (이전 fa-book → 책 펼친 모양)

4. 페이지 별 추가 네비게이션​

페이지추가 이동 포인트
/ui/main카드 클릭 → 해당 메뉴 화면. 카운터(연결된 목록 N) 클릭 → list. 시스템 오류 (오늘) 빨간 숫자 클릭 → 시스템 로그
/ui/connect/listOPC 행 액션 ▶ ⏹ 🔧 🗑 / 태그 행 ✏ 인라인 쓰기 / 📈 tag-view 차트
/ui/connect/tag-view헤더 ← 뒤로 → list 로 돌아가기
/ui/opcua트리 노드 클릭 → 우측 상세 + 차트. NodeId 복사 아이콘
/ui/apps+ 새 앱 배포 / 카드 포트 클릭 → 새 창에서 그 앱
/system/log/list좌측 검색 조건 폼 / 우상단 🗑 모두 삭제 (확인 후)
/ui/system/config헤더 ← 뒤로 → main / 💾 저장 (재시작 안내)

5. 단축 동작 패턴​

의도빠른 길
오늘 ERROR 만 빨리 보기메인 화면 → 시스템 오류 (오늘) 빨간 숫자 클릭
지금 PLC 가 정말 연결되어 있나?메인 연결된 목록 (N) 클릭 → 좌측 OPC 표 연결 상태 컬럼
어제 13:00 의 어떤 태그 값사이드바 🗄 포인트 검색 → 기간 / OPC / 태그 → 검색 → CSV
외부 SCADA 가 보는 노드 트리사이드바 🌿 OPC-UA 노드 뷰어
지금 도는 컨테이너메인 도커 카드 또는 사이드바 🧊 애플리케이션
환경 변수 한 줄만 바꾸기사이드바 ⚙ → 에디터 검색 (Cmd+F) → 한 줄 수정 → 저장 → 🔁 재시작
지금 게이트웨이 OS 가 멈춤상태바 🎬 시스템 리부트 (3-5 분)
새 빌드 적용상태바 ☁ S/W 업그레이드 (뱃지가 빨강일 때만)

6. 더 알아보기​