gc/kcg-ai-monitoring
7
0
포크 0
코드 이슈 풀 리퀘스트 Actions 위키 활동

feat: 중국어선 감시 실데이터 연동 + 특이운항 미니맵/판별 패널 #62

병합
htlee feature/china-fishing-backend-api 에서 develop 로 4 commits 를 머지했습니다 2026-04-16 14:36:31 +09:00
대화 0 커밋 4 파일 변경됨 20 +1570 -186
htlee 코멘트됨, 2026-04-16 14:36:17 +09:00
소유자
Copy Link

변경 사항

추가 (feat)

  • feat(prediction) 14eb4c7 — vessel_analysis_results 에 분석 시점 lat/lon 저장 (AnalysisResult + to_db_tuple + upsert_results SQL). 분류 파이프라인 / 경량 분석 두 경로에 좌표 주입. 구조적 NULL 누락 해결, 첫 사이클 8173/8173 non-null 확인
  • feat(backend) 820ed75 — /api/analysis/stats 단일 쿼리 COUNT FILTER 집계, /api/analysis/gear-detections MMSI 중복 제거 목록, /api/analysis/vessels 에 mmsiPrefix/minRiskScore/minFishingPct 필터 추가. VesselAnalysisResponse 에 violationCategories/bd09OffsetM/ucafScore/ucftScore/clusterId 5개 필드 노출. VesselAnalysisResult 엔티티에 violation_categories TEXT[] 매핑 추가
  • feat(frontend) d82eaf7 — 중국어선 감시 3개 탭(AI 대시보드/환적/어구판별) 을 deprecated iran proxy → 자체 /api/analysis/* 로 전환. 특이운항 선박 클릭 시 24h 항적 미니맵(MapLibre + deck.gl) + Dark/Spoofing/환적/어구위반/고위험 신호를 시간순 segment 로 병합해 CRITICAL/WARNING/INFO 3단계 색상으로 하이라이트. 판별 구간 상세 패널. 어구/어망 판별 탭 최하단 자동탐지 결과 row 클릭 시 상단 입력 폼 프리필. 관심영역/VIIRS/기상/VTS 카드 "데모 데이터" 뱃지, 비허가/제재/관심 탭 "준비중" 뱃지

문서 (docs)

  • docs a9f81c6 — 릴리즈 노트 [Unreleased] 업데이트

운영 배포 상태

  • rocky-211 backend JAR 2026-04-16 12:43 배포 완료, /actuator/health UP
  • rocky-211 Flyway V029 checksum repair 1건 (prediction 수동 DDL → 스키마 이력 정합성 맞춤)
  • redis-211 prediction 2026-04-16 14:14 배포 완료, 14:28 첫 사이클 upsert 8173 건 lat/lon non-null 확인

관련 이슈

  • 없음 (ad-hoc 실데이터 연동)

테스트

  • 백엔드 Maven clean compile 성공
  • 프론트 npx tsc --noEmit 0 errors
  • 프론트 ESLint 0 errors / 0 warnings
  • 운영 백엔드 /api/analysis/stats?mmsiPrefix=412&hours=1 200 OK + 0이 아닌 실데이터
  • 운영 백엔드 /api/analysis/gear-detections?mmsiPrefix=412 UNREGISTERED_GEAR / GEAR_MISMATCH row 반환
  • 운영 prediction 첫 사이클 8173/8173 lat/lon non-null (412354335 실제 좌표 31.806755, 122.070525)
  • Dev 서버 HMR 정상 (ChinaFishing / RealVesselAnalysis / GearIdentification / VesselMiniMap / VesselAnomalyPanel)
## 변경 사항 ### 추가 (feat) - **`feat(prediction)` 14eb4c7** — vessel_analysis_results 에 분석 시점 lat/lon 저장 (`AnalysisResult` + `to_db_tuple` + `upsert_results` SQL). 분류 파이프라인 / 경량 분석 두 경로에 좌표 주입. 구조적 NULL 누락 해결, 첫 사이클 8173/8173 non-null 확인 - **`feat(backend)` 820ed75** — `/api/analysis/stats` 단일 쿼리 COUNT FILTER 집계, `/api/analysis/gear-detections` MMSI 중복 제거 목록, `/api/analysis/vessels` 에 mmsiPrefix/minRiskScore/minFishingPct 필터 추가. VesselAnalysisResponse 에 violationCategories/bd09OffsetM/ucafScore/ucftScore/clusterId 5개 필드 노출. VesselAnalysisResult 엔티티에 violation_categories TEXT[] 매핑 추가 - **`feat(frontend)` d82eaf7** — 중국어선 감시 3개 탭(AI 대시보드/환적/어구판별) 을 deprecated iran proxy → 자체 /api/analysis/* 로 전환. 특이운항 선박 클릭 시 24h 항적 미니맵(MapLibre + deck.gl) + Dark/Spoofing/환적/어구위반/고위험 신호를 시간순 segment 로 병합해 CRITICAL/WARNING/INFO 3단계 색상으로 하이라이트. 판별 구간 상세 패널. 어구/어망 판별 탭 최하단 자동탐지 결과 row 클릭 시 상단 입력 폼 프리필. 관심영역/VIIRS/기상/VTS 카드 "데모 데이터" 뱃지, 비허가/제재/관심 탭 "준비중" 뱃지 ### 문서 (docs) - **`docs` a9f81c6** — 릴리즈 노트 [Unreleased] 업데이트 ## 운영 배포 상태 - **rocky-211 backend JAR** 2026-04-16 12:43 배포 완료, `/actuator/health` UP - **rocky-211 Flyway V029 checksum repair** 1건 (prediction 수동 DDL → 스키마 이력 정합성 맞춤) - **redis-211 prediction** 2026-04-16 14:14 배포 완료, 14:28 첫 사이클 upsert 8173 건 lat/lon non-null 확인 ## 관련 이슈 - 없음 (ad-hoc 실데이터 연동) ## 테스트 - [x] 백엔드 Maven clean compile 성공 - [x] 프론트 `npx tsc --noEmit` 0 errors - [x] 프론트 ESLint 0 errors / 0 warnings - [x] 운영 백엔드 `/api/analysis/stats?mmsiPrefix=412&hours=1` 200 OK + 0이 아닌 실데이터 - [x] 운영 백엔드 `/api/analysis/gear-detections?mmsiPrefix=412` UNREGISTERED_GEAR / GEAR_MISMATCH row 반환 - [x] 운영 prediction 첫 사이클 8173/8173 lat/lon non-null (412354335 실제 좌표 31.806755, 122.070525) - [x] Dev 서버 HMR 정상 (ChinaFishing / RealVesselAnalysis / GearIdentification / VesselMiniMap / VesselAnomalyPanel)
htlee added 4 commits 2026-04-16 14:36:18 +09:00 
AnalysisResult 에 lat/lon 필드 + to_db_tuple 반영 + upsert_results SQL
컬럼 추가. 분류 파이프라인(last_row) / 경량 분석(all_positions) 두 경로
모두 분석 시점의 선박 위치를 함께 기록해 프론트 미니맵에서 특이운항
판별 위치를 실제 항적 위에 표시할 수 있게 한다.

배포 후 첫 사이클 8173/8173 lat/lon non-null 확인.
중국어선 감시 화면의 실데이터 연동을 위해 기존 /api/analysis 에 집계/
필터 기능을 보강한다.

- VesselAnalysisResult 엔티티에 violation_categories TEXT[] 매핑 추가
- VesselAnalysisResponse 에 violationCategories / bd09OffsetM /
  ucafScore / ucftScore / clusterId 5개 필드 노출
- /api/analysis/vessels 에 mmsiPrefix / minRiskScore / minFishingPct
  필터 파라미터 추가
- /api/analysis/stats: MMSI별 최신 row 기준 단일 쿼리 COUNT FILTER
  집계 (total/dark/spoofing/transship/risk별/zone별/fishing/avgRisk)
- /api/analysis/gear-detections: gear_code/judgment NOT NULL 인 row
  MMSI 중복 제거 목록. 어구/어망 판별 탭 '자동탐지 결과' 섹션 연동용
- deprecated 스텁 /api/vessel-analysis 는 프론트 호출 제거 후 다음
  릴리즈에서 삭제 예정 (이번 PR 에서는 유지)
Tab 1 AI 감시 대시보드 / Tab 2 환적탐지 / Tab 3 어구판별 3개 탭을
deprecated iran proxy 에서 자체 /api/analysis/* 로 전환하고, 특이운항
선박의 24h 항적과 판별 구간 상세를 지도와 패널로 제공한다.

서비스 계층
- analysisApi.ts 확장: getAnalysisStats / getAnalysisVessels(필터 3종) /
  getGearDetections 추가. VesselAnalysis 에 violationCategories /
  bd09OffsetM / ucafScore / ucftScore / clusterId 필드 노출
- analysisAdapter.ts: flat VesselAnalysis → nested VesselAnalysisItem
  변환으로 기존 컴포넌트 재사용
- vesselAnalysisApi.ts fetchVesselAnalysis @deprecated 마킹

Tab 1 (ChinaFishing)
- 서버 집계(stats) 기준 카운터 재구성. 중국어선 / Dark / 환적 / 고위험
  모두 mmsiPrefix=412 로 서버 필터
- 선박 리스트 vessel_type UNKNOWN 인 경우 "중국어선" + "미분류" 로 표시
- 특이운항 row 클릭 → 아래 행에 미니맵 + 판별 패널 배치
- 관심영역 / VIIRS / 기상 / VTS 카드에 "데모 데이터" 뱃지. 비허가 /
  제재 / 관심 탭 disabled + "준비중" 뱃지

Tab 2 (RealVesselAnalysis)
- /analysis/dark / /analysis/transship / /analysis/vessels mode별 분기
- 상단 통계 카드를 items 클라이언트 집계로 전환해 하단 테이블과 정합

Tab 3 (GearIdentification)
- 최하단 "최근 자동탐지 결과" 섹션 추가. row 클릭 시 상단 입력 폼
  프리필 + 결과 패널에 자동탐지 근거 프리셋

특이운항 판별 시각화 (VesselMiniMap / VesselAnomalyPanel /
vesselAnomaly 유틸)
- 24h getAnalysisHistory 로드 → classifyAnomaly 로 DARK/SPOOFING/
  TRANSSHIP/GEAR_VIOLATION/HIGH_RISK 5개 카테고리 판별. 좌표는
  top-level lat/lon 우선, features.gap_start_* fallback
- groupAnomaliesToSegments: 5분 주기 반복되는 동일 신호를 시작~종료
  구간으로 병합
- 미니맵: 전체 궤적은 연한 파랑, segment 시간범위와 매칭되는 AIS
  궤적 서브구간을 severity 색(CRITICAL 빨강 / WARNING 주황 / INFO
  파랑) 으로 하이라이트. 이벤트 기준 좌표는 작은 흰 점
- 판별 패널: 시작→종료 · 지속 · N회 연속 감지 · 카테고리 뱃지 · 설명
claude-bot 이 변경사항을 승인하였습니다. 2026-04-16 14:36:24 +09:00
claude-bot left a comment
멤버
Copy Link

MR 승인 (via /mr skill) — 운영 배포 + 동작 확인 완료

MR 승인 (via /mr skill) — 운영 배포 + 동작 확인 완료
htlee merged commit 9607f798dd into develop 2026-04-16 14:36:31 +09:00
htlee 삭제된 브랜치 feature/china-fishing-backend-api 2026-04-16 14:36:31 +09:00
"로그인하여 이 대화에 참여"
리뷰어
No reviewers
claude-bot
레이블
레이블 초기화
No items
레이블 없음
마일스톤
마일스톤 초기화
No items
마일스톤 없음
담당자
담당자 초기화
담당자 없음
참여자 2명
알림
마감일
기한이 올바르지 않거나 범위를 벗어났습니다. 'yyyy-mm-dd'형식을 사용해주십시오.

마감일이 설정되지 않았습니다.

의존성

No dependencies set.

Reference: gc/kcg-ai-monitoring#62
No description provided.
Delete Branch "feature/china-fishing-backend-api"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?