# 문서 재구조화 계획: 감사 → 실행 파이프라인 ## Context 80_implementation_audit.md는 v2/v3 구현 감사와 수익률 분석을 수행했으나, 여러 차례 리뷰를 거치면서 리뷰 이력/데이터 품질 논의/SQL 쿼리 등이 혼재되어 **실행 문서로 사용하기 어려운 상태**다. 목표: 이 감사 결과를 바탕으로 **티켓 생성 → 개발 설계 → 구현/리뷰 → 검증 → 실환경 테스트**까지 일관되게 진행할 수 있는 문서 체계를 만든다. ## 변경 사항 ### 1. 80_implementation_audit.md 정리 (감사 기록 문서) **역할**: 현재 상태의 팩트 기록. "무엇이 문제인가"에만 집중. 정리 내용: - Section 3: P&L 분석을 핵심 수치만 남기고 간결화 - 3.1(종합), 3.3(시장별), 3.4(통화 분리), 3.5(전략 진입분 분리), 3.6(무결성 결론) 유지 - 3.2 일별 손익: 주의 문구 제거, 본문으로 통합 - 3.7 데이터 품질: 핵심 결론만 남기고 세부 항목 제거 - 3.8 SQL: 별도 파일(`scripts/audit_queries.sql`)로 분리, 본문에서 참조만 - Section 6.1, 6.2 리뷰 반영 이력: 전부 제거 (git history로 추적 가능) - Section 6 테스트: "재점검으로 확인" 항목을 "테스트 존재" 항목에 통합 - 신규 Section 7: 후속 문서 링크 (85_ 참조) ### 2. 85_loss_recovery_action_plan.md 신규 작성 (실행 계획 문서) **역할**: "어떻게 고칠 것인가". 티켓 생성부터 실환경 검증까지의 실행 청사진. 구조: ``` ## 1. 요약 - 목표: 손실 구간 탈출을 위한 7개 ROOT/5개 GAP 해소 - 성공 기준 (정량) ## 2. Phase별 작업 분해 ### Phase 1: 즉시 파라미터/로직 수정 (손실 출혈 차단) 각 항목마다: - ROOT/GAP 참조 - Gitea 이슈 제목/설명 템플릿 - 변경 대상 파일 + 현재 동작 + 목표 동작 - 수용 기준 (acceptance criteria) - 테스트 계획 - 의존성/차단 관계 ### Phase 2: 데이터 정합성 + v2 실효화 (동일 형식) ### Phase 3: v3 세션 최적화 (동일 형식) ## 3. 검증 계획 - 단위 테스트 기준 - 통합 테스트 시나리오 (백테스트 파이프라인 활용) - 실환경 검증: 소액 live 운용으로 직접 검증 (paper trading 제외 — 실환경과 괴리가 커 검증 신뢰도 부족) - Phase별 실환경 투입 기준: 단위/통합 테스트 통과 → 소액 live → 모니터링 → 정상 확인 후 본운용 ## 4. 의존성 그래프 - Phase 간 blocking 관계 - Phase 내 작업 순서 ## 5. 롤백 계획 - 각 Phase 실패 시 롤백 절차 ``` ### 3. README.md 업데이트 - 85_ 문서 링크 추가 ## 작업 순서 1. 80_ 정리 (노이즈 제거, SQL 분리, 리뷰 이력 삭제) 2. `scripts/audit_queries.sql` 작성 (80_에서 분리한 SQL) 3. 85_ 신규 작성 (실행 계획) 4. README.md 업데이트 ## 작성하지 않는 것 - 30_code_level_work_orders.md, 40_acceptance_and_test_plan.md 업데이트: 85_를 기반으로 실제 구현 시점에 업데이트 (지금은 실행 계획 수립까지만) - 01_requirements_registry.md: ROOT/GAP에서 파생되는 신규 REQ는 구현 착수 시 등록 - Gitea 이슈 생성: 85_ 문서 확정 후 별도 진행 ## 검증 - 80_: 감사 팩트만 남았는지, 리뷰 이력이 제거되었는지 확인 - 85_: Phase별 작업이 Gitea 이슈로 바로 전환 가능한 수준인지 확인 - 85_ 각 항목에 수용 기준과 테스트 계획이 포함되었는지 확인