검증 가능한 샘플 데모
Integration Reliability Kit
외부 시스템 연동은 정상 건만 처리하는 것으로 끝나지 않습니다. 일부 행이 실패해도 정상 행을 보존하고, 실패 원인을 남긴 뒤 수정된 한 건만 재처리해야 합니다.
1. 최초 실행
상태: 부분 실패 · 입력 3건 중 2건 처리, 1건 실패
- 처리 합계
- 1,215,000원
- 합계 교차검증
- 통과
- 체크섬
6f7b6144
| 실패 ID | 오류 | 설명 | 재처리 |
|---|---|---|---|
| failure-2-unknown_account | UNKNOWN_ACCOUNT | 계정 코드 매핑을 확인해야 합니다. | 가능 |
2. 수정 후 수동 재처리
잘못된 계정 매핑을 수정한 한 건만 재처리했습니다. 상태는 완료, 처리 합계는 320,000원입니다.
3. 중복 입력 보호
이미 처리한 외부 ID를 다시 보냈을 때 새 레코드를 만들지 않았습니다. 중복 키 ERP:INV-001를 건너뛰었습니다.
4. POS·SCM → BI 적용 시나리오
POS 매출과 SCM 재고 이동 3건을 API 입력으로 정규화했습니다. 정상 2건은 보존하고, 매핑이 없는 SCM 1건만 실패 로그에 남긴 뒤 수정·재처리했습니다.
- 최초 정상 합계
- 3,310,000원
- 재처리 합계
- 120,000원
- 중복 보호
- 1건 건너뜀
실제 공급사 API·증분 기준·Looker Studio 스키마는 계약 전 샘플 감사가 필요합니다. 이 샘플은 운영 처리량이나 고객 성과를 증명하지 않습니다.
5. Looker Studio용 CSV 출력
처리된 2건을 Looker Studio에 바로 넣을 수 있는 CSV(헤더 고정, BOM 無, 끝 줄바꿈)로 내보냅니다. 대시보드 파이프라인은 수동 작업 없이 이 파일에서 시작합니다.
sample-output.csv다운로드
run_id,source,external_id,account,amount_krw,occurred_at sample-run-001,ERP,INV-001,매출,1200000,2026-08-28 sample-run-001,API,INV-003,지급수수료,15000,2026-08-28
6. 클라이언트용 실패 설명
기술 로그를 그대로 던지지 않습니다. 실패마다 사람이 읽을 수 있는 한 줄로 다시 씁니다 — 아래 1줄이 그 예입니다.
- failure-2-unknown_account · UNKNOWN_ACCOUNT · 계정 코드 매핑을 확인해야 합니다. (retryable)