Skip to content

feat: 주간 요약 리포트 — 판단 주기 다이제스트 + 귀속 주간 푸시#433

Merged
easygap merged 1 commit into
mainfrom
feat/weekly-report
Jul 2, 2026
Merged

feat: 주간 요약 리포트 — 판단 주기 다이제스트 + 귀속 주간 푸시#433
easygap merged 1 commit into
mainfrom
feat/weekly-report

Conversation

@easygap

@easygap easygap commented Jul 2, 2026

Copy link
Copy Markdown
Owner

무엇

한 달 운영 리뷰(docs/PAPER_MONTH1_REVIEW_AND_PLAN.md P1-7)의 주간 요약 리포트를 구현합니다. --mode weekly_report가 판단 주기(주 1회)에 맞춘 다이제스트를 Discord로 발송합니다.

일일 숫자는 노이즈가 커서 매일 판단하기엔 부적합합니다. 또한 P1-4의 귀속 분해(실행/구성 격차)가 지금은 CLI에만 있어 오너가 직접 실행해야 봅니다. 주간 요약은 그 분석을 오너에게 자동 푸시하고, 성과·진행률·주간 이벤트를 한 장으로 모아 "주 1회 이것만 봐도 판단"이 되게 합니다.

무엇을 했나

  • core/weekly_report.py: 순수 build_weekly_summary(...) — 성과(주간·누적) / vs KS11 / 귀속 분해 / 진행률·커버리지 / 주간 이벤트 필드 생성, 데이터 없으면 필드 생략.
  • main.py: run_weekly_report() + --mode weekly_report. 바스켓별 평가(귀속 포함) + 스냅샷/이벤트 조회 → 다이제스트 발송(best-effort). 금요일 크론에 추가해 씁니다.

실데이터 스모크(발송 제외):

⏳ 주간 요약 — kr_diversified_hold (WAIT)
💰 성과: 주간 -2.39% · 누적 -5.47%
📊 vs KS11: NAV -5.47% vs KS11 +2.08% (격차 -7.55%p)
🔎 귀속 분해: 실행 -1.00%p · 구성 -6.55%p (실행=통제가능 / 구성=설계수용)
📅 진행률: 17/60일 (28%) · 커버리지 94%
🛠 주간 이벤트: 결측 1일 · 사이클 오류 0건

적대적 리뷰 반영 (7건 제기 → 2건 확정, 모두 low)

  • 결측 카운트 부풀림: P0-1이 미복구 결측을 매 사이클 재경보하므로 SNAPSHOT_GAP 이벤트 원시 카운트는 하루 결측을 여러 건으로 부풀림 → 최근 7일 고유 결측 일수로 집계(detect_snapshot_gaps).
  • 주간 창 오표기: 스냅샷 공백 시 기준 스냅샷이 2~4주 전이면 다주간 수익을 '주간'으로 오표기 → 기준을 1주 밴드(-10-4일)로 제한, 밖이면 주간 항 생략(누적 유지).

테스트

  • tests/test_weekly_report.py — 성과/귀속/진행률/이벤트 필드 + 결측 고유일수 계약 + 텍스트 폴백.
  • 전체 스위트 통과.

한 달 운영 리뷰(docs/PAPER_MONTH1_REVIEW_AND_PLAN.md P1-7) 처방. 일일 숫자는
노이즈가 커서 매일 판단엔 부적합하다. 주간 요약이 성과·귀속 분해·진행률·주간
이벤트를 한 장으로 모아 주 1회 판단을 돕는다. CLI에만 있던 P1-4 귀속 분해를
오너에게 주간 자동 푸시하는 것이 핵심.

core/weekly_report.py: 순수 build_weekly_summary — 성과(주간/누적) · vs KS11 ·
  귀속 분해(실행/구성) · 진행률/커버리지 · 주간 이벤트 필드(데이터 없으면 생략)
main.py: run_weekly_report + --mode weekly_report. 금요일 크론에 추가해 쓴다.

적대적 리뷰 반영(low 2건):
- 결측은 SNAPSHOT_GAP 이벤트 원시 카운트 대신 '고유 일수'로 집계 — P0-1이
  미복구 결측을 매 사이클 재경보해 부풀리는 것을 방지(detect_snapshot_gaps)
- 주간 변화 기준 스냅샷을 ~1주 밴드(-10~-4일)로 제한 — 스냅샷 공백 시
  다주간 수익을 주간으로 오표기하는 것 방지(밖이면 주간 항 생략, 누적 유지)

실데이터 스모크로 다이제스트 확인. 전체 스위트 1593 통과.
@easygap easygap merged commit 7749982 into main Jul 2, 2026
1 check passed
@easygap easygap deleted the feat/weekly-report branch July 2, 2026 05:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant