SAG / ARCHITECTURE NOTE

외부 수집 어댑터와 fallback: 대체 응답은 언제 성공인가?

외부 서비스의 입력·오류·원문을 공통 관측으로 변환하는 경계입니다. API실패를 예시로 대체해 성공이라 표시하면 실제 수집으로 오해합니다. 호출 복구와 결과 대체는 다릅니다.

SAG 기술 편집팀 · 2026-05-26 · 수정 2026-10-06

수집 어댑터란 무엇인가?

외부 서비스의 입력·오류·원문을 공통 관측으로 변환하는 경계입니다. 이 노트는 수집 어댑터를 기능 이름보다 입력·변환·출력의 책임으로 읽습니다. 분석 결과를 신뢰하려면 어떤 자료가 들어왔고, 무엇을 확인했으며, 어디까지 결론을 낼 수 있는지 이어져야 합니다.

API실패를 예시로 대체해 성공이라 표시하면 실제 수집으로 오해합니다. 호출 복구와 결과 대체는 다릅니다.

제공자·조건·원문·유효상태를 반환하고 재시도·대체제공자·미관측을 구분합니다. 예시는 실측 저장 경로와 분리합니다.

외부 제공자 → 공통 관측 검증 → 실측·미관측

각 단계는 앞 단계의 성공을 다음 단계의 성과로 바꿔 부르지 않아야 합니다. 자료의 식별자와 기간, 검증 상태를 이어서 기록하면 누락과 오류가 생긴 위치를 찾고 다시 확인할 범위를 정할 수 있습니다.

SAG 관측은 제공자와 원문 조건을 기록합니다. 실제 호출은 운영 연결 설정이 필요하며 미연결 예시는 실측이 아닙니다.

SAG의 운영 가치는 이 관계를 페이지와 질문, 비교 결과와 개선 작업으로 연결하는 데 있습니다. 고객은 숫자만 읽는 대신 보강할 대상과 판단 근거를 함께 검토할 수 있습니다. 추가 적용이 필요한 패턴은 해당 문단의 범위를 기준으로 읽어야 합니다.

설명용 키미설정은0위가 아니라 설정부족입니다. 승인된 대체 제공자로 호출했다면 그 제공자와 원문을 새관측으로 남겨야 합니다.

위 예제는 구조와 계산을 설명하기 위한 자료이며 특정 고객사의 실측 성과가 아닙니다. 실제 보고서에는 선택한 기간·대상·관측 조건과 원문 기록이 연결돼야 같은 판단을 다시 확인할 수 있습니다.

정상 입력뿐 아니라 비어 있는 자료, 중복 자료와 조건이 다른 자료에서도 같은 의미를 유지하는지 확인하세요. 검증 항목을 작업 완료 기준에 연결하면 기능 설명과 실제 운영의 차이를 줄일 수 있습니다.

제공자 변경은 비교 조건도 바꿀 수 있습니다. 복구 성공과 동일조건은 별도로 확인해야 합니다.

외부 자료는 위 설계 주제의 배경이며 SAG의 모든 구현이나 고객 성과를 인증하는 자료가 아닙니다. 이 노트의 적용 해석과 설명용 예제는 SAG 운영 구조를 기준으로 정리했습니다. 자료 확인: 2026-10-06.