kcg-ai-monitoring/docs/sfr-user-guide.md

SFR 요구사항별 화면 사용 가이드

문서 작성일: 2026-04-06 시스템 버전: v0.1.0 (프로토타입) 다국어: 한국어/영어 전환 지원 (헤더 우측 EN/한국어 버튼) 테마: 다크/라이트 전환 지원 (헤더 우측 해/달 아이콘 버튼)

---

문서 안내

이 문서는 KCG AI 모니터링 시스템의 각 SFR(소프트웨어 기능 요구사항)이 화면에서 어떻게 구현되어 있는지를 비개발자(일반 사용자, 사업 PM, 산출물 작성자)가 이해할 수 있도록 정리한 가이드입니다.

현재 시스템은 **프로토타입 단계(v0.1.0)**로, 모든 SFR의 UI가 완성되어 있으나 백엔드 서버 연동은 아직 이루어지지 않았습니다. 화면에 표시되는 데이터는 시연용 샘플 데이터입니다.

---

목차

• SFR-01: 사용자 인증 및 접근 제어
• SFR-02: 시스템 공통기능 및 환경설정
• SFR-03: 데이터 수집 허브
• SFR-04: AI 모델 관리
• SFR-05: 위험도 분석 지도
• SFR-06: 단속 계획 및 경보
• SFR-07: 단일함정 순찰경로 최적화
• SFR-08: 다함정 경로 최적화
• SFR-09: Dark Vessel 탐지
• SFR-10: 어망/어구 탐지
• SFR-11: 단속/탐지 이력 관리
• SFR-12: 종합 상황판 및 경보 현황판
• SFR-13: 통계 및 성과 분석
• SFR-14: 외부 서비스 연계
• SFR-15: 모바일 서비스
• SFR-16: 함정 Agent
• SFR-17: AI 알림 발송
• SFR-18/19: MLOps 플랫폼
• SFR-20: AI 의사결정 지원

---

SFR-01: 사용자 인증 및 접근 제어

로그인

메뉴 위치: 시스템 접속 시 최초 화면 URL: /login 접근 권한: 모든 사용자

화면 설명: 시스템에 접속하기 위한 로그인 화면입니다. 사용자 ID와 비밀번호를 입력하여 로그인할 수 있으며, 역할별로 5개의 데모 계정이 제공됩니다.

주요 기능:

• 사용자 ID/비밀번호 입력을 통한 로그인
• 역할별 데모 계정 선택 (ADMIN, OPERATOR, ANALYST, FIELD, VIEWER)
• 로그인 후 역할에 따른 메뉴 접근 제어

구현 완료:

• ✅ 로그인 화면 UI 및 데모 계정 5종 로그인 기능
• ✅ 역할 기반 세션 유지 및 메뉴 접근 제어

향후 구현 예정:

• 🔲 SSO(Single Sign-On) 연동
• 🔲 GPKI(정부 공인인증서) 인증 연동
• 🔲 실제 사용자 DB 연동 및 비밀번호 암호화

보완 필요:

• ⚠️ 현재 데모 계정은 하드코딩되어 있으며, 운영 환경에서는 실제 인증 체계로 대체 필요

---

권한 관리

메뉴 위치: 시스템 관리 > 권한 관리 URL: /access-control 접근 권한: ADMIN

화면 설명: 시스템 사용자의 역할(Role)과 권한을 관리하는 화면입니다. RBAC(역할 기반 접근 제어) 방식으로 5가지 역할을 정의하고 각 역할별 메뉴 접근 권한을 설정할 수 있습니다.

주요 기능:

• 5가지 역할(ADMIN, OPERATOR, ANALYST, FIELD, VIEWER) 조회
• 역할별 접근 가능 메뉴 및 기능 권한 설정
• 사용자 목록 조회 및 역할 할당

구현 완료:

• ✅ RBAC 5역할 체계 UI 및 역할별 권한 매트릭스 표시
• ✅ 권한 설정 화면 레이아웃 및 인터랙션

향후 구현 예정:

• 🔲 실제 사용자 DB 연동을 통한 권한 CRUD
• 🔲 감사 로그(권한 변경 이력) 기록

보완 필요:

• ⚠️ 현재 화면의 데이터는 샘플이며 실제 저장/반영되지 않음

---

SFR-02: 시스템 공통기능 및 환경설정

환경설정

메뉴 위치: 시스템 관리 > 환경설정 URL: /system-config 접근 권한: ADMIN, OPERATOR

화면 설명: 시스템 운영에 필요한 기준정보를 조회하고 관리하는 화면입니다. 875건의 기준정보 항목이 표시되며, 검색 및 필터링이 가능합니다.

주요 기능:

• 기준정보 875건 목록 조회 및 검색
• 카테고리별 필터링
• 설정값 수정 UI

구현 완료:

• ✅ 875건 기준정보 목록 표시 및 검색/필터 UI
• ✅ 공통 컴포넌트 적용 (DataTable, 엑셀 내보내기, 인쇄 기능)

향후 구현 예정:

• 🔲 기준정보 DB 연동 (조회/수정/저장)
• 🔲 설정 변경 이력 관리

보완 필요:

• ⚠️ 현재 표시 데이터는 샘플이며, DB 연동 후 실제 운영 데이터로 교체 필요

---

공지사항

메뉴 위치: 시스템 관리 > 공지사항 URL: /notices 접근 권한: ADMIN (작성/수정/삭제), 전체 역할 (조회)

화면 설명: 시스템 운영 관련 공지사항을 등록하고 조회하는 게시판입니다.

주요 기능:

• 공지사항 목록 조회
• 공지사항 작성, 수정, 삭제 (CRUD)
• 공지사항 상세 조회

구현 완료:

• ✅ 공지사항 CRUD UI 완성
• ✅ 목록/상세/작성/수정 화면 전환

향후 구현 예정:

• 🔲 공지사항 DB 연동
• 🔲 첨부파일 업로드/다운로드

보완 필요:

• ⚠️ 현재 작성한 공지사항은 새로고침 시 초기화됨

---

이벤트 목록

메뉴 위치: 단속/이력 > 이벤트 목록 URL: /event-list 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 시스템에서 발생한 각종 이벤트(탐지, 경보, 알림 등)를 통합 목록으로 조회하는 화면입니다.

주요 기능:

• 이벤트 유형별 필터링 및 검색
• 이벤트 상세 정보 조회
• 이벤트 목록 엑셀 내보내기

구현 완료:

• ✅ 이벤트 통합 목록 UI 및 필터/검색
• ✅ DataTable 공통 컴포넌트 적용 (정렬, 페이징, 엑셀, 인쇄)

향후 구현 예정:

• 🔲 실시간 이벤트 수신 및 목록 자동 갱신
• 🔲 이벤트 DB 연동

보완 필요:

• ⚠️ 현재 목록은 샘플 데이터이며, 실시간 연동 후 자동 업데이트 필요

---

SFR-03: 데이터 수집 허브

메뉴 위치: 시스템 관리 > 데이터 허브 URL: /data-hub 접근 권한: ADMIN, OPERATOR

화면 설명: 외부 데이터 소스(AIS, LRIT, SAR, CCTV, VMS 등 5개 신호원)로부터 데이터를 수집하는 현황을 모니터링하는 화면입니다. 22개 수집 채널의 상태를 실시간으로 확인할 수 있습니다.

주요 기능:

• 5개 신호원별 수집 상태 대시보드
• 22개 수집 채널별 연결 상태, 수신량, 오류율 조회
• 채널별 상세 수집 이력 확인

구현 완료:

• ✅ 5개 신호원 + 22개 수집 채널 현황 대시보드 UI
• ✅ 채널별 상태(정상/경고/오류) 시각화

향후 구현 예정:

• 🔲 실제 데이터 수집 엔진 연동
• 🔲 수집 채널 실시간 상태 모니터링
• 🔲 수집 데이터 품질 검증 기능

보완 필요:

• ⚠️ 현재 모든 수집 현황은 샘플 데이터이며, 실제 신호원 연결 후 실데이터로 교체 필요

---

SFR-04: AI 모델 관리

메뉴 위치: 시스템 관리 > AI 모델관리 URL: /ai-model 접근 권한: ADMIN, OPERATOR

화면 설명: AI 탐지 모델의 버전, 탐지 규칙, 입력 피처(Feature), 학습 파이프라인을 관리하는 화면입니다. 모델의 성능을 확인하고 운영 중인 모델을 교체하거나 새 버전을 등록할 수 있습니다.

주요 기능:

• AI 모델 5개 버전 목록 및 상세 정보 조회
• 6개 탐지 규칙 관리 (임계값, 조건 설정)
• 20개 입력 피처 목록 및 중요도 확인
• 학습 파이프라인 실행 현황 조회

구현 완료:

• ✅ 모델 버전 관리 UI (5버전 목록, 성능지표 비교)
• ✅ 탐지 규칙 6건 설정 화면
• ✅ 피처 20건 목록 및 중요도 시각화
• ✅ 파이프라인 현황 표시

향후 구현 예정:

• 🔲 실제 AI 모델 서버 연동 (모델 등록/배포/롤백)
• 🔲 모델 학습 파이프라인 실행 연동
• 🔲 모델 성능 모니터링 실시간 연동

보완 필요:

• ⚠️ 현재 모델 성능 지표는 샘플 데이터이며, 실제 모델 연동 후 정확한 지표로 교체 필요

---

SFR-05: 위험도 분석 지도

메뉴 위치: 탐지/분석 > 위험도 지도 URL: /risk-map 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 해역별 불법조업 위험도를 히트맵(열지도) 형태로 시각화한 화면입니다. 10x18 격자로 분할된 관할 해역의 위험도를 색상으로 표현하며, MTIS 해양사고 통계를 6개 탭으로 분류하여 제공합니다.

주요 기능:

• 10x18 격자 기반 위험도 히트맵 지도 표시
• 격자별 상세 위험도 정보 팝업
• MTIS 해양사고 통계 6탭 (사고유형별, 해역별, 월별 등)
• 기간별 위험도 변화 추이 확인

구현 완료:

• ✅ 위험도 히트맵 10x18 격자 시각화
• ✅ MTIS 해양사고 통계 6탭 UI

향후 구현 예정:

• 🔲 AI 위험도 예측 모델 연동
• 🔲 실시간 AIS/VMS 데이터 기반 동적 위험도 갱신
• 🔲 과거 데이터 기반 위험도 예측 기능

보완 필요:

• ⚠️ 현재 히트맵 데이터는 샘플이며, 예측 모델 연동 후 정확한 위험도로 교체 필요

---

SFR-06: 단속 계획 및 경보

메뉴 위치: 탐지/분석 > 단속 계획/경보 URL: /enforcement-plan 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 불법조업 단속 계획을 수립하고, 경보 발생 조건(임계값)을 설정하는 화면입니다. 현재 등록된 5건의 단속 계획과 경보 조건을 확인하고 관리할 수 있습니다.

주요 기능:

• 단속 계획 5건 목록 조회 및 상세 확인
• 신규 단속 계획 작성 및 수정
• 경보 임계값(위험도 기준, 선박 수 기준 등) 설정
• 단속 계획별 투입 함정/인력 배치 확인

구현 완료:

• ✅ 단속 계획 5건 목록/상세 UI
• ✅ 경보 임계값 설정 화면

향후 구현 예정:

• 🔲 AI 기반 단속 계획 자동 추천
• 🔲 경보 임계값 도달 시 자동 경보 발생
• 🔲 단속 계획 DB 연동

보완 필요:

• ⚠️ 현재 단속 계획 데이터는 샘플이며, 자동 추천 및 경보 기능은 AI 모델 연동 후 구현 필요

---

SFR-07: 단일함정 순찰경로 최적화

메뉴 위치: 현장 대응 > 단일함정 순찰경로 URL: /patrol-route 접근 권한: ADMIN, OPERATOR, FIELD

화면 설명: 개별 함정(경비함)의 순찰 경로를 지도 위에 표시하고, AI가 최적화한 경로를 제안하는 화면입니다. 4척의 함정별 경로와 3가지 시나리오(최단거리, 위험지역 우선, 연료절감)를 비교할 수 있습니다.

주요 기능:

• 4척 함정별 순찰 경로 지도 표시
• 3가지 시나리오별 경로 비교
• 경유지 추가/제거를 통한 수동 경로 조정
• 예상 소요시간, 연료소모량, 해역 커버리지 정보 표시

구현 완료:

• ✅ 함정 4척 경로 지도 시각화
• ✅ 3가지 시나리오 비교 UI

향후 구현 예정:

• 🔲 AI 경로 최적화 엔진 연동
• 🔲 실시간 함정 위치 반영
• 🔲 기상/해황 정보 반영 경로 재계산

보완 필요:

• ⚠️ 현재 경로는 샘플 데이터이며, AI 최적화 엔진 연동 후 실제 최적 경로 제공 필요

---

SFR-08: 다함정 경로 최적화

메뉴 위치: 현장 대응 > 다함정 경로최적화 URL: /fleet-optimization 접근 권한: ADMIN, OPERATOR

화면 설명: 여러 함정을 동시에 운용할 때 전체 해역 커버리지를 최대화하는 최적 경로를 계산하는 화면입니다. 5척의 함정이 6개 구역을 효율적으로 분담 순찰하도록 배치합니다.

주요 기능:

• 5척 함정의 담당 구역 배정 및 지도 시각화
• 6개 구역별 커버리지율 표시
• 전체 해역 커버리지 최적화 결과 확인
• 함정별 순찰 스케줄 표시

구현 완료:

• ✅ 5척 함정 배치 및 6구역 커버리지 시각화
• ✅ 구역별 커버리지율 표시 UI

향후 구현 예정:

• 🔲 AI 다함정 경로 최적화 알고리즘 연동
• 🔲 실시간 함정 위치 기반 동적 재배치
• 🔲 기상/해황 조건 반영 최적화

보완 필요:

• ⚠️ 현재 배치 결과는 샘플 데이터이며, AI 최적화 알고리즘 연동 후 실제 최적 배치로 교체 필요

---

SFR-09: Dark Vessel 탐지

메뉴 위치: 탐지/분석 > Dark Vessel 탐지 URL: /dark-vessel 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: AIS(선박자동식별장치) 신호를 의도적으로 끈 의심 선박(Dark Vessel)을 탐지하는 화면입니다. 7척의 의심 선박과 5가지 행동 패턴 분석 결과를 확인할 수 있습니다.

주요 기능:

• Dark Vessel 의심 선박 7척 목록 및 지도 표시
• 5가지 의심 패턴(AIS 소실, 속도 급변, 해역 이탈 등) 분석 결과
• 의심 선박 상세 프로필 및 이동 궤적 조회
• 위험도 등급별 분류 표시

구현 완료:

• ✅ 의심 선박 7척 목록/지도 시각화
• ✅ 5가지 행동 패턴 분석 결과 UI

향후 구현 예정:

• 🔲 AI Dark Vessel 탐지 엔진 연동
• 🔲 실시간 AIS 데이터 분석 연동
• 🔲 SAR(위성영상) 기반 탐지 연동

보완 필요:

• ⚠️ 현재 탐지 결과는 샘플 데이터이며, AI 탐지 엔진 연동 후 실시간 탐지 결과로 교체 필요

---

중국어선 분석

메뉴 위치: 탐지/분석 > 중국어선 분석 URL: /china-fishing 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 중국 어선의 불법조업 활동을 집중 분석하는 화면입니다. Dark Vessel 탐지(SFR-09) 및 어구 탐지(SFR-10) 결과를 중국 어선에 특화하여 종합 분석합니다.

주요 기능:

• 중국 어선 활동 현황 지도 표시
• 불법조업 의심 어선 목록 조회
• 해역별 중국 어선 밀집도 분석
• 시계열 활동 패턴 분석

구현 완료:

• ✅ 중국 어선 분석 종합 대시보드 UI
• ✅ 지도 기반 활동 현황 시각화

향후 구현 예정:

• 🔲 AI 탐지 엔진 연동 (Dark Vessel + 어구 탐지 통합)
• 🔲 실시간 데이터 기반 분석 갱신

보완 필요:

• ⚠️ 현재 분석 데이터는 샘플이며, 실제 탐지 엔진 연동 필요

---

SFR-10: 어망/어구 탐지

메뉴 위치: 탐지/분석 > 어망/어구 탐지 URL: /gear-detection 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 불법 어망 및 어구를 탐지하고 분류하는 화면입니다. 6건의 탐지 결과와 어구 종류를 식별하는 결정트리(Decision Tree) 분석 결과를 제공합니다.

주요 기능:

• 어구 탐지 6건 목록 및 지도 표시
• 어구 종류별 식별 결정트리 시각화
• 탐지 결과 상세 정보 (위치, 크기, 어구 유형, 위험도)
• 탐지 이미지 확인

구현 완료:

• ✅ 어구 6건 탐지 결과 목록/지도 UI
• ✅ 어구 식별 결정트리 시각화

향후 구현 예정:

• 🔲 AI 어구 탐지 모델 연동 (영상 분석 기반)
• 🔲 실시간 CCTV/SAR 영상 분석 연동
• 🔲 탐지 결과 자동 분류 및 알림

보완 필요:

• ⚠️ 현재 탐지 결과는 샘플 데이터이며, AI 탐지 모델 연동 후 실제 탐지 결과로 교체 필요

---

SFR-11: 단속/탐지 이력 관리

메뉴 위치: 단속/이력 > 단속/탐지 이력 URL: /enforcement-history 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 과거 단속 및 탐지 활동의 이력을 조회하고 관리하는 화면입니다. 6건의 단속 이력과 AI 매칭 검증 결과를 확인할 수 있습니다.

주요 기능:

• 단속 이력 6건 목록 조회 (날짜, 위치, 대상 선박, 결과)
• AI 매칭 검증 — 탐지 결과와 실제 단속 결과 비교 분석
• 이력 상세 정보 조회 및 검색/필터
• 이력 데이터 엑셀 내보내기

구현 완료:

• ✅ 단속 이력 6건 목록/상세 UI
• ✅ AI 매칭 검증 결과 표시

향후 구현 예정:

• 🔲 단속 이력 DB 연동 (조회/등록/수정)
• 🔲 AI 매칭 검증 엔진 연동
• 🔲 탐지-단속 연계 자동 분석

보완 필요:

• ⚠️ 현재 이력 데이터는 샘플이며, DB 연동 후 실제 단속 데이터로 교체 필요

---

SFR-12: 종합 상황판 및 경보 현황판

종합 상황판

메뉴 위치: 모니터링 > 종합 상황판 URL: /dashboard 접근 권한: ADMIN, OPERATOR, ANALYST, FIELD, VIEWER

화면 설명: 시스템의 전체 운영 현황을 한눈에 파악할 수 있는 종합 대시보드입니다. KPI(핵심 성과 지표), 해역 위험도 히트맵, 이벤트 타임라인, 함정 배치 현황 등이 통합 표시됩니다.

주요 기능:

• KPI 카드 (탐지 건수, 정확도, 대응 시간 등) 표시
• 해역 위험도 히트맵 축소판
• 최근 이벤트 타임라인
• 함정 배치 현황 요약
• 실시간 경보 알림 표시

구현 완료:

• ✅ KPI 카드 + 히트맵 + 타임라인 + 함정 현황 통합 대시보드 UI
• ✅ 반응형 레이아웃 (화면 크기에 따른 자동 배치)

향후 구현 예정:

• 🔲 실시간 데이터 연동 (WebSocket 등)
• 🔲 KPI 수치 실시간 갱신
• 🔲 히트맵/타임라인 실시간 업데이트

보완 필요:

• ⚠️ 현재 모든 수치는 샘플 데이터이며, 실시간 연동 후 정확한 운영 데이터로 교체 필요

---

경보 현황판

메뉴 위치: 모니터링 > 경보 현황판 URL: /monitoring 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 현재 발생 중인 경보를 중심으로 긴급 상황을 모니터링하는 화면입니다. 경보 등급별 분류, 미처리 경보 목록, 경보 상세 정보를 확인할 수 있습니다.

주요 기능:

• 경보 등급별(긴급/경고/주의/정보) 현황 표시
• 미처리 경보 목록 및 상세 조회
• 경보 처리(확인/대응/종결) 워크플로우
• 경보 발생 이력 조회

구현 완료:

• ✅ 경보 등급별 현황판 UI
• ✅ 경보 목록/상세 조회 화면

향후 구현 예정:

• 🔲 실시간 경보 수신 연동
• 🔲 경보 처리 워크플로우 DB 연동
• 🔲 경보 자동 에스컬레이션

보완 필요:

• ⚠️ 현재 경보 데이터는 샘플이며, 실시간 연동 후 실제 경보 데이터로 교체 필요

---

실시간 감시

메뉴 위치: 모니터링 > 실시간 감시 URL: /events 접근 권한: ADMIN, OPERATOR, ANALYST, FIELD

화면 설명: 실시간 지도(LiveMap)를 통해 해역 상황을 감시하는 화면입니다. 선박 위치, 이벤트 발생 지점, 함정 위치 등을 실시간으로 확인할 수 있습니다.

주요 기능:

• 실시간 지도 기반 선박/함정 위치 표시
• 이벤트 발생 시 지도 상 알림 표시
• 선박/이벤트 클릭 시 상세 정보 팝업
• 지도 확대/축소 및 해역 필터링

구현 완료:

• ✅ LiveMap 기반 실시간 감시 지도 UI
• ✅ 선박/이벤트 마커 및 팝업 인터랙션

향후 구현 예정:

• 🔲 실시간 AIS/VMS 데이터 연동
• 🔲 WebSocket 기반 실시간 위치 업데이트
• 🔲 이벤트 발생 시 자동 지도 포커스 이동

보완 필요:

• ⚠️ 현재 선박 위치는 샘플 데이터이며, 실시간 데이터 연동 필요

---

해역 통제

메뉴 위치: 모니터링 > 해역 통제 URL: /map-control 접근 권한: ADMIN, OPERATOR

화면 설명: 특정 해역에 대한 통제 구역을 설정하고 관리하는 지도 기반 화면입니다. 통제 구역 진입 선박을 감시할 수 있습니다.

주요 기능:

• 통제 구역 지도 상 설정 및 표시
• 통제 구역 진입/이탈 선박 모니터링
• 통제 구역 관리 (생성/수정/삭제)

구현 완료:

• ✅ 지도 기반 해역 통제 구역 표시 UI
• ✅ 통제 구역 관리 인터페이스

향후 구현 예정:

• 🔲 실시간 선박 위치 기반 진입 감시
• 🔲 통제 구역 위반 자동 경보

보완 필요:

• ⚠️ 현재 통제 구역 데이터는 샘플이며, 실시간 연동 필요

---

SFR-13: 통계 및 성과 분석

메뉴 위치: 통계/보고 > 통계/성과 분석 URL: /statistics 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 시스템의 운영 성과를 통계적으로 분석하는 화면입니다. 월별 추이 그래프와 5개 KPI(탐지 정확도 93.2%, 오탐율 7.8% 등)를 제공합니다.

주요 기능:

• 월별 탐지/단속 추이 그래프
• KPI 5개 지표 대시보드 (탐지 정확도, 오탐율, 대응 시간, 커버리지, 가동률)
• 기간별/해역별/유형별 필터링
• 통계 데이터 엑셀 내보내기 및 인쇄

구현 완료:

• ✅ 월별 추이 차트 및 KPI 5개 대시보드 UI
• ✅ 필터링 및 엑셀 내보내기/인쇄 기능

향후 구현 예정:

• 🔲 통계 데이터 DB 연동
• 🔲 실제 운영 데이터 기반 KPI 자동 산출
• 🔲 맞춤형 보고서 생성 기능

보완 필요:

• ⚠️ 현재 KPI 수치(정확도 93.2%, 오탐율 7.8% 등)는 샘플 데이터이며, 실제 운영 데이터 기반으로 교체 필요

---

보고서 관리

메뉴 위치: 통계/보고 > 보고서 관리 URL: /reports 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: 시스템 운영 보고서를 생성하고 관리하는 화면입니다. 정기/비정기 보고서를 작성하고 조회할 수 있습니다.

주요 기능:

• 보고서 목록 조회 및 검색
• 보고서 작성/수정/삭제
• 보고서 템플릿 관리

구현 완료:

• ✅ 보고서 관리 UI 및 목록/상세 화면

향후 구현 예정:

• 🔲 보고서 DB 연동
• 🔲 통계 데이터 자동 삽입
• 🔲 PDF 보고서 생성 및 다운로드

보완 필요:

• ⚠️ 현재 보고서 데이터는 샘플이며, DB 연동 필요

---

SFR-14: 외부 서비스 연계

메뉴 위치: 시스템 관리 > 외부 서비스 연계 URL: /external-service 접근 권한: ADMIN

화면 설명: 외부 시스템과의 API 연계 현황을 관리하는 화면입니다. 5개 외부 서비스(해양경찰청 통합시스템, GICOMS, 해양교통관제 등)의 API 연결 상태를 확인할 수 있습니다.

주요 기능:

• 외부 서비스 5건 연계 현황 대시보드
• 서비스별 API 연결 상태(정상/오류) 확인
• API 호출 이력 및 오류 로그 조회
• 연계 설정 관리

구현 완료:

• ✅ 외부 서비스 5건 연계 현황 UI
• ✅ API 상태 표시 대시보드

향후 구현 예정:

• 🔲 실제 외부 API 연동 구현
• 🔲 API 헬스체크 자동화
• 🔲 장애 시 자동 알림 및 재연결

보완 필요:

• ⚠️ 현재 API 상태는 샘플 데이터이며, 실제 API 연동 후 실시간 상태 표시 필요

---

SFR-15: 모바일 서비스

메뉴 위치: 현장 대응 > 모바일 서비스 URL: /mobile-service 접근 권한: ADMIN, OPERATOR, FIELD

화면 설명: 현장 요원이 사용할 모바일 앱의 화면을 웹에서 미리보기(프리뷰)하는 시뮬레이션 화면입니다. 실제 모바일 앱이 아닌 웹 기반 시뮬레이션으로, 모바일 앱의 기능과 화면 구성을 확인할 수 있습니다.

주요 기능:

• 모바일 앱 화면 프리뷰 (웹 시뮬레이션)
• 주요 기능 화면 미리보기 (경보 수신, 위치 공유, 보고서 작성 등)
• 모바일 레이아웃 시뮬레이션

구현 완료:

• ✅ 모바일 앱 프리뷰 화면 (웹 시뮬레이션)
• ✅ 주요 기능별 화면 미리보기

향후 구현 예정:

• 🔲 실제 모바일 앱(iOS/Android) 개발
• 🔲 Push 알림 연동
• 🔲 오프라인 모드 지원

보완 필요:

• ⚠️ 현재는 웹 시뮬레이션으로, 실제 모바일 앱과 UI/UX가 다를 수 있음

---

SFR-16: 함정 Agent

메뉴 위치: 현장 대응 > 함정 Agent URL: /ship-agent 접근 권한: ADMIN, OPERATOR

화면 설명: 각 경비함에 설치되는 Agent 소프트웨어의 상태를 모니터링하는 화면입니다. 6건의 함정 Agent 상태(온라인/오프라인, 버전, 마지막 통신 시간 등)를 확인할 수 있습니다.

주요 기능:

• 함정 Agent 6건 상태 목록 조회
• Agent별 온라인/오프라인 상태 확인
• Agent 소프트웨어 버전 및 업데이트 현황
• 마지막 통신 시간 및 통신 이력 확인

구현 완료:

• ✅ 함정 Agent 6건 상태 모니터링 UI
• ✅ 상태별 시각적 표시 (온라인/오프라인)

향후 구현 예정:

• 🔲 실제 Agent 소프트웨어 개발 및 배포
• 🔲 Agent 실시간 통신 연동
• 🔲 Agent 원격 업데이트 기능

보완 필요:

• ⚠️ 현재 Agent 상태는 샘플 데이터이며, 실제 Agent SW 개발 후 연동 필요

---

SFR-17: AI 알림 발송

메뉴 위치: 현장 대응 > AI 알림 발송 URL: /ai-alert 접근 권한: ADMIN, OPERATOR

화면 설명: AI가 분석한 결과를 기반으로 관련 담당자에게 알림을 발송하는 화면입니다. 5건의 알림 전송 현황을 확인하고 새로운 알림을 발송할 수 있습니다.

주요 기능:

• AI 알림 5건 전송 현황 조회
• 알림 유형별(긴급/일반/정보) 분류
• 알림 수신자 설정 및 발송
• 알림 전송 결과(성공/실패) 확인

구현 완료:

• ✅ 알림 5건 전송 현황 UI
• ✅ 알림 유형별 분류 및 상세 조회

향후 구현 예정:

• 🔲 실제 알림 발송 기능 구현 (SMS, 이메일, Push 등)
• 🔲 AI 분석 결과 기반 자동 알림 트리거
• 🔲 알림 발송 이력 DB 연동

보완 필요:

• ⚠️ 현재 알림은 실제 발송되지 않으며, 발송 채널(SMS/이메일/Push) 연동 필요

---

SFR-18/19: MLOps 플랫폼

메뉴 위치: 시스템 관리 > MLOps URL: /mlops 접근 권한: ADMIN

화면 설명: AI 모델의 전체 생명주기(실험, 학습, 배포, 모니터링)를 관리하는 MLOps 플랫폼 화면입니다. 7개 탭으로 구성되어 실험 관리, 모델 레지스트리, 배포 관리, API 서빙, LLMOps 등의 기능을 제공합니다.

주요 기능:

• 실험 관리 — AI 모델 학습 실험 기록 및 비교
• 모델 레지스트리 — 학습된 모델 버전 관리
• 배포 관리 — 모델 서빙 환경 배포 및 모니터링
• API 서빙 — 모델 추론 API 관리
• LLMOps — 대규모 언어 모델(LLM) 운영 관리
• 모니터링 — 모델 성능 드리프트 감시
• 파이프라인 — 자동화된 학습/배포 파이프라인 관리

구현 완료:

• ✅ MLOps 7탭 UI (실험/모델/배포/API/LLMOps/모니터링/파이프라인)
• ✅ 각 탭별 상세 관리 화면

향후 구현 예정:

• 🔲 실제 MLOps 인프라 연동 (MLflow, Kubeflow 등)
• 🔲 모델 학습/배포 파이프라인 자동화
• 🔲 모델 성능 모니터링 실시간 연동
• 🔲 LLM 운영 관리 기능 연동

보완 필요:

• ⚠️ 현재 모든 데이터는 샘플이며, MLOps 인프라 구축 후 실제 데이터로 교체 필요

---

SFR-20: AI 의사결정 지원

메뉴 위치: 시스템 관리 > AI 의사결정 지원 URL: /ai-assistant 접근 권한: ADMIN, OPERATOR, ANALYST

화면 설명: AI에게 질문하고 답변을 받을 수 있는 대화형(채팅) 인터페이스입니다. RAG(검색 증강 생성) 기술을 활용하여 관련 법령, 규정, 매뉴얼을 참조한 답변을 제공합니다.

주요 기능:

• AI Q&A 채팅 UI (질문 입력 및 답변 표시)
• RAG 기반 법령/규정 참조 답변 (참조 출처 표시)
• 대화 이력 관리
• 답변 품질 피드백 (유용함/유용하지 않음)

구현 완료:

• ✅ AI Q&A 채팅 UI
• ✅ RAG 법령 참조 답변 표시 화면

향후 구현 예정:

• 🔲 LLM(대규모 언어 모델) 백엔드 서버 연동
• 🔲 RAG 시스템 구축 (법령/규정/매뉴얼 벡터 DB)
• 🔲 답변 품질 개선을 위한 Fine-tuning

보완 필요:

• ⚠️ 현재 답변은 사전 작성된 샘플이며, LLM 백엔드 연동 후 실제 AI 답변으로 교체 필요

---

부록: 시스템 관리 메뉴

시스템 관리

메뉴 위치: 시스템 관리 > 시스템 관리 URL: /admin 접근 권한: ADMIN

화면 설명: 시스템 전반의 관리 기능을 제공하는 화면입니다. 서버 상태, 로그 조회, 사용자 관리 등 시스템 운영에 필요한 관리 기능을 포함합니다.

주요 기능:

• 시스템 상태 모니터링
• 사용자 계정 관리
• 시스템 로그 조회

구현 완료:

• ✅ 시스템 관리 기본 UI

향후 구현 예정:

• 🔲 실제 서버 상태 모니터링 연동
• 🔲 사용자 관리 DB 연동
• 🔲 시스템 로그 수집/조회 연동

---

부록: 역할(Role)별 접근 권한 요약

역할	설명	접근 가능 주요 메뉴
ADMIN	시스템 관리자	모든 메뉴 접근 가능
OPERATOR	운영 담당자	모니터링, 탐지/분석, 단속/이력, 통계/보고, 현장 대응, 일부 시스템 관리
ANALYST	분석 담당자	모니터링, 탐지/분석, 단속/이력, 통계/보고, AI 의사결정 지원
FIELD	현장 요원	종합 상황판, 실시간 감시, 순찰경로, 모바일 서비스
VIEWER	조회 전용	종합 상황판 (조회만 가능)

---

부록: 현재 시스템 상태 요약

항목	상태
UI 구현	모든 SFR 완료
백엔드 연동	미구현 (전체)
데이터	시연용 샘플 데이터
인증 체계	데모 계정 5종 (SSO/GPKI 미연동)
실시간 기능	미구현 (WebSocket 등 미연동)
AI 모델	미연동 (탐지/예측/최적화 등)
외부 시스템	미연동 (GICOMS, MTIS 등)
모바일 앱	웹 시뮬레이션만 제공 (네이티브 앱 미개발)