영상 단건·구독 서비스
오프라인 기반 기존 고객과 온라인 사용자가 같은 영상센터에서 콘텐츠를 구매·구독하도록, 언어·통화·국내외 PG·시청 권한을 하나의 백엔드 흐름으로 연결한 서비스입니다. 선행 플랫폼에서 검증한 주문·결제·권한 모델과 PG·Outbox 패턴을 재사용해, 기획서 수령 후 3주 내 영상센터 결제·구독 백엔드를 운영 배포했습니다.
- Company
- 한국심리교육원
- Service
- 영상센터
- Period
- 2026.06–2026.07 · 3주
- Role
- Backend Engineer
- Responsibility
- User/Admin API · DB · Async/Batch · AWS Ops
- Team
- BE 1 · FE 2 · Designer 1 · PM/Ops 1
- NestJS
- TypeScript
- PostgreSQL
- Prisma
- BullMQ
- Redis
- Outbox
- AWS
- NICEPAY · Payletter (PG)
- Claude · Codex
Project Overview
기존 오프라인·온라인 고객을 하나의 영상센터 서비스로 전환했습니다
프로젝트의 핵심 과제는 오프라인 중심으로 운영되던 고객 기반과 별도로 존재하던 온라인 이용 흐름을 하나의 영상 콘텐츠 서비스로 연결하는 것이었습니다.
외국인 사용자 비중도 있었기 때문에, 이 전환은 국내 사용자용 결제 기능을 붙이는 수준이 아니라 처음부터 글로벌 타겟을 고려한 서비스 구조로 진행했습니다.
선행 플랫폼에서 검증한 주문·결제·권한 모델과 PG·Outbox 패턴을 재사용해, 기획서 수령 후 3주 내 영상센터 결제·구독 백엔드를 운영 배포했습니다.
백엔드 전반을 맡아 사용자가 영상을 탐색하고 단건 구매 또는 월 구독으로 시청까지 이어지는 흐름을 만들었습니다. 세부 책임과 먼저 막아야 했던 제약은 아래 Ownership / Constraints에 요약하고, 구현 근거는 Implementation Timeline에서 Phase별로 풀었습니다.
Ownership
직접 담당한 범위
- 기획·운영과 상품·가격·구독 정책을 구체화하고, 프런트엔드와 Swagger/OpenAPI 기반 결제·구독 계약 공유
- 영상·구독 상품, 언어별 표시·가격 통화와 수강권·시청 권한 모델 설계
- 단건 구매와 월 구독의 주문·청구·결제·접근 권한 유스케이스 구현
- NICEPAY·Payletter 연동과 최초 결제·갱신·재시도·플랜 변경·기간말 해지·재개 구현
- PG 승인 후 내부 처리 실패를 재결제 없이 복구하는 경로와 PostgreSQL·Redis·AWS 운영 환경 구성
Constraints
먼저 해결해야 했던 제약
- 영상 1개가 콘텐츠 단위라 기존 강의/섹션 계층을 그대로 쓰면 상품·구매·시청 권한 구조가 불필요하게 복잡해졌습니다.
- 국내외 사용자가 함께 쓰므로 언어별 표시, 가격 통화, 상품 코드, 접근 권한, 결제 상태가 한 모델 안에서 섞이면 안 됐습니다.
- 단건 구매와 월 구독은 구매 이력, 청구 이력, 권한 생성·종료 기준이 서로 달라 같은 흐름으로 섞을 수 없었습니다.
- NICEPAY와 Payletter의 승인·콜백 방식은 달랐지만, 서비스 내부에서는 같은 결제 상태와 처리 기준으로 다뤄야 했습니다.
- 중복 청구와 PG 승인 후 내부 확정 실패는 사용자 재과금 없이 복구 가능한 상태로 남겨야 했습니다.
Implementation Timeline
기존 고객을 온라인 영상 결제·구독 서비스로 확장한 구현 순서입니다
오프라인 기반 고객, 기존 온라인 사용자, 해외 사용자를 함께 고려하면서 영상 모델, 언어·통화 표시, 단건 구매, 최초 구독, 갱신 복구, 변경·해지 기준으로 Phase를 나눴습니다. 필요한 Phase를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.
영상 상품·접근 정책
Project Infrastructure
프로젝트 공통 인프라는 API, Worker, DB, Redis, 외부 PG 경계로 분리했습니다
결제·구독 운영에 필요한 실행 경계와 배포 확인 지점을 별도로 정리했습니다.
다이어그램을 렌더링하는 중입니다.
- API와 갱신·Outbox Worker를 분리하고, PostgreSQL은 주문·청구·결제·권한 상태를, Redis · BullMQ는 비동기 실행과 재시도를 맡게 했습니다.
- GitHub Actions가 배포 산출물을 만들고, S3 · CodeDeploy · PM2를 거쳐 API와 Worker 프로세스를 갱신하도록 구성했습니다.
- 외부 PG 호출은 DB 트랜잭션 밖에서 수행하고, 내부 상태 확정은 짧은 트랜잭션과 Worker 재처리 경계에서 처리했습니다.
- 배포 후에는 준비 상태와 단건 결제·최초 구독·갱신 Worker의 핵심 경로를 확인 기준으로 삼았습니다.
Outcome
확인 가능한 결과
- 영상 접근 정책과 단건 수강권을 분리해 요청 시점의 시청 가능 여부를 서버에서 판단
- NICEPAY · Payletter 단건 결제와 최초 구독을 공통 주문·결제·구독 모델로 연결
- 최초 결제·갱신·플랜 변경·기간말 해지·재개의 구독 생명주기 구현
- 행 잠금·회차 선점·유일성 제약으로 같은 청구 회차의 중복 과금 방어
- PG 승인 후 내부 확정 실패를 PG 재호출 없이 복구하는 활성화·갱신 재처리 경로 구현
Limitations
한계와 미구현 범위
- 단건 전액 환불은 구현했지만, 동시 환불 선점과 PG 취소 성공 후 내부 확정 실패의 자동 복구는 추가 하드닝이 필요합니다.
- 부분 환불과 구독 환불은 구현 범위에 포함되지 않았습니다.
- 정책 모델에 차액 계산 구조는 있으나 최종 제품 정책에는 적용하지 않았습니다.
- Payletter 웹훅 유실이나 PG 승인 요청 타임아웃처럼 불확정 상태가 남는 경우에는 공급자 재전송·수동 확인이 필요하며, 자동 대사 계층은 별도 개선 후보입니다.
- PG별 운영 성공률·처리량 지표는 공개 가능한 운영 자료가 없어 정량 성과로 사용하지 않습니다.