From b14b6c241e6b1e8ad2e0de767fcb12b1127edb24 Mon Sep 17 00:00:00 2001 From: htlee Date: Sat, 4 Apr 2026 10:49:10 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EB=A6=B4=EB=A6=AC=EC=A6=88=20=EB=85=B8?= =?UTF-8?q?=ED=8A=B8=20=EC=A0=95=EB=A6=AC=20(2026-04-04)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/RELEASE-NOTES.md | 42 ++++++++++++++---------------------------- 1 file changed, 14 insertions(+), 28 deletions(-) diff --git a/docs/RELEASE-NOTES.md b/docs/RELEASE-NOTES.md index 9db0845..05a551a 100644 --- a/docs/RELEASE-NOTES.md +++ b/docs/RELEASE-NOTES.md @@ -4,6 +4,8 @@ ## [Unreleased] +## [2026-04-04] + ### 추가 - 어구 모선 추론(Gear Parent Inference) 시스템 — 다층 점수 모델 + Episode 연속성 + 자동 승격/검토 워크플로우 - Python: gear_parent_inference(1,428줄), gear_parent_episode(631줄), gear_name_rules @@ -14,36 +16,23 @@ ### 수정 - 모선 검토 대기 목록을 폴리곤 5분 폴링 데이터에서 파생하여 동기화 문제 해소 - - Backend: 폴링 SQL에 candidateCount CTE 추가 - - Frontend: parentInferenceQueue를 useMemo 파생으로 전환 (별도 API 제거) - - 초기 로드 시 자동 그룹 선택 제거 → 검토 패널만 표시, 미선택 상태 - - 렌더 루프 수정 (refreshParentInferenceQueue deps 안정화) - 후보 소스 배지 축약 (CORRELATION→CORR, PREVIOUS_SELECTION→PREV 등) -- 1h 활성 판정을 parent_name 전체 합산 기준으로 변경 (서브클러스터 분리 후 개별 소수 문제 해결) -- vessel_store의 _last_bucket 타임존 오류 수정 (tz-naive KST → UTC 잘못 변환 → incremental fetch 0건) -- time_bucket 수집 안전 윈도우 도입 — safe_bucket(12분 지연) + 3 bucket 백필로 데이터 누락 방지 -- 모선 추론 점수 가중치 조정 — 100%는 DIRECT_PARENT_MATCH 전용 (china 0.15→0.05, prior_cap 0.20→0.10) -- prediction proxy target을 nginx 경유로 변경 (192.168.1.18 직접 → kcg.gc-si.dev) +- 1h 활성 판정을 parent_name 전체 합산 기준으로 변경 +- vessel_store의 _last_bucket 타임존 오류 수정 (tz-naive KST 유지) +- time_bucket 수집 안전 윈도우 도입 — safe_bucket(12분 지연) + 3 bucket 백필 +- 모선 추론 점수 가중치 조정 — 100%는 DIRECT_PARENT_MATCH 전용 +- prediction proxy target을 nginx 경유로 변경 ### 변경 - fleet_tracker: SQL 테이블명 qualified_table() 동적화 + is_trackable_parent_name 필터 - gear_correlation: 후보 track에 timestamp 필드 추가 - kcgdb: SQL 스키마 하드코딩 → qualified_table() 패턴 전환 -## [2026-04-01.2] +## [2026-04-01] ### 추가 - 한국 현황 위성지도/ENC 토글 (gcnautical 벡터 타일 연동) - ENC 스타일 설정 패널 (12개 심볼 토글 + 8개 색상 수정 + 초기화) - -### 수정 -- 라이브 어구 현황에서 fallback 그룹 제외 (1h-fb resolution 분리) -- FLEET 타입 resolution='1h' 누락 수정 -- DB resolution 컬럼 VARCHAR(4)→VARCHAR(8) 확장 - -## [2026-04-01] - -### 추가 - 어구 그룹 1h/6h 듀얼 폴리곤 (Python 듀얼 스냅샷 + DB resolution 컬럼 + Backend/Frontend 독립 렌더) - 리플레이 컨트롤러 A-B 구간 반복 기능 - 리플레이 프로그레스바 통합 (1h/6h 스냅샷 막대 + 호버 툴팁 + 클릭 고정) @@ -68,6 +57,9 @@ - 모델 패널: 헤더→푸터 구조, 개별 확장/축소, 우클릭 툴팁 고정 ### 수정 +- 라이브 어구 현황에서 fallback 그룹 제외 (1h-fb resolution 분리) +- FLEET 타입 resolution='1h' 누락 수정 +- DB resolution 컬럼 VARCHAR(4)→VARCHAR(8) 확장 - 어구 group_key 변동 → 이력 불연속 문제 해결 (sub_cluster_id 구조 전환) - 한국 국적 선박(440/441) 어구 오탐 제외 - Backend correlation API 서브클러스터 중복 제거 (DISTINCT ON CTE) @@ -123,6 +115,9 @@ - 현장분석 항적 미니맵: 선박 클릭 시 72시간 항적 + 현재 위치 표시 - 현장분석 위험도 점수 기준 섹션 - Python 경량 분석: 파이프라인 미통과 412* 선박 간이 위험도 +- 폴리곤 히스토리 애니메이션: 12시간 타임라인 기반 재생 (중심 궤적 + 어구별 궤적 + 가상 아이콘) +- 재생 컨트롤러: 재생/일시정지 + 프로그레스 바 (드래그/클릭) + 신호없음 구간 표시 +- nginx /api/gtts 프록시 (Google TTS CORS 우회) ### 변경 - 위험도 용어 통일: HIGH→WATCH, MEDIUM→MONITOR, LOW→NORMAL (전체) @@ -130,15 +125,6 @@ - 보고서: Python riskCounts 실데이터 기반 위험 평가 - 현장분석: AI 파이프라인 ON/OFF 실상태 + BD-09 실측 탐지 수 - 보고서 버튼: 현장분석 내부로 이동, 수역별 허가업종 동적 참조 - -## [2026-03-25] - -### 추가 -- 폴리곤 히스토리 애니메이션: 12시간 타임라인 기반 재생 (중심 궤적 + 어구별 궤적 + 가상 아이콘) -- 재생 컨트롤러: 재생/일시정지 + 프로그레스 바 (드래그/클릭) + 신호없음 구간 표시 -- nginx /api/gtts 프록시 (Google TTS CORS 우회) - -### 변경 - 분석 파이프라인: MIN_TRAJ_POINTS 100→20 (16척→684척 분석 대상 확대) - risk.py: SOG 급변 count 위험도 점수 반영 - spoofing.py: BD09 오프셋 중국 MMSI(412*) 예외 처리 -- 2.45.2