[jsshin2022]

무엇을 했나요?

7주 과정을 비판적으로 점검한 결과와 다시 세운 계획을 레포 문서로 남기고, 그 계획의 1단계 중 코드로 할 수 있는 사용성 개편을 반영했습니다.

문서

• docs/ops/roadmap.md — 점검(증거 표: 외부 질문·테스트 0, 멘티 PR 리뷰 0, 사전 등록 기록 약함 6/6, 판별 못함만 나옴, 재현 0, 법령 갱신 멈춤)과 3단계 계획·관문·지켜볼 숫자
• docs/ops/user-test.md — 외부인 5명 과업 테스트(과업 5개, 성공 기준, 관문)
• 이슈 템플릿 2개: 교차 재현 기록, 사용자 과업 테스트 기록 (이름·연락처는 받지 않음)
• 참여 가이드: 계획 PR 먼저, 7단계 '재현받기', 짝 리뷰 기준, 사이트가 자동으로 확인하는 것
• PR 템플릿: '계획만 담은 PR 먼저' · '한 문장 해석' 체크

사이트 (사용자 쪽)

• 첫 화면이 과업 4개로 시작합니다: 효과가 있었는지 알고 싶어요 / 물어보고 싶어요 / 우리 지역에도 / 참여하고 싶어요
• 메뉴 정리: 프로젝트·참여하기 → 참여 하나로
• 답 페이지에 이 결과를 얼마나 믿을 수 있나: 사전 등록 기록(plan.yaml 첫 커밋 vs 첫 결과 커밋), 교차 재현, 한 문장 해석, 실행 상태 — 판정이 아니라 기록만
• '크기를 판별하지 못함' 결과에 배제 범위 문장 자동 추가 (예: 창원 통합 인구 +19.8%보다 큰 증가나 −26.0%보다 큰 감소는 자료와 맞지 않음)
• 결과 화면에 우리 지역·정책에 같은 분석을 하려면 안내
• 주제 페이지: 법령 목록이 14일 넘게 갱신 안 되면 경고 (지금은 9.27 기준이라 경고가 뜸 — 법제처 인증값을 등록하면 자동으로 사라짐)
• 판정 이름을 사이트·앱에서 통일: 효과 근거 있음 · 크기를 판별하지 못함 · 판단 불가

사이트 (참여자 쪽)

• 프로젝트 카드에 다음 할 일 자동 표시 (한 문장 해석 추가, 교차 재현 요청, 다음엔 계획 PR 먼저, fetch.py 등)
• catalog/projects.yaml에 reproduced_by 필드(설명만 추가, 값은 재현 이슈가 확인되면)
• results.json에 record(사전 등록 기록·교차 재현) 추가
• pages 워크플로는 fetch-depth: 0 (사전 등록 기록에 전체 git 기록 필요. 얕은 clone이면 이 항목만 빠짐)

케이스

케이스 폴더는 건드리지 않았습니다.

확인

• pytest 전체 통과, 새 테스트 tests/test_site_quality.py(배제 범위·사전 등록·다음 할 일·법령 경고)
• ruff check, 바꾼 파일 ruff format, Python 3.11 컴파일
• 사이트 내부 링크 460개 깨짐 0, 데스크톱·모바일 가로 넘침 없음, 콘솔 오류 0
• Streamlit 앱 3개 화면 예외 0

리뷰어에게

• 사전 등록 기록은 git 시각만 비교하므로 '로컬에서 데이터를 먼저 봤는지'는 증명하지 못합니다. 그래서 화면 문구를 판정이 아닌 기록으로 썼고, 노란 항목은 "틀렸다"가 아니라 "확인 안 됨"이라고 밝혔습니다.
• 지금 결과 6개 모두 노란색입니다(같은 날 커밋 5, 결과 뒤 수정 1, 멘토 예시 포함). 점검 문서의 결론과 같습니다.

---

Generated by Claude Code