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

# 설비 관리

## 목차

* [개요](#overview)
* [화면 구성](#layout)
* [상단 — 페이지 제목·도구](#top)
* [좌측 사이드바 — 검색·필터링](#sidebar)
* [우측 — 설비 카드 목록](#card-list)
  * [설비 카드 구성](#card-structure)
  * [카드 상단 — 이름·설명](#card-header)
  * [상태 점등 5종](#status-dots)
  * [오늘 알람 카운트 3종](#alarm-counts)
  * [설비 이미지·생산 상태·푸터](#card-bottom)
* [타임라인 분석](#timeline)
* [활용 시나리오](#use-cases)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)

***

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

설비 메뉴는 등록된 설비(Equipment)들을 카드 형태로 한눈에 보여 줍니다. 각 카드에는 설비 이미지, 연결·건강·등록 상태 점등, 오늘 알람 카운트, 태그 수, 자산 트리 링크가 포함됩니다. 좌측 사이드바의 사이트·구역·라인 필터로 원하는 설비만 빠르게 좁혀 볼 수 있습니다.

이 화면은 운영자가 다음을 빠르게 판단할 때 사용됩니다.

* 어떤 설비가 통신이 끊겼나
* 어떤 설비가 건강 진단에서 경고/위험인가
* 오늘 어느 설비에서 심각 알람이 발생했나

**경로**: 왼쪽 메뉴 > **Equipment > 설비 목록** (내부 URL `/equipment/index`)

***

## 화면 구성 <a href="#layout" id="layout"></a>

```
┌──────────────────────────────────────────────────────────────────┐
│  📺 설비  [총 N 개의 설비]              [타임라인 분석] [↻]       │ ← ① 상단
├──────────┬───────────────────────────────────────────────────────┤
│ 🔎 필터링 │  ▾ 설비 목록 [N]                                       │
│          │ ─────────────────────────────────────────────────────│
│ [사이트▼] │   ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐                │
│ [구역 ▼]  │   │ 카드 │ │ 카드 │ │ 카드 │ │ 카드 │                │ ← ③ 카드 그리드
│ [라인 ▼]  │   │ ...  │ │ ...  │ │ ...  │ │ ...  │                │
│          │   └──────┘ └──────┘ └──────┘ └──────┘                │
│ [설비 유형]│                                                       │
│ [설명]    │                                                       │
│ [검색]    │                                                       │
└──────────┴───────────────────────────────────────────────────────┘
```

| 영역        | 위치        | 표시                             |
| --------- | --------- | ------------------------------ |
| ① 상단      | 전체 폭      | 페이지 제목·총 설비 수·타임라인 분석/새로고침 버튼  |
| ② 좌측 사이드바 | col-lg-2  | 사이트/구역/라인 셀렉터 + 검색 옵션 + 검색 버튼  |
| ③ 우측      | col-lg-10 | 설비 카드 목록 (검색 결과 수 표시 + 카드 그리드) |

***

## 상단 — 페이지 제목·도구 <a href="#top" id="top"></a>

| 항목          | 형태           | 표시                                                        |
| ----------- | ------------ | --------------------------------------------------------- |
| **페이지 제목**  | 좌측           | 📺 "설비" + `[ 총 ${total_equipment_size} 개의 설비 ]` 작은 회색 텍스트 |
| **타임라인 분석** | 우측 빨강 버튼     | 📊 "타임라인 분석" — 다중 설비 타임라인 비교 화면 호출(`openTimeline()`)      |
| **새로고침**    | 우측 빨강 버튼 + ↻ | 좌측 필터 그대로 유지하고 카드 목록만 다시 불러오기                             |

> 페이지 진입 시 카드 목록은 비어 있고, 좌측 사이드바에서 검색 옵션을 설정한 뒤 **검색** 을 눌러야 채워집니다.

***

## 좌측 사이드바 — 검색·필터링 <a href="#sidebar" id="sidebar"></a>

좌측 패널의 폼은 4개 그룹으로 구성됩니다.

### 1) 사이트 셀렉터

```
🏭  [ 전체 사이트  ▼ ]
```

| 항목          | ID        | 옵션                                  |
| ----------- | --------- | ----------------------------------- |
| **사이트 셀렉터** | `site_id` | "전체 사이트" + 등록된 사이트 목록 (`사이트명 [설명]`) |

> 사이트를 변경하면 (`onchange="changedSite()"`) 그 사이트에 속한 구역(`area_list`)과 라인(`line_list`)이 자동으로 다시 채워집니다.

### 2) 구역|라인 필터링

`<fieldset>` 으로 묶여 있으며, **구역|라인 필터링** 라벨이 표시됩니다.

| 셀렉터           | ID        | 옵션                                |
| ------------- | --------- | --------------------------------- |
| **구역** (Area) | `area_id` | "구역 선택" + 사이트의 구역 목록 (`자산명 [설명]`) |
| **라인** (Line) | `line_id` | "라인 선택" + 구역의 라인 목록 (`자산명 [설명]`)  |

> 구역을 변경하면(`changedArea()`) 그 구역에 속한 라인만 라인 셀렉터에 채워지고, 라인을 변경하면(`changedLine()`) 그 라인 자산이 즉시 검색 조건에 반영됩니다.

### 3) 검색 옵션

`<fieldset>` 으로 묶여 있으며, **검색 옵션** 라벨이 표시됩니다.

| 입력           | name                | placeholder | 설명                                      |
| ------------ | ------------------- | ----------- | --------------------------------------- |
| **설비 공통 유형** | `common_table_type` | "설비 공통 유형"  | 도메인 유형(예: `MOTOR`, `PUMP`, `VALVE`) 키워드 |
| **설명**       | `description`       | "설명"        | 설비 설명 텍스트 키워드                           |

### 4) 검색 버튼

| 버튼     | 폭          | 동작                        |
| ------ | ---------- | ------------------------- |
| **검색** | 100px (파랑) | 위 필터·옵션을 모두 적용해 카드 목록을 갱신 |

***

## 우측 — 설비 카드 목록 <a href="#card-list" id="card-list"></a>

검색 결과가 없으면 다음 안내가 표시됩니다.

> 🖼 \[설비 일러스트]
>
> 검색 옵션을 조정하신 후, 설비를 검색하십시오.

검색 결과가 있으면 카드 그리드(`eq-card-list`)에 설비가 카드 단위로 표시됩니다.

```
┌───────────── 우측 영역 헤더 ─────────────┐
│ ▾ 설비 목록 [N]                            │
└────────────────────────────────────────────┘
```

| 헤더 항목      | 표시                                                     |
| ---------- | ------------------------------------------------------ |
| **헤더 라벨**  | "설비 목록 \[N]" — N 은 검색된 설비 수 (`search_equipment_count`) |
| **결과 텍스트** | 작은 글씨(`result_txt`) — 검색 메타 정보 (예: 검색에 사용된 필터 요약)      |

### 설비 카드 구성 <a href="#card-structure" id="card-structure"></a>

각 카드(`eq-card`)는 다음 영역으로 구성됩니다.

```
┌────────────────────────────────────┐
│  설비명 (굵게)                       │ ← header
│  설비 설명                           │ ← desc
├────────────────────────────────────┤
│  📶 ❤️ 🏷 📅 🥧 │ 🟢 🟡 🔴           │ ← status (점등 5종 + 알람 3종)
├────────────────────────────────────┤
│                                    │
│        설비 이미지 (썸네일)           │ ← thumb (클릭 시 설비 대시보드)
│                                    │
├────────────────────────────────────┤
│         생산 상태 뱃지                │ ← OEE area (active 상태)
├────────────────────────────────────┤
│  🏷 N                          ⚙   │ ← footer (태그 수 / 자산 트리 이동)
└────────────────────────────────────┘
```

### 카드 상단 — 이름·설명 <a href="#card-header" id="card-header"></a>

| 영역        | 클래스              | 표시                             |
| --------- | ---------------- | ------------------------------ |
| **카드 헤더** | `eq-card-header` | 설비 이름(`asset_name`) — 굵은 글씨    |
| **카드 설명** | `eq-card-desc`   | 설비 설명(`description`) — 한 줄 텍스트 |

### 상태 점등 5종 <a href="#status-dots" id="status-dots"></a>

카드 상태 영역(`eq-card-status`) 좌측에 5개 점등이 가로로 배치됩니다. 각 점등은 hover 시 툴팁으로 의미가 표시됩니다.

| 아이콘            | ID                                   | 툴팁          | 의미                                      |
| -------------- | ------------------------------------ | ----------- | --------------------------------------- |
| 📶 (Wi-Fi)     | `${asset_id}_status_connection`      | "연결상태"      | 통신 연결 상태 (정상연결·연결지연·연결이상·연결끊김·연결안됨 5단계) |
| ❤️ (Heartbeat) | `${asset_id}_status_health`          | "건강상태"      | 자산 헬스 진단 결과 (정상·주의·위험·미상 4단계)           |
| 🏷 (Tags)      | `${asset_id}_status_tag_reg`         | "태그 등록 상태"  | 설비에 태그가 등록되었는지                          |
| 📅 (Calendar)  | `${asset_id}_status_event_reg`       | "이벤트 등록 상태" | 자산 이벤트 룰이 등록되었는지                        |
| 🥧 (Pie)       | `${asset_id}_status_aggregation_reg` | "집계 등록 상태"  | 자산 집계(Aggregation) 룰이 등록되었는지            |

> 색상 의미는 [상태 코드 정의](/plantpulse-platform/user/status.md) 참고. 회색 = 미상/미등록, 녹색 = 정상, 주황 = 주의, 빨강 = 이상.

### 오늘 알람 카운트 3종 <a href="#alarm-counts" id="alarm-counts"></a>

상태 영역의 우측(왼쪽 5개와 세로 구분선으로 구분)에 오늘 알람 카운트가 3색으로 배치됩니다.

| 색상    | ID                              | 툴팁         | 표시       |
| ----- | ------------------------------- | ---------- | -------- |
| 🟢 녹색 | `${asset_id}_count_alarm_info`  | "오늘 정보 알람" | 정보 알람 건수 |
| 🟡 주황 | `${asset_id}_count_alarm_warn`  | "오늘 경고 알람" | 경고 알람 건수 |
| 🔴 빨강 | `${asset_id}_count_alarm_error` | "오늘 심각 알람" | 심각 알람 건수 |

값이 들어오기 전에는 모두 `-` 으로 표시됩니다.

### 설비 이미지·생산 상태·푸터 <a href="#card-bottom" id="card-bottom"></a>

#### 설비 이미지 (`eq-card-thumb`)

* 설비별 등록된 이미지를 썸네일로 표시 (`/asset/image/${asset_id}`)
* 클릭 시 `/asset/dashboard/equipment/${asset_id}` 새 창으로 이동 — 설비 단위 대시보드 화면
* 이미지가 등록되지 않은 설비는 기본 자리표시자 이미지가 표시됨

#### 생산 상태 뱃지 (`eq-oee-area`)

| ID                          | 표시                                   |
| --------------------------- | ------------------------------------ |
| `${asset_id}_status_active` | 현재 활성 상태(가동/정지/대기/유휴/이상) 뱃지가 색상으로 표시 |

#### 카드 푸터 (`eq-card-footer`)

| 항목        | 표시                                                            |
| --------- | ------------------------------------------------------------- |
| 🏷 + 태그 수 | `${asset_id}_tag_count` — 이 설비에 등록된 태그 수                      |
| ⚙ (톱니)    | 클릭 시 자산 트리 화면(`/asset/tree/index?sel=${asset_id}`) — 자산 메타 수정 |

***

## 타임라인 분석 <a href="#timeline" id="timeline"></a>

상단 **타임라인 분석** 버튼은 다중 설비 타임라인 비교 화면을 엽니다(`/timeline/index`). 자세한 사용법은 아래 [설비 메뉴 하위 화면 — 타임라인 비교](#timeline-compare) 를 참고하세요.

***

## 설비 메뉴 하위 화면 (목록 외 3종) <a href="#submenus" id="submenus"></a>

설비 메뉴에는 카드 목록(`/equipment/index`) 외에도 다음 3개 하위 화면이 있습니다.

| 메뉴              | 내부 URL                | 용도                                                                        |
| --------------- | --------------------- | ------------------------------------------------------------------------- |
| **목록** (위에서 다룸) | `/equipment/index`    | 설비 카드 그리드 모니터링                                                            |
| **데이터 조회**      | `/asset/data/index`   | 설비별 도메인 데이터(스냅샷·알람·이벤트·상태·집계·명령) 조회                                       |
| **타임라인 비교**     | `/timeline/index`     | 다중 설비의 시간 축 비교                                                            |
| **ISO 데이터**     | `/asset/plugin/index` | OEE/RAM/EMS 분석 ([ISO 데이터 및 분석](/plantpulse-platform/user/plugins.md) 매뉴얼) |

***

## 데이터 조회 화면 (`/asset/data/index`) <a href="#asset-data" id="asset-data"></a>

설비 단위로 도메인 데이터를 6 종류 중 하나로 조회하는 화면입니다.

### 상단 검색 영역

```
📋 데이터 조회   [기간] [데이터 유형 ▼] [시간 단위 ▼] [건수 ▼] [조회][전체 출력][↻]
```

| 컨트롤                      | 폭     | 설명                                                              |
| ------------------------ | ----- | --------------------------------------------------------------- |
| **기간** (`search_time`)   | 280px | 시작\~종료 (가운데, 굵은 글씨). hidden `search_date_from`/`search_date_to` |
| **데이터 유형** (`data_type`) | 120px | 6 옵션 — 스냅샷·알람·이벤트·상태·집계·명령                                      |
| **시간 단위** (`time_unit`)  | 110px | 초/분/시/일 단위 그룹화                                                  |
| **건수** (`limit`)         | 140px | 최근 1,000/2,000/5,000/10,000건                                    |
| **조회·전체 출력·새로고침**        | 빨강    | `search()` / `downloadCSV()` / `refresh()`                      |

### 데이터 유형 6종

| 코드            | 라벨  | 설명                     |
| ------------- | --- | ---------------------- |
| `DATA`        | 스냅샷 | 일정 간격으로 샘플링된 태그 값      |
| `ALARM`       | 알람  | 그 자산의 알람 이력            |
| `EVENT`       | 이벤트 | 자산 단위 이벤트(상태 변경 등)     |
| `CONTEXT`     | 상태  | 자산 상태(가동/정지/이상)의 변경 시점 |
| `AGGREGATION` | 집계  | 시간 단위 집계 결과(평균·합계 등)   |
| `COMMAND`     | 명령  | 자산에 발행한 명령 이력          |

### 좌측 (col-lg-2) — 자산 트리 패널

다른 설비 분석 화면과 동일: 사이트 셀렉터·에셋 트리·검색·푸터(에셋 ID 미리보기).

### 우측 (col-lg-10)

#### 1) 시간대별 건수 차트 (`hourly_chart`, 140px)

| 항목       | 설명                                 |
| -------- | ---------------------------------- |
| **헤더**   | 📊 "시간대별 건수" + 결과 요약(`result_txt`) |
| **차트**   | 데이터 유형별 시간대 막대 차트                  |
| **빈 상태** | "에셋 트리에서 설비를 선택하고 조회하여 주십시오."      |

#### 2) 조회 결과 테이블 (`data_table`)

표 헤더는 데이터 유형에 따라 동적으로 변경됩니다.

기본(스냅샷) 컬럼:

| 컬럼          | 폭     | 설명            |
| ----------- | ----- | ------------- |
| **시간**      | 200px | 측정 시각         |
| **에셋 ID**   | 150px | 자산 식별자        |
| **데이터 맵**   | 250px | 태그-값 페어의 JSON |
| **타임스탬프 맵** | 250px | 각 태그의 인입 시각   |

데이터 유형이 ALARM/EVENT/CONTEXT/AGGREGATION/COMMAND 로 변경(`onDataTypeChange()`)되면 그 유형에 맞는 컬럼으로 헤더가 다시 그려집니다.

***

## 타임라인 비교 화면 (`/timeline/index`) <a href="#timeline-compare" id="timeline-compare"></a>

여러 설비의 도메인 이벤트(상태/집계/이벤트/명령)를 하나의 시간 축에 겹쳐 비교하는 화면입니다.

### 상단 검색 영역

```
🔁 타임라인 비교   [기간] [타임라인 유형 ▼] [알람 표시 ▼] [건수 ▼] [조회][전체 출력][필터][↻]
```

| 컨트롤                             | 폭        | 설명                                                                      |
| ------------------------------- | -------- | ----------------------------------------------------------------------- |
| **기간** (`search_time`)          | 280px    | 시작\~종료                                                                  |
| **타임라인 유형** (`timeline_type`)   | 140px    | 4 옵션 — 상태(`CONTEXT`) / 집계(`AGGREGATION`) / 이벤트(`EVENT`) / 명령(`COMMAND`) |
| **알람 표시** (`show_alarm`)        | 140px    | 알람 표시(Y) / 표시안함(N, 기본)                                                  |
| **건수** (`limit`)                | 140px    | 100/200/300/500/1,000건                                                  |
| **조회**                          | 빨강 + 🔍  | `search()`                                                              |
| **전체 출력**                       | 빨강 + 📄  | `downloadCSV()`                                                         |
| **컨디션 필터** (`condition_button`) | 빨강 + 🎚️ | 데이터 조회 컨디션 옵션 (기본 숨김, `conditionOption()` 으로 펼치기)                       |
| **새로고침**                        | 빨강 + ↻   | —                                                                       |

### 컨디션 입력 (선택)

| 입력                         | 설명                                                                             |
| -------------------------- | ------------------------------------------------------------------------------ |
| `condition` (350px, 기본 숨김) | placeholder: `컨디션 : VALUE > 10 AND VALUE < 50 AND QUALITY = 192` 형태의 SQL 유사 조건 |

### 좌측 (col-lg-2) — 자산 트리

다른 화면과 동일한 트리 패널 (에셋 / 연결 탭).

### 우측 (col-lg-10) — 타임라인

| 항목           | 설명                                      |
| ------------ | --------------------------------------- |
| **헤더**       | 🕐 "타임라인" + 결과 요약(`result_txt`)         |
| **빠른 시간 범위** | 6 버튼(`10M`/`30M`/`1H`/`6H`/`12H`/`ALL`) |
| **타임라인 영역**  | 좌측 트리에서 체크한 자산들을 같은 시간 축에 색상 막대로 표시     |

### 활용

다중 설비의 가동·정지 패턴을 동시 비교하거나, 한 라인 내 설비 간 상태 변화의 시간 차이를 분석할 때 사용합니다. 알람 표시를 켜면 같은 시각의 알람 마커가 함께 표시되어 인과 관계 분석이 쉬워집니다.

***

## 자산 단위 대시보드 (`/asset/dashboard/{level}/{asset_id}`) <a href="#asset-dashboard" id="asset-dashboard"></a>

설비 카드의 이미지를 클릭하면 새 창으로 그 자산의 상세 대시보드가 열립니다. 자산 계층(사이트/구역/라인/설비) 4 단계 별로 다른 대시보드 화면이 제공됩니다.

| 계층  | 내부 URL                                  | 분량 (JSP) | 용도                        |
| --- | --------------------------------------- | -------- | ------------------------- |
| 사이트 | `/asset/dashboard/site/{site_id}`       | 281줄     | 사이트 전체 KPI + 모든 라인 요약     |
| 구역  | `/asset/dashboard/area/{asset_id}`      | 300줄     | 구역 내 라인·설비 종합             |
| 라인  | `/asset/dashboard/line/{asset_id}`      | 274줄     | 라인의 모든 설비 한 화면            |
| 설비  | `/asset/dashboard/equipment/{asset_id}` | 570줄     | **단일 설비 종합 대시보드** (가장 자세) |

### 설비 대시보드 (가장 자세) — 화면 구성

#### 상단 — 대시보드 타이틀바

```
[로고] | 설비명                          [▼ 다른 설비]   [↻실시간] [<일자>] [↻] [✕닫기]
사이트 / 구역 / 라인 / 설비 (브레드크럼)
```

| 영역                              | 설명                                                    |
| ------------------------------- | ----------------------------------------------------- |
| **다른 설비 드롭다운**                  | "이 위치의 다른 설비로 이동" — 같은 라인에 속한 다른 설비 목록 (`equip_list`) |
| **실시간 토글**                      | 클릭 시 회전 아이콘 활성/비활성                                    |
| **일자 선택** (`sandbox-container`) | 날짜 선택 — 그 일자의 데이터로 화면 갱신                              |
| **이전/다음 일**                     | ← → 버튼으로 일자 이동                                        |
| **새로고침**                        | `pageRefresh()`                                       |
| **창 닫기**                        | `self.close()` — 새 창 모드용                              |
| **브레드크럼**                       | 사이트 → 구역 → 라인 → 설비 경로 표시                              |

#### 좌측 col-lg-8 — 본문 패널

**패널 1 — 에셋 정보 (파란 보더 3px)**

| 영역           | 표시                                                        |
| ------------ | --------------------------------------------------------- |
| **헤더**       | 📺 설비명 + (등록일·수정일)                                        |
| **상태 점등**    | 자산 상태(`asset_status`) + 연결 상태(`connection_status`) — 색상으로 |
| **이미지**      | 자산 이미지 또는 SVG 도면 (640×320)                                |
| **OEE 미니 표** | 워크오더·제품·시프트 등 그 일자의 운영 메타가 둥근 표 형태로 표시                    |

**패널 2 — 에셋 타임라인 및 데이터**

| 항목          | 설명                                           |
| ----------- | -------------------------------------------- |
| **헤더**      | 📊 "에셋 타임라인 및 데이터" + 결과 요약(`result_txt`)     |
| **타임라인 이동** | 우측 버튼 — [타임라인 비교](#timeline-compare) 화면으로 이동 |
| **타임라인 영역** | 그 일자의 자산 이벤트(상태/집계/이벤트/명령) 시간 막대             |

**패널 3 — 태그 및 트렌드 차트**

| 항목          | 설명                                                                |
| ----------- | ----------------------------------------------------------------- |
| **헤더**      | 📈 "태그 및 트렌드 차트 \[전체 태그 : N개]"                                    |
| **태그목록 이동** | 우측 버튼 — [태그 목록](/plantpulse-platform/user/factory.md#tag) 화면으로 이동 |
| **빈 상태**    | "왼쪽 태그 목록에서 표시할 태그를 선택하십시오."                                      |
| **차트**      | 선택한 태그의 시계열 차트                                                    |

**패널 4 — KPI 미니 차트 3종**

| 차트        | 설명                                   |
| --------- | ------------------------------------ |
| (좌측) OEE  | 그 일자의 OEE 추이 — "표시할 데이터가 없습니다." 빈 상태 |
| (가운데) RAM | 신뢰성/정비성 추이                           |
| (우측) EMS  | 에너지 소비 추이                            |

**패널 5 — 설비 상태**

| 영역              | 설명                          |
| --------------- | --------------------------- |
| **헤더**          | 🔋 "설비 상태 \[전체 알람 건수 : N건]" |
| **설비 운전 상태 도넛** | RUN/IDLE/STOP/FAULT 비율      |
| **알람 분포**       | 우선순위별 알람 카운트                |

**패널 6 — 최근 설비 알람 목록**

| 항목           | 설명                                                                     |
| ------------ | ---------------------------------------------------------------------- |
| **헤더**       | 🔔 "최근 설비 알람 목록"                                                       |
| **알람 고급 검색** | 우측 버튼 — [알람 고급 검색](/plantpulse-platform/user/alarm.md#advsearch) 으로 이동 |
| **목록**       | 최근 알람 N건을 시간 역순으로                                                      |

#### 우측 col-lg-4 — 사이드 패널

자산 단위 부가 정보 패널들이 세로로 배치됩니다.

| 패널      | JSP                      | 표시                |
| ------- | ------------------------ | ----------------- |
| **알람**  | `pannel/alarm.jsp`       | 자산 단위 알람 요약       |
| **상태**  | `pannel/context.jsp`     | 자산 컨텍스트(현재 운영 상태) |
| **집계**  | `pannel/aggregation.jsp` | 자산 집계(평균/최대/최소)   |
| **이벤트** | `pannel/event.jsp`       | 자산 이벤트 이력         |
| **명령**  | `pannel/command.jsp`     | 자산에 발행한 명령 이력     |

### 사이트/구역/라인 대시보드 차이

상위 계층 대시보드는 자식 자산을 종합 표시합니다.

| 계층      | 차이점                          |
| ------- | ---------------------------- |
| **사이트** | 모든 라인의 KPI 합계·도넛 차트·하위 자산 목록 |
| **구역**  | 그 구역에 속한 라인·설비의 가동 상태 종합     |
| **라인**  | 라인의 모든 설비를 한 화면에 격자로         |

상세 매뉴얼은 별도 제공하지 않으며, 본 자산 대시보드(설비)와 같은 패턴이라 익숙해지시면 다른 계층도 자연스럽게 사용하실 수 있습니다.

### 활용 패턴

| 분석 흐름              | 화면 흐름                                        |
| ------------------ | -------------------------------------------- |
| **현장 운영자 모니터링 화면** | 설비 대시보드 → 새 창 전체화면으로 띄우기 → 현장 디스플레이          |
| **이상 발생 직후 정밀 분석** | 설비 카드 → 대시보드 → 일자 선택 → 타임라인 + 트렌드 + 알람 종합 분석 |
| **다른 설비와 빠른 비교**   | 설비 대시보드 → 우상단 다른 설비 드롭다운 → 같은 라인 다른 설비       |

***

## 활용 시나리오 <a href="#use-cases" id="use-cases"></a>

| 시나리오             | 사용 방법                                                      |
| ---------------- | ---------------------------------------------------------- |
| **사이트 단위 야간 점검** | 사이트 셀렉터로 야간 운영 사이트 선택 → 검색 → 빨강 점등(연결끊김/심각 알람)인 카드만 빠르게 식별 |
| **특정 라인의 설비 상태** | 사이트 → 구역 → 라인 차례로 좁혀 검색 → 라인 내 모든 설비를 한 화면에                |
| **설비 유형별 모니터링**  | 검색 옵션의 "설비 공통 유형" 에 `MOTOR` 입력 → 모터 계열만 검색                 |
| **알람 폭증 자산 식별**  | 정렬·필터로 빨강 알람 카운트 큰 카드부터 확인                                 |
| **설비 이미지로 식별**   | 카드의 썸네일 이미지로 시각적으로 빠른 매칭                                   |
| **자산 메타 수정**     | 카드 푸터의 ⚙ 버튼으로 자산 트리 화면으로 이동                                |

***

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

**Q. 페이지에 들어왔는데 카드가 비어 있습니다.** A. 페이지 진입 시에는 검색 결과가 비어 있고 좌측 사이드바에서 **검색** 버튼을 눌러야 카드가 표시됩니다. 사이트를 "전체 사이트" 로 둔 채 검색을 눌러도 됩니다.

**Q. 사이트는 선택했는데 구역 셀렉터가 비어 있습니다.** A. 그 사이트에 등록된 구역이 없거나 페이지 진입 시 구역이 미로딩 상태일 수 있습니다. 사이트 셀렉터를 다시 한 번 변경하시면 구역 목록이 다시 채워집니다. 구역이 정말 없다면 [팩토리 관리 > 모델](/plantpulse-platform/user/factory.md) 에서 구역을 등록하세요.

**Q. 카드의 점등 색상이 모두 회색입니다.** A. 해당 설비에 등록된 태그/이벤트/집계가 없거나, 통신이 한 번도 인입되지 않은 상태입니다. [팩토리 관리 > 태그](/plantpulse-platform/user/factory.md) 에서 태그가 등록되어 있는지 먼저 확인하세요.

**Q. 알람 카운트가 모두 `-` 로 표시됩니다.** A. 알람 데이터가 아직 로딩되지 않았습니다. 잠시 기다리거나 우상단 새로고침 버튼을 눌러 보세요. 그래도 표시되지 않으면 [알람](/plantpulse-platform/user/alarm.md) 화면에서 그 설비의 알람 발생 여부를 확인하세요.

**Q. 설비 이미지 자리에 자리표시자만 보입니다.** A. 그 설비에 이미지가 등록되어 있지 않습니다. 자산 트리 화면에서 설비를 선택해 이미지를 업로드할 수 있습니다.

**Q. 카드를 클릭하면 어디로 이동하나요?** A. 이미지 영역을 클릭하면 그 설비의 단일 대시보드 화면이 새 창으로 열립니다. 카드 푸터의 ⚙ 버튼은 자산 트리 편집 화면으로 이동합니다.

**Q. 검색 결과가 너무 많아서 화면이 느립니다.** A. 사이트 → 구역 → 라인 순서로 좁히고, "설비 공통 유형" 검색 옵션도 함께 사용하시면 결과가 줄어듭니다.

**Q. 검색 결과 정렬을 바꿀 수 있나요?** A. 화면은 자산 트리 등록 순서로 표시됩니다. 정렬 변경이 필요하면 자산 트리 화면에서 순서를 조정하세요.

**Q. 여러 설비의 가동 시간을 한 번에 비교하고 싶어요.** A. 상단 **타임라인 분석** 버튼으로 다중 설비 비교 화면을 사용하세요.

***

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

* [팩토리 관리](/plantpulse-platform/user/factory.md) — 사이트·구역·라인·설비 등록과 자산 트리
* [데이터 포인트](/plantpulse-platform/user/data-point.md) — 설비의 태그 데이터 트렌드 조회
* [알람](/plantpulse-platform/user/alarm.md) — 설비 단위 알람 발생 이력
* [일일 통계](/plantpulse-platform/user/statistics.md) — 사이트·구역·라인·설비별 비교 분석
* [상태 코드 정의](/plantpulse-platform/user/status.md) — 5단계 연결 상태와 4단계 건강 상태 색상 매핑
* [대시보드](/plantpulse-platform/user/summary.md) — 설비 연결/건강 히트맵 (한눈에 모든 설비)