> 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/login.md).

# 로그인

## 목차

* [개요](#overview)
* [접속 방법](#access)
* [로그인 화면 — 입력 필드](#login-form)
* [로그인 절차](#login-steps)
* [자동 로그인](#auto-login)
* [로그인 실패 시 대응](#login-failures)
* [로그아웃](#logout)
* [세션 관리](#session)
* [사용자 역할(ADMIN/MANAGER/USER)별 메뉴 차이](#roles)
* [로그인 후 메인 화면 구성](#post-login)
  * [최신 콘솔 탐색 문서](#navigation-doc)
  * [상단 헤더 — 좌측](#header-left)
  * [도메인 ID 통합 검색 다이얼로그](#domain-search)
  * [상단 헤더 — 우측 도구](#header-right)
  * [좌측 사이드 메뉴](#sidebar-menu)
  * [좌측 하단 시스템 성능 박스](#perf-box)
* [모바일 접속](#mobile)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)

***

## 개요 <a href="#overview" id="overview"></a>

플랫폼을 사용하시려면 먼저 웹 브라우저로 관리 콘솔에 로그인해야 합니다. 이 문서에서는 처음 사용하시는 분도 따라하실 수 있도록 접속 방법, 로그인 화면의 모든 입력 항목, 자동 로그인 설정, 사용자 역할별 메뉴 차이, 그리고 로그인 후 마주치는 메인 화면의 모든 요소를 자세히 안내해 드립니다.

***

## 접속 방법 <a href="#access" id="access"></a>

웹 브라우저 주소창에 다음 URL 을 입력해 주세요.

| 접속 유형       | URL 형식                   | 설명                       |
| ----------- | ------------------------ | ------------------------ |
| **표준 웹 접속** | `http://[서버IP]/` (포트 80) | 일반 사용자가 사용하는 메인 콘솔       |
| **관리 콘솔**   | `http://[서버IP]:7500/`    | 시스템 관리자(ADMIN)용 별도 관리 콘솔 |

`[서버IP]` 자리에는 시스템 관리자가 안내한 서버 IP 또는 도메인을 입력합니다.

> **예**: `http://192.168.0.110/` 또는 `https://platform.example.com/`

### 지원 브라우저

| 브라우저           | 권장              |
| -------------- | --------------- |
| Chrome         | **권장** — 가장 안정적 |
| Microsoft Edge | 권장              |
| Firefox        | 사용 가능           |
| Safari         | 사용 가능           |

***

## 로그인 화면 — 입력 필드 <a href="#login-form" id="login-form"></a>

```
┌──────────────────────────────────────────────┐
│                                              │
│              [PlantPulse 로고]                │
│                                              │
│              플랜트펄스 플랫폼                 │
│                                              │
│  [ 아이디 또는 이메일 주소         ]          │
│  [ 비밀번호                       ]          │
│                                              │
│  ☐ 세션이 유효할 시, 자동 로그인              │
│                                              │
│  ┌──────────────────────────────┐             │
│  │           로그인              │             │
│  └──────────────────────────────┘             │
│                                              │
│         📱 모바일버전으로 접속                 │
│                                              │
└──────────────────────────────────────────────┘
```

| 입력 항목          | 필드명          | 형태                 | placeholder / 라벨    | 설명                 |
| -------------- | ------------ | ------------------ | ------------------- | ------------------ |
| **아이디 또는 이메일** | `userId`     | 텍스트 입력             | "아이디 또는 이메일 주소"     | 발급받은 사용자 ID 또는 이메일 |
| **비밀번호**       | `password`   | 패스워드 입력 (마스킹)      | "비밀번호"              | 개인 비밀번호            |
| **자동 로그인**     | `auto_login` | 체크박스 (값 `true`)    | "세션이 유효할 시, 자동 로그인" | 다음 접속 시 로그인 절차 생략  |
| **로그인 버튼**     | (`#bt`)      | 큰 버튼 (form submit) | "로그인"               | 클릭 또는 Enter 키로 제출  |
| **모바일 접속**     | (링크)         | 텍스트 + 모바일 아이콘      | "모바일버전으로 접속"        | `/m/` 모바일 화면으로 이동  |

### 로그인 진행 표시

로그인 버튼을 누르면 폼이 잠시 사라지고 로딩 표시가 표시됩니다.

```
   ⟳ (회전)
  로그인 중...
```

서버 응답이 오면 자동으로 메인 화면으로 이동합니다.

***

## 로그인 절차 <a href="#login-steps" id="login-steps"></a>

**1단계** — 아이디/이메일 입력란에 발급받은 사용자 ID 또는 이메일을 입력합니다.

**2단계** — 비밀번호 입력란에 비밀번호를 입력합니다. 입력값은 자동으로 가려집니다(•••••).

**3단계** (선택) — 다음 접속 시 로그인 절차를 생략하고 싶으면 **자동 로그인** 체크박스를 선택합니다.

**4단계** — **로그인** 버튼을 클릭하거나 키보드의 **Enter** 를 누릅니다.

> 최초 설치 시 기본 관리자 계정은 `admin` / `admin123!` 입니다. 보안을 위해 로그인 후 즉시 비밀번호를 변경해 주세요.

***

## 자동 로그인 <a href="#auto-login" id="auto-login"></a>

로그인 화면의 **세션이 유효할 시, 자동 로그인** 체크박스를 선택하면 다음 접속 시 로그인 절차가 생략됩니다.

### 동작 원리

* 자동 로그인은 **브라우저 쿠키**에 토큰을 저장해 다음 접속 시 자동 인증합니다
* 쿠키가 유효한 동안만 동작합니다 — 브라우저 쿠키 삭제·시크릿 모드 사용·다른 브라우저 사용 시 다시 로그인이 필요합니다
* 로그아웃을 명시적으로 하면 쿠키가 무효화되어 자동 로그인이 해제됩니다

### 보안 권고

* **공용 PC** 에서는 자동 로그인을 사용하지 마세요
* **공용 PC** 에서 사용했다면 사용 후 반드시 명시적으로 로그아웃하세요
* 자리를 비울 때는 화면을 잠그거나 로그아웃하시기를 권장합니다

***

## 로그인 실패 시 대응 <a href="#login-failures" id="login-failures"></a>

| 상황            | 화면 메시지              | 조치                                                          |
| ------------- | ------------------- | ----------------------------------------------------------- |
| ID 또는 비밀번호 오류 | "로그인 정보가 올바르지 않습니다" | ID/비밀번호 확인 후 재입력                                            |
| 계정 잠금         | 일정 횟수 이상 실패 시 일시 잠금 | 잠시 후 재시도 또는 시스템 관리자에게 잠금 해제 요청                              |
| 세션 만료         | 자동으로 로그인 페이지로 이동    | 다시 로그인                                                      |
| 페이지 로드 실패     | 브라우저가 서버 접속 불가      | 서버 IP/포트 확인, 시스템 관리자에게 서버 가동 여부 확인                          |
| 비밀번호 정책 위반    | "비밀번호 정책 위반" 안내     | [보안 관리](/plantpulse-platform/user/security.md) 의 비밀번호 정책 확인 |

> 로그인 실패 메시지는 시스템 메시지 코드 `login.text.login_error` / `login.text.login_error_msg` 로 처리되며, 다국어 환경에서는 사용자 언어에 맞춰 표시됩니다.

***

## 로그아웃 <a href="#logout" id="logout"></a>

상단 헤더 우측의 **사용자 아이콘**을 열어 로그아웃하실 수 있습니다.

| 방법                | 위치                       | 동작                            |
| ----------------- | ------------------------ | ----------------------------- |
| **사용자 메뉴 → 로그아웃** | 우상단 사용자 아이콘 클릭 → 드롭다운 메뉴 | 프로필·비밀번호 변경 메뉴와 함께 빨강 텍스트로 표시 |

로그아웃하면 자동 로그인 쿠키도 무효화됩니다.

***

## 세션 관리 <a href="#session" id="session"></a>

| 항목            | 설명                                                  |
| ------------- | --------------------------------------------------- |
| **세션 유효 시간**  | 기본 30분 (관리자 설정에 따라 변경 가능)                           |
| **자동 로그아웃**   | 유효 시간 동안 활동이 없으면 자동으로 세션 만료 → 로그인 페이지 이동            |
| **동시 로그인**    | 동일 계정으로 여러 브라우저 동시 접속 가능                            |
| **세션 갱신**     | 활동(클릭, 페이지 이동, API 호출)이 있으면 자동 갱신                   |
| **자동 로그인 토큰** | 별도 쿠키로 저장 — 세션이 만료되어도 자동 로그인 토큰이 유효하면 다음 접속 시 자동 인증 |

***

## 사용자 역할(ADMIN/MANAGER/USER)별 메뉴 차이 <a href="#roles" id="roles"></a>

플랫폼 역할은 시스템 관리자가 [보안 관리 > 사용자](/plantpulse-platform/user/security.md) 화면에서 설정합니다. 현재 공통 레이아웃은 통합 메뉴 구조를 기준으로 렌더링되며, 실제 조회·수정·삭제·제어 가능 여부는 역할과 서버 보안 정책에 따라 제한됩니다.

### ADMIN — 시스템 관리자

전체 운영·설정·보안·시스템 관리 기능을 사용할 수 있습니다.

| 그룹            | 하위 메뉴                                            |
| ------------- | ------------------------------------------------ |
| Overview      | 대시보드·일일 통계                                       |
| Connectivity  | 프로토콜·연결 상태·엣지                                    |
| Factory Model | 모델·에셋·태그·온톨로지·메타데이터·기준정보                         |
| Production    | 고객·제품·직원·근무표·워크오더                                |
| Equipment     | 설비 목록·데이터 조회·타임라인 비교                             |
| ISO           | ISO 데이터·ISO 분석                                   |
| Data          | 스트림·트렌드·스냅샷·데이터 출력·오브젝트(BLOB)                    |
| Alarm         | 알람·알람 고급검색·알람 시각화 분석·고급 EQL 알람                   |
| Visualization | 캔버스                                              |
| Automation    | 플로우·플로우 실행 이력·EQL 쿼리·스테이트먼트                      |
| Standard      | UNS·OPC-UA·AAS V3                                |
| System        | 사용자·보안 정책·API 토큰·모니터링·진단·로그·설정·환경정보·클러스터·고급 모니터링 |

### MANAGER — 운영 관리자

ADMIN 메뉴 중 보안·시스템 관리 일부가 제한된 메뉴 셋이 표시됩니다.

### USER — 일반 사용자

조회 중심 기능을 사용합니다. 수정·삭제·제어 동작은 화면에 보이더라도 서버 권한에서 제한될 수 있습니다.

> 역할 변경이 필요하면 시스템 관리자에게 요청해 주세요. 자세한 역할별 권한은 [보안 관리](/plantpulse-platform/user/security.md) 페이지를 참조해 주세요.

***

## 로그인 후 메인 화면 구성 <a href="#post-login" id="post-login"></a>

로그인이 완료되면 자동으로 [대시보드](/plantpulse-platform/user/summary.md) 로 이동합니다. 모든 페이지에서 공통으로 보이는 상단 헤더와 좌측 사이드 메뉴를 함께 안내해 드립니다.

### 최신 콘솔 탐색 문서 <a href="#navigation-doc" id="navigation-doc"></a>

화면 개편 이후 좌측 메뉴는 실제 서버웹 통합 메뉴 기준으로 **Overview / Connectivity / Factory Model / Production / Equipment / ISO / Data / Alarm / Visualization / Automation / Standard / System** 순서로 정리되었습니다. 최신 메뉴 순서, 도메인 검색, 토스트 알림, 공통 화면 패턴은 [콘솔 탐색과 공통 화면](/plantpulse-platform/user/navigation.md) 을 기준 문서로 사용하세요.

```
┌──────────┬───────────────────────────────────────────────────────────┐
│ [PP로고] │ ☰  [🔍 도메인 검색  ...힌트...  CTRL+K]                    │ ← 상단 헤더 좌측
│          │                    [🟢LIVE] [🔔N] [📺] [⚙] [📖] [👤]      │ ← 상단 헤더 우측
├──────────┼───────────────────────────────────────────────────────────┤
│ 대시보드 │                                                           │
│  연결 ▶  │                                                           │
│  팩토리▶ │              메인 콘텐츠 영역                              │
│  ...     │            (선택한 메뉴 화면 표시)                         │
│  ...     │                                                           │
│  ───     │                                                           │
│  CPU [─] │                                                           │
│  MEM [─] │                                                           │
└──────────┴───────────────────────────────────────────────────────────┘
```

> 우측 툴바 순서는 **LIVE → 알람 → 전체화면 → 환경설정 → 매뉴얼 → 사용자(맨 오른쪽)** 입니다.

### 상단 헤더 — 좌측 <a href="#header-left" id="header-left"></a>

상단 헤더 좌측에는 **사이드 브랜드 로고 + 사이드 메뉴 토글 + 도메인 ID 통합 검색** 3가지 요소가 표시됩니다.

| 요소                         | 위치                    | 동작                                                                                 |
| -------------------------- | --------------------- | ---------------------------------------------------------------------------------- |
| **PlantPulse 로고**          | 사이드바 헤더 (가장 좌측 다크 영역) | 클릭 시 [대시보드](/plantpulse-platform/user/summary.md) (`/map/index`) 이동                |
| **사이드 메뉴 토글** (☰ 들여쓰기 아이콘) | 로고 우측                 | 좌측 사이드 메뉴 접기/펼치기 (펼친 폭 정리 동시)                                                      |
| **도메인 검색 버튼**              | 토글 우측 (와이드)           | 🔍 + "도메인 검색" + 힌트 텍스트 + `CTRL+K` 칩 — 클릭 또는 키보드 `Ctrl+K` (Mac `⌘+K`) 로 즉시 다이얼로그 오픈 |

> EQL 입력창은 더 이상 상단 헤더에 노출되지 않습니다. EQL 작성은 [CEP](/plantpulse-platform/user/cep.md) 메뉴 안의 전용 화면에서 수행하세요.

#### 도메인 ID 통합 검색 다이얼로그 <a href="#domain-search" id="domain-search"></a>

상단 검색 버튼 또는 `Ctrl+K` (Mac `⌘+K`) 단축키로 어디서나 호출할 수 있습니다. 입력 중인 입력란/편집기와 무관하게 우선순위 최상으로 가로채 다이얼로그가 열립니다.

다이얼로그 구성 (위에서 아래로):

| 영역               | 표시                                                      |
| ---------------- | ------------------------------------------------------- |
| **헤더**           | 🔍 "도메인 ID 통합 검색" 타이틀 + 닫기(×)                           |
| **검색창** (`ds-q`) | 단일 입력창 — ID/이름/설명 어느 곳에 포함되어도 검색됩니다                     |
| **도메인 칩** (필터)   | 도메인 필터 — 클릭으로 단독 도메인만 표시. 각 칩에 현재 결과 건수가 같이 표시됨         |
| **최근 검색 행**      | 최근에 검색한 키워드 칩 — 클릭하면 그 키워드로 재검색                         |
| **결과 테이블**       | 도메인별 색상 뱃지 + ID(클릭 시 클립보드 복사) + 이름 + 상세 화면으로 이동하는 액션 버튼 |
| **푸터**           | 페이징 + 결과 수 표시                                           |

#### 검색 가능한 도메인과 색상

| 뱃지                | 도메인       | 색상      |
| ----------------- | --------- | ------- |
| **SITE**          | 사이트       | 🟦 청록   |
| **AREA**          | 영역        | 🟩 진녹   |
| **LINE**          | 라인        | 🟢 녹    |
| **EQUIPMENT**     | 장비 (자산)   | 🟢 밝은 녹 |
| **TAG**           | 태그        | 🟡 머스타드 |
| **OPC**           | OPC 데이터소스 | 🟣 보라   |
| **EDGE**          | 엣지 게이트웨이  | 🟦 청록2  |
| **ALARM\_CONFIG** | 알람 정의     | 🔴 빨강   |
| **USER**          | 사용자       | 🔵 네이비  |
| **EMPLOYEE**      | 직원        | 🟠 주황   |
| **SECURITY**      | 보안 정책     | 🟣 보라   |
| **CUSTOMER**      | 고객        | ⚫ 슬레이트  |
| **PRODUCT**       | 제품        | 🔵 블루   |
| **FLOW**          | 플로우       | 🟣 퍼플   |

#### 검색 결과 사용

* **ID 셀 클릭** → 클립보드에 ID 복사 (다이얼로그는 닫히지 않음)
* **상세 화면 이동 액션** → 도메인별 상세 페이지로 이동 (예: EDGE → `/edge/view/{id}`, EQUIPMENT → 자산 트리)
* **도메인 칩 클릭** → 해당 도메인만 단독 필터링

### 상단 헤더 — 우측 도구 <a href="#header-right" id="header-right"></a>

우상단의 툴바 아이콘은 **좌→우 순서**로 다음과 같습니다 (전면 개편으로 순서·아이콘이 명확하게 정리됨).

| 순번    | 아이콘                    | 의미                                 | 클릭 동작                                                                    |
| ----- | ---------------------- | ---------------------------------- | ------------------------------------------------------------------------ |
| **1** | **🟢 LIVE (도트 + 텍스트)** | 실시간 푸시(웹소켓) 연결 상태 — 도트가 펄스 깜빡이면 정상 | 드롭다운 — 📡 연결 안내 + 웹소켓 주소 + 현재 시간                                         |
| **2** | **🔔 알람 종 + 빨강 배지**    | 최근 수신 알람 카운트 (100건 이상은 `99+` 로 캡)  | 드롭다운 — 최근 알람 미리보기 + "알람 메뉴로 이동" 푸터 링크                                    |
| **3** | **📺 TV (전체화면)**       | 브라우저 전체화면 토글                       | 클릭 즉시 토글 (드롭다운 없음)                                                       |
| **4** | **⚙ 설정**               | 화면 환경설정                            | 화면 배율, 알람 팝업, 진단 로그 표시 설정                                                |
| **5** | **📖 책 (매뉴얼)**         | 매뉴얼 새 창                            | 본 GitBook 매뉴얼 (`https://kopens.gitbook.io/plantpulse-platform`) 새 탭으로 이동 |
| **6** | **👤 사용자 (맨 오른쪽)**     | 로그인 사용자 메뉴                         | 드롭다운 — 큰 아바타·사용자명 + 프로필 / 비밀번호 변경 / 로그아웃                                 |

> 💡 사용자 메뉴의 로그아웃은 항상 **빨강 텍스트**로 표시됩니다 — 실수 방지용 시각 표시.

#### LIVE 도트의 의미

| 표시                          | 의미                                |
| --------------------------- | --------------------------------- |
| 🟢 도트가 **펄스(깜빡)**           | 웹소켓이 정상 연결되어 실시간 데이터 수신 중         |
| 🔘 도트가 회색 또는 정지             | 웹소켓 끊김 — 새로고침으로 재연결 시도            |
| 드롭다운 우측 시계 (`current-time`) | 매초 갱신되는 서버 시각 — 멈춰 있으면 WS 가 끊긴 신호 |

#### 알람 배지 표시 규칙

| 카운트        | 표시                  |
| ---------- | ------------------- |
| 0          | `0` (작게)            |
| 1\~99      | 해당 숫자               |
| **100 이상** | **`99+`** — 화면 폭 절약 |

알람 드롭다운에는 최근 N건의 알람 헤드라인이 시간 역순으로 표시되며, "**알람 메뉴로 이동**" 푸터 링크로 [알람](/plantpulse-platform/user/alarm.md) 메뉴 전체 목록으로 이동할 수 있습니다.

### 좌측 사이드 메뉴 <a href="#sidebar-menu" id="sidebar-menu"></a>

좌측 사이드바에는 사용자 역할에 따라 메뉴가 표시됩니다(위 [역할별 메뉴 차이](#roles) 참고). ADMIN 역할 기준으로 다음과 같습니다.

| 아이콘 | 메뉴                | URL                 | 하위 메뉴                                                                                                                                                                                                                               |
| --- | ----------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🌐  | **대시보드**          | `/map/index`        | OVERVIEW                                                                                                                                                                                                                            |
| 📊  | **일일 통계**         | `/statistics/index` | OVERVIEW                                                                                                                                                                                                                            |
| 🔌  | **Connectivity**  | (다중)                | 프로토콜(`/connect/index`) · 연결 상태(`/connect/status`) · 엣지(`/edge/index`)                                                                                                                                                               |
| 🏭  | **팩토리**           | (다중)                | 모델(`/model/index`) · 에셋(`/asset/tree/index`) · 태그(`/tag/index`) · 온톨로지(`/ontology/index`) · 메타데이터(`/metadata/index`) · 기준정보(`/basedata/index`)                                                                                      |
| ⚙️  | **Production**    | (다중)                | 고객(`/customer/index`) · 제품(`/product/index`) · 직원(`/employee/index`) · 근무표(`/calendar/index`) · 워크오더(`/order/index`)                                                                                                                |
| 📺  | **Equipment**     | (다중)                | 설비 목록(`/equipment/index`) · 데이터 조회(`/asset/data/index`) · 타임라인 비교(`/timeline/index`)                                                                                                                                                |
| 📈  | **ISO**           | (다중)                | ISO 데이터(`/asset/plugin/index`) · ISO 분석(`/analysis/index`)                                                                                                                                                                          |
| 🗄️ | **Data**          | (다중)                | 스트림(`/stream/index`) · 트렌드(`/storage/index`) · 스냅샷(`/snapshot/index`) · 데이터 출력(`/data/index`) · 오브젝트(BLOB)(`/blob/store`)                                                                                                           |
| 🔔  | **Alarm**         | (다중)                | 알람(`/alarm/index`) · 알람 고급검색(`/alarm/advsearch/index`) · 알람 시각화 분석(`/alarm/analysis/index`) · 고급 EQL 알람(`/alarm/config/index`)                                                                                                      |
| 🎨  | **Visualization** | `/canvas/index`     | 캔버스                                                                                                                                                                                                                                 |
| 🔀  | **Automation**    | (다중)                | 플로우(`/flow/index`) · 플로우 실행 이력(`/flow/log`) · EQL 쿼리(`/query/index`) · 스테이트먼트(`/statement/index`)                                                                                                                                   |
| 🌐  | **Standard**      | (다중/외부)             | UNS(`/uns/tree`) · OPC-UA(:12780) · AAS V3(:8091/ui)                                                                                                                                                                                |
| ⚙   | **System**        | (다중/외부)             | 사용자(`/user/index`) · 보안 정책(`/security/index`) · API 토큰(`/token/index`) · 모니터링(`/monitoring/index`) · 진단(`/diagnostic/index`) · 로그(`/log/index`) · 설정(`/config/index`) · 환경정보(`/env/view`) · 클러스터(`/cluster/index`) · 고급 모니터링(:3000) |

> 하위 메뉴가 있는 항목은 ▼ 화살표 아이콘이 표시됩니다. 클릭 시 펼쳐지며, 다른 메뉴 클릭 시 자동으로 접힙니다.

### 좌측 하단 시스템 성능 박스 <a href="#perf-box" id="perf-box"></a>

좌측 메뉴 아래에 시스템 성능 모니터링 박스가 있습니다.

| 항목                      | 표시                                                       |
| ----------------------- | -------------------------------------------------------- |
| **헤더**                  | "시스템 성능" + 토글 화살표 (펼치기/접기)                               |
| **CPU** (`cpu-text`)    | 현재 CPU 사용률 (%) + 1분 스파크라인 (`nav-cpu-sparkline`, 40px 높이) |
| **메모리** (`memory-text`) | 현재 메모리 사용량 + 1분 스파크라인 (`nav-memory-sparkline`, 40px 높이)  |

전체화면 보기 모드에서는 이 박스가 숨겨집니다.

***

## 모바일 접속 <a href="#mobile" id="mobile"></a>

모바일 브라우저(스마트폰·태블릿)로 동일한 URL 에 접속하시면 자동으로 모바일 최적화 화면(`/m/`)으로 전환되거나, 로그인 화면 하단의 **📱 모바일버전으로 접속** 링크로 이동하실 수 있습니다.

### 모바일에서 제공하는 주요 기능

* 대시보드 조회
* 실시간 알람 확인·푸시 알림
* 데이터 포인트 조회
* 작업지시 상태 확인

자세한 모바일 기능은 모바일 화면에서 직접 확인해 주세요.

***

## 자주 묻는 질문 <a href="#faq" id="faq"></a>

**Q. 로그인 후 화면이 흰색으로 멈춰 있어요.** A. 브라우저가 서버에 연결되었는지 확인하세요. 우상단의 WS 신호 아이콘이 빨강이면 실시간 연결이 끊긴 상태입니다. 새로고침(F5)으로 복구되지 않으면 시스템 관리자에게 문의해 주세요.

**Q. 자동 로그인을 했는데 매번 다시 로그인해야 합니다.** A. 브라우저의 쿠키 차단·시크릿 모드 사용·여러 브라우저 혼용 시 자동 로그인이 동작하지 않습니다. 같은 브라우저에서 쿠키 허용 상태로 사용해 주세요.

**Q. 비밀번호를 잊어버렸어요.** A. 시스템 관리자(ADMIN)에게 비밀번호 초기화를 요청하세요. 운영 환경에 따라 자동 초기화 메일 기능이 있을 수도 있으나 표준 동작은 관리자 초기화입니다.

**Q. 다른 PC에서 로그인하면 기존 세션이 끊기나요?** A. 끊기지 않습니다. 동시 로그인이 허용됩니다. 다만 보안 정책에 따라 단일 세션만 허용하도록 설정되어 있을 수 있으니 [보안 관리](/plantpulse-platform/user/security.md) 의 보안 정책을 확인해 주세요.

**Q. 일정 시간 사용하지 않으면 자동으로 로그아웃되나요?** A. 네, 기본 30분 미사용 시 세션이 만료됩니다. 자동 로그인이 켜져 있다면 다음 접속 시 자동 인증되지만, 그렇지 않으면 다시 로그인해야 합니다.

**Q. 상단의 EQL 입력창이 사라졌습니다.** A. UI 전면 개편으로 EQL 입력창은 [CEP](/plantpulse-platform/user/cep.md) 메뉴 안의 전용 화면으로 이동했습니다. 대신 상단 좌측에 **도메인 ID 통합 검색** 버튼이 추가되어 어느 화면에서도 `Ctrl+K` (Mac `⌘+K`) 로 호출할 수 있습니다.

**Q. `Ctrl+K` 단축키가 입력 중인 텍스트박스에서도 동작하나요?** A. 네, 우선순위 최상으로 가로채도록 설계되었습니다. EQL 편집기·코드 편집기 안에서도 그대로 동작합니다. 입력 중인 텍스트는 자동으로 다이얼로그의 검색창으로 옮겨가지는 않으니, 검색하시려는 키워드를 다시 입력하세요.

**Q. 도메인 검색에서 우리 사용자 ID 가 안 보입니다.** A. **USER** 도메인은 검색 대상이지만, **보안 정책·API 토큰**은 의도적으로 검색에서 제외됩니다. 사용자 일반 정보는 USER 도메인 칩 필터로, 보안 식별자는 [보안 관리](/plantpulse-platform/user/security.md) 화면에서 직접 확인하세요.

**Q. 알람 카운트가 `99+` 로 표시됩니다.** A. 처리되지 않은 알람이 100건 이상 누적된 상태입니다. 🔔 클릭하여 알람 드롭다운에서 최근 항목을 확인하시거나, "**알람 메뉴로 이동**" 으로 전체 목록을 검토 후 처리해 주세요.

**Q. LIVE 도트가 회색이거나 멈춰 보입니다.** A. 실시간 푸시 채널이 끊긴 상태입니다. 우상단 LIVE 클릭 → 드롭다운의 "현재 시간" 이 매초 갱신되는지 확인하세요. 멈춰 있으면 페이지 새로고침(F5)으로 재연결되며, 그래도 끊기면 [진단](/plantpulse-platform/user/diagnostic.md) 화면에서 서버 모듈 상태를 확인해 주세요.

**Q. 도메인 검색(`CTRL+K`)은 무엇을 검색하나요?** A. 사이트 ID·자산 ID·태그 ID·작업지시 ID 같은 도메인 식별자를 통합 검색합니다. 결과 클릭 시 해당 도메인의 상세 화면으로 즉시 이동합니다.

**Q. 알람 종 아이콘 옆 숫자가 줄어들지 않습니다.** A. 그 숫자는 최근 N분 이내의 알람 개수입니다. 시간이 지나면 자동으로 윈도우에서 빠져 0이 됩니다. 즉시 0으로 만들고 싶다면 알람 종을 클릭해 알람 메뉴로 이동 후 확인 처리하세요.

**Q. 시스템 성능 박스의 CPU 가 100% 가까이 가있어요.** A. 일시적이라면 정상 부하일 수 있습니다. 5분 이상 지속되면 시스템 관리자에게 문의해 주세요. 더 자세한 모니터링은 [대시보드](/plantpulse-platform/user/summary.md) 의 우측 헬스 레일과 [시스템](/plantpulse-platform/user/system.md) 모니터링 화면을 함께 확인하세요.

**Q. 좌측 메뉴를 접고 싶어요.** A. 좌상단의 ☰ 토글 아이콘을 클릭하면 메뉴가 접힙니다. 다시 클릭하면 펼쳐집니다.

***

## 관련 화면 <a href="#related" id="related"></a>

* [콘솔 탐색과 공통 화면](/plantpulse-platform/user/navigation.md) — 최신 메뉴 구조와 공통 화면 패턴
* [대시보드](/plantpulse-platform/user/summary.md) — 로그인 후 첫 화면
* [보안 관리](/plantpulse-platform/user/security.md) — 사용자 계정·역할·비밀번호 정책
* [CEP](/plantpulse-platform/user/cep.md) — EQL 쿼리 작성·관리
* [진단](/plantpulse-platform/user/diagnostic.md) — 로그인 실패 등 시스템 진단 로그