SYSTEM BLUEPRINT

산단 360 로드뷰
이상징후 관리 MVP 화면 설계

관제 운영자, 데이터 관리자, 시스템 관리자가 현장 데이터를 조회하고 조치하는 전체 흐름을 정의한 사전 기획서입니다.

관제 운영자 시나리오

지도 기반 이상징후 확인 흐름

관제 운영자는 3D GIS에서 위험 이벤트를 확인하고 360 로드뷰로 현장 근거를 검토한 뒤 담당자 조치를 요청합니다.

1. 지도 접속

산단 3D GIS 화면 진입
시설물과 주행 경로 확인

2. 위험 이벤트 확인

위험등급별 색상 마커 확인
신규 및 미조치 이벤트 필터링

3. 촬영 지점 선택

360 촬영 포인트 클릭
촬영일자와 위치정보 조회

4. 로드뷰 검토

360 이미지 또는 영상 확인
초음파 결과와 현장 사진 비교

5. 조치 요청

위험등급과 담당자 지정
조치 이력 생성

관제 운영자 | 화면 01

3D GIS 관제 화면

https://roadview-mvp.local/gis
3D GIS 관제
주행 경로활성
위험 이벤트12건
고위험3건
미조치7건

[화면 개요 및 목적]

시설물, 주행 경로, 촬영 포인트, 이상 이벤트를 레이어로 분리해 한 화면에서 확인합니다. 운영자는 위험등급과 상태 필터를 통해 우선 처리 대상을 빠르게 찾습니다.

[핵심 기능 로직]

CesiumJS 레이어는 API 서버에서 받은 GeoJSON 또는 타일 데이터를 표시하고, 이벤트 마커 클릭 시 상세 패널을 엽니다. PostGIS 좌표 기준과 클라이언트의 좌표계 문서를 초기 설계에서 맞춥니다.

  • CesiumJS 레이어
  • PostGIS 좌표 조회
관제 운영자 | 화면 02

360 로드뷰 상세 화면

https://roadview-mvp.local/roadview/point-042
360 로드뷰
촬영 지점P-042
촬영일자2026.05.18
연결 이벤트2건
파일 상태변환 완료

[화면 개요 및 목적]

촬영 지점의 360 이미지 또는 영상을 확인하고 이전, 다음 촬영 위치로 이동합니다. 촬영일자, 좌표, 파일 상태, 연결된 이벤트를 함께 표시합니다.

[핵심 기능 로직]

미디어 원본은 오브젝트 스토리지에 저장하고, 뷰어용 변환본과 썸네일을 별도로 생성합니다. 위치 메타데이터와 파일 식별자를 DB에서 연결합니다.

  • 360 뷰어
  • 오브젝트 스토리지
관제 운영자 | 화면 03

이상 이벤트 상세 화면

이상 이벤트
유형배관 누출 의심
위험등급높음
담당자현장 점검팀
상태조치 요청

[화면 개요 및 목적]

운영자가 이상 후보를 이벤트로 등록하고 위험등급, 담당자, 조치상태를 관리합니다. 조치 완료 시 근거 자료와 이력이 남습니다.

[핵심 기능 로직]

이벤트 상태값은 신규, 검토중, 조치요청, 조치완료, 반려로 관리합니다. 모든 변경은 이력 테이블에 저장해 추후 감사와 리포트에 활용합니다.

  • 이벤트 상태 머신
  • 조치 이력 로그
데이터 관리자 시나리오

촬영 데이터 업로드 및 매핑 흐름

데이터 관리자는 360 이미지와 영상, 초음파 이미지, 좌표 정보를 업로드하고 촬영 포인트와 파일 연결 상태를 검증합니다.

1. 파일 업로드

360 이미지 및 영상 등록
초음파 이미지 첨부

2. 메타데이터 확인

촬영일자와 좌표 검증
파일 형식 확인

3. 포인트 매핑

지도 촬영 포인트와 연결
주행 경로 기준 정렬

4. 변환 상태 확인

썸네일과 뷰어용 파일 생성
오류 파일 분리

5. 보정 및 승인

누락 좌표 보정
운영 화면 노출 승인

데이터 관리자 | 화면 01

촬영 데이터 업로드 화면

https://roadview-mvp.local/data/upload
데이터 업로드
업로드 대기18개
변환중4개
완료112개
오류1개

[화면 개요 및 목적]

대용량 360 파일과 초음파 이미지를 등록하고 촬영일자, 좌표, 설명을 함께 입력합니다. 업로드 상태와 변환 작업을 실시간으로 확인합니다.

[핵심 기능 로직]

파일은 스트리밍 업로드로 저장하고, 작업 큐가 썸네일과 뷰어용 변환본 생성을 처리합니다. 실패 작업은 재시도 큐로 분리합니다.

  • 스트리밍 업로드
  • 비동기 작업 큐
데이터 관리자 | 화면 02

촬영 포인트 매핑 화면

https://roadview-mvp.local/data/mapping
포인트 매핑
미연결 포인트6개
좌표 오류2개
검수 완료98개
노출 승인91개

[화면 개요 및 목적]

지도 위 촬영 포인트와 업로드된 파일을 연결하고 좌표 누락이나 날짜 오류를 보정합니다. 운영 노출 전 데이터 품질을 검수합니다.

[핵심 기능 로직]

촬영 포인트 식별자, 좌표, 파일 식별자, 촬영 순서를 연결합니다. 이전, 다음 포인트 이동을 위해 주행 경로 순번을 함께 저장합니다.

  • 좌표 검증
  • 파일 매핑 테이블
데이터 관리자 | 화면 03

파일 목록 및 품질 검수 화면

https://roadview-mvp.local/data/files
파일 품질 검수
원본 용량42.8GB
썸네일 생성완료
재처리 필요1건
운영 노출가능

[화면 개요 및 목적]

파일별 변환 상태, 용량, 연결 포인트, 오류 사유를 목록으로 확인합니다. 문제가 있는 데이터는 보정 후 다시 처리합니다.

[핵심 기능 로직]

파일 상태는 업로드됨, 변환중, 완료, 오류, 보류로 관리합니다. 오류 로그와 재처리 요청을 기록해 운영자가 원인을 추적할 수 있게 합니다.

  • Data Aggregation & Visualization
  • 파일 상태 관리
시스템 관리자 시나리오

정책 및 운영 현황 관리 흐름

시스템 관리자는 이벤트 분류, 위험등급, 담당자 권한, 미처리 현황, 운영 리포트를 관리합니다.

1. 정책 설정

이벤트 유형과 위험등급 관리
상태값 기준 설정

2. 권한 관리

운영자와 담당자 권한 설정
접근 범위 분리

3. 현황 확인

미처리와 고위험 이벤트 확인
기간별 통계 조회

4. 이력 검토

조치 완료 근거 확인
변경 로그 추적

5. 리포트 출력

운영 지표 요약
유지보수 개선점 도출

시스템 관리자 | 화면 01

관리자 대시보드

admin.roadview-mvp.local/dashboard
운영 대시보드
신규 이벤트9건
고위험3건
장기 미처리2건
완료율78%

[화면 개요 및 목적]

고위험 이벤트, 미조치 이벤트, 일정 기간 이상 미처리 이벤트, 조치완료 추이를 한 화면에서 확인합니다.

[핵심 기능 로직]

이벤트 상태와 위험등급별 집계를 API로 제공하고, 기간 조건에 따라 대시보드 카드와 차트를 갱신합니다.

  • 집계 API
  • 운영 대시보드
시스템 관리자 | 화면 02

이벤트 정책 관리

admin.roadview-mvp.local/policies
이벤트 정책
유형5개
위험등급4단계
담당 그룹3개
AI 후보수신 대기

[화면 개요 및 목적]

이상징후 유형, 위험등급, 담당자 배정 기준을 관리합니다. MVP 이후 AI 후보 유형도 동일한 정책 구조에 연결됩니다.

[핵심 기능 로직]

정책값은 코드 테이블로 관리해 이벤트 등록 화면과 AI 결과 수신 API가 같은 기준을 사용하도록 합니다.

  • 코드 테이블
  • 권한 관리
시스템 관리자 | 화면 03

운영 리포트 화면

admin.roadview-mvp.local/reports
운영 리포트
월간 이벤트48건
평균 처리2.1일
반복 구간4곳
개선 제안7개

[화면 개요 및 목적]

기간별 이벤트 발생, 조치 소요 시간, 반복 발생 위치, 담당자별 처리 현황을 확인합니다. 유지보수와 AI 고도화의 근거 자료로 활용합니다.

[핵심 기능 로직]

조치 이력과 이벤트 위치를 집계해 반복 발생 구간과 처리 병목을 도출합니다. 추후 AI 학습 데이터 선별에도 활용 가능한 구조입니다.

  • 리포트 집계
  • Issue Tracking & Status Management