대시보드 패널
개요
이 화면은 무엇인가요?
대시보드에 배치할 **개별 패널(위젯)**을 구성하는 화면입니다. 실시간 차트, 게이지, 설비 상태 맵, 알람 목록, 트윈 뷰어 등 다양한 패널 유형을 선택하고, 표시할 태그·설비·시간 범위·임계선을 설정합니다.
누가 사용하나요?
- IoT 엔지니어: 패널 배치, 태그 바인딩, 임계선 설정
언제 사용하나요?
- 대시보드에 새로운 모니터링 패널을 추가할 때
- 패널에 표시할 태그나 설비를 변경할 때
- 패널의 위치, 크기, 시간 범위를 조정할 때
주요 기능
- 5가지 패널 유형: 실시간 차트, 게이지, 설비 상태 맵, 알람 목록, 트윈 뷰어
- 태그 바인딩: 패널에 표시할 데이터 태그 지정
- 임계선 설정: 경고/위험 기준선 표시
- 위치/크기 조정: 드래그앤드롭으로 패널 배치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 대시보드 | 패널을 배치할 대시보드 | ✅ | 대시보드 목록에서 선택 |
| 패널유형 | 패널의 시각화 유형 | ✅ | realtime_chart / gauge / status_map / alarm_list / twin_viewer |
| 제목 | 패널에 표시되는 제목 | ✅ | 로봇 모터 온도 추이 |
| 패널코드 | 패널 식별 코드 | ✅ | PNL-TEMP-ROBOT |
| 바인딩태그 | 표시할 데이터 태그 목록 | 태그 ID 배열 | |
| 설비자산 | 연결할 설비 | 설비 선택 | |
| 새로고침간격(초) | 패널별 데이터 갱신 주기 | 3 | |
| 시간범위 | 차트에 표시할 시간 범위 | realtime / 1h / 6h / 24h 등 | |
| 임계선 | 경고/위험 기준값 표시 | JSON 형태 | |
| X좌표 / Y좌표 | 대시보드 내 패널 위치 | 0, 0 | |
| 너비 / 높이 | 패널의 크기 | 6, 4 | |
| 표시여부 | 패널 표시/숨김 | 기본값: 표시 |
자주 묻는 질문 (FAQ)
패널 유형별 용도는?
| 패널 유형 | 용도 | 적합한 데이터 |
|---|---|---|
| realtime_chart | 시계열 데이터 추이 | 온도, 압력, 전류 등 연속 값 |
| gauge | 현재 값을 게이지로 표시 | 가동률, 에너지 효율 등 비율 |
| status_map | 설비 상태를 색상 맵으로 표시 | 공장 레이아웃 기반 가동 상태 |
| alarm_list | 활성 알람 목록 | 미처리 알람, 경고 |
| twin_viewer | 3D 트윈 모델 뷰어 | 설비 3D 시각화 |
참고: 데이터 구조
대시보드패널 테이블 (dashboard_panels)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
panel_code | 패널코드 | VARCHAR *필수 *고유 | - |
dashboard_id | 대시보드ID | UUID (FK) *필수 | dashboards 참조 |
panel_type | 패널유형 | ENUM *필수 | realtime_chart/gauge/status_map/alarm_list/twin_viewer |
title | 제목 | VARCHAR *필수 | - |
tag_ids | 바인딩태그 | JSONB | 표시할 태그 ID 배열 |
asset_id | 설비자산ID | UUID (FK) | equipment_assets 참조 |
time_range | 시간범위 | ENUM | realtime/1h/6h/12h/24h/7d/30d/custom |
thresholds | 임계선 | JSONB | 경고/위험 기준값 |
position_x | X좌표 | INT | - |
position_y | Y좌표 | INT | - |
width | 너비 | INT | - |
height | 높이 | INT | - |