From 7f35103c609bdfa1bbabe89a151eb561f5ba18fe Mon Sep 17 00:00:00 2001 From: htlee Date: Wed, 8 Apr 2026 07:10:22 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=ED=94=84=EB=A1=9C=EC=A0=9D=ED=8A=B8=20?= =?UTF-8?q?=EB=AC=B8=EC=84=9C=20=EC=B5=9C=EC=8B=A0=ED=99=94=20(2026-04-08)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 메모리 갱신 (Claude 내부) - project-snapshot.md: 48테이블, V001~V016, prediction e2e 정상, System Flow 뷰어, 데모계정 5종 - project-history.md: 2026-04-07~08 릴리즈 이력 요약 (MR #3~#15) - next-task: 1순위를 UI/표기 다듬기로 전환 - api-types: /api/stats/hourly + V014~V016 보조 테이블 추가 - debugging: 최근 해결된 11개 이슈 패턴 정리 - 구버전 참고 파일 정리 (data-analysis, refactoring-decisions) ## 리포지토리 문서 - docs/RELEASE-NOTES.md: Unreleased 섹션에 prediction e2e 수정, System Flow 포커스 모드, hourly API, V014~V016, mock 정리, KST 통일, DemoQuickLogin hostname 등 추가 - CLAUDE.md: database/ 설명 V001~V016, 48 테이블로 갱신 Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 2 +- docs/RELEASE-NOTES.md | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 5d3d644..e17f2b0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,7 +9,7 @@ kcg-ai-monitoring/ ├── frontend/ # React 19 + TypeScript + Vite (UI) ├── backend/ # Spring Boot 3.x + Java 21 (인증/권한/감사 + 분석 API) ├── prediction/ # Python 3.9 + FastAPI (AIS 분석 엔진, 5분 주기) -├── database/ # PostgreSQL 마이그레이션 (Flyway V001~V013) +├── database/ # PostgreSQL 마이그레이션 (Flyway V001~V016, 48 테이블) │ └── migration/ ├── deploy/ # 배포 가이드 + 서버 설정 문서 ├── docs/ # 프로젝트 문서 (SFR, 아키텍처) diff --git a/docs/RELEASE-NOTES.md b/docs/RELEASE-NOTES.md index 23c68c5..af3aa96 100644 --- a/docs/RELEASE-NOTES.md +++ b/docs/RELEASE-NOTES.md @@ -8,9 +8,28 @@ - System Flow 뷰어 (`/system-flow.html`) — 시스템 전체 데이터 흐름 시각화 - 102 노드 + 133 엣지, 10개 카테고리 매니페스트 - stage/menu 두 가지 그룹화 토글, 검색/필터/딥링크 지원 + - 포커스 모드 (1-hop 연결 노드만 활성화, 나머지 dim) - 메인 SPA와 분리된 별도 entry, 산출문서 노드 ID 참조용 - `/version` 스킬 사후 처리로 manifest version 자동 동기화 - CI/CD에서 버전별 스냅샷을 서버 archive에 영구 보존 +- 백엔드 `GET /api/stats/hourly?hours=24` — 시간별 통계 조회 (PredictionStatsHourly) +- V014 prediction 보조 테이블 12개 (fleet_vessels, gear_correlation_scores 등) +- V015 NUMERIC precision 일괄 확대 (score→7,4, pct→12,2) +- V016 parent workflow 누락 컬럼 일괄 추가 (17+ 컬럼, candidate_mmsi generated column) + +### 수정 +- **prediction e2e 5가지 이슈 수정** (2026-04-08) + - gear_correlation: psycopg2 Decimal × float TypeError → `_load_all_scores()` float 변환 + - violation_classifier: `(mmsi, analyzed_at)` 기준 UPDATE + 중국선박 EEZ 판정 로직 + - kpi_writer / stats_aggregator: UTC → KST 날짜 경계 통일 + - parent workflow 스키마 ↔ 코드 불일치 → V016로 일괄 해결 +- DemoQuickLogin hostname 기반 노출 (Gitea CI `.env` 차단 대응) +- 프론트 전수 mock 정리: eventStore.alerts, enforcementStore.plans, transferStore 완전 제거 +- Dashboard/MonitoringDashboard/Statistics 하드코딩 → 실 API 전환 +- UTC → KST 시간 표시 통일 (`@shared/utils/dateFormat.ts` 공통 유틸) +- i18n `group.parentInference` JSON 중복키 제거 +- RiskMap Math.random() 격자 제거, MTIS 라벨 + "AI 분석 데이터 수집 중" 안내 +- 12개 mock 화면에 "데모 데이터" 노란 배지 추가 ## [2026-04-07]