Skip to content

feat: 문장 검증·검토 배지 + PyWhy·CausalML 연계 + 첫 화면 정리 (#79·#80 대체) - #81

Merged
jsshin2022 merged 5 commits into
mainfrom
feat/trust-causal-v2
Nov 7, 2026
Merged

jsshin2022 merged 5 commits into
mainfrom
feat/trust-causal-v2

Conversation

@jsshin2022

@jsshin2022 jsshin2022 commented Nov 7, 2026 •

Copy link
Copy Markdown
Member

#79와 #80을 대체합니다. #78이 squash로 머지되면서 그 위에 쌓아 둔 두 브랜치에 충돌이 생겼습니다. 같은 내용을 main 위에 일직선 커밋 4개로 다시 올렸고, 파일 내용은 바뀌지 않았습니다.

커밋 순서: ① 배제 범위 전면 배치·뉴스 문장 검증·검토 배지·구조화 데이터(#79 내용) ② 첫 화면 정리 ③ PyWhy·CausalML 연계 ④ networkx 버전 고정(CI의 causal 작업 수정)

1. PyWhy(DoWhy) · CausalML 연계 — core/causal

판정은 지금처럼 plan.yaml과 기본 추정(make flow)이 냅니다. 여기서 추가하는 것은 두 번째 의견이며 판정을 바꾸지 않습니다.

기능 무엇을 하나 어디에 보이나
가설·데이터 점검 (feasibility, 추가 설치 없음) 처치 시점 근거, 비교 대상, 결과 데이터, 공통 원인(통제) 데이터, 공간 단위, 시간 단위 6가지를 카탈로그로 확인하고, PyWhy 방식 인과 그래프(정책 → 결과, 공통 원인 → 정책·결과)를 만듦 이슈 보드 맨 위. 검색 결과가 없을 때 판정 패널
plan.yaml 초안 (draft) 질문 → 주제·이슈 매칭 → 스키마를 통과하는 초안 생성. 시행일은 issues.yaml의 공식 날짜만 쓰고, 모르는 칸은 TODO로 남김 make draft Q="…" [NEW=<id>]
DoWhy 단위별 정책 전후 변화 표 → 뒷문 기준 식별(정책 전 수준·공변량 보정) → 추정 → 반박 검정 3종(가짜 처치 / 무작위 공통 원인 / 80% 부분 표본) 결과 페이지 '두 번째 의견'
CausalML T-러너로 단위별 효과를 구하고, 정책 전 수준 3구간으로 나눠 평균. 처치·비교가 각각 10곳 이상일 때만 실행 결과 페이지 '두 번째 의견'
  • 검증:
    • 합성 예제(참효과 -5.0)에서 DoWhy -5.18, CausalML ATE -5.17이 나왔고, 반박 검정 3종 모두 통과했습니다.
    • 단위별 변화 표의 처치-비교 차이가 2×2 이중차분과 정확히 같은지 테스트로 고정했습니다.
  • 첫 적용: 멘토 예시 t3-land-permit-2025(시뮬레이션 데이터)에 pywhy_check.json을 커밋했습니다.
    • 기본 추정과 같은 방향이고, 반박 검정 3종 모두 통과했습니다.
    • 처치 단위가 4곳뿐이라 CausalML은 건너뜀 표시가 나옵니다.
  • 설치·CI:
    • pip install -e ".[causal]"에 causalml을 추가했습니다.
    • CI에 causal 작업을 따로 만들었습니다(라이선스 검사·테스트·예제 실행). 의존성 106개 중 GPL·AGPL은 없습니다.

2. 주제별 묶어 보기

이슈 보드 분석 단계에 '결과를 한 축에 놓고 보기'를 추가했습니다. 각 결과의 95% 범위를 한 축에 나란히 놓으며, 설계가 달라 숫자를 합치지는 않습니다. 지금은 부동산, 행정통합 주제에 표시됩니다.

3. 뉴스 신호

  • refresh_trends가 구글 뉴스 RSS에서 최근 7일 기사 수를 셉니다. 키가 필요 없고, 제목·본문은 저장하지 않습니다.
  • 이 숫자는 이슈 보드 순위와 '뉴스 N' 배지에 쓰이고, 검색 첫 화면 '이번 주 뉴스에 많이 나온 주제'에도 나옵니다. 아직 분석이 없는 주제는 다음 분석 후보로 표시됩니다.
  • 이 작업 환경에서는 프록시 때문에 실제 호출을 확인하지 못했고, RSS 파싱만 테스트했습니다. 확인은 Actions에서 돌 때 하게 됩니다.

4. 첫 화면 정리

  • 섹션을 네 개로 줄였습니다: 검색·흐름 띠 → 최근 확인한 판정 → 이슈 보드 → 처음 오셨나요.
  • 서로 다른 모양의 그림 썸네일 대신, 모든 결과를 같은 형식의 판정 줄로 보여 줍니다(판정 · 작성자 · 제목 · 말할 수 있는 것 · 95% 범위 그림).
  • 중복되던 '지금 이슈/바로 받을 데이터' 두 칸과 레벨 사다리를 홈에서 뺐습니다.
  • 모바일에서 아바타 줄이 화면 밖으로 넘치던 것을 고쳤습니다.

확인

  • pytest 전체 통과(causal 라이브러리 없는 환경 + Python 3.11 venv에 dowhy·causalml을 설치한 환경), ruff 통과.
  • 홈·검색·이슈 보드·결과 페이지를 데스크톱과 모바일(390px, 가로 넘침 없음)에서 확인했습니다.

Generated by Claude Code## 5. 차별점 단계 마무리 (추가 커밋 4dceeca)

  • 사람이 승인하는 에이전트(.github/workflows/plan-agent.yml):
    • 작업 제안 이슈가 열리면 가설·데이터 점검 결과와 plan.yaml 초안을 댓글로 답니다.
    • 메인테이너가 plan-approved 라벨을 붙이면 그 초안으로 PR을 엽니다.
    • 이슈 본문은 셸 명령에 넣지 않고 환경변수로만 넘깁니다. 담당자 ID는 GitHub ID 형식만 받고, 질문은 한 줄로 접어 YAML에 다른 항목을 끼워 넣을 수 없게 했습니다. 각각 테스트로 확인합니다.
  • 주장 검토 기록: 검색 화면의 문장 검증에서 '검토 기록으로 남기기'를 누르면 claim-review 이슈 폼이 열립니다. 주장·비교 사례·자동 결과가 미리 채워져 있고, 검토자가 claims에 추가하면 ClaimReview 마크업이 붙습니다.
  • 검토 짝: 참여 화면에 결과가 있는데 아직 검토받지 않은 분석마다 다른 참여자를 돌아가며 검토자로 제안합니다. 자기 자신은 배정하지 않습니다.
  • plan-approved, claim-review 라벨을 레포에 만들었습니다.

Generated by Claude Code

jsshin2022 and others added 5 commits November 8, 2026 00:13
1. 판정 옆 한 줄 (answers.takeaway)
   - 크기를 판별하지 못함 → 배제 범위("±X%보다 큰 변화는 자료와 맞지 않음"), 판단 불가 → 판단할 수 없는 이유, 관측 통계 → 인용 가능한 범위
   - 답 페이지 판정 상자와 검색 판정 패널 맨 앞에
2. 뉴스 문장 검증 (search.js checkClaim)
   - 문장을 붙여 넣으면 가장 가까운 분석과 비교: 뒷받침 / 범위 안 / 결과를 넘어섬 / 결과와 다름
   - '효과 없다'·'늘었다/줄었다'·'N%'를 키워드 규칙으로 읽고, 판정과 95% 범위(로그 지표는 %)로 판단
   - 결과 안에서 말할 수 있는 문장(이렇게 쓰세요) 제안, 공식 팩트체크 아님을 고지
   - usage_rules 로 결과 페이지와 같은 규칙을 공유
3. 검토 배지 (docs/ops/review-checklist.md)
   - 작성자 아닌 사람이 여덟 항목 확인 → projects.yaml reviewed_by → '검토됨' 배지·신뢰 항목·다음 할 일
   - PR 템플릿에 검토 체크 항목
4. 구조화 데이터 (answers.jsonld)
   - 모든 답 페이지에 schema.org Dataset(CSV 배포 포함)
   - ClaimReview 는 사람이 projects.yaml claims 에 실제 주장·출처·평가를 적었을 때만 (질문을 주장처럼 꾸미지 않음)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMnmZPBD5PQJW1UQAARN7q
- 그림 썸네일 카드(서로 다른 matplotlib 그림) → 같은 모양의 판정 줄: 판정 · 작성자 · 주제 · 제목 · 그래도 말할 수 있는 것 · 95% 범위 그림
- 섹션 순서: 검색·흐름 띠 → 최근 확인한 판정 → 이슈 보드 → 처음 오셨나요
- 홈에서 뺀 것: 지금 이슈/바로 받을 데이터 두 칸(이슈 보드·데이터 페이지와 중복), 레벨 사다리(처음 오셨나요와 중복)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMnmZPBD5PQJW1UQAARN7q
…+ 주제별 묶어 보기·뉴스 신호

core/causal (판정은 바꾸지 않는 '두 번째 의견')
- feasibility: 주제마다 처치 시점 근거·비교 대상·결과·공통 원인(통제)·공간·시간 단위 6개 점검 + PyWhy 식 인과 그래프
  → 이슈 보드 맨 위 '이 주제, 지금 있는 데이터로 분석할 수 있나', 검색에서 결과가 없을 때 판정 패널
- draft: 질문 → 주제·이슈 매칭 → 스키마를 통과하는 plan.yaml 초안 (시행일은 issues.yaml 공식 날짜만, 모르는 칸은 TODO)
  make draft Q="…" [NEW=<내ID>-<주제>]
- pywhy: 단위별 정책 전후 변화 표 → DoWhy 뒷문 식별·추정·반박 검정 3종(가짜 처치·무작위 공통 원인·부분 표본)
  + CausalML T-러너 단위별 효과(처치·비교 각 10곳 이상일 때만) → cases/<케이스>/pywhy_check.json
  make pywhy CASE=… (pip install -e ".[causal]"), 답 페이지 '두 번째 의견' 섹션
- 합성 예제에서 참효과 -5.0 → DoWhy -5.18, CausalML ATE -5.17, 반박 검정 3종 통과 (tests/test_causal.py)
- t3-land-permit-2025(멘토 예시, 시뮬레이션 데이터)에 pywhy_check.json 첫 커밋
- pyproject causal extra 에 causalml, CI 에 causal 작업(라이선스 검사 포함) 분리

주제별 묶어 보기
- 이슈 보드 분석 단계에 '결과를 한 축에 놓고 보기'(95% 범위, 합치지 않고 나란히)

뉴스 신호
- refresh_trends: 구글 뉴스 RSS 최근 7일 기사 수(제목·본문 저장 안 함) → 이슈 보드 순위·'뉴스 N' 배지,
  검색 첫 화면 '이번 주 뉴스에 많이 나온 주제'(아직 분석 없음 = 다음 분석 후보)

기타: 홈 아바타 줄 모바일 넘침 수정

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMnmZPBD5PQJW1UQAARN7q
…arated 를 쓴다

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMnmZPBD5PQJW1UQAARN7q
…, 검토 짝

차별점 단계의 남은 고리를 닫는다 (사람이 승인하는 에이전트 · 실제 주장 검토 · 리뷰 문화).

- .github/workflows/plan-agent.yml + core/causal/issue_agent.py
  작업 제안 이슈가 열리거나 고쳐지면 가설·데이터 점검과 plan.yaml 초안을 댓글 하나로(계속 갱신),
  메인테이너가 'plan-approved' 라벨을 붙이면 그 초안으로 브랜치·PR. 이슈 본문은 환경변수로만 넘기고
  담당자 ID 는 GitHub ID 형식만, 질문은 한 줄로 접어 YAML 에 끼어들 수 없게 함 (tests)
- draft: 주제·이슈 id 힌트는 매칭에만 쓰고 plan 의 질문에는 넣지 않음
- 주장 검토 기록: 검색 문장 검증 → '검토 기록으로 남기기' → claim-review 이슈 폼(주장·출처·날짜·케이스·자동 결과 미리 채움)
  → 검토자가 projects.yaml claims 에 추가하면 ClaimReview
- 참여 화면 '검토 짝': 결과가 있는데 검토 전인 분석마다 다른 참여자를 돌아가며 제안 (자기 자신 배정 없음)
- 문서: 분석 트랙 표, 검토 체크리스트 절차

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EMnmZPBD5PQJW1UQAARN7q
@jsshin2022
jsshin2022 merged commit abb13eb into main Nov 7, 2026
2 checks passed
@jsshin2022
jsshin2022 deleted the feat/trust-causal-v2 branch November 7, 2026 16:27
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