Skip to content

Public Data Lens v1.2.0-beta.3

Pre-release
Pre-release

Choose a tag to compare

@haklaekim haklaekim released this 25 Aug 10:30
3e210af

월간 변화 추적 시작 — 두 회차가 쌓여 "지난달과 무엇이 달라졌는가"에 답합니다.

⚠️ 기존 이용자: 커넥터 재연결이 필요합니다

이번 릴리스는 입력 파라미터를 추가했습니다. MCP 호스트는 연결 시점의 도구 목록을 캐시하므로, 기존 연결에는 새 파라미터가 보이지 않습니다.

기능 재연결
월간 변화 추적 (get_catalog_changes) 불필요 — 데이터만 채워졌습니다
기관 간 완전성 비교 (get_catalog_stats axis=org) 불필요 — 기본 적용으로 변경(ADR-019)
기관명 정확일치 (search_datasets orgMatch) 필요 — 신규 입력 파라미터
통계 교차 집계 명시 지정 (breakdown) 필요 — 신규 입력 파라미터

Claude는 설정 → 커넥터에서 비활성화 후 재활성화, ChatGPT는 삭제 후 재등록하면 됩니다. 월간 스냅샷 갱신은 재연결이 필요하지 않습니다.

새 기능

월간 변화 추적 (최초 생성)

기준 2026-06 → 현재 2026-07
ADDED 415 · MODIFIED 5,564 · MISSING_FROM_SNAPSHOT 361 · POSSIBLE_IDENTITY_CHANGE 2  (총 6,342)
OFFICIALLY_WITHDRAWN 0

스냅샷 부재를 폐기로 단정하지 않습니다 — 관측 사실과 판정을 구분합니다.

기관 간 비교 · 정확일치 (Issue #1 실사용 보고 반영)

  • get_catalog_stats(axis=org) — 기관별 완전성을 프로파일(FILE/API/STD)별로 분해. 전수 수집이 필요 없어졌습니다. 프로파일 간 분모가 달라 합산은 금지합니다
  • search_datasets(orgMatch=EXACT)서울특별시 8,957건(부분일치) → 3,317건(정확일치). 자치구가 걸러집니다. 0건일 때는 데이터 부재가 아니라 기관명 표기 차이임을 응답이 알립니다

웹 기계 판독 레이어 · 관측 현황 화면

JSON-LD·정적 본문·동적 llms.txt, 검색 순위 오독 방지(items[].rank·ranking.scoreDirection), 관측 현황(/observatory), 카피 전면 개정.

판정 규칙 개정 — 발행자 표기 변화를 실질 변경으로 세지 않습니다

2026-07 회차를 2026-06과 전수 대조한 결과, 변경행 17,812건 중 약 69%가 발행 과정의 표기 요동이었습니다.

  • API 유형 11,960행의 날짜가 엑셀 일련번호로 기재 (2012-12-0641249)
  • 설명 필드 줄바꿈 처리가 회차마다 전환 (0 → 5,961 → 0)

글자 하나 바뀌지 않은 행이 MODIFIED로 잡히고 있었습니다. 신설·개정 규칙:

규칙 내용
normalize-date-v1.0 엑셀 일련번호 환산. 발행자 수정본과 11,960/11,960 일치 검증
normalize-empty-v1.0 수식 오류 잔재(#NAME?·ME?)를 값 없음으로 판정
diff-v1.1 확장자는 정규 토큰, 텍스트 5필드는 공백 둔감 비교. 저장값은 원문 유지
issue-detect-v1.1 날짜·수식 오류 관찰 3종 추가 — 변환은 침묵하지 않습니다
catalog-completeness-*-v1.1 미기재 판정을 normalize-empty-v1.0에 위임
catalog-stats-breakdown-v1.0 axis=org 교차 집계 기본 적용, none 옵트아웃

스냅샷 수용 게이트 (scripts/verify_snapshot.py)

빌드 전 9개 항목을 검사하고 차단 시 종료코드 1로 멈춥니다 — 헤더·중복키·날짜 ISO·카운터 단조성·채움률 델타·어휘 집합 델타·값 회귀·수식 오류·원문 급감. monthly_update.sh에 편입돼 직전 회차와 자동 대조합니다.

실전 검증: 2026-07 초판 차단 2건, 수정본 수용 가능, 2026-08 API 합성본 차단 12건.

알려진 사항 (발행자 측)

  • 서술형 필드 74건의 원문 소실-로 시작하는 셀이 스프레드시트에서 수식으로 해석된 결과. null + EXCEL_FORMULA_ERROR_ARTIFACT 관찰로 처리, 복원 요청 중
  • 2026-07 말 등록분 27건 누락, 파일명 기준일과 수정일 범위 불일치(2,148건) — 확인 요청 중

버전 구분

버전
서비스 v1.2.0-beta.3
MCP 계약 v1.8.0 (SCHEMA_VERSION 불변)
카탈로그 스냅샷 2026-07
판정 규칙 31종

검증

CI 통과(서버·웹·compose), 전체 스위트 179 passed, 계약 스펙 라이브 검증 9종 통과. 배포 후 운영 서버 실측이 빌드 기대치와 전 항목 일치.

사용

https://service.datahub.kr/projects/public-data-lens/mcp

Claude → 설정 → 커넥터 → 커스텀 커넥터 추가. 기존 이용자는 위 재연결 안내를 확인하세요.

관련 ADR: 016 수용 게이트·diff-v1.1 · 017 Issue #1 반영 · 018 수식 오류 판정 · 019 교차 집계 기본 적용과 클라이언트 캐시