차트 옆에 공식 자료라는 작은 배지가 붙으면 방문자는 숫자 전체를 더 신뢰할 수 있다. 실제 차트 컴포넌트에서 제목에 따라 기본 표시가 달라지는 코드를 읽고, 편리한 기본값이 판단을 대신하는 경계를 살폈다.

표시가 숫자의 출처처럼 읽히는 순간

기존 컴포넌트에는 제목의 특정 표현에 따라 시뮬레이션과 기본 공식 자료 표시를 고르는 구조가 있다. 제목은 편집자가 독자를 위해 바꾸는 문장이다. 데이터가 그대로인데 제목만 바꿔도 자료 성격이 달라질 수 있다면 두 책임이 섞인다. 나는 실제 출처가 틀렸다고 단정하기보다 이 자동 추정의 입력을 문제로 삼았다.

공식 배지는 제목이 근사하거나 그래프가 정교하다는 뜻이어서는 안 된다. 단위와 조사 범위, 확인 시점이 어떤 자료를 가리키는지 별도로 읽을 수 있어야 한다. 예시 데이터도 나쁜 자료가 아니라 다른 목적의 자료다. 이 구분을 숨기면 설명용 수치가 실제 성과처럼 보일 수 있다.

자료 성격을 필수 입력으로 두었다

새 chart 함수는 official, synthetic, unverified 중 하나를 명시하도록 한다. reference, checked와 unit도 따로 받으며 유효하지 않은 날짜를 거절한다. 공식처럼 들리는 제목이라도 synthetic을 전달하면 예시 자료로 남는다. 제목을 읽어 자동 승격하는 규칙은 없다.

이 함수가 원본 기관을 조회해 진위를 확인하는 것은 아니다. caller_declared를 남겨 누가 확인해야 할 입력인지 분명히 했다. 출처 문자열 하나가 있다는 사실과 그 출처가 실제 값·기간을 뒷받침한다는 사실도 다르다. 공유 계약은 표현의 일관성을 돕지만 근거 검토자의 일을 없애지 않는다.

확인해야 할 단위를 좁혀 갔다

합성 테스트는 공식처럼 보이는 제목과 synthetic을 함께 넣어 분류가 변하지 않는지 확인한다. 알 수 없는 분류와 존재하지 않는 날짜도 거절한다. 자료 성격을 다른 문구로 바꿔 붙이는 테마 작업을 해도 데이터 계약은 같아야 한다. 표현을 다듬는 권한이 자료의 지위를 바꾸는 권한이 되어서는 안 된다.

기존 출처 편집 글과 달리 이번 글의 범위는 차트 배지의 기본 추정이다. 실제 통계값과 최신 공식 자료를 소개하지 않고 고정된 합성 제목을 사용했다. 새로운 주장이나 광고 성과 수치를 만들지 않았으므로 외부 글을 베껴 근거인 것처럼 붙이는 방식도 쓰지 않았다.

공식이라는 한 단어를 쪼개서 검토한다

자료 성격을 명시해도 그 표지가 적용되는 범위가 차트 전체인지 특정 계열인지 물어야 한다. 이번 작은 함수는 하나의 선언을 한 차트에 연결하므로 자료 성격이 섞인 계열을 자동 처리하지 않는다. 그런 차트라면 계열별 근거를 추가하거나 분리해서 표현하는 설계가 필요하다. 한 개의 배지를 편리하게 재사용하다가 혼합 자료를 가리는 일을 피하려는 질문이다.

checked는 자료를 확인했다고 선언한 날짜이며 원본 통계의 관측 기간을 뜻하지 않는다. 기간 정보가 필요하면 별도 필드를 정의해야 한다. 날짜 하나를 적었다고 모든 시간 정보를 표현한 것은 아니다. 같은 원칙으로 unit도 실제 축과 계열의 단위가 맞는지 연결 화면에서 검사해야 한다.

표지의 색과 표현을 바꾸는 일은 이 근거 계약을 유지한 다음에 할 수 있다. 방문자가 예시를 실제 관측으로 이해하지 않게 하는 설명이 먼저다. 나는 이 순서가 디자이너와 편집자, 개발자가 같은 차트를 다룰 때 책임을 나누는 데도 유용하다고 보았다.

화면에 연결한 뒤에도 남는 질문

공유 패키지는 사용조건 일치, 사진과 주장 연결, 검토 상태를 함께 다루되 각 계약은 별도 함수다. 전체 12개 테스트가 소스와 ZIP 추출 환경에서 통과했다. 글의 예제 선택기는 실제 로컬 실행 기록을 읽으며 외부 자료를 자동 확인하지 않는다. 사람이 배지를 어떻게 이해하는지에 대한 사용성 실험도 아니다.

차트에 연결할 때는 분류만 넣고 끝내기보다 단위·기간·참고 자료와 제한이 가까운 위치에 보이는지 확인하면 좋다. 예시라면 예시라고 읽혀야 하고 확인하지 못했다면 그 상태가 남아야 한다. 나는 신뢰감을 주는 장식보다 신뢰를 판단할 재료가 있는 화면을 만들고 싶었다.

확인 기록이 오래됐다면 날짜를 새로 적는 것만으로 최신 자료가 되지 않는다. 실제 원본을 다시 확인하고 달라진 값이 있는지 검토한 뒤 표시를 갱신해야 한다. 이 함수는 그 확인을 수행했다고 대신 말하지 않는다.