SYSTEM BLUEPRINT

부분방전 IoT 관제 플랫폼
사용자별 화면 설계 및 시나리오

MPDM 장비 데이터가 모바일 앱과 Grafana 관제 화면으로 연결되는 핵심 운영 화면 설계입니다.

현장 및 설비 담당자 시나리오

위험 장비 확인 흐름

앱에서 위험 장비를 빠르게 찾고 상세 상태와 알람 내역을 확인하는 사용자 여정입니다.

1. 로그인

권한 기반 접속
담당 장비 목록 로드

2. 장비 목록

SOH와 온습도 요약
위험도 배지 확인

3. 상세 그래프

기간별 추이 확인
이상 패턴 파악

4. 알람 확인

푸시 알림 수신
조치 필요 장비 식별

5. 조치 기록

확인 상태 저장
운영 이력 반영

현장 및 설비 담당자 | 화면 01

모바일 장비 목록

app.partial-iot/devices

전체 장비 상태

정상18대
경고3대
위험1대
통신 끊김2대

[화면 개요 및 목적]

담당자가 앱을 열자마자 전체 장비의 위험도를 확인하는 첫 화면입니다.

[핵심 기능 로직]

API는 최신 상태 테이블을 조회하고 위험, 경고, 정상, 통신 끊김 상태를 즉시 계산합니다.

  • Flutter list view
  • Latest status API
현장 및 설비 담당자 | 화면 02

장비 상세 그래프

app.partial-iot/devices/MPDM-042

MPDM-042 상세

SOH61점
온도72도
습도48퍼센트
최근 알람절연 상태 경고

[화면 개요 및 목적]

SOH, 온도, 습도 추이를 기간별로 확인하고 위험 원인을 파악합니다.

[핵심 기능 로직]

TimescaleDB 이력 테이블에서 기간 조건으로 데이터를 집계해 그래프에 표시합니다.

  • TimescaleDB query
  • Chart rendering
현장 및 설비 담당자 | 화면 03

알람 내역 화면

알람 내역
MPDM-042 SOH 경고
MPDM-017 온도 상승
MPDM-011 정상 복귀

[화면 개요 및 목적]

최근 위험 알람과 정상 복귀 이벤트를 한 화면에서 확인합니다.

[핵심 기능 로직]

중복 억제 정책을 통과한 알람만 노출해 현장 피로도를 줄입니다.

  • FCM push
  • Alarm history API
시스템 관리자 시나리오

장비와 알람 정책 관리 흐름

장비 등록, 임계치, 권한, 알람 정책을 관리하는 운영 준비 흐름입니다.

1. 장비 등록

장비 ID 입력
Topic 매핑

2. 사업장 연결

설비 위치 지정
담당자 연결

3. 임계치 설정

SOH 기준 설정
온습도 기준 설정

4. 알람 정책

중복 억제
정상 복귀 기준

5. 권한 관리

관리자 권한
담당자 알림 설정

시스템 관리자 | 화면 01

장비 등록 화면

admin.partial-iot/devices/new

장비 등록

장비 IDMPDM-042
사업장전주 1공장
Topicmpdm/042/status
상태활성

[화면 개요 및 목적]

MPDM 장비를 사업장과 Topic에 연결하는 기본 설정 화면입니다.

[핵심 기능 로직]

장비 ID 중복 검증 후 Topic, 위치, 담당자 정보를 설비 마스터에 저장합니다.

  • Device master schema
  • Topic validation
시스템 관리자 | 화면 02

임계치 및 알람 정책

admin.partial-iot/rules

임계치 설정

SOH 경고70점 미만
SOH 위험50점 미만
온도 경고75도 이상
중복 억제30분

[화면 개요 및 목적]

SOH와 온습도 기준, 중복 알람 억제 시간을 설정합니다.

[핵심 기능 로직]

수신 데이터가 저장될 때 규칙 엔진이 임계치를 평가하고 알람 이벤트를 생성합니다.

  • Rule engine
  • Alarm table
시스템 관리자 | 화면 03

사용자 권한 관리

admin.partial-iot/users

권한 관리

관리자2명
현장 담당자8명
알림 수신사용
감사 로그저장

[화면 개요 및 목적]

관리자와 현장 담당자의 접근 권한과 알림 수신 범위를 관리합니다.

[핵심 기능 로직]

JWT 권한 정보와 사용자별 담당 장비 매핑을 기준으로 API 응답 범위를 제한합니다.

  • Data Aggregation & Visualization
  • JWT role based access
운영 관리자 시나리오

Grafana 관제 및 로그 추적 흐름

전체 장비 상태와 수신 로그를 Grafana에서 확인하고 CSV로 내려받는 운영 흐름입니다.

1. 현황판 접속

전체 장비 통계
SOH 분포 확인

2. 기간 필터

사업장과 장비 선택
기간별 이력 조회

3. 로그 확인

수신 성공률
실패 원인 확인

4. CSV 추출

상태 이력 다운로드
보고 자료 확보

5. 장애 대응

재연결 이력 확인
원인 추적

운영 관리자 | 화면 01

Grafana 통합 관제

grafana.partial-iot/dashboard

Grafana 종합 현황

평균 SOH86점
수신 성공률99.2퍼센트
금일 알람7건
장애 로그1건

[화면 개요 및 목적]

전체 장비의 SOH, 알람, 수신 성공률을 한눈에 보는 운영 현황판입니다.

[핵심 기능 로직]

PostgreSQL 데이터 소스를 직접 연결하고 패널별 집계 쿼리를 구성합니다.

  • Grafana dashboard
  • PostgreSQL data source
운영 관리자 | 화면 02

기간별 수신 로그

grafana.partial-iot/logs

수신 로그 조회

성공12,482건
파싱 실패4건
재연결2회
CSV다운로드 가능

[화면 개요 및 목적]

장비별 수신 성공, 실패, 재연결 이력을 기간 조건으로 조회합니다.

[핵심 기능 로직]

수신 실패, 파싱 실패, DB 저장 실패 로그를 분리해 장애 원인을 빠르게 찾습니다.

  • Structured logging
  • CSV export
운영 관리자 | 화면 03

오류 원인 추적

grafana.partial-iot/failure

오류 추적

원인페이로드 누락
장비MPDM-009
처리재수신 대기
담당운영 관리자

[화면 개요 및 목적]

문제가 발생한 장비와 페이로드 오류 원인을 확인하고 조치 상태를 추적합니다.

[핵심 기능 로직]

장비 ID, 시간, 오류 유형을 기준으로 실패 로그를 필터링합니다.

  • Failure log table
  • Issue Tracking & Status Management