SAG / ARCHITECTURE NOTE
미관측과0%: null을 지키는 것이 보고서의 전문성인 이유
자료 없음과 측정된0을 구분해 보존하는 모델입니다. 미확인을0으로 채우면 고객은 자료 확보 문제를 서비스 성과 문제로 오인합니다. 차트의 자동 기본값도 같은 위험이 있습니다.
결측 의미란 무엇인가?
자료 없음과 측정된0을 구분해 보존하는 모델입니다. 이 노트는 결측 의미를 기능 이름보다 입력·변환·출력의 책임으로 읽습니다. 분석 결과를 신뢰하려면 어떤 자료가 들어왔고, 무엇을 확인했으며, 어디까지 결론을 낼 수 있는지 이어져야 합니다.
왜 이 기술이 필요한가?
미확인을0으로 채우면 고객은 자료 확보 문제를 서비스 성과 문제로 오인합니다. 차트의 자동 기본값도 같은 위험이 있습니다.
설계 원리와 데이터 흐름
실측, 무노출 확인, 실패와 미연결 상태를 나눕니다. null의 숫자 변환을 검사하고 이유와 재수집 범위를 제공합니다.
관측 상태 → 유효성 판단 → 실측·결측 분리
각 단계는 앞 단계의 성공을 다음 단계의 성과로 바꿔 부르지 않아야 합니다. 자료의 식별자와 기간, 검증 상태를 이어서 기록하면 누락과 오류가 생긴 위치를 찾고 다시 확인할 범위를 정할 수 있습니다.
SAG 아키텍처와의 연결
SAG는 미관측을0위·0%로 바꾸지 않습니다. 예시 자료도 실측 빈 월을 메우는 원장과 구분합니다.
SAG의 운영 가치는 이 관계를 페이지와 질문, 비교 결과와 개선 작업으로 연결하는 데 있습니다. 고객은 숫자만 읽는 대신 보강할 대상과 판단 근거를 함께 검토할 수 있습니다. 추가 적용이 필요한 패턴은 해당 문단의 범위를 기준으로 읽어야 합니다.
설명용 예제와 판단 기준
설명용 유효답변10개 모두 무인용이면0/10=0%입니다. 답변을 못 받았다면 분모0으로 계산하지 않고 자료 없음으로 안내합니다.
위 예제는 구조와 계산을 설명하기 위한 자료이며 특정 고객사의 실측 성과가 아닙니다. 실제 보고서에는 선택한 기간·대상·관측 조건과 원문 기록이 연결돼야 같은 판단을 다시 확인할 수 있습니다.
실무 검증 체크리스트
| 흐름 단계 | 확인할 항목 |
|---|---|
| 관측 상태 | null변환 검사 |
| 유효성 판단 | 실측0·미관측 구분 |
| 실측·결측 분리 | 제외 건수 표시 |
정상 입력뿐 아니라 비어 있는 자료, 중복 자료와 조건이 다른 자료에서도 같은 의미를 유지하는지 확인하세요. 검증 항목을 작업 완료 기준에 연결하면 기능 설명과 실제 운영의 차이를 줄일 수 있습니다.
한계와 적용 시 주의점
제외가 많으면 비교도 불안정합니다. 결측을 뺀 유리한 결과만 보여주지 않고 제외 건수와 조건을 공개해야 합니다.
연구와 공식 문서
- PostgreSQL JSON 자료형 — JSON 저장 자료형의 특성과 제약을 설명하는 공식 문서입니다.
외부 자료는 위 설계 주제의 배경이며 SAG의 모든 구현이나 고객 성과를 인증하는 자료가 아닙니다. 이 노트의 적용 해석과 설명용 예제는 SAG 운영 구조를 기준으로 정리했습니다. 자료 확인: 2026-10-06.
이어 읽기와 기능 확인
이 기술을 이어서 읽는 방법
월별 표본, 인용률 분모, 경쟁 기준점과 Goal 달성률을 구분합니다.
SAG / KNOWLEDGE LINKS
