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

# ISO 데이터 및 분석 (OEE/RAM/EMS)

## 목차

* [개요](#overview)
* [화면 구성](#layout)
* [상단 — 검색 영역](#top)
* [좌측 — 모델(에셋 트리) 패널](#left-tree)
* [우측 — 분석 콘텐츠 (3 탭)](#right-content)
  * [OEE 탭](#tab-oee)
  * [RAM 탭](#tab-ram)
  * [EMS 탭](#tab-ems)
* [지표 정의](#metrics)
* [활용 시나리오](#use-cases)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)

***

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

ISO 데이터 및 분석 화면은 ISO 22400 기반의 운영 성능 지표 3가지를 한 화면에서 차트와 표로 분석합니다.

| 플러그인    | 한국어      | 약어 의미                                    |
| ------- | -------- | ---------------------------------------- |
| **OEE** | 설비 종합 효율 | Overall Equipment Effectiveness          |
| **RAM** | 신뢰성·정비성  | Reliability·Availability·Maintainability |
| **EMS** | 에너지 관리   | Energy Management System                 |

세 플러그인 모두 동일한 좌측 에셋 트리·검색 영역을 공유하며, 우측 콘텐츠만 탭에 따라 다른 차트와 표를 보여 줍니다.

**경로**: 왼쪽 메뉴 > **ISO > ISO 데이터** (내부 URL `/asset/plugin/index`) 또는 **ISO > ISO 분석** (내부 URL `/analysis/index`)

***

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

```
┌──────────────────────────────────────────────────────────────────────┐
│ 🌎 ISO 데이터  [기간 ▭▭▭] [플러그인 ▼] [건수 ▼] [조회][전체출력][↻]│ ← ① 상단
├──────────┬───────────────────────────────────────────────────────────┤
│ 🗂 모델   │   ◯ 추이 차트 (OEE/RAM/EMS 중 선택된 탭)                  │
│ ─────── │  ┌──────────────────────────────────────────────────────┐ │
│ 사이트▼ │  │   라인/영역 차트 토글, 300px 높이                     │ │ ← ②/③
│ ─────── │  └──────────────────────────────────────────────────────┘ │
│ 🔍 검색  │                                                            │
│ ─────── │   ◯ 히스토리 테이블 (탭별 컬럼 다름)                       │
│ 에셋    │  ┌──────────────────────────────────────────────────────┐ │
│ 트리    │  │  시간 / 워크오더 / 핵심 지표 컬럼들                     │ │
│ ─────── │  └──────────────────────────────────────────────────────┘ │
│ 오브젝트│                                                            │
│  ID :   │                                                            │
└──────────┴───────────────────────────────────────────────────────────┘
```

| 영역   | 위치        | 표시                            |
| ---- | --------- | ----------------------------- |
| ① 상단 | 전체 폭      | 검색 영역 (기간·플러그인·건수·도구)         |
| ② 좌측 | col-lg-2  | 사이트 셀렉터 + 에셋 트리               |
| ③ 우측 | col-lg-10 | 추이 차트 + 히스토리 테이블 (선택된 플러그인 탭) |

***

## 상단 — 검색 영역 <a href="#top" id="top"></a>

```
🌎 ISO 데이터          [기간] [플러그인 ▼] [건수 ▼] [조회] [전체 출력] [↻]
```

| 컨트롤                      | 폭       | 설명                                                             |
| ------------------------ | ------- | -------------------------------------------------------------- |
| **기간** (`search_time`)   | 280px   | 시작\~종료 일시 (가운데 정렬, 굵은 글씨). 날짜 범위 선택기                           |
| **플러그인** (`plugin_type`) | 200px   | OEE/RAM/EMS 중 선택 — 변경 시(`onPluginTypeChange()`) 우측 콘텐츠 탭 자동 전환 |
| **건수** (`filter_limit`)  | 150px   | 최근 1,000(기본)/5,000/10,000건                                     |
| **조회**                   | 빨강 + 🔍 | `search()` — 좌측 트리에서 선택된 자산의 데이터를 위 조건으로 조회                    |
| **전체 출력**                | 빨강 + 📄 | `downloadCSV()` — 검색 조건의 전체 결과 CSV 다운로드                        |
| **새로고침**                 | 빨강 + ↻  | `refresh()` — 화면 새로고침                                          |

### 플러그인 셀렉터 옵션

| 값     | 라벨            |
| ----- | ------------- |
| `OEE` | OEE - 설비종합효율  |
| `RAM` | RAM - 신뢰성/정비성 |
| `EMS` | EMS - 에너지 관리  |

***

## 좌측 — 모델(에셋 트리) 패널 <a href="#left-tree" id="left-tree"></a>

[데이터 포인트](/plantpulse-platform/user/data-point.md#common-left) 와 동일한 구조의 트리 패널입니다.

| 영역                          | 표시                                                                                     |
| --------------------------- | -------------------------------------------------------------------------------------- |
| **헤더 도구 3개**                | 설명 표시 토글(`btn_show_description`) / 검색 토글(`searchItem()`) / 선택 복사(`copySelectedTags()`) |
| **사이트 셀렉터** (`site_select`) | 사이트명 \[설명] 옵션. 변경 시 트리 다시 로드                                                           |
| **에셋 트리** (`assetTreeDiv`)  | 사이트 → 구역 → 라인 → 설비 → 태그 계층                                                             |
| **검색 입력**                   | 토글식 (`assetSearchInput`) — placeholder: "검색..."                                        |
| **푸터**                      | 호버 자산의 ID 미리보기(`tag_hover`)                                                            |

> 자산 트리에서 **설비 단위** 노드를 선택하셔야 우측 차트와 표에 데이터가 표시됩니다. 설비를 미선택하시면 차트 영역에 "에셋 트리에서 설비를 선택하고 조회하여 주십시오." 안내가 표시됩니다.

***

## 우측 — 분석 콘텐츠 (3 탭) <a href="#right-content" id="right-content"></a>

플러그인 셀렉터의 값에 따라 우측 콘텐츠 영역이 자동 전환됩니다.

| 셀렉터 값      | 표시되는 div  |
| ---------- | --------- |
| `OEE` (기본) | `tab_oee` |
| `RAM`      | `tab_ram` |
| `EMS`      | `tab_ems` |

각 탭은 **추이 차트(상단)** + **히스토리 테이블(하단)** 두 패널로 구성됩니다.

### OEE 탭 <a href="#tab-oee" id="tab-oee"></a>

#### 추이 차트 — `oee_trend_chart` (300px)

| 항목           | 설명                                                   |
| ------------ | ---------------------------------------------------- |
| **헤더**       | 📈 "OEE 추이" + 결과 요약(`result_txt`)                    |
| **차트 유형 토글** | 라인(기본) ↔ 영역 (`changeChartType('oee','line'/'area')`) |
| **시리즈**      | OEE / 가용성 / 성능 / 품질 (4 시리즈)                          |
| **빈 상태**     | "에셋 트리에서 설비를 선택하고 조회하여 주십시오."                        |

#### 히스토리 테이블 — `oee_data_table` (12 컬럼)

| 컬럼        | 폭     | 설명                        |
| --------- | ----- | ------------------------- |
| **시간**    | 120px | 측정 시각                     |
| **워크오더**  | 150px | 동시간대 진행 중인 작업지시 ID        |
| **설비 상태** | 70px  | RUN/STOP/IDLE 등           |
| **전체**    | 60px  | 총 생산량                     |
| **정상**    | 60px  | 양품 수                      |
| **불량**    | 60px  | 불량품 수                     |
| **가동 시간** | 80px  | 단위 시간 (분/시간)              |
| **다운 시간** | 80px  | 비가동 시간                    |
| **OEE**   | 55px  | 종합 효율 (%) — 가용성 × 성능 × 품질 |
| **가용성**   | 55px  | Availability (%)          |
| **성능**    | 55px  | Performance (%)           |
| **품질**    | 55px  | Quality (%)               |

### RAM 탭 <a href="#tab-ram" id="tab-ram"></a>

#### 추이 차트 — `ram_chart` (300px)

| 항목           | 설명                               |
| ------------ | -------------------------------- |
| **헤더**       | 📈 "RAM 추이"                      |
| **차트 유형 토글** | 라인(기본) ↔ 영역                      |
| **시리즈**      | MTBF · MTTR · MA · R · M (5 시리즈) |

#### 히스토리 테이블 — `ram_data_table` (9 컬럼)

| 컬럼          | 폭     | 설명                                         |
| ----------- | ----- | ------------------------------------------ |
| **시간**      | 120px | 측정 시각                                      |
| **워크오더**    | 150px | 작업지시 ID                                    |
| **MTBF(h)** | 70px  | Mean Time Between Failures (시간) — 평균 고장 간격 |
| **MTTR(h)** | 70px  | Mean Time To Repair (시간) — 평균 수리 시간        |
| **MA(%)**   | 60px  | Maintainability Availability — 정비성 가용도     |
| **고장률**     | 70px  | Failure Rate (단위 시간당 고장 확률)                |
| **R(1h)**   | 60px  | 1시간 신뢰도 (Reliability)                      |
| **M(1h)**   | 60px  | 1시간 정비성 (Maintainability)                  |
| **고장수**     | 60px  | 누적 고장 발생 수                                 |

### EMS 탭 <a href="#tab-ems" id="tab-ems"></a>

#### 추이 차트 — `ems_chart` (300px)

| 항목           | 설명                              |
| ------------ | ------------------------------- |
| **헤더**       | 📈 "EMS 추이"                     |
| **차트 유형 토글** | 라인(기본) ↔ 영역                     |
| **시리즈**      | 에너지 소비 / 효율 / CO2 배출 / 피크/평균 전력 |

#### 히스토리 테이블 — `ems_data_table` (10 컬럼)

| 컬럼             | 폭     | 설명                           |
| -------------- | ----- | ---------------------------- |
| **시간**         | 120px | 측정 시각                        |
| **워크오더**       | 150px | 작업지시 ID                      |
| **에너지(kWh)**   | 80px  | 그 구간의 총 전력 사용량               |
| **단위당(kWh)**   | 80px  | 생산 단위 1개당 전력 사용 (생산성·효율 비교용) |
| **효율(%)**      | 60px  | 에너지 효율                       |
| **CO2(kg)**    | 70px  | 그 구간의 총 CO2 배출량              |
| **Scope1(kg)** | 75px  | 직접 배출 (사업장 내 연료 연소 등)        |
| **Scope2(kg)** | 75px  | 간접 배출 (구매한 전력 등)             |
| **피크(kW)**     | 70px  | 그 구간의 최대 순간 전력               |
| **평균(kW)**     | 70px  | 그 구간의 평균 전력                  |

***

## 지표 정의 <a href="#metrics" id="metrics"></a>

### OEE 의 3가지 구성

| 지표                     | 계산               | 의미                            |
| ---------------------- | ---------------- | ----------------------------- |
| **가용성 (Availability)** | 가동 시간 ÷ 계획 운전 시간 | 설비가 가동되어야 할 시간 대비 실제 가동 시간 비율 |
| **성능 (Performance)**   | 실제 생산량 ÷ 이상적 생산량 | 가동 시간 동안 이상치 대비 실제 처리 속도      |
| **품질 (Quality)**       | 양품 수 ÷ 총 생산량     | 생산물 중 정상품의 비율                 |
| **OEE**                | 가용성 × 성능 × 품질    | 종합 효율 (3 지표 모두 100% 일 때 100%) |

### RAM 의 핵심 지표

| 지표       | 계산                   | 단위    | 의미                             |
| -------- | -------------------- | ----- | ------------------------------ |
| **MTBF** | 총 가동시간 ÷ 고장수         | 시간(h) | 평균 무고장 시간 — 클수록 신뢰성 ↑          |
| **MTTR** | 총 수리시간 ÷ 고장수         | 시간(h) | 평균 수리 시간 — 작을수록 정비성 ↑          |
| **MA**   | MTBF ÷ (MTBF + MTTR) | %     | 가용도                            |
| **R(t)** | exp(-λt)             | 비율    | 시간 t 동안 무고장으로 운영될 확률 (λ = 고장률) |
| **M(t)** | 1 − exp(-μt)         | 비율    | 시간 t 안에 수리가 끝날 확률 (μ = 수리율)    |

### EMS 의 배출 분류

| 분류          | 의미                                           |
| ----------- | -------------------------------------------- |
| **Scope 1** | 사업장에서 직접 발생 (자체 보유 보일러·발전기·차량 연료 연소)         |
| **Scope 2** | 외부에서 구매한 전기·열·증기로 인한 간접 배출                   |
| **Scope 3** | (현재 화면 미표시) 공급망·운송·폐기 등 가치사슬 전체 — 별도 보고서로 산정 |

***

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

| 시나리오                  | 화면          | 절차                                                                                                                                  |
| --------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **라인 OEE 일주일 추이**     | OEE 탭       | 기간 7일·플러그인 OEE → 라인 자산 선택 → 조회 → 추이 차트 4시리즈 비교                                                                                      |
| **다운타임 원인 분석**        | OEE 히스토리    | OEE 가 낮은 시간대 행 클릭 → 워크오더 ID 확인 → [작업지시](/plantpulse-platform/user/production.md) 와 교차 분석                                            |
| **정비 주기 결정 (MTBF)**   | RAM 탭       | RAM 히스토리에서 자산별 MTBF 평균 확인 → 정비 주기를 MTBF 의 1/3 수준으로 설정                                                                               |
| **신규 설비 vs 노후 설비 비교** | RAM         | 두 자산의 MTBF·MTTR·고장수를 한 기간 비교                                                                                                        |
| **에너지 절감 KPI**        | EMS 탭       | 단위당(kWh) 트렌드 분석 → 작업지시별로 비교 → 효율 낮은 구간 식별                                                                                           |
| **CO2 보고용 데이터 추출**    | EMS         | 한 달 기간 + Scope1/Scope2 컬럼 → 전체 출력 CSV 다운로드                                                                                          |
| **알람 임계 결정**          | OEE/RAM/EMS | 안정 운영 기간의 평균 ± σ 를 [알람](/plantpulse-platform/user/alarm.md) 임계값 또는 [예측 분석](/plantpulse-platform/user/forecast.md) 의 LIMIT\_MAX 에 적용 |

***

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

**Q. 차트가 비어 있고 안내 문구만 나옵니다.** A. 좌측 자산 트리에서 **설비 단위** 노드를 선택하셔야 합니다. 라인이나 사이트 등 상위 계층 선택만으로는 데이터가 표시되지 않습니다. 설비 선택 후 **조회** 를 누르세요.

**Q. 플러그인 셀렉터를 바꿨는데 우측 영역이 그대로입니다.** A. 셀렉터 변경 시 자동으로 탭이 전환됩니다. 만약 데이터가 보이지 않는다면 새 플러그인에 대해 **조회** 를 한 번 더 누르세요.

**Q. OEE 가 100% 가 넘는 비정상 값이 나옵니다.** A. 일반적으로 OEE 는 가용성·성능·품질의 곱이라 100% 를 넘지 않습니다. 100% 초과는 입력 데이터(생산량·이상치 기준값)가 잘못 설정된 경우입니다. [팩토리 관리](/plantpulse-platform/user/factory.md) 의 자산 메타에서 이상치 처리 속도(ideal cycle time)를 확인하세요.

**Q. RAM 의 R(1h) 가 0.99 인데 좋은 값인가요?** A. 매우 좋은 값입니다. R(1h)=0.99 는 1시간 동안 무고장으로 운영될 확률이 99% 라는 뜻입니다. R 이 0.95 미만으로 떨어지면 정비 주기를 점검할 시점입니다.

**Q. EMS 의 Scope1 이 0 인데 정상인가요?** A. 사업장에 자체 연료 연소(보일러·자가발전기·차량)가 없으면 Scope1 은 0 입니다. 외부 전기만 사용하는 설비라면 Scope2 만 있는 것이 정상입니다.

**Q. 단위당 kWh 가 갑자기 커졌습니다.** A. 그 구간의 생산량이 0에 가까웠는데 전력은 소비되고 있던 경우 단위당이 매우 큰 값이 됩니다. **가동 시간**과 **다운 시간** 을 함께 보시면 비가동 시간에 전력이 소비된 비효율을 확인할 수 있습니다.

**Q. 워크오더 컬럼이 비어 있습니다.** A. 그 시간에 진행 중인 작업지시가 없거나 자산-작업지시 매핑이 안 된 경우입니다. [작업지시](/plantpulse-platform/user/production.md) 화면에서 해당 자산의 작업지시 등록을 확인하세요.

**Q. 차트의 라인을 영역으로 바꾸면 무엇이 달라지나요?** A. 영역 차트는 라인 아래를 색상으로 채워 누적·총량의 시각적 비교가 쉽고, 라인 차트는 변화의 정확한 추세 비교가 쉽습니다.

**Q. 결과가 너무 많아 차트가 느립니다.** A. 검색 영역의 **건수** 셀렉터를 1,000건으로 줄이시거나, 기간을 짧게(1주일 이내) 잡으세요.

**Q. 다운로드한 CSV 가 너무 큽니다.** A. CSV 는 검색 조건 전체를 출력합니다. 기간을 줄이거나 자산을 한 개만 선택해 다운로드하시면 작아집니다.

***

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

* [대시보드](/plantpulse-platform/user/summary.md) — KPI 카드의 종합 OEE 표시
* [일일 통계](/plantpulse-platform/user/statistics.md) — 사이트·라인·설비별 비교 분석
* [설비](/plantpulse-platform/user/equipment.md) — 설비 카드의 가동 상태 + 알람
* [작업지시](/plantpulse-platform/user/production.md) — 워크오더 컬럼과 교차 분석
* [예측 분석](/plantpulse-platform/user/forecast.md) — 안정 구간 학습 → 임계값 결정
* [데이터 포인트](/plantpulse-platform/user/data-point.md) — 원본 태그 데이터 트렌드
* [상태 코드 정의](/plantpulse-platform/user/status.md) — 설비 운전 상태(OEE) 코드 매핑