본문으로 건너뛰기

설비

목차​

설비 화면


개요​

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

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

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

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


화면 구성​

┌──────────────────────────────────────────────────────────────────┐
│ 설비 총 N개 설비 — 사이트별 모니터링 [타임라인 분석] [↻] │ ← ① 상단
├──────────┬───────────────────────────────────────────────────────┤
│ 🔎 검색 │ ⚙ [검색된 설비: N] 설비 목록 │
│ 조건 입력 │ 필터 조건에 맞는 설비 │
│ 후 검색 │ ─────────────────────────────────────────────────────│
│ [사이트▼] │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ [구역 ▼] │ │ 카드 │ │ 카드 │ │ 카드 │ │ 카드 │ │ ← ③ 카드 그리드
│ [라인 ▼] │ │ ... │ │ ... │ │ ... │ │ ... │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │
│ [설비분류▼]│ │
│ [설명] │ │
│ [↺][검색] │ │
└──────────┴───────────────────────────────────────────────────────┘
영역위치표시
① 상단전체 폭페이지 제목·총 설비 수·타임라인 분석/새로고침 버튼
② 좌측 사이드바col-lg-2"검색" 필터 패널 — 사이트/구역/라인 + 검색 옵션, 하단에 초기화·검색 버튼
③ 우측col-lg-10설비 카드 목록 (검색된 설비 수 + 카드 그리드)

상단 — 페이지 제목·도구​

항목형태표시
페이지 제목좌측"설비" + 부제 총 N개 설비 — 사이트별 모니터링
타임라인 분석우측 주 버튼"타임라인 분석" — 다중 설비 타임라인 비교 화면 호출(openTimeline())
새로고침우측 보조 버튼 + ↻좌측 필터 그대로 유지하고 카드 목록만 다시 불러오기

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


좌측 사이드바 — 검색·필터링​

패널 제목은 검색, 부제는 "조건 입력 후 검색" 입니다. 폼은 2개 그룹으로 묶여 있고, 버튼 2개는 패널 하단(푸터)에 있습니다.

1) 사이트 / 구역 / 라인​

세 셀렉터가 하나의 그룹으로 묶여 있습니다.

셀렉터ID옵션
사이트site_id등록된 사이트 목록 (사이트명 [설명]) — 늘 하나가 골라져 있습니다
구역 (Area)area_id"모든 구역" + 사이트의 구역 목록 (자산명 [설명])
라인 (Line)line_id"모든 라인" + 구역의 라인 목록 (자산명 [설명])

범위 선택에 «모든 사이트» 는 없습니다. 비워 두는 «모든 구역» · «모든 라인» 은 고른 사이트 안의 전체입니다. 화면이 여는 사이트 순서는 주소(URL)의 사이트 → 프로필의 기준 사이트 → 첫 사이트입니다. 마지막에 고른 범위는 기억하지 않습니다.

사이트를 변경하면(changedSite()) 그 사이트에 속한 구역(area_list)과 라인(line_list)이 자동으로 다시 채워집니다. 구역을 변경하면(changedArea()) 그 구역에 속한 라인만 라인 셀렉터에 채워지고, 라인을 변경하면(changedLine()) 그 라인 자산이 즉시 검색 조건에 반영됩니다.

2) 검색 옵션​

입력ID형태설명
설비 분류asset_class_code셀렉터 — "전체 유형" + 등록된 설비 분류 목록설비에 지정된 설비 분류로 좁힘
설명description텍스트 입력 — placeholder "설명 키워드"설비 설명 텍스트 키워드
설비 분류는 골라야 합니다

설비 분류는 직접 입력하는 칸이 아니라 드롭다운입니다. 목록은 기준정보 의 설비 분류 탭에서 옵니다.

3) 패널 하단 버튼​

버튼동작
↺ 초기화resetFilter() — 위 필터·옵션을 모두 비웁니다
검색search() — 위 필터·옵션을 모두 적용해 카드 목록을 갱신

우측 — 설비 카드 목록​

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

⚙ 검색된 설비 없음

왼쪽 필터에서 사이트·구역·라인 또는 검색 옵션을 조정한 후 검색 버튼을 클릭하여 주십시오.

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

┌───────────── 우측 영역 헤더 ─────────────┐
│ ⚙ [검색된 설비: N] 설비 목록 │
│ 필터 조건에 맞는 설비 │
└────────────────────────────────────────────┘
헤더 항목표시
헤더 라벨[검색된 설비: N] 설비 목록 — N 은 검색된 설비 수 (search_equipment_count). 건수가 제목 앞에 옵니다
부제"필터 조건에 맞는 설비" — 고정 문구입니다 (검색 조건 요약이 아닙니다)

설비 카드 구성​

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

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

카드 상단 — 이름·설명​

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

상태 점등 5종​

카드 상태 영역(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) 룰이 등록되었는지

앞의 두 개와 뒤의 세 개는 색이 도는 방식이 다릅니다.

점등색 단계
연결상태·건강상태진단 결과에 따라 여러 단계 (회색 = 미상, 녹색 = 정상, 주황 = 주의, 빨강 = 이상)
태그·이벤트·집계 등록 상태녹색 아니면 회색 둘뿐입니다 — 등록됐으면 녹색, 아니면 회색

뒤의 세 개가 회색이라고 고장난 것이 아닙니다. 그 설비에 태그·이벤트 룰·집계 룰이 아직 등록되지 않았다는 뜻일 뿐입니다.

색상 의미는 상태 코드 정의 참고.

오늘 알람 카운트 3종​

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

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

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

설비 이미지·생산 상태·푸터​

설비 이미지 (eq-card-thumb)​

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

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

ID표시
${asset_id}_status_active현재 활성 상태(가동/정지/대기/유휴/이상) 뱃지가 색상으로 표시
항목표시
🏷 + 태그 수${asset_id}_tag_count — 이 설비에 등록된 태그 수
⚙ (톱니)클릭 시 자산 트리 화면(/asset/tree/index?sel=${asset_id}) — 자산 메타 수정

타임라인 분석​

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


설비 메뉴 하위 화면 (목록 외 2종)​

좌측 메뉴 Equipment 섹션에는 화면이 3개 있습니다.

메뉴내부 URL용도
설비 목록 (위에서 다룸)/equipment/index설비 카드 그리드 모니터링
데이터 조회/asset/data/index설비별 도메인 데이터(스냅샷·알람·이벤트·상태·집계·명령) 조회
타임라인 비교/timeline/index다중 설비의 시간 축 비교

ISO 데이터(/asset/plugin/index) 는 Equipment 가 아니라 좌측 메뉴의 별도 ISO 섹션에 있습니다 — 같은 섹션의 ISO 분석(/analysis/index) 과 함께입니다. 내용은 ISO 데이터 및 분석 을 보세요.


데이터 조회 화면 (/asset/data/index)​

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

상단 검색 영역​

📋 데이터 조회 [기간] [데이터 유형 ▼] [시간 단위 ▼] [건수 ▼] [조회][전체 출력][↻]
컨트롤폭설명
기간 (search_time)280px시작~종료 (가운데, 굵은 글씨). hidden search_date_from/search_date_to
데이터 유형 (data_type)120px6 옵션 — 스냅샷·알람·이벤트·상태·집계·명령
시간 단위 (time_unit)110px초/분/시/일 단위 그룹화
건수 (limit)140px최근 100(기본)/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측정 시각
에셋 ID150px자산 식별자
데이터 맵250px태그-값 페어의 JSON
타임스탬프 맵250px각 태그의 인입 시각

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


타임라인 비교 화면 (/timeline/index)​

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

타임라인 비교 화면 — 번호는 읽는 순서

번호자리하는 일
①좌측 맨 위사이트 선택
②좌측 본문태그 트리 — 체크박스로 여러 설비를 함께 고릅니다
③상단기간 — 시작 ~ 종료
④그 옆타임라인 유형 · 알람 표시 · 건수
⑤우측 끝조회 · 전체 출력(CSV) · 새로고침
⑥타임라인 머리표시 폭 프리셋 — 10m · 30m · 1h · 6h · 12h · All
⑦본문타임라인 — 시간 축 위에 활동이 막대로 놓입니다
⑧우측 아래확대 · 축소 · 좌우 이동
설비를 고르지 않으면 타임라인이 비어 있습니다

위 그림이 그 상태입니다. 좌측 트리에서 비교할 설비를 체크하고 조회를 누르세요.

상단 검색 영역​

🔁 타임라인 비교 [기간] [타임라인 유형 ▼] [알람 표시 ▼] [건수 ▼] [조회][전체 출력][필터][↻]
컨트롤폭설명
기간 (search_time)280px시작~종료
타임라인 유형 (timeline_type)140px4 옵션 — 상태(CONTEXT) / 집계(AGGREGATION) / 이벤트(EVENT) / 명령(COMMAND)
알람 표시 (show_alarm)140px알람 표시(Y) / 표시안함(N, 기본)
건수 (limit)140px100/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})​

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

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

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

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

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

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

패널 1 — 에셋 정보 (파란 보더 3px)​
영역표시
헤더📺 설비명 + (등록일·수정일)
상태 점등자산 상태(asset_status) + 연결 상태(connection_status) — 색상으로
이미지자산 이미지 또는 SVG 도면 (640×320)
OEE 미니 표워크오더·제품·시프트 등 그 일자의 운영 메타가 둥근 표 형태로 표시
패널 2 — 에셋 타임라인 및 데이터​
항목설명
헤더📊 "에셋 타임라인 및 데이터" + 결과 요약(result_txt)
타임라인 이동우측 버튼 — 타임라인 비교 화면으로 이동
타임라인 영역그 일자의 자산 이벤트(상태/집계/이벤트/명령) 시간 막대
패널 3 — 태그 및 트렌드 차트​
항목설명
헤더📈 "태그 및 트렌드 차트 [전체 태그 : N개]"
태그목록 이동우측 버튼 — 태그 목록 화면으로 이동
빈 상태"왼쪽 태그 목록에서 표시할 태그를 선택하십시오."
차트선택한 태그의 시계열 차트
패널 4 — KPI 미니 차트 3종​
차트설명
(좌측) OEE그 일자의 OEE 추이 — "표시할 데이터가 없습니다." 빈 상태
(가운데) RAM신뢰성/정비성 추이
(우측) EMS에너지 소비 추이
패널 5 — 설비 상태​
영역설명
헤더🔋 "설비 상태 [전체 알람 건수 : N건]"
설비 운전 상태 도넛RUN/IDLE/STOP/FAULT 비율
알람 분포우선순위별 알람 카운트
패널 6 — 최근 설비 알람 목록​
항목설명
헤더🔔 "최근 설비 알람 목록"
알람 검색우측 버튼 — 알람 검색 으로 이동
목록최근 알람 N건을 시간 역순으로

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

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

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

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

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

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

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

활용 패턴​

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

활용 시나리오​

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

자주 묻는 질문​

Q. 페이지에 들어왔는데 카드가 비어 있습니다. A. 페이지 진입 시에는 검색 결과가 비어 있고 좌측 사이드바에서 검색 버튼을 눌러야 카드가 표시됩니다. 구역·라인을 "모든 구역" · "모든 라인" 으로 둔 채 검색을 누르면 고른 사이트의 설비가 전부 나옵니다.

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

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

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

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

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

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

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

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


관련 화면​