데이터가 모이는 구조

## 이 문서에서 얻는 것 "연동은 했는데 숫자가 왜 지금 이 값인가"를 스스로 설명할 수 있게 되는 것이 목표입니다. 수집 시각, 캐시 동작, 화면별 갱신 기준을 알면 대부분의 "데이터가 이상하다" 의문이 풀립니다. ## 전체 그림 ``` [외부 채널] [모닝인사이트] [화면] Google Ads 모닝 대시보드 Meta Ads ──▶ ① 정기 수집 (스케줄러) ──▶ 광고 · 매출 · SNS Cafe24 ② 화면 진입 시 조회 재무 · 은행 · 카드 Toss Place ③ 캐시 ──▶ AI 에이전트 은행 · 카드 능동 알림 Jira · 이메일 ``` ## 데이터는 두 가지 경로로 들어옵니다 ### ① 정기 수집 — 매일 정해진 시각 서버가 백그라운드로 채널을 돌며 데이터를 모아 둡니다. | 시각 | 하는 일 | |---|---| | 05:00 | 업무 도구(Jira·Confluence) 활동 수집 | | **06:00** | **쇼핑몰 · SNS · 광고 · 은행/카드 데이터 일괄 동기화** | | 07:30 | 데일리 브리핑 발송 | | 매시 정각 | 능동 알림 — 지표 이상 여부 점검 | | 매주 월 08:00 | 주간 성과 리포트 | | 매월 1일 08:00 | 월간 종합 리포트 | 아침에 접속하면 이미 채워져 있는 이유가 06:00 동기화입니다. 브리핑을 받는 시간은 설정에서 조정할 수 있습니다. ### ② 화면 진입 시 조회 화면을 열면 그 시점에 채널 API 를 직접 호출해 최신값을 가져오기도 합니다. 정기 수집 이후에 발생한 매출·클릭이 반영되는 경로입니다. ## 캐시와 3단 폴백 외부 API 는 느리고, 가끔 죽고, 호출 한도가 있습니다. 그래서 화면은 아래 순서로 데이터를 찾습니다. 1. **캐시** — 최근에 수집해 둔 값이 있으면 그것을 먼저 씁니다 (빠름) 2. **실시간 호출** — 캐시가 없으면 채널 API 를 직접 부릅니다 3. **오래된 캐시** — 실시간 호출까지 실패하면 **지난번 값이라도** 보여줍니다 3번이 동작하면 화면이 텅 비는 대신 **약간 오래된 숫자**가 보입니다. "어제와 값이 똑같다"면 이 경우일 수 있으니 채널 연동 상태를 확인하세요. ## 비교 기준 — 7일 평균 지표 옆의 증감 표시는 **직전 7일 평균과의 차이**입니다. - 어제 하루만 비교하면 요일 효과(월요일·주말)에 흔들립니다 - 7일 평균과 비교하면 "평소와 다른가"를 볼 수 있습니다 - 따라서 **데이터가 7일 이상 쌓인 뒤부터** 증감 표시가 의미를 갖습니다 ## 미연동 채널은 비워 둡니다 연동하지 않은 채널은 **가짜 데이터로 채우지 않습니다.** 해당 지표는 `미연동` 으로 표시되며, 합계에도 포함되지 않습니다. 숫자가 비어 있다면 두 가지 중 하나입니다. - 아직 연동하지 않았다 → [연동 화면 사용법](/news/guide/integration-howto) - 연동은 했지만 수집이 안 된다 → [데이터가 보이지 않을 때](/news/guide/trouble-data) ## 채널별 반영 시점의 차이 | 채널 유형 | 반영 특징 | |---|---| | 광고 (Google · Meta · 네이버) | 플랫폼 자체 집계가 몇 시간~1일 지연됩니다. 당일 광고비는 확정값이 아닙니다 | | 쇼핑몰 · POS | 주문 발생 후 비교적 빠르게 반영됩니다 | | SNS | 조회수·인사이트 지표는 플랫폼 집계 주기를 따릅니다 (당일치는 불완전) | | 은행 · 법인카드 | 승인·매입 시점 차이가 있어 카드 사용액은 며칠 뒤 확정됩니다 | | 재무제표 | 업로드한 파일 기준. 자동 수집이 아닙니다 | > 어제까지의 값이 오늘 다시 바뀌는 것은 정상입니다. 광고·카드는 사후 확정되는 데이터입니다. ## AI 에이전트가 보는 데이터 AI 에이전트는 화면과 **같은 데이터**를 조회합니다. 별도 데이터베이스가 아니라, 화면이 쓰는 것과 동일한 경로로 지표를 읽습니다. - 따라서 화면에 없는 데이터는 에이전트도 답하지 못합니다 - 질문한 사람의 **역할 권한도 함께 적용**됩니다. 권한 없는 영역은 조회되지 않습니다 ## 관련 문서 - [화면 구조 둘러보기](/news/guide/screen-tour) - [연동 상태 · 재인증 · 토큰 만료](/news/guide/integration-refresh)