---
type: template
domain: product
role: Tech Lead·아키텍처
status: active
last-reviewed: 2026-07-27
---

# 통합·리뷰·롤백 계획

> 역할별 결과를 계약 기준으로 통합하고, 위험별 독립 리뷰와 이관·복구 절차를 착수 전에 정한다. 통합·리뷰의 증거는 그대로 **테스트결과서**의 입력이 되고, 이관 절차는 **이관·검수확인서** 단계의 실행 계획이다 — 검수 서명과 잔금의 근거를 여기서 만든다 ([[외주 개발 산출물]]).

## 통합 순서

| 단계 | 입력 Result Card·변경물 | 확인 계약 | 통합 명령·환경 | PASS | 실패 시 Owner |
|---:|---|---|---|---|---|
| 1 | `{database/backend 등}` | `{schema/API}` | `{명령}` | `{조건}` | `{역할}` |

## 계약 정합성

| 확인 | 생산자 | 소비자 | 대조 항목 | 검증법 | 결과·증거 |
|---|---|---|---|---|---|
| Frontend↔Backend | `backend` | `frontend` | endpoint·payload·error | `{contract/E2E}` | `{값}` |
| Backend↔Database | `database` | `backend` | 컬럼·제약·migration | `{integration}` | `{값}` |
| 시스템↔발주사 연동 | `{연동 담당}` | `{발주사 시스템}` | 인터페이스 사양·실데이터 | `{연동 테스트 — 발주사 환경·계정 필요}` | `{값}` |
| PM↔전체 | `PM` | `specialists` | 요구 누락·범위 일탈 | `{RTM 대조}` | `{값}` |

> RTM 대조가 통합의 최종 관문이다 — 요구 항목마다 구현 위치·테스트 결과가 채워져야 결과보고서의 본체가 산다. 범위 일탈(계약에 없는 구현)도 여기서 걸러 CR 또는 제거로 처리한다.

## 리뷰 계획

| 리뷰 | 활성화 조건 | 독립 렌즈·대상 | 산출 경로 | 차단 기준 | 수정 Owner |
|---|---|---|---|---|---|
| Tech Lead | 항상 | 계약·누락·소유권·과설계 | `.state/dev-summary.md` | `{실제 결함}` | `{role}` |
| Security | 항상 cross-review | 실제 변경 파일 | `.state/dev/_review-security.md` | `FAIL` | `{role}` |
| 3+1 적대 검증 | 인증·권한·결제·암호화·PII | correctness/security/reproduce/GPT | `_review-security-*.md` | `2표 이상 FAIL` | `{role}` |
| Design | Frontend 참여 | handoff·실제 UI | `.state/design-review.md` | `FAIL` | `frontend` |
| QA·Judge | 구현·리뷰 후 | 원본 요구+실제 변경물 | `.state/qa-verdict.md` | `FAIL/CONDITIONAL 조건` | `{role}` |

## 이관·배포·마이그레이션

| 단계 | 명령·행동 | 사전 조건 | 관측 | 승인자 | 중단 기준 |
|---|---|---|---|---|---|
| `{preflight}` | `{명령}` | `{backup·env·QA}` | `{신호}` | `{사람}` | `{조건}` |
| `{운영 이관/deploy}` | `{행동}` | `{발주사 승인·이관 절차 준수}` | `{신호}` | `{발주사+수행사}` | `{조건}` |
| `{안정화 관찰}` | `{핵심 경로}` | `{이관 완료}` | `{에러율·p95·비용}` | `{사람}` | `{조건}` |

> 운영 반영은 발주사 인프라·승인 절차 안에서 실행된다 — 수행사 단독 배포 권한이 없는 환경이 기본값이다. 단계 오픈(파일럿→베타→가오픈→오픈)이면 단계별 진입 조건을 여기 적는다.

## 롤백 계획

| Trigger ID | 신호·임계값 | 코드 롤백 | 스키마·데이터 복구 | 트래픽·기능 플래그 | 검증 | 결정자 |
|---|---|---|---|---|---|---|
| `RB-01` | `{수치·사건}` | `{명령·버전}` | `{backward/restore}` | `{행동}` | `{health·use case}` | `{발주사·수행사 합의 창구}` |

> 어느 버전이 검수본인지 형상관리로 고정한다 — 롤백 후 "검수받은 버전이 뭐였나"가 불명이면 분쟁이다.

## 재디스패치·에스컬레이션

| 회차 | 발견 근거 | 대상 역할 | 수정 지시·완료 조건 | 결과 |
|---:|---|---|---|---|
| 1 | `{파일:라인·재현}` | `{role}` | `{구체적 지시}` | `{PASS/FAIL}` |
| 2 | `{값}` | `{role}` | `{값}` | `{값}` |

- 2회 후 남은 이슈: `{목록}`
- 사람 선택지: `직접 수정 / 위험 승인 후 진행(발주사 고지) / 추가 1회`
- 결정자·일시: `{값}`

## 완료·인계

- 통합 결과·실제 변경 파일: `{dev-summary·commit — 검수본 버전 태그}`
- 테스트결과서 반영 상태: `{케이스별 PASS/FAIL·결함 조치 이력}`
- 미해결·후속: `{없음 또는 Owner·기한 — 검수 조건부 항목이면 발주사 합의 기록}`
- 이관·롤백 Owner: `{수행사·발주사 각각}`
- Release·QA가 실행할 다음 행동: `{한 문장}`