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

3.4 KiB

Raw Blame 히스토리

Release Notes

이 문서는 Keep a Changelog 형식을 따릅니다.

[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 모노레포 대응

3.4 KiB Raw Blame 히스토리 Unescape Escape

Release Notes

[Unreleased]

추가

수정

[2026-04-07]

추가

수정

변경

문서

기타

3.4 KiB

Raw Blame 히스토리