---
type: template
domain: product
role: Data·ML
status: active
last-reviewed: 2026-07-27
---

# 추론·모델 운영

> Backend가 호출할 추론 계약과 모델 version의 배포·관측·rollback을 정의한다. 추론 interface는 API 정의서에, 운영·재학습 절차는 운영 매뉴얼·인수인계서에 들어간다 — 발주사 운영자가 개발사 없이 굴릴 수 있어야 인수인계가 끝난다.

## 추론 Interface (API 정의서 반영)

| 항목 | 계약 |
|---|---|
| 호출 방식·endpoint / batch |  |
| Input schema·최대 크기 |  |
| Output schema·score 의미 |  |
| validation 오류 |  |
| timeout·재시도·idempotency |  |
| P95 latency·memory 한계 (NFR 합의값) |  |

## Version·Artifact

| 구성 | version 규칙 | registry·경로 | 연결 관계 | 검증·서명 |
|---|---|---|---|---|
| 모델 |  |  | 데이터·코드 version |  |
| feature pipeline |  |  |  |  |
| runtime·dependency |  |  |  |  |

## 배포·Fallback

> 단계 오픈(파일럿→베타→가오픈→오픈) 일정과 정합시키고, 중단 threshold는 발주사와 사전 합의한다.

| 단계·조건 | traffic | 검증 지표 | 중단 threshold | fallback·rollback |
|---|---|---|---|---|
| shadow / canary |  |  |  |  |
| full |  |  |  |  |

## 운영 관측

| 신호 | metric·slice | threshold | 알림 Owner | 대응 runbook |
|---|---|---|---|---|
| latency·error |  |  |  |  |
| input drift |  |  |  |  |
| 성능 proxy·feedback |  |  |  |  |
| 정보 누설·abuse |  |  |  |  |

## 학습 운영 (운영 매뉴얼·인수인계서 반영)

> 오픈 이후 재학습·모델 교체가 하자보수(무상)인지 유지보수(유상)인지 경계를 종료 전에 합의한다 ([[SI 수주와 범위 관리]]).

| 항목 | 결정 |
|---|---|
| 학습 trigger·주기 |  |
| 승인·promotion gate (발주사 승인 포함 여부) |  |
| 이전 version 보존 기간 |  |
| rollback·재학습 절차 |  |

## 완료 질문

- [ ] Backend가 input·output·오류·지연 계약을 확인했는가?
- [ ] 학습과 추론 feature 변환이 동일한 code path인가?
- [ ] 낮은 신뢰도·모델 장애 시 안전한 fallback이 있는가?
- [ ] 모델·로그가 학습 데이터와 PII를 누설하지 않는가?
- [ ] 발주사 운영자가 절차서만으로 rollback·재학습을 수행할 수 있는가?