핵심 요약
- 구독 문서는 가입 단계와 운영 단계를 분리해서 읽어야 용어 충돌이 줄어들어요.
- 같은
approve,reject라는 단어도 어느 단계에서 쓰는지에 따라 의미가 달라질 수 있어요. - 새 구조에서는
subscribe/*와manage/*를 분리해 용어를 정리해요. - 이 페이지를 먼저 읽으면 구독 플로우 문서 사이를 이동할 때 상태를 덜 헷갈려요.
1라이프사이클 단계
구독 라이프사이클은 크게 다섯 덩어리로 이해하면 돼요.
| 단계 | 질문 | 주요 문서 |
|---|---|---|
| 계약 정의 | 무엇을 얼마 주기로 팔 것인가 (구독 템플릿·정책·상품·회차 가격표 설계) | /subscription/plan/contract, /subscription/overview/entities |
| 가입 신청 | 누가 구독을 시작하려 하는가 | /subscription/subscribe/purchase |
| 가입 처리 | 신청을 승인할 것인가 거절할 것인가 | /subscription/subscribe/requests#1-신청-승인, /subscription/subscribe/requests#2-신청-거절 |
| 회차 청구 | 실제로 이번 회차를 어떻게 청구하는가 | /subscription/ops/bill/cycle |
| 운영 관리 | 정지, 차단, 재활성화, 해지를 어떻게 처리하는가 | /subscription/ops/manage/activate, /subscription/ops/manage/block |
핵심은 가입 시점의 판단과 운영 시점의 판단을 같은 단어로 부르지 않는 것이에요.
예를 들어 가입 단계의 거절은 아직 계약이 살아나지 않은 상태에서 시작을 막는 행위예요. 반면 운영 단계의 차단은 이미 돌고 있는 구독을 강제로 멈추는 행위예요. 둘 다 결과적으로 서비스 이용을 막지만 맥락이 달라요.
문서를 읽을 때는 다음 순서를 기준으로 보면 돼요.
- 계약을 정의해요 (구독 템플릿·정책·상품·회차 가격표 설계).
- 고객이 구독을 신청해요.
- 가입 승인 또는 가입 거절을 처리해요.
- 활성 구독의 회차를 청구해요.
- 필요하면 운영 단계에서 재활성화하거나 강제 차단해요.
2명칭 충돌 해소표
구 문서와 새 문서를 같이 볼 때 가장 헷갈리는 표현을 아래처럼 정리해요.
| 단계 | 기존 이름 | 새 이름 | 의미 |
|---|---|---|---|
| 가입 | request-approval | subscribe/approve | 구독 신청 받기 |
| 가입 | request-reject | subscribe/reject | 구독 신청 거절 |
| 관리 | approve | manage/activate | 정지·해지된 구독 다시 켜기 |
| 관리 | reject | manage/block | 구독을 강제로 끊기 |
이 표가 중요한 이유는 단어 자체보다 시점이 다르기 때문이에요.
subscribe/approve는 아직 시작 전 단계의 승인이에요.manage/activate는 이미 존재하는 계약을 다시 살리는 동작이에요.subscribe/reject는 신청서를 반려하는 느낌이에요.manage/block은 운영 정책상 더 이상 계속하지 못하게 막는 느낌이에요.
실무에서 흔한 혼선은 다음과 같아요.
| 혼선 | 왜 생기는가 | 정리 기준 |
|---|---|---|
| approve를 전부 같은 의미로 봐요 | 가입 승인과 재활성화를 같은 단어로 써 왔다 | 가입은 subscribe, 운영은 manage로 분리해요 |
| reject와 block을 구분하지 않는다 | 둘 다 중단처럼 보여요 | 시작 전 반려는 reject, 진행 중 강제 중단은 block예요 |
| purchase와 activate를 섞는다 | 둘 다 고객이 다시 쓰는 느낌이 있어요 | purchase는 가입 진입, activate는 운영 복구다 |
3자주 묻는 용어
purchase
고객이 구독을 시작하려고 결제 또는 신청을 넣는 진입 단계예요. 아직 운영 중인 구독을 다시 켜는 의미는 아니에요.
approve
가입 단계에서는 신청을 받아들인다는 뜻이에요. 운영 단계에서 같은 단어를 쓰면 혼란이 커지므로 새 구조에서는 activate로 분리해요.
reject
가입 단계의 반려예요. 이미 진행 중인 구독을 차단하는 의미로 쓰지 않아요.
activate
정지되었거나 해지 직전 상태의 구독을 다시 활성 상태로 돌리는 운영 동작이에요.
block
운영 정책상 구독을 강제로 끊는 동작이에요. 결제 실패, 약관 위반, 관리자의 강제 중단 같은 상황에서 써요.
terminate
구독을 종료 상태로 보내요. 고객 자의 해지와 관리자 종료 모두 포함될 수 있으므로 세부 문맥을 함께 봐야 해요.
cycle
한 번의 청구 회차를 뜻해요. 계약 전체와 회차 하나를 구분하지 않으면 과금 분석이 꼬이기 쉬워요.
plan (URL 단계명)
URL 상의 /subscription/plan/*은 계약을 설계하는 단계명으로만 써요. 실체는 네 계층(구독 템플릿 · 구독 정책 · 구독 상품 · 회차 가격표)이므로 본문·라벨에서는 "플랜" 대신 각 엔티티명을 써요. 자세한 매핑은 구독 모델 구조에 있어요.
용어가 헷갈릴수록 문서 순서를 줄이는 편이 나아요. 먼저 구독 결제 연동을 읽고, 이후 각 문서로 내려가면 단계가 자연스럽게 연결돼요.