파트너 제재 가능항목 정의 통합
ADR-170 파트너 제재 가능항목 정의 통합
1. Metadata
- ADR ID: ADR-170
- Status: draft
- Date: 2026-03-09
- Owner: YSY
2. Domain Decision
- 파트너 제재 대상 행위를 항목 단위로 분류한다.
- 자동 제재와 수동 제재 조건을 분리한다.
- 제재 해제 조건은 별도 정책으로 관리한다.
3. Product Decision
- 파트너 제재 단계와 해제 조건을 정책화한다.
- 제재 사유 분류와 고지 의무를 정의한다.
- 제재 중 기능 제한 범위를 명확히 한다.
4. UX Decision
- 파트너 제재 사유/기간/제한 기능을 통지한다.
- 이의제기/복구 절차를 통지 화면에서 제공한다.
- 제재 상태에서 가능한 작업만 노출한다.
5. Tech Decision
- 제재 적용 엔진과 예외 처리 경로를 분리한다.
- 제재 해제/완화 이벤트를 추적 가능하게 구현한다.
- 수동 조치와 자동 조치를 동일 감사 포맷으로 남긴다.
6. Ops Decision
- 파트너 제재 접수/판정/통지 절차를 정의한다.
- 제재 해제 심사 및 재발 방지 조치를 운영한다.
- 제재 관련 감사 로그/증적 보존 기준을 명시한다.
7. Implementation Contract (Optional)
7.1 API Contract
- 제재 적용/해제 API는
reason_code, duration, applied_by를 필수 입력으로 받는다. - 제재 중 제한 액션은
PARTNER_SANCTION_ACTIVE로 거부한다.
7.2 Data Contract
- 제재 이력은 자동/수동 구분값과 근거 이벤트 ID를 함께 저장한다.
- 해제 이벤트는 해제 사유와 승인자 정보를 필수 저장한다.
7.3 Error/Observability Contract
- 제재 적용/완화/해제 이벤트를 동일 포맷으로 감사로그에 기록한다.
- 오판 제재 건수와 평균 해제 시간을 운영 지표로 추적한다.
7.4 Test/Acceptance Contract
- 제재 단계별 제한 기능이 정확히 적용되어야 한다.
- 해제 후 제한 기능이 즉시 복구되어야 한다.
8. Validation
Buy me a coffee