- PostgreSQL history contract와 schema/validator를 추가했습니다.
- .NET history store, snapshot reader, repository, migration을 연결했습니다.
- history-first 운영 모델 문서와 daily signal tracking 문구를 정리했습니다.
- docs/CLOUD_SERVER_SETUP.md 신규 생성
- 서버 기본 정보 (Ubuntu 26.04, AMD EPYC-Rome 2C, 3.7GiB)
- 서비스 아키텍처: Nginx, Gitea, QuantEngine Blazor, PostgreSQL 18
- Docker Compose v5.2.0 기반 Gitea 설정 전문
- .NET 10 (ASP.NET Core 10.0.9) systemd 서비스 설정 전문
- 6x Gitea Act Runner CI 컨테이너 현황
- 보안: SSH hardening, UFW 방화벽, fail2ban, 네트워크 격리
- 시놀로지 → 클라우드 마이그레이션 매핑표
- 운영 명령 치트시트 및 검증 하네스
- 참조 인덱스(TOC) 및 관련 문서 상호 참조
- AGENTS.md Directory Routing 섹션에 문서 경로 등록
provenance: ssh kjh2064@178.104.200.7 라이브 명령 실행으로 수집 (2026-06-26)
배포 및 실전 운영 준비:
1. 배포 스크립트 (deploy.sh)
- SSH 기반 자동 배포
- 원격 백업 생성
- nginx 자동 재시작
- 헬스 체크
2. Live Outcome Ledger (live_outcome_ledger.gs)
- addSignal_(): 신호 기록
- updatePriceT5_(): T+5 가격 입력
- updatePriceT20_(): T+20 가격 + outcome 자동 계산
- calculateStats_(): 통계 계산 (win_rate, avg_margin)
- checkCalibrationReady_(): CALIBRATED 전환 조건 확인
- calibrateIfReady_(): 자동 전환 (30개 신호 + 60% 승률)
3. 일일 추적 가이드 (DAILY_SIGNAL_TRACKING.md)
- 신호 발생 시 → T+5 → T+20 프로세스
- 주간 리뷰 체크리스트
- 마일스톤 일정 (6주)
- CALIBRATED 전환 조건
- honest_proof_score 개선 경로
배포 준비:
- publish 폴더: 24MB (172개 파일)
- appsettings.json: PostgreSQL 연결 설정됨
- MudBlazor UI: 반응형 대시보드
- GAS 함수: 7개 (P3~P6)
실전 운영:
- 신호 수집 기간: 2026-06-25 ~ 2026-08-10 (6주)
- 목표: 30개 신호 + win_rate >= 60%
- 최종 목표: honest_proof_score 95.0 달성
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
현재 상태: 15개 DB 파일이 3개 위치에 분산
- Canonical (정규): src/quant_engine/ (2)
- Legacy/Test: outputs/ (10)
- Temp: Temp/ (3)
문제점 식별:
1. kis_data_collection.db: 3개 위치 (1 canonical + 2 legacy)
2. snapshot_admin.db: 4+ 위치 (1 canonical + 3+ legacy)
3. qualitative_sell_strategy.db: 미사용
리팩토링 계획 문서화:
- Step 1: Canonical 위치 검증 [OK]
- Step 2: 구형 파일 아카이빙 (archive_db/)
- Step 3: 미사용 참조 제거
- Step 4: 문서 및 배포 스크립트 업데이트
리팩토링 분석 도구: refactor_database_structure.py
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
WBS-9.1: F14 마이그레이션 완결 ✅
- late_chase_risk_score, late_chase_gate 포트 완료
- Parity 테스트 36개 PASS (17+19 테스트)
- docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md
WBS-9.2: snapshot_admin 성능 최적화
- tools/benchmark_snapshot_admin_performance_v1.py
- 단일/동시 테이블 성능 측정
- P99 < 2초 검증, 자동 리포트 생성
WBS-9.3: 데이터 품질 강화 ✅ 80% 완료
- spec/12_field_dictionary.yaml: NULL 정책 추가
- auto_fill_atr20_v1.py: ATR20 자동 계산
- auto_fill_rsi14_v1.py: RSI14 자동 계산
- auto_fill_velocity_v1.py: velocity 자동 계산
- auto_fill_stop_price_v1.py: 손절가 자동 계산
- CI 게이트 3개 (NULL_CHECK, FILLABLE, ESTIMATION_BLOCK)
WBS-9.4: 장애 대응 플레이북 ✅
- docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md
- 5가지 시나리오 (KIS, Cloudflare, GAS, Admin, Data)
- RTO/RPO 명시, 모의 훈련 일정
WBS-9.5: 섹터 플로우 신호 신뢰도
- tools/measure_sector_flow_reliability_v1.py
- Hit Rate, Correlation, Reliability Score 측정
- HIGH/MEDIUM/LOW/INSUFFICIENT 판정
- WBS-8.5 완료(섹터 플로우 30일) 후 실행
WBS-9.6: LLM 레이더 문서 최적화 전략
- docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md
- 5-Phase 구현 계획 (신뢰도/순서/의존성/용어/오류검증)
- 목표: 독해 오류율 50% 이상 감소
WBS-9.7: 자동 백업 & 복구
- tools/backup_recovery_manager_v1.py
- 일일 증분/주간 전체 백업
- 자동 정리(30일), 무결성 검증
- 복구 < 1시간, 99% 성공률 목표
WBS-9 최종 요약:
- docs/WBS_9_FINAL_SUMMARY_2026_06_22.md
- 7개 항목 모두 준비 완료
- 2026-08-01 공식 시작
- 14-21일 병렬 진행으로 완료 가능
파일 추가:
- src/quant_engine/auto_fill_atr20_v1.py
- src/quant_engine/auto_fill_rsi14_v1.py
- src/quant_engine/auto_fill_velocity_v1.py
- src/quant_engine/auto_fill_stop_price_v1.py
- tools/measure_sector_flow_reliability_v1.py
- tools/backup_recovery_manager_v1.py
- docs/WBS_9_FINAL_SUMMARY_2026_06_22.md
Next: WBS-8.1 (T+20 ledger 30건, ~2026-07-15)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
WBS-8.7: spec-code 동기화 확장 완료 (66.4%, 93/140)
- 목표 50% 초과달성 (12 files)
- strategy, risk, exit, formulas, governance 파일 대량 태깅
WBS-9: 모든 7개 항목 준비 완료
WBS-9.1: F14 마이그레이션 완결 (GAS → Python)
- late_chase_risk_score, late_chase_gate 포트 완료
- Parity 테스트 전부 PASS
- 상세 문서: docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md
WBS-9.2: snapshot_admin 성능 최적화
- 벤치마킹 도구 작성: tools/benchmark_snapshot_admin_performance_v1.py
- P99 < 2초 목표, 10개 테이블 동시 로드 검증
- 성능 리포트 및 최적화 권장사항 자동 생성
WBS-9.3: 데이터 품질 강화
- 12_field_dictionary.yaml에 NULL 정책 추가
- chargeability, priority, fillable 필드 명시
- 자동 충전 규칙 및 CI 게이트 정의
- 4개 자동 충전 절차 구현 준비
WBS-9.4: 장애 대응 플레이북
- 5가지 시나리오별 복구 절차 표준화
- RTO/RPO 명시 (KIS 5분, Cloudflare 2분, GAS 3분 등)
- 모의 훈련 일정 (2026-07-01 ~ 07-29)
- 상세 문서: docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md
WBS-9.6: LLM 레이더 문서 최적화 전략
- 신뢰도 레벨 분류 (Canonical/Adapter/Reference/Deprecated)
- 5-계층 읽음 순서 정의
- 의존성 그래프 자동화 계획
- 용어 표준화 및 오류율 측정 도구
- 목표: 독해 오류율 50% 이상 감소
- 상세 문서: docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md
파일 추가:
- tools/benchmark_snapshot_admin_performance_v1.py (성능 벤치마크)
- docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md
- docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md
- docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md
WBS-9 시작 예정: 2026-08-01
- 9.1~9.4, 9.6, 9.7 병렬 진행 가능
- 9.5는 WBS-8.5 완료(섹터 플로우 30일) 후
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
## 7개 항목별 세부 스펙 및 실행 전략
### 항목 개요
1. **WBS-9.1**: GAS 마이그레이션 완결 (F14 재검토)
- 1-2일, 중간 난이도, 무선행조건
2. **WBS-9.2**: snapshot_admin 성능 최적화 (<2초)
- 2-3일, 중간 난이도
3. **WBS-9.3**: 데이터 품질 강화 (NULL 정책)
- 1-2일, 낮음 난이도
4. **WBS-9.4**: 장애 대응 플레이북 (5가지 시나리오)
- 2-3일, 중간 난이도
5. **WBS-9.5**: 섹터 플로우 신호 신뢰도 (WBS-8.5 의존)
- 1일, 낮음 난이도
6. **WBS-9.6**: LLM 레이더 문서 최적화
- 2-3일, 높음 난이도
7. **WBS-9.7**: 자동 백업 & 복구
- 2-3일, 중간 난이도
### 실행 전략
- **병렬 진행**: 9.1, 9.2, 9.3, 9.4, 9.6, 9.7 (동시 가능)
- **순차 필수**: 9.5 (WBS-8.5 완료 후)
- **총 예상**: 14-21일 (병렬 진행)
- **시작**: 2026-08-01 (WBS-8.1 활성화 후)
### 문서 포함 사항
각 항목별 세부 작업 단계, 성공 기준, 예상 기간, 선행조건 명시
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
WBS-9.8 (Slack 통합 모니터링) 항목 제거.
Slack API 연동하지 않음 — 모니터링은 로그/상태 파일로 관리.
WBS-9: 7개 항목으로 축소
1. GAS 마이그레이션 완결 (F14)
2. snapshot_admin 성능 최적화
3. 데이터 품질 강화
4. 장애 대응 플레이북
5. 섹터 플로우 신호 신뢰도
6. 문서 신뢰도 맵
7. 자동 백업 & 복구
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
## WBS-9 개요
WBS-8의 실증 검증 완료 후, 성능 최적화와 운영 안정성을 극대화하는 단계.
예상 기간: 2026-08-01 ~ 2026-10-31
## 8개 항목
1. **WBS-9.1**: GAS 마이그레이션 완결 (F14 미해결 항목)
2. **WBS-9.2**: snapshot_admin 성능 최적화 (<2초 로딩)
3. **WBS-9.3**: 데이터 품질 강화 (NULL 처리 정책)
4. **WBS-9.4**: 장애 대응 플레이북 (5가지 시나리오)
5. **WBS-9.5**: 섹터 플로우 신호 신뢰도 측정
6. **WBS-9.6**: LLM 레이더 문서 최적화
7. **WBS-9.7**: 자동 백업 & 복구 체계
8. **WBS-9.8**: Slack 통합 모니터링
## 의존성 구조
- 독립 병렬: 9.1, 9.2, 9.3, 9.4, 9.6, 9.7, 9.8
- 선행 의존: WBS-8.5 완료 → WBS-9.5
## 테스트 상태
179/179 PASS (parity + unit tests)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
## WBS-8 개요
WBS-7 구조적 경화 완료 후, 실거래 데이터 누적을 통한 이론적 임계값의 실증적 검증 및 운영 안정화.
예상 기간: 2026-07-01 ~ 2026-09-30
현재 parity 테스트: 95/95 PASS
## 8개 항목
1. **WBS-8.1**: T+20 레저 30건 달성 & 예측 정확도 활성화 (~2026-07-15)
2. **WBS-8.2**: 알파 보정 루프 1차 실행 (8.1 의존)
3. **WBS-8.3**: 캘리브레이션 실증 전환 1차 (8.1 의존)
4. **WBS-8.4**: 슬리피지 실측 보정 (체결 5건↑)
5. **WBS-8.5**: 섹터 플로우 30일 누적 검증 (~2026-07-21)
6. **WBS-8.6**: Synology snapshot_admin 라이브 배포 검증
7. **WBS-8.7**: spec-코드 동기화 게이트 커버리지 확장 (12.5%→50%↑)
8. **WBS-8.8**: KIS 수집기 리팩터 (원격 병행 중)
## 의존성 구조
- 병렬 진행 가능: 8.5, 8.6, 8.7, 8.8
- 순차 의존: 8.1 → {8.2, 8.3, 8.4}
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
GAS calcDistributionRiskRow_의 "THIN_ADAPTER: delegated to Python" 주석이
틀린 주석이었음을 발견 — GAS(DISTRIBUTION_RISK_SCORE_V1, 점수식 BUY 차단
게이트)와 Python calc_distribution_detector_per_ticker(DISTRIBUTION_SELL_DETECTOR_V1,
6신호 카운트, PRE_DISTRIBUTION_EARLY_WARNING 정밀도 보완)는 이미 spec에
서로 다른 고유 formula_id로 등록된 독립 공식이었다. "GAS가 Python의 중복"
이라는 ledger 전제가 거짓이었을 뿐, 코드는 원래부터 올바르게 분리돼 있었다.
사용자 결정(둘 다 유지, 역할 분리)에 따라:
- GAS 소스의 잘못된 주석 정정(gdf_03_portfolio_gates.gs) + 번들 재생성
- 양쪽 formula_registry에 상호 related_formula 참조 추가(향후 혼동 방지)
- governance/gas_logic_migration_ledger_v1.yaml: migration_action을
DELETE_DISTRIBUTION_RISK_GAS → KEEP_BOTH_SEPARATE_ROLES로 변경, DONE
Synology 실배포는 검증 불가하지만, 인증 게이트 자체(401/wrong-401/correct-200,
WWW-Authenticate 헤더)는 로컬에서 --auth-user/--auth-password로 재현해 문서의
실측 절차 1)·3) 기대값과 정확히 일치함을 확인했다. 2)/5)/6)은 실제 NAS·공개
호스트명이 필요해 사용자가 직접 수행해야 함을 명시했다.
이미 harness_file:/python_tool:/validator: 필드로 1:1 코드 매핑을
스스로 명시하고 있던 H001~H008 결정론적 하네스 계약 7개(spec/52~58)와
spec/32(canonical_artifact_resolver), spec/37(evaluation_dashboard_contract)에
has_code_implementation/code_path를 추가했다. 모든 대상 파일의 code_path
실존을 사전 확인했다.
governance/rules/00~05, spec/40·45·46·gas_adapter_contract 등 다중 구현체에
걸친 계약은 단일 code_path로 환원하면 거짓 1:1 매핑이 되므로 의도적으로
제외했다(WBS-7.11 핵심 원칙 유지).
"자동화가 안 되면 차후 개선 목표로" 라는 지시에 따라 추정이 아니라
실제로 pykrx(이미 EOD 가격조회에 쓰이는 동일 라이브러리)의
get_shorting_balance()/get_etf_price_deviation()/get_etf_tracking_error()를
호출해 재시도했다. 기본 시세조회는 정상 작동하지만 이 세 함수는 세션
부트스트랩 후에도 HTTP 400 LOGOUT을 반환 — KRX 회원 로그인이 필요한
서버측 인증 게이트임을 raw HTTP로 재현 확인했다(헤더/세션 문제 아님).
자동화하려면 KRX 계정을 자격증명으로 등록해야 하는데, 이는
governance/rules/06·07과 같은 종류의 새 정책 결정이라 사용자 승인
없이 추가하지 않고 개선 목표로 이관한다(next_review_date: 2026-09-30).
- spec/16_data_gaps_roadmap.yaml S4/S5: automation_attempt_2026_06_22
필드에 재현 절차 기록, next_review_action을 "API 키 발급"이 아니라
"KRX 계정 발급·자격증명 관리 정책 승인 여부"로 재구성
- docs/runbook.md: 공매도 잔고율 주1회(매주 월요일 개장 전) CSV 수동
갱신, ETF NAV 수동 import(tools/import_etf_nav_manual.py) 운영절차 명문화
매수/매도 주문 및 계좌 잔고조회를 API로 직접 실행하지 않는다는 원칙을
코드 레벨에서 강제하는 안전게이트(governance/rules/06, 07)와 함께,
시세/호가/공매도거래비중 등 조회전용 KIS Open API 연동 및 SQLite
수집 파이프라인을 추가한다.
- kis_api_client_v1: 모든 요청이 _assert_read_only를 통과해야 하며
/trading/ 경로·주문 TR_ID는 RuntimeError로 즉시 차단
- kis_data_collection_v1: KIS 우선 + Naver 폴백, 네트워크 실패는
개별 ticker 단위로 흡수(배치 전체 중단 없음)
- data_collection_store_v1 / storage_backend_v1: SQLite 캐노니컬
저장소, PostgreSQL 전환 대비 백엔드 추상화
- Gitea 영업일 스케줄(2시간 간격) + CI 강제 게이트
(validate_no_direct_api_trading_v1, validate_kis_api_credentials_v1)
kjh2064