---
type: template
domain: product
role: Backend
status: active
last-reviewed: 2026-07-27
---

# DB·외부연동 의존성

> 서버 코드가 요구하는 데이터 접근 패턴과 외부 서비스 실패 경계를 사전에 합의한다. 계약에 없는 타 시스템 연동은 대표적인 범위 밖 항목 — 요청이 오면 CR로 회부한다.

## Database 의존성

| 유스케이스 | 테이블·컬럼 | WHERE / JOIN / ORDER BY | 예상 건수 | pagination·LIMIT | transaction·lock | 필요한 변경 |
|---|---|---|---|---|---|---|
|  |  |  |  |  |  |  |

## 쿼리 위험

| 위험 | 발생 조건 | 예방·측정 | Owner | 상태 |
|---|---|---|---|---|
| N+1 |  |  |  | Open |
| full scan |  |  |  | Open |
| 장기 transaction |  |  |  | Open |
| 동시 갱신 충돌 |  |  |  | Open |

## 외부 서비스 계약

| 서비스·목적 | endpoint·SDK | 인증·secret | timeout | retry·backoff | idempotency | fallback·circuit |
|---|---|---|---|---|---|---|
|  |  |  |  |  |  |  |

## 장애·데이터 일관성

| 시나리오 | 사용자 결과 | 내부 상태 | 재처리·보상 | 알림·추적 |
|---|---|---|---|---|
| 외부 성공·내부 실패 |  |  |  |  |
| 내부 성공·외부 timeout |  |  |  |  |
| 중복 callback·webhook |  |  |  |  |

## 발주사 제공 항목·지연 기록

> 연동 테스트 계정, 접속 정보(IP·방화벽), 테스트 데이터 등 발주사 제공 항목의 미제공은 즉시 기록하고 일정 영향을 공지한다 ([[SI 수주와 범위 관리]]).

| 제공 항목 | 요청일 | 발주사 담당 | 기한 | 수령일 | 일정 영향 |
|---|---|---|---|---|---|
|  |  |  |  |  |  |

## 완료 질문

- [ ] Database 담당자가 실제 쿼리 패턴과 migration 필요를 확인했는가?
- [ ] 모든 목록 조회에 상한 또는 pagination이 있는가?
- [ ] 외부 호출에 timeout이 있고 무제한 retry가 없는가?
- [ ] secret은 코드·예시·로그에 실제 값으로 남지 않는가?
- [ ] 모든 외부 연동이 계약 범위(포함 목록)에 있는가? 아니면 CR 회부했는가?

## 승인·미결

- Database 확인자·확인일:
- 외부 서비스 Owner:
- 차단 의존성: