Skip to content

결과를 가져다 쓸 수 있게 — 배제 범위를 리포트·API까지, 주제별 지금 말할 수 있는 것, 내려받기·공유 - #43

Merged
jsshin2022 merged 1 commit into
mainfrom
feat/results-usable
Oct 25, 2026
Merged

jsshin2022 merged 1 commit into
mainfrom
feat/results-usable

Conversation

@jsshin2022

Copy link
Copy Markdown
Member

무엇을 했나요?

사이트를 "결과를 읽는 곳"에서 결과를 가져다 쓰는 곳으로 바꿨습니다. 기자·실무자가 주제로 들어와 바로 쓸 수 있는 문장을 얻고, 숫자를 내려받고, 링크로 공유할 수 있게 했습니다.

판별하지 못한 결과에서도 쓸 문장 (배제 범위)

  • core/report/interpret.py 하나로 사이트·리포트·API가 같은 문장을 씁니다.
  • '크기를 판별하지 못함' 결과에 지표별로: "주민등록인구(로그): +19.8%보다 큰 증가나 -26.0%보다 큰 감소는 이 자료와 맞지 않습니다(설계 가정이 맞다는 전제)."
  • 판단 불가 결과에는 만들지 않고, 로그 범위가 1.0보다 넓으면(%로 의미 없음) 말하지 않습니다.
  • report.md에 '그래도 말할 수 있는 것' 절 추가 — 케이스 폴더는 건드리지 않았고, 각자 make flow를 다시 돌리면 반영됩니다.
  • 최소 검출 효과(MDE) 계산 함수는 계획 단계용으로만 두었습니다. 결과를 본 뒤의 사후 검정력은 해석을 흐려서 화면에 넣지 않았습니다.

가져다 쓰기

  • 주제 페이지 맨 위 '지금 말할 수 있는 것': 그 주제의 결과를 판정·한 줄 답·배제 범위로 요약. 결과가 없으면 질문·분석 제안 버튼. (아래쪽 중복 목록은 제거)
  • 답 페이지: 케이스별 CSV 내려받기, 링크 복사, 공유 미리보기(Open Graph — 카카오톡·SNS에 판정과 그림이 뜸)
  • API: results.json 지표별 said·unit, 새 api/results.csv(엑셀에서 한글 안 깨지게 BOM)
  • 결과 화면 검색: 정책·지역·주제로 찾기, results.html?q=창원처럼 링크 가능

판정 이름 통일 마무리

리포트·CLI 출력·자동 요약 문장까지 효과 근거 있음 · 크기를 판별하지 못함 · 판단 불가로 맞췄습니다.

케이스

케이스 폴더 변경 없음.

확인

  • pytest 전체 통과 (새 tests/test_report_interpret.py: 범위·판정별 문장·MDE·리포트 절)
  • ruff check, 바꾼 파일만 ruff format, Python 3.11 컴파일
  • make demo 리포트에 새 절 생성 확인
  • 사이트 내부 링크 482개 깨짐 0, 데스크톱·모바일 가로 넘침 없음, 콘솔 오류 0, 검색 필터 동작
  • Streamlit 앱 3개 화면 예외 0

리뷰어에게

  • 배제 범위 문장이 "효과가 없다"로 읽히지 않도록 매번 "'효과가 없다'는 뜻이 아닙니다"를 붙였습니다. 표현이 더 나은 게 있으면 interpret.py 한 곳만 고치면 됩니다.

Generated by Claude Code

- core/report/interpret.py: 판정을 넘지 않는 문장(배제 범위). 판단 불가에는 쓰지 않고, 로그 1.0 보다 넓은 범위는 말하지 않음.
  MDE 계산은 계획 단계용으로만 둠(결과 뒤 사후 검정력은 쓰지 않음)
- report.md: '그래도 말할 수 있는 것' 절 (make flow 를 다시 돌린 케이스부터 반영)
- api: results.json 지표별 said·unit, results.csv(엑셀용 BOM) 추가
- 답 페이지: 지표별 배제 범위, 케이스 CSV 내려받기, 링크 복사, 공유 미리보기(Open Graph · 그림)
- 주제 페이지: 맨 위 '지금 말할 수 있는 것' (결과가 없으면 질문·제안 안내), 아래쪽 중복 결과 목록 제거
- 결과 화면: 정책·지역·주제 검색 (?q= 로 링크 가능)
- 판정 이름 통일을 리포트·CLI·요약 문장까지 확장 (효과 근거 있음 · 크기를 판별하지 못함 · 판단 불가)
- roadmap: 2단계 진행 표시

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMnmZPBD5PQJW1UQAARN7q
@jsshin2022
jsshin2022 merged commit 7b5674d into main Oct 25, 2026
1 check passed
@jsshin2022
jsshin2022 deleted the feat/results-usable branch October 25, 2026 03:47
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