Files
The-Ouroboros/docs/ouroboros/82_doc_restructure_plan.md
agentson ab9ea56efa
Some checks failed
Gitea CI / test (push) Has been cancelled
docs: consolidate implementation audit updates and add restructure plan
2026-02-28 13:04:15 +09:00

3.5 KiB

문서 재구조화 계획: 감사 → 실행 파이프라인

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_ 각 항목에 수용 기준과 테스트 계획이 포함되었는지 확인