kcg-ai-monitoring

gc/kcg-ai-monitoring

포크 0

커밋 그래프

작성자	SHA1	메시지	날짜
htlee	04d4b12c50	docs: 2026-04-20 릴리즈 후속 정적 문서 최신화 Phase 0-1/0-2/0-3 + Phase 1-1 V034 반영 + Phase 1-2 재개 포인트 명시. ### 변경 - architecture.md — 27→29 보호 경로, /illegal-fishing + /transshipment 라우트 추가 - sfr-traceability.md - Flyway V001~V030 → V001~V034 (34 마이그레이션) - Database 51 → 56 테이블 (V034 detection_model_* 5종 + 뷰 1, 반영 대기) - Prediction 섹션에 stage_runner 사이클 에러 경계 (Phase 0-1) 추가 - SFR-09: TransshipmentDetection(V033/PR #86) 페이지 추가 - SFR-10: IllegalFishingPattern(V032/PR #85) 페이지 추가 - 부록 A: 신규 화면 파일 경로 반영 - sfr-user-guide.md — SFR-10 하위에 "불법 조업 이벤트" + "환적 의심 탐지" 2개 신규 페이지 사용자 가이드 섹션 신설 - system-flow-guide.md — V030 미반영 경고를 V030~V034 노드 일괄 미반영으로 확장 (detection_models / detection_model_versions / detection_model_run_outputs / detection_model_metrics / dag_executor / shadow_runner / api.detection_models_* / ui.illegal_fishing / ui.transshipment_detection / ui.detection_model_management) - prediction-analysis.md — P1 권고 4건 중 3건 완료 표시 - ✅ 사이클 스테이지 에러 경계 (PR #83) - 🟡 임계값 외부화 (V034 스키마 머지, Phase 1-2 대기) - ✅ ILLEGAL_FISHING_PATTERN 전용 페이지 (PR #85) - ✅ 환적 전용 페이지 (PR #86) - 변경 이력에 2026-04-20 행 추가 ### 범위 밖 - memory/* 는 세션 로컬 경로, 저장소 외 - prediction/backend 코드 변경 없음 — 문서만	2026-04-20 07:10:48 +09:00
htlee	b37e18d952	docs: prediction-analysis 신규 + 루트/SFR 문서 drift 해소 - docs/prediction-analysis.md 신설 — opus 4.7 독립 리뷰 기반 prediction 구조/방향 심층 분석 (9개 섹션: 아키텍처·5분 사이클·17 알고리즘·4대 도메인 커버리지·6축 구조 평가·개선 제안 P1~P4·임계값 전수표) - AGENTS.md / README.md — V001~V016→V030, Python 3.9→3.11+, 14→17 알고리즘 모듈 - docs/architecture.md — /gear-collision 라우트 추가 (26→27 보호 경로) - docs/sfr-traceability.md — V029→V030, 48→51 테이블, SFR-10 에 GEAR_IDENTITY_COLLISION 추가 - docs/sfr-user-guide.md — 어구 정체성 충돌 페이지 섹션 신설 - docs/system-flow-guide.md — 노드 수 102→115, V030 manifest 미반영 경고 - backend/README.md — "Phase 2 예정" 상태 → 실제 운영 구성 + PR #79 hotfix 요구사항 전면 재작성	2026-04-17 11:20:53 +09:00
htlee	a6f6003c5f	feat: System Flow 뷰어 추가 (system-flow.html) — 102 노드, 133 엣지 iran 프로젝트의 gear-parent-flow 패턴을 차용하여 시스템 전체 데이터 흐름을 노드/엣지로 시각화하는 별도 React 앱 추가. 메인 SPA와 완전 분리. ## 인프라 - @xyflow/react 추가 - frontend/system-flow.html (별도 entry HTML) - frontend/src/systemFlowMain.tsx (React entry) - vite.config.ts: rollupOptions.input에 systemFlow 추가 - 빌드 산출물: dist/system-flow.html + dist/assets/systemFlow-*.js (231kB, 메인과 분리) ## 매니페스트 (frontend/src/flow/manifest/) 카테고리별 JSON 분할 + 빌드 시 병합: - 01-ingest.json (6) — snpdb, vessel_store, refresh - 02-pipeline.json (7) — 7단계 분류 파이프라인 - 03-algorithms.json (12) — zone/dark/spoofing/risk/transship 등 - 04-fleet.json (9) — fleet_tracker, polygon_builder, gear_correlation, parent_inference - 05-output.json (8) — event/violation/kpi/stats/alert/redis - 06-storage.json (18) — 핵심 DB 테이블 - 07-backend.json (15) — Spring Boot 컨트롤러 + endpoint - 08-frontend.json (17) — 프론트 화면 (menu 매핑 포함) - 09-decision.json (8) — 운영자 의사결정 액션 - 10-external.json (2) — iran, redis - edges.json (133) — data/trigger/feedback 분류 ## 뷰어 컴포넌트 - SystemFlowViewer.tsx — 3단 레이아웃 + React Flow + 상태 관리 - components/FilterBar.tsx — 검색/단계/메뉴/상세필터 + 레이아웃 토글 - components/NodeListSidebar.tsx — 좌측 카테고리별 노드 리스트 - components/NodeDetailPanel.tsx — 우측 선택 정보 + incoming/outgoing 흐름 - components/nodeShapes.ts — kind별 모양/색상 헬퍼 - SystemFlowViewer.css — 전용 다크 테마 스타일 ## 기능 - stage(단계) ⇄ menu(메뉴) 두 가지 그룹화 토글 - 통합 검색 (label/file/symbol/tag) - 다중 필터 (kind/trigger/status) - 노드 모양: kind별 (algorithm=다이아몬드, decision=마름모, api=6각형 등) - 엣지 색상: data=회색, trigger=녹색, feedback=노란 점선 - 딥링크: /system-flow.html#node=<id> (산출문서에서 직접 참조) ## /version 스킬 통합 - CLAUDE.md에 "/version 스킬 사후 처리" 섹션 추가 Claude가 /version 호출 후 자동으로 manifest.meta version/updatedAt/releaseDate 갱신 - .gitea/workflows/deploy.yml에 archive 보존 단계 추가 /deploy/kcg-ai-monitoring-archive/system-flow/v{version}_{date}/ 영구 누적 (nginx 노출 X, 서버 로컬 보존) - docs/system-flow-guide.md 작성 (URL, 노드 ID 명명, 산출문서 참조법, 갱신 절차) ## URL - 운영: https://kcg-ai-monitoring.gc-si.dev/system-flow.html - 메인 SPA에 링크 노출 없음 (개발 단계 페이지) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-07 17:10:22 +09:00

작성자

SHA1

메시지

날짜

htlee

04d4b12c50

docs: 2026-04-20 릴리즈 후속 정적 문서 최신화

Phase 0-1/0-2/0-3 + Phase 1-1 V034 반영 + Phase 1-2 재개 포인트 명시.

### 변경
- architecture.md — 27→29 보호 경로, /illegal-fishing + /transshipment 라우트 추가
- sfr-traceability.md
  - Flyway V001~V030 → V001~V034 (34 마이그레이션)
  - Database 51 → 56 테이블 (V034 detection_model_* 5종 + 뷰 1, 반영 대기)
  - Prediction 섹션에 stage_runner 사이클 에러 경계 (Phase 0-1) 추가
  - SFR-09: TransshipmentDetection(V033/PR #86) 페이지 추가
  - SFR-10: IllegalFishingPattern(V032/PR #85) 페이지 추가
  - 부록 A: 신규 화면 파일 경로 반영
- sfr-user-guide.md — SFR-10 하위에 "불법 조업 이벤트" + "환적 의심 탐지" 2개 신규 페이지 사용자 가이드 섹션 신설
- system-flow-guide.md — V030 미반영 경고를 V030~V034 노드 일괄 미반영으로 확장 (detection_models / detection_model_versions / detection_model_run_outputs / detection_model_metrics / dag_executor / shadow_runner / api.detection_models_* / ui.illegal_fishing / ui.transshipment_detection / ui.detection_model_management)
- prediction-analysis.md — P1 권고 4건 중 3건 완료 표시
  - ✅ 사이클 스테이지 에러 경계 (PR #83)
  - 🟡 임계값 외부화 (V034 스키마 머지, Phase 1-2 대기)
  - ✅ ILLEGAL_FISHING_PATTERN 전용 페이지 (PR #85)
  - ✅ 환적 전용 페이지 (PR #86)
  - 변경 이력에 2026-04-20 행 추가

### 범위 밖
- memory/* 는 세션 로컬 경로, 저장소 외
- prediction/backend 코드 변경 없음 — 문서만

2026-04-20 07:10:48 +09:00

htlee

b37e18d952

docs: prediction-analysis 신규 + 루트/SFR 문서 drift 해소

- docs/prediction-analysis.md 신설 — opus 4.7 독립 리뷰 기반 prediction 구조/방향 심층 분석
  (9개 섹션: 아키텍처·5분 사이클·17 알고리즘·4대 도메인 커버리지·6축 구조 평가·개선 제안 P1~P4·임계값 전수표)
- AGENTS.md / README.md — V001~V016→V030, Python 3.9→3.11+, 14→17 알고리즘 모듈
- docs/architecture.md — /gear-collision 라우트 추가 (26→27 보호 경로)
- docs/sfr-traceability.md — V029→V030, 48→51 테이블, SFR-10 에 GEAR_IDENTITY_COLLISION 추가
- docs/sfr-user-guide.md — 어구 정체성 충돌 페이지 섹션 신설
- docs/system-flow-guide.md — 노드 수 102→115, V030 manifest 미반영 경고
- backend/README.md — "Phase 2 예정" 상태 → 실제 운영 구성 + PR #79 hotfix 요구사항 전면 재작성

2026-04-17 11:20:53 +09:00

htlee

a6f6003c5f

feat: System Flow 뷰어 추가 (system-flow.html) — 102 노드, 133 엣지

iran 프로젝트의 gear-parent-flow 패턴을 차용하여 시스템 전체 데이터 흐름을
노드/엣지로 시각화하는 별도 React 앱 추가. 메인 SPA와 완전 분리.

## 인프라
- @xyflow/react 추가
- frontend/system-flow.html (별도 entry HTML)
- frontend/src/systemFlowMain.tsx (React entry)
- vite.config.ts: rollupOptions.input에 systemFlow 추가
- 빌드 산출물: dist/system-flow.html + dist/assets/systemFlow-*.js (231kB, 메인과 분리)

## 매니페스트 (frontend/src/flow/manifest/)
카테고리별 JSON 분할 + 빌드 시 병합:
- 01-ingest.json (6) — snpdb, vessel_store, refresh
- 02-pipeline.json (7) — 7단계 분류 파이프라인
- 03-algorithms.json (12) — zone/dark/spoofing/risk/transship 등
- 04-fleet.json (9) — fleet_tracker, polygon_builder, gear_correlation, parent_inference
- 05-output.json (8) — event/violation/kpi/stats/alert/redis
- 06-storage.json (18) — 핵심 DB 테이블
- 07-backend.json (15) — Spring Boot 컨트롤러 + endpoint
- 08-frontend.json (17) — 프론트 화면 (menu 매핑 포함)
- 09-decision.json (8) — 운영자 의사결정 액션
- 10-external.json (2) — iran, redis
- edges.json (133) — data/trigger/feedback 분류

## 뷰어 컴포넌트
- SystemFlowViewer.tsx — 3단 레이아웃 + React Flow + 상태 관리
- components/FilterBar.tsx — 검색/단계/메뉴/상세필터 + 레이아웃 토글
- components/NodeListSidebar.tsx — 좌측 카테고리별 노드 리스트
- components/NodeDetailPanel.tsx — 우측 선택 정보 + incoming/outgoing 흐름
- components/nodeShapes.ts — kind별 모양/색상 헬퍼
- SystemFlowViewer.css — 전용 다크 테마 스타일

## 기능
- stage(단계) ⇄ menu(메뉴) 두 가지 그룹화 토글
- 통합 검색 (label/file/symbol/tag)
- 다중 필터 (kind/trigger/status)
- 노드 모양: kind별 (algorithm=다이아몬드, decision=마름모, api=6각형 등)
- 엣지 색상: data=회색, trigger=녹색, feedback=노란 점선
- 딥링크: /system-flow.html#node=<id> (산출문서에서 직접 참조)

## /version 스킬 통합
- CLAUDE.md에 "/version 스킬 사후 처리" 섹션 추가
  Claude가 /version 호출 후 자동으로 manifest.meta version/updatedAt/releaseDate 갱신
- .gitea/workflows/deploy.yml에 archive 보존 단계 추가
  /deploy/kcg-ai-monitoring-archive/system-flow/v{version}_{date}/ 영구 누적
  (nginx 노출 X, 서버 로컬 보존)
- docs/system-flow-guide.md 작성 (URL, 노드 ID 명명, 산출문서 참조법, 갱신 절차)

## URL
- 운영: https://kcg-ai-monitoring.gc-si.dev/system-flow.html
- 메인 SPA에 링크 노출 없음 (개발 단계 페이지)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-07 17:10:22 +09:00

3 커밋