docs: consolidate implementation audit updates and add restructure plan
Some checks failed
Gitea CI / test (push) Has been cancelled
Some checks failed
Gitea CI / test (push) Has been cancelled
This commit is contained in:
96
docs/ouroboros/82_doc_restructure_plan.md
Normal file
96
docs/ouroboros/82_doc_restructure_plan.md
Normal file
@@ -0,0 +1,96 @@
|
||||
<!--
|
||||
Doc-ID: DOC-PLAN-082
|
||||
Version: 1.0.0
|
||||
Status: draft
|
||||
Owner: strategy
|
||||
Updated: 2026-02-28
|
||||
-->
|
||||
|
||||
# 문서 재구조화 계획: 감사 → 실행 파이프라인
|
||||
|
||||
## 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_ 각 항목에 수용 기준과 테스트 계획이 포함되었는지 확인
|
||||
Reference in New Issue
Block a user