SAG / ARCHITECTURE NOTE

요청 중복 제거: 같은 월 메뉴를 빠르게 보여주는 구조

같은 자료를 원하는 화면들이 진행 중 요청 하나를 공유하는 패턴입니다. 빠른 메뉴 전환마다 같은API를 반복하면 지연·비용이 늘고 응답 순서도 흔들립니다. 수집과 조회를 분리해야 합니다.

SAG 기술 편집팀 · 2026-04-25 · 수정 2026-10-06

요청 병합란 무엇인가?

같은 자료를 원하는 화면들이 진행 중 요청 하나를 공유하는 패턴입니다. 이 노트는 요청 병합를 기능 이름보다 입력·변환·출력의 책임으로 읽습니다. 분석 결과를 신뢰하려면 어떤 자료가 들어왔고, 무엇을 확인했으며, 어디까지 결론을 낼 수 있는지 이어져야 합니다.

빠른 메뉴 전환마다 같은API를 반복하면 지연·비용이 늘고 응답 순서도 흔들립니다. 수집과 조회를 분리해야 합니다.

완료 캐시를 먼저 보고 진행 요청은 키별로 공유합니다. 성공은 저장하고 실패는 재시도 가능한 상태로 정리합니다.

월 조회 → 진행 요청 병합 → 화면 공유

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

SAG 로더는 같은 월 진행 요청을 병합하고 짧은 메모리 캐시를 재사용합니다. 화면 이동은 재수집 실행이 아닙니다.

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

설명용 SEO와GEO가 같은 월 워크스페이스를 요청하면 결과 하나를 공유합니다. 독립 채널 자료라면 키 범위를 다르게 정해야 합니다.

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

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

키가 좁으면 다른 자료가 섞이고 넓으면 재사용이 줄어듭니다. 권한·월 경계를 먼저 정의해야 합니다.

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