gc/kcg-ai-monitoring
7
0
포크 0
코드 이슈 풀 리퀘스트 Actions 위키 활동

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

병합
htlee feature/docs-refresh-2026-04-20 에서 develop 로 2 commits 를 머지했습니다 2026-04-20 07:12:33 +09:00
대화 0 커밋 2 파일 변경됨 6 +92 -17
htlee 코멘트됨, 2026-04-20 07:11:30 +09:00
소유자
Copy Link

변경 사항

2026-04-20 release 이후 정적 문서 일괄 최신화

이번 릴리즈에 반영된 Phase 0-1/0-2/0-3 + Phase 1-1 V034 내용을 SFR 트레이스·사용자 가이드·아키텍처·시스템 플로우·prediction 분석 리포트 5개 문서에 동시 반영.

문서별 변경

문서 변경
architecture.md 27→29 보호 경로 (/illegal-fishing, /transshipment 2개 추가)
sfr-traceability.md Flyway V030→V034 (34 마이그레이션) · 51→56 테이블 (V034 detection_model_* 5 + 뷰 1) · stage_runner 사이클 에러 경계 · SFR-09 TransshipmentDetection · SFR-10 IllegalFishingPattern · 부록 A 파일 경로
sfr-user-guide.md SFR-10 섹션 하위에 "불법 조업 이벤트" + "환적 의심 탐지" 2개 신규 페이지 사용자 가이드 추가 (메뉴 위치·URL·접근 권한·주요 기능·구현 완료/향후 구현 예정)
system-flow-guide.md V030 미반영 경고를 V030~V034 노드 일괄 미반영으로 확장 (ui.illegal_fishing, ui.transshipment_detection, storage.detection_model_*, infra.dag_executor, infra.shadow_runner, api.detection_models_*, ui.detection_model_management)
prediction-analysis.md P1 권고 4건 중 3건 완료(✅) 표시. 임계값 외부화는 🟡 (V034 스키마 머지, Phase 1-2 대기). 변경 이력에 2026-04-20 행 추가

P1 권고 이행 현황

# 권고 상태
1 사이클 스테이지 에러 경계 ✅ Phase 0-1 (PR #83) — 효과 검증: V031 잠복 버그 즉시 노출 + 4시간 누락 복원
2 임계값 외부화 🟡 V034 스키마 머지 — Phase 1-2 Model Registry + DAG Executor 구현 대기
3 ILLEGAL_FISHING_PATTERN 전용 UI ✅ Phase 0-2 (PR #85)
3 환적 전용 UI ✅ Phase 0-3 (PR #86)
4 사이클 부분 원자성 명시 ⏸ 별도 docs/prediction-transactions.md 신설 예정

테스트

  • 문서 변경만 포함 (코드·DB 영향 없음)
  • 내부 링크 절대 경로 유지
  • Keep-a-Changelog [Unreleased] 에 "문서" 섹션으로 반영

범위 밖

  • memory/* (세션 로컬 경로, 저장소 외) — 동시 갱신했으나 커밋 대상 아님
  • prediction/backend 코드 변경 없음
  • system-flow manifest 실제 노드 추가는 /version 릴리즈에서 일괄 동기화

관련

  • PR #82/#83/#84/#85/#86/#87/#88/#89/#90 (2026-04-20 release) 의 후속 문서 정리
## 변경 사항 **2026-04-20 release 이후 정적 문서 일괄 최신화** 이번 릴리즈에 반영된 Phase 0-1/0-2/0-3 + Phase 1-1 V034 내용을 SFR 트레이스·사용자 가이드·아키텍처·시스템 플로우·prediction 분석 리포트 5개 문서에 동시 반영. ### 문서별 변경 | 문서 | 변경 | |---|---| | `architecture.md` | 27→29 보호 경로 (`/illegal-fishing`, `/transshipment` 2개 추가) | | `sfr-traceability.md` | Flyway V030→V034 (34 마이그레이션) · 51→56 테이블 (V034 detection_model_* 5 + 뷰 1) · stage_runner 사이클 에러 경계 · SFR-09 TransshipmentDetection · SFR-10 IllegalFishingPattern · 부록 A 파일 경로 | | `sfr-user-guide.md` | SFR-10 섹션 하위에 "불법 조업 이벤트" + "환적 의심 탐지" 2개 신규 페이지 사용자 가이드 추가 (메뉴 위치·URL·접근 권한·주요 기능·구현 완료/향후 구현 예정) | | `system-flow-guide.md` | V030 미반영 경고를 V030~V034 노드 일괄 미반영으로 확장 (`ui.illegal_fishing`, `ui.transshipment_detection`, `storage.detection_model_*`, `infra.dag_executor`, `infra.shadow_runner`, `api.detection_models_*`, `ui.detection_model_management`) | | `prediction-analysis.md` | P1 권고 4건 중 3건 완료(✅) 표시. 임계값 외부화는 🟡 (V034 스키마 머지, Phase 1-2 대기). 변경 이력에 2026-04-20 행 추가 | ### P1 권고 이행 현황 | # | 권고 | 상태 | |---|---|---| | 1 | 사이클 스테이지 에러 경계 | ✅ Phase 0-1 (PR #83) — 효과 검증: V031 잠복 버그 즉시 노출 + 4시간 누락 복원 | | 2 | 임계값 외부화 | 🟡 V034 스키마 머지 — Phase 1-2 Model Registry + DAG Executor 구현 대기 | | 3 | ILLEGAL_FISHING_PATTERN 전용 UI | ✅ Phase 0-2 (PR #85) | | 3 | 환적 전용 UI | ✅ Phase 0-3 (PR #86) | | 4 | 사이클 부분 원자성 명시 | ⏸ 별도 `docs/prediction-transactions.md` 신설 예정 | ## 테스트 - [x] 문서 변경만 포함 (코드·DB 영향 없음) - [x] 내부 링크 절대 경로 유지 - [x] Keep-a-Changelog [Unreleased] 에 "문서" 섹션으로 반영 ## 범위 밖 - memory/* (세션 로컬 경로, 저장소 외) — 동시 갱신했으나 커밋 대상 아님 - prediction/backend 코드 변경 없음 - system-flow manifest 실제 노드 추가는 `/version` 릴리즈에서 일괄 동기화 ## 관련 - PR #82/#83/#84/#85/#86/#87/#88/#89/#90 (2026-04-20 release) 의 후속 문서 정리
htlee added 2 commits 2026-04-20 07:11:30 +09:00 
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 코드 변경 없음 — 문서만
claude-bot 이 변경사항을 승인하였습니다. 2026-04-20 07:12:32 +09:00
claude-bot left a comment
멤버
Copy Link

docs refresh 2026-04-20 승인 — Phase 0/Phase 1-1 반영 정적 문서 최신화

docs refresh 2026-04-20 승인 — Phase 0/Phase 1-1 반영 정적 문서 최신화
htlee merged commit d8fe1ef202 into develop 2026-04-20 07:12:33 +09:00
htlee 삭제된 브랜치 feature/docs-refresh-2026-04-20 2026-04-20 07:12:33 +09:00
"로그인하여 이 대화에 참여"
리뷰어
No reviewers
claude-bot
레이블
레이블 초기화
No items
레이블 없음
마일스톤
마일스톤 초기화
No items
마일스톤 없음
담당자
담당자 초기화
담당자 없음
참여자 2명
알림
마감일
기한이 올바르지 않거나 범위를 벗어났습니다. 'yyyy-mm-dd'형식을 사용해주십시오.

마감일이 설정되지 않았습니다.

의존성

No dependencies set.

Reference: gc/kcg-ai-monitoring#91
No description provided.
Delete Branch "feature/docs-refresh-2026-04-20"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?