> For the complete documentation index, see [llms.txt](https://kopens.gitbook.io/plantpulse-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kopens.gitbook.io/plantpulse-platform/user/navigation.md).
# 콘솔 탐색과 공통 화면
## 목차
* [개요](#overview)
* [전체 화면 프레임](#frame)
* [상단 바](#topbar)
* [도메인 통합 검색](#domain-search)
* [좌측 메뉴 구조](#sidebar)
* [실시간 알림과 토스트](#notifications)
* [공통 화면 패턴](#patterns)
* [권장 운영 동선](#daily-flow)
* [권한과 메뉴 노출](#roles)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)
***
## 개요
이 문서는 로그인 이후 모든 화면에서 공통으로 사용하는 콘솔 프레임을 설명합니다. 현재 콘솔은 **상단 도메인 검색**, **우측 실시간 툴바**, **좌측 업무 그룹 메뉴**, **카드·차트·테이블 기반 본문**으로 구성됩니다.
전체 메뉴 맵과 업무 흐름도는 [전체 메뉴 구조와 운영 흐름도](/plantpulse-platform/user/menu-flow.md) 에서 한눈에 볼 수 있습니다.
운영자는 보통 다음 흐름으로 사용합니다.
1. [대시보드](/plantpulse-platform/user/summary.md) 에서 사이트 지도, 파이프라인, KPI, 인프라 헬스를 확인합니다.
2. 이상 KPI 를 클릭해 [연결 상태](/plantpulse-platform/user/connection.md#status-screen), [알람](/plantpulse-platform/user/alarm.md), [설비](/plantpulse-platform/user/equipment.md), [일일 통계](/plantpulse-platform/user/statistics.md) 로 내려갑니다.
3. 상단 **도메인 검색**으로 사이트·에셋·태그·OPC·엣지·플로우·알람 설정 ID 를 바로 찾아 상세 화면으로 이동합니다.
4. 우측 상단 LIVE·알람·토스트에서 새 이상 신호를 확인합니다.
> 예전 문서의 "요약" 첫 화면은 현재 UI 에서 **대시보드**로 정리되었습니다. 내부 URL 은 계속 `/map/index` 입니다.
***
## 전체 화면 프레임
```
┌──────────────┬────────────────────────────────────────────────────────────┐
│ PlantPulse │ ☰ [도메인 검색 사이트 / 에셋 / 태그 / OPC / ... CTRL+K] │
│ 좌측 메뉴 │ [LIVE] [알람] [전체] [설정] [매뉴얼] [사용자] │
├──────────────┼────────────────────────────────────────────────────────────┤
│ Overview │ 페이지 제목 / 현재 업무 설명 │
│ Connectivity │ ┌────────────────────────────────────────────────────────┐ │
│ Factory │ │ 지도·카드·차트·테이블·트리·드로어 등 선택 화면 본문 │ │
│ ... │ └────────────────────────────────────────────────────────┘ │
└──────────────┴────────────────────────────────────────────────────────────┘
```
| 영역 | 역할 |
| ---------- | ------------------------------------------------------ |
| **상단 바** | 메뉴 접기, 전역 도메인 검색, LIVE 상태, 알람, 전체화면, 환경설정, 매뉴얼, 사용자 메뉴 |
| **좌측 메뉴** | 실제 서버웹 `nav-role/admin.jsp` 기준의 업무 그룹 메뉴 |
| **본문 상단** | 페이지 제목, 현재 사이트/업무 컨텍스트, 조회·새로고침·이동 버튼 |
| **본문 영역** | 지도, 카드, 차트, 테이블, 트리, 상세 패널 |
| **토스트 영역** | 우측 상단에 실시간 진단·알람 이벤트를 짧게 표시 |
***
## 상단 바
상단 바는 모든 화면에서 동일하게 동작합니다.
| 순서 | 요소 | 사용법 |
| -- | ----------- | -------------------------------------------------------------------------------- |
| 1 | **메뉴 토글** | 좌측 메뉴를 접거나 펼칩니다. 좁은 화면에서 본문 공간을 확보할 때 사용합니다. |
| 2 | **도메인 검색** | 클릭 또는 `Ctrl+K` / Mac `Cmd+K` 로 엽니다. 콘솔 전체 도메인 ID 를 검색합니다. |
| 3 | **LIVE 상태** | 웹소켓 연결 상태입니다. 정상일 때 LIVE 도트가 펄스 형태로 표시됩니다. |
| 4 | **알람** | 최근 알람 수와 미리보기를 표시합니다. 메뉴 푸터에서 [알람](/plantpulse-platform/user/alarm.md) 으로 이동합니다. |
| 5 | **전체화면** | 브라우저 전체화면을 토글합니다. |
| 6 | **환경설정** | 화면 배율, 알람 팝업, 진단 로그 표시 같은 사용자 화면 설정을 엽니다. |
| 7 | **매뉴얼** | GitBook 매뉴얼을 새 탭으로 엽니다. |
| 8 | **사용자 메뉴** | 프로필, 비밀번호 변경, 로그아웃을 제공합니다. |
> 상단 검색은 화면별 검색 폼과 다릅니다. 화면별 검색은 현재 목록을 필터링하고, 도메인 검색은 콘솔 전체의 주요 ID 를 찾아 상세 화면으로 이동합니다.
***
## 도메인 통합 검색
도메인 검색은 `/api/v4/domain/search` 를 호출해 결과를 DataTable 로 표시합니다. ID 셀은 클릭하면 클립보드에 복사되고, 액션 버튼은 도메인별 상세 화면으로 이동합니다.
### 검색 대상
| 도메인 | 예시 | 이동 대상 |
| --------------------------------- | ---------------------- | --------------- |
| **SITE / AREA / LINE** | `S1_LOTTE_CS_DJ_SITE` | 대시보드, 에셋 트리, 모델 |
| **EQUIPMENT / ASSET** | `ASSET_LINE_01` | 에셋 트리, 설비 상세 |
| **TAG** | `TAG_EDGE_00303_90000` | 태그, 데이터 조회, 트렌드 |
| **OPC** | `OPC_MAIN_01` | 연결 상세 |
| **EDGE** | `EDGE-303` | 엣지 상세 |
| **ALARM\_CONFIG** | 알람 설정 ID | 고급 EQL 알람 |
| **FLOW** | 플로우 ID | 플로우 목록·편집 |
| **USER / SECURITY** | 사용자·보안 정책 ID | 시스템·보안 관리 |
| **EMPLOYEE / CUSTOMER / PRODUCT** | 생산 마스터 ID | 생산 관리 화면 |
### 검색 결과 사용
| 동작 | 결과 |
| ------------------ | ----------------------------------- |
| `Ctrl+K` / `Cmd+K` | 어떤 입력창에 포커스가 있어도 도메인 검색 다이얼로그를 엽니다. |
| 도메인 칩 클릭 | 해당 도메인만 필터링합니다. |
| ID 클릭 | ID 를 클립보드에 복사합니다. |
| 상세 이동 버튼 클릭 | 도메인별 상세 화면이나 목록 화면으로 이동합니다. |
| 최근 검색어 클릭 | 같은 키워드로 다시 검색합니다. |
운영 중 알람 메시지나 진단 토스트에서 보이는 ID 를 바로 검색하면 원인 객체로 이동하는 시간이 크게 줄어듭니다.
***
## 좌측 메뉴 구조
현재 좌측 메뉴는 서버웹의 통합 메뉴 렌더링 기준으로 다음 순서입니다. 메뉴 그룹명은 영어로 표시되고, 실제 메뉴명은 한국어 라벨로 표시됩니다.
### Overview
| 메뉴 | 내부 URL | 용도 |
| --------- | ------------------- | --------------------------------- |
| **대시보드** | `/map/index` | 사이트 지도, 데이터 파이프라인, 플랫폼 헬스, 핵심 KPI |
| **일일 통계** | `/statistics/index` | 연간 히트맵과 선택일 운영 통계 |
### Connectivity
| 메뉴 | 내부 URL | 용도 |
| --------- | ----------------- | -------------------------------- |
| **프로토콜** | `/connect/index` | OPC/PLC/Modbus/DB/API 등 데이터소스 등록 |
| **연결 상태** | `/connect/status` | 전체 연결의 정상·지연·이상·끊김·미연결 모니터링 |
| **엣지** | `/edge/index` | 현장 엣지 장비 상태와 상세 제어 |
### Factory Model
| 메뉴 | 내부 URL | 용도 |
| --------- | ------------------- | ------------------ |
| **모델** | `/model/index` | 사이트·구역·라인·설비 계층 모델 |
| **에셋** | `/asset/tree/index` | 에셋 트리와 상세 속성 |
| **태그** | `/tag/index` | 수집 태그 정의와 상태 |
| **온톨로지** | `/ontology/index` | 의미 모델·관계 정의 |
| **메타데이터** | `/metadata/index` | 도메인별 확장 속성 |
| **기준정보** | `/basedata/index` | 운영 기준값과 공통 코드 |
### Production
| 메뉴 | 내부 URL | 용도 |
| -------- | ----------------- | ---------- |
| **고객** | `/customer/index` | 고객 마스터 |
| **제품** | `/product/index` | 제품 마스터 |
| **직원** | `/employee/index` | 작업자·담당자 정보 |
| **근무표** | `/calendar/index` | 시프트와 운영 일정 |
| **워크오더** | `/order/index` | 생산 작업지시 |
### Equipment
| 메뉴 | 내부 URL | 용도 |
| ----------- | ------------------- | -------------------- |
| **설비 목록** | `/equipment/index` | 설비 카드와 설비 단위 대시보드 진입 |
| **데이터 조회** | `/asset/data/index` | 에셋·태그별 수집 데이터 조회 |
| **타임라인 비교** | `/timeline/index` | 태그·설비 간 시간축 비교 |
### ISO
| 메뉴 | 내부 URL | 용도 |
| ----------- | --------------------- | ----------------------------- |
| **ISO 데이터** | `/asset/plugin/index` | OEE/RAM/EMS 계산을 위한 설비별 원천 데이터 |
| **ISO 분석** | `/analysis/index` | ISO 22400 기반 KPI 분석 |
### Data
| 메뉴 | 내부 URL | 용도 |
| --------------- | ----------------- | -------------------- |
| **스트림** | `/stream/index` | 실시간 시계열 스트리밍 차트 |
| **트렌드** | `/storage/index` | 태그 시계열 트렌드와 샘플링 분석 |
| **스냅샷** | `/snapshot/index` | 간격별 시계열 스냅샷 |
| **데이터 출력** | `/data/index` | 태그 시계열 데이터 조회·CSV 출력 |
| **오브젝트 (BLOB)** | `/blob/store` | 이미지·문서·바이너리 파일 저장소 |
### Alarm
| 메뉴 | 내부 URL | 용도 |
| ------------- | ------------------------ | ------------------------------------ |
| **알람** | `/alarm/index` | 실시간 알람 목록. 좌측 메뉴에 정보·경고·심각 카운트 배지 표시 |
| **알람 고급검색** | `/alarm/advsearch/index` | 기간·태그·상태·우선순위 조건 검색 |
| **알람 시각화 분석** | `/alarm/analysis/index` | 매트릭스, 히트맵, 랭킹, 트렌드 분석 |
| **고급 EQL 알람** | `/alarm/config/index` | EQL 기반 알람 룰 설정 |
### Visualization
| 메뉴 | 내부 URL | 용도 |
| ------- | --------------- | ----------------- |
| **캔버스** | `/canvas/index` | SVG 기반 현장 모니터링 화면 |
### Automation
| 메뉴 | 내부 URL | 용도 |
| ------------- | ------------------ | ---------------------------------- |
| **플로우** | `/flow/index` | 자동화 그래프 목록·편집. 좌측 메뉴에 에러 카운트 배지 표시 |
| **플로우 실행 이력** | `/flow/log` | 플로우 실행 로그와 실패 이력 |
| **EQL 쿼리** | `/query/index` | 실시간 이벤트 쿼리 실행 |
| **스테이트먼트** | `/statement/index` | 배포된 EQL statement 관리 |
> 별도 **트리거** 메뉴는 현재 통합 메뉴에서 비활성화되어 있습니다. 트리거는 [플로우](/plantpulse-platform/user/flow.md) 그래프 내부 노드나 [EQL 도움말](/plantpulse-platform/user/eql.md) 의 statement 맥락에서 다룹니다.
### Standard
| 메뉴 | 내부 URL / 외부 포트 | 용도 |
| ---------- | ------------------------- | --------------------------------------------------- |
| **UNS** | `/uns/tree` | Unified Namespace 계층과 Kafka/MQTT/SparkplugB 토픽 미리보기 |
| **OPC-UA** | `http://[현재호스트]:12780` | OPC-UA 표준 도구를 새 창으로 엽니다. |
| **AAS V3** | `http://[현재호스트]:8091/ui/` | AAS V3 UI 를 새 창으로 엽니다. |
### System
| 메뉴 | 내부 URL / 외부 포트 | 용도 |
| ----------- | --------------------- | ------------------------ |
| **사용자** | `/user/index` | 사용자 계정 관리 |
| **보안 정책** | `/security/index` | 비밀번호·접근 보안 정책 |
| **API 토큰** | `/token/index` | 외부 연동용 API 토큰 |
| **모니터링** | `/monitoring/index` | 인프라 헬스·파이프라인·엔진 메트릭 |
| **진단** | `/diagnostic/index` | 시스템 진단 이벤트 |
| **로그** | `/log/index` | 애플리케이션 로그 |
| **설정** | `/config/index` | 시스템 키-값 설정 |
| **환경정보** | `/env/view` | 프로퍼티별 환경 설정 조회 |
| **클러스터** | `/cluster/index` | 클러스터 노드 상태 |
| **고급 모니터링** | `http://[현재호스트]:3000` | 외부 모니터링 대시보드를 새 창으로 엽니다. |
***
## 실시간 알림과 토스트
우측 상단 토스트는 새 진단 이벤트나 설비 상태 변화를 짧게 보여 줍니다.
```
진단 · 192.168.0.41
설비 상태 변경 - 설비=[ASSET_DJ_M_16_2], RUN -> FAULT
```
| 항목 | 의미 |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **제목** | 알림 종류와 발생 장비 또는 모듈 |
| **본문** | 상태 변화, 알람 내용, 진단 메시지 요약 |
| **색상** | 정보·경고·심각 수준에 따라 강조 |
| **후속 확인** | 알람은 [알람](/plantpulse-platform/user/alarm.md), 설비 상태는 [설비](/plantpulse-platform/user/equipment.md), 시스템 이벤트는 [진단](/plantpulse-platform/user/diagnostic.md) 에서 추적 |
토스트는 신호입니다. 실제 조치 전에는 관련 화면에서 시간, 대상 ID, 상세 로그를 다시 확인하세요.
***
## 공통 화면 패턴
### 상태 색상
| 색상 | 일반 의미 | 예시 |
| -- | ------- | ----------------------- |
| 녹색 | 정상 | 연결 정상, 인프라 UP, 설비 건강 정상 |
| 주황 | 주의·지연 | 연결 지연, 경고 알람, 처리 지연 |
| 빨강 | 이상·심각 | 연결 이상, 심각 알람, 엔진 오류 |
| 회색 | 미연결·미확인 | 데이터 없음, 아직 수집 이력 없음 |
정확한 코드 의미는 [상태 코드 정의](/plantpulse-platform/user/status.md) 를 기준으로 확인합니다.
### 목록과 상세
대부분의 업무 화면은 **상단 검색 → 목록 테이블 → 행 클릭 상세** 패턴을 사용합니다.
| 단계 | 설명 |
| -------- | ------------------------- |
| 검색 조건 선택 | 기간, 사이트, 상태, 키워드, 표시 건수 |
| 조회 | 현재 조건으로 목록 또는 카드 갱신 |
| 행 클릭 | 해당 도메인의 상세 화면이나 드로어 열기 |
| 새로고침 | 실시간 수치가 의심될 때 직전 조건으로 재조회 |
### 시간 범위
알람·진단·로그·데이터 조회 화면은 빠른 시간 범위를 제공합니다.
| 버튼 | 용도 |
| ------------------- | -------------- |
| `10M` / `30M` | 방금 발생한 장애 추적 |
| `1H` / `6H` / `12H` | 당일 교대 시간대 분석 |
| `ALL` | 검색 조건 전체 기간 표시 |
***
## 권장 운영 동선
### 교대 시작
1. [대시보드](/plantpulse-platform/user/summary.md) 에서 통신 연결률, 금일 수집, 금일 알람, 설비 가동률, 설비 가용률, OEE 를 확인합니다.
2. 지도에서 빨강·주황 사이트 또는 연결 상태 칩이 있는지 확인합니다.
3. 우측 헬스 레일에서 캐시, WS, MQTT, Kafka, 이벤트DB, 시계열 상태를 확인합니다.
4. [일일 통계](/plantpulse-platform/user/statistics.md) 에서 전일과 오늘의 수집량·알람량을 비교합니다.
### 알람 발생
1. 우측 상단 토스트 또는 알람 배지로 새 알람을 확인합니다.
2. [알람](/plantpulse-platform/user/alarm.md) 에서 기간과 사이트를 좁혀 상세를 엽니다.
3. 태그·에셋 ID 를 도메인 검색에 넣어 설비·데이터 조회 화면으로 이동합니다.
4. 반복 알람이면 [고급 EQL 알람](/plantpulse-platform/user/alarm.md#config), [플로우](/plantpulse-platform/user/flow.md), [EQL 도움말](/plantpulse-platform/user/eql.md) 을 확인해 룰과 자동화 상태를 점검합니다.
### 연결 이상
1. [대시보드](/plantpulse-platform/user/summary.md) 의 연결률 카드 또는 지도 상태 칩을 클릭합니다.
2. [연결 상태](/plantpulse-platform/user/connection.md#status-screen) 에서 지연·이상·끊김 대상을 찾습니다.
3. 엣지 장비 문제로 보이면 [엣지](/plantpulse-platform/user/connection.md#edge) 상세로 내려갑니다.
4. 같은 시간대 진단 이벤트가 있는지 [진단](/plantpulse-platform/user/diagnostic.md) 에서 확인합니다.
***
## 권한과 메뉴 노출
현재 공통 레이아웃은 통합 메뉴 구조를 기준으로 렌더링됩니다. 다만 실제 조회·수정·삭제·제어 권한은 사용자 역할과 서버 보안 정책에 따라 제한될 수 있습니다.
| 역할 | 일반 범위 |
| ----------- | ------------------------------- |
| **ADMIN** | 전체 운영·설정·보안·시스템 관리 |
| **MANAGER** | 운영·분석 중심. 일부 시스템/보안 변경 제한 |
| **USER** | 조회 중심. 현장 대시보드, 알람, 데이터 조회 등 제한 |
권한이 없어 기능이 막히는 경우에는 보안 관리자에게 역할 변경을 요청합니다. 자세한 계정 관리는 [보안 관리](/plantpulse-platform/user/security.md) 를 참고하세요.
***
## 자주 묻는 질문
**Q. 예전의 "요약" 메뉴가 안 보입니다.**
A. 화면 개편 이후 첫 화면 메뉴명은 **대시보드**로 정리되었습니다. 내부 URL 은 `/map/index` 로 동일합니다.
**Q. `도구` 메뉴의 시계열 엔진·SQL 항목이 사라졌습니다.**
A. 현재 통합 메뉴에는 Standard 의 **OPC-UA**, **AAS V3**, System 의 **고급 모니터링**만 외부 창 항목으로 노출됩니다. 일반 시계열 조회는 Data 그룹의 **트렌드**, **데이터 출력**, **스냅샷** 화면을 사용합니다.
**Q. 상단 검색으로 데이터를 조회했는데 현재 테이블이 바뀌지 않습니다.**
A. 상단 검색은 전역 도메인 이동용입니다. 현재 테이블을 필터링하려면 각 화면 본문 상단의 검색 폼을 사용하세요.
**Q. 토스트가 사라졌는데 내용을 다시 볼 수 있나요?**
A. 알람은 [알람](/plantpulse-platform/user/alarm.md), 시스템 이벤트는 [진단](/plantpulse-platform/user/diagnostic.md), 상세 애플리케이션 로그는 [시스템](/plantpulse-platform/user/system.md) 의 로그 화면에서 다시 조회합니다.
**Q. 좌측 메뉴가 보이지 않습니다.**
A. 상단 좌측의 메뉴 토글을 클릭하세요. 브라우저 폭이 좁으면 자동으로 접힌 상태일 수 있습니다.
***
## 관련 화면
* [로그인](/plantpulse-platform/user/login.md) — 접속, 세션, 역할별 메뉴 차이
* [전체 메뉴 구조와 운영 흐름도](/plantpulse-platform/user/menu-flow.md) — 전체 메뉴 맵과 상황별 진입 흐름
* [대시보드](/plantpulse-platform/user/summary.md) — 로그인 후 첫 화면과 KPI 해석
* [일일 통계](/plantpulse-platform/user/statistics.md) — 날짜별 운영 통계
* [연결 관리](/plantpulse-platform/user/connection.md) — 프로토콜, 연결 상태, 엣지
* [UNS](/plantpulse-platform/user/uns.md) — Unified Namespace 와 토픽 미리보기
* [상태 코드 정의](/plantpulse-platform/user/status.md) — 연결·건강·알람·생산 상태 코드