kcg-ai-monitoring/docs/RELEASE-NOTES.md
htlee 7f35103c60 docs: 프로젝트 문서 최신화 (2026-04-08)
## 메모리 갱신 (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) <noreply@anthropic.com>
2026-04-08 07:10:22 +09:00

65 lines
3.4 KiB
Markdown
Raw Blame 히스토리

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Release Notes
이 문서는 [Keep a Changelog](https://keepachangelog.com/ko/1.0.0/) 형식을 따릅니다.
## [Unreleased]
### 추가
- 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]
### 추가
- 모노레포 구조 전환 (frontend/ + backend/ + prediction/ + database/)
- Spring Boot 백엔드 초기화 + Flyway DB 마이그레이션 (V001~V013)
- 자체 인증 시스템 (JWT + 트리 기반 RBAC + 감사로그 + 데모 계정)
- 모선 워크플로우 + 관리자 화면 + 권한 라우트 가드
- 권한 관리 UI 고도화 (트리 RBAC PermissionsPanel)
- iran 백엔드 실연결 + 시스템 상태 + AI 채팅 기반 구현
- 마스터 데이터 + prediction 기반 DB 스키마 (V008~V013)
- 백엔드 API — 이벤트/통계/단속/마스터 데이터 CRUD
- prediction 분석 엔진 모노레포 이식 (14개 알고리즘, 7단계 파이프라인)
- prediction 출력 모듈 5종 (이벤트/위반/KPI/통계/경보)
- alerts API + AIAlert/Dashboard 위험선박 실데이터 전환
- VesselDetail + LiveMapView 실데이터 전환
- 프론트 15개 화면 실데이터 연동 (EventList, Statistics, Dashboard 등)
- 배포 환경 구성 (rocky-211 백엔드 + redis-211 prediction + nginx 프록시)
### 수정
- prediction_stats_monthly.stat_month CHAR(7) → DATE 타입 변경
- 권한 트리 UX 개선 + 라벨 사이드바 일치 + EXPORT 가드
### 변경
- 시스템 관리 페이지 백엔드 연결 + 메트릭 카드
### 문서
- 배포 문서 보강 + CI/CD 모노레포 수정
### 기타
- 팀 워크플로우 초기화 + Prettier + 타입 에러 수정
- .env 파일 서버 정책 준수 + pre-commit 모노레포 대응