ADR-P-006_파트너 상태 및 구독 연동 정책
1. 기본 정보
- ADR ID: ADR-P-006
- 제목: 파트너 상태 및 구독 연동 정책
- 상태: Accepted
- 작성일: 2026-03-08
- 작성자: YSY
- 관련 ADR: ADR-P-005, ADR-U-010, ADR-DS-000
- Supersedes: N/A
- Superseded By: N/A
2. 배경 (Context)
- 파트너 온보딩과 슬롯 발행 권한을 분리해야 한다.
- 본 서비스의 파트너 기능은 구독제(Basic/Plus, 추후 Pro)와 직접 연동된다.
- 초기 단계에서는 환불/분쟁/제재 세부 정책보다 상태 전이 시점 고정이 우선이다.
- 전화 인증은 회원가입 ADR에서 다루며, 본 ADR에서는 전제 조건으로만 취급한다.
3. 결정 (Decision)
파트너 상태를 다음 3단계로 정의한다.
partner_registered
- 파트너 등록 + 정책 동의 완료
- 슬롯 발행 불가
partner_active
- 유료 구독(Basic/Plus) 활성화 성공
- 슬롯 발행 가능
partner_suspended
- 운영 정책 위반 또는 시스템 판단으로 제한된 상태
- 슬롯 발행/운영 기능 제한
상태 전이 규칙:
user -> partner_registered
- 파트너 등록 필수 정보 입력 + 정책 동의 완료 시 전이
partner_registered -> partner_active
- 유료 구독 결제 성공 및 구독 활성화 시 전이
partner_active -> partner_registered
- 구독 해지, 만료, 결제 실패(유예 종료 포함) 시 전이
* -> partner_suspended
- 운영 정책 위반 또는 시스템 제어 필요 시 전이
- 세부 트리거는 별도 ADR에서 정의
4. 경계 및 책임 (Boundaries)
- Product Policy: 상태 정의와 전이 시점 책임
- Billing/Subscription: 구독 활성/만료 이벤트 책임
- Domain: 상태 전이에 따른 슬롯 발행 가능 여부 집행 책임
- 운영 제재 세부 룰(정량 기준)은 본 ADR 범위 밖
5. 단일 원천(SoT) 참조
- 파트너 상태/구독 연동 SoT: ADR-P-006 (본 문서)
- 지연 인증 SoT: ADR-P-005
- 파트너 콘솔 UX SoT: ADR-U-010
- 도메인 개요 SoT: ADR-DS-000
6. 대안 (Alternatives Considered)
대안 A: 2상태(registered, active)만 사용
- 장점: 단순함
- 단점: 운영 제한/제재 상태를 표현하기 어려움
- 미채택 이유:
suspended를 미리 두는 편이 확장 안전성이 높음
대안 B: 사업자등록증 인증을 필수 전이 조건으로 사용
- 장점: 형식상 추가 검증 가능
- 단점: 사용자 부담 증가 대비 실질 보안 효과 제한적
- 미채택 이유: 초기 단계에서는 전화 인증 + 유료 구독 + 시스템 제약이 더 효율적
7. 결과 (Consequences)
긍정적 결과
- 파트너 온보딩과 발행 권한 분기가 명확해진다.
- 구독 상태와 발행 권한이 일관되게 연동된다.
- 운영 제한 상태를 별도 관리할 수 있다.
부정적 결과
- 구독 이벤트 처리 누락 시 상태 불일치 리스크가 발생한다.
- 유예기간/실패 재시도 정책이 별도 정의되지 않으면 해석 차이가 생길 수 있다.
8. 영향 범위 (Impact)
- 파트너 등록/프로필 상태 모델
- 구독 결제 성공/실패 이벤트 핸들링
- 슬롯 발행 가능 여부 판단 로직
- 파트너 모드 진입 UX 분기
9. 검증 및 운영 확인 (Validation)
검증 시나리오:
- 파트너 등록 완료 시
partner_registered전이 - 구독 성공 시
partner_active전이 - 구독 만료/해지 시
partner_registered복귀 - 제재 이벤트 시
partner_suspended전이
운영 확인:
- 상태 전이 로그와 구독 이벤트 로그의 일치 여부
active상태에서만 슬롯 발행 API가 허용되는지 확인
10. 재검토 조건 (Revisit Conditions)
- 플랜 구조가 변경(Basic/Plus/Pro 정책 개편)될 때
- 유예기간/정산 정책이 제품 핵심에 포함될 때
- 운영 제재 기준을 정량화해야 할 필요가 커질 때
Buy me a coffee