이찬양Backend Engineer

언어

← 프로젝트 목록으로 돌아가기

영상 결제·구독

LiveGlobal

영상 단건·구독 서비스

오프라인 기반 기존 고객과 온라인 사용자가 같은 영상센터에서 콘텐츠를 구매·구독하도록, 언어·통화·국내외 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를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.

Phase 01 · 영상 상품·접근 정책

영상 상품·접근 정책

Phase 01

영상 상품은 “판매 항목”보다 “지금 볼 수 있는가”라는 질문으로 다시 잡았습니다

영상 1개가 서비스의 콘텐츠 단위였기 때문에, 기존 강의 계층을 그대로 쓰면 상품·구매·시청 권한이 과하게 복잡해졌습니다. 영상 상품, 구독 상품, 번역 레코드, 접근 정책을 나눠 “지금 볼 수 있는가”를 요청 시점마다 판단하게 했습니다.

영상 접근 정책 관계 요약Mermaid

다이어그램을 렌더링하는 중입니다.

  1. 01

    요구 분석

    영상 1개를 콘텐츠 단위로 두고, 무료·구독·스페셜 접근 유형, 언어별 표시명, 구독 상품별 영상 길이 조건을 별도 요구로 분리했습니다.

    • 사용자 질문은 “이 상품이 어떤 등급인가”보다 “내가 지금 이 영상을 볼 수 있는가”에 가까웠습니다.
    • 같은 영상이라도 상품명·부제·설명·카테고리·키워드는 요청 언어에 따라 달라져야 했고, 접근 권한 자체는 번역 문구와 무관하게 판단되어야 했습니다.
    • 목록의 구독 안내와 실제 재생 허가는 서로 다른 요청 시점의 판단이므로 같은 응답 값을 권한 정본으로 쓰지 않게 했습니다.
  2. 02

    도메인 모델링

    공통 상품 헤더 아래 영상 상품과 구독 상품을 분리하고, 표시 텍스트는 언어별 상품·카테고리·키워드 기록이 맡게 했습니다.

    • 영상 상품은 길이·카테고리·접근 유형을 보존하고, 구독 상품은 월정액 판매 단위와 가격·청구 연결을 담당합니다.
    • 카테고리는 분류 코드를 정본으로 두고 언어별 표시명을 별도 기록으로 두어, URL·필터·배너 타깃은 안정적인 코드를 쓰고 화면은 번역 문구를 사용하게 했습니다.
    • 키워드는 표준 검색 축과 언어별 표시명·별칭을 분리해, 태그 표시와 사용자 검색어 매핑을 같은 모델에 섞지 않았습니다.
    • 구독 상품명이나 등급명을 권한 기준으로 쓰지 않고, 영상 길이 조건을 정책 룰로 평가하게 했습니다.
  3. 03

    아키텍처 결정

    정책 변경 때 사용자 구독 데이터를 대량 수정하지 않고, 목록·상세·재생 요청 시점마다 현재 활성 정책을 다시 평가하도록 했습니다.

    • 운영자가 접근 조건을 바꿔도 기존 구독 기록을 일괄 마이그레이션하지 않아도 됩니다.
    • 정책 변경의 과거 감사까지 필요하면 별도 정책 버전 또는 평가 로그가 필요하다는 트레이드오프를 남겼습니다.
  4. 04

    구현·검증

    구독 접근 평가기, 목록·상세의 사용자 상태 조립, 언어별 상품·카테고리·키워드 응답, 시청 진행 기록 전 권한 재검증 흐름을 코드와 테스트로 확인했습니다.

    • 영상 길이 조건은 재생 시간 정책값을 현재 영상 길이와 비교하는 Evaluator로 구현했습니다.
    • 상세 응답은 현재 요청 언어에 맞는 상품 텍스트, 카테고리, 키워드 표시 문구를 조립합니다.
    • 활성 접근 정책이 없는 구독 상품은 공개 이용권 목록에서 제외하고, 내부 길이 제한 값은 응답에 직접 노출하지 않았습니다.
  5. 05

    운영·복구

    접근 관련 문의는 영상 접근 유형, 활성 구독, 단건 수강권, 활성 접근 정책, 시청 진행 기록을 순서대로 확인하게 했습니다.

    • 정책 보정 커밋은 2026.07에 별도 신호로 남아 있어 요구 변경 이후 권한 판정이 다시 조정됐음을 확인할 수 있습니다.
    • 정확한 권한 판단 실패율 같은 운영 수치는 공개 가능한 원본 로그가 없어 성과 지표로 쓰지 않습니다.

Project Infrastructure

프로젝트 공통 인프라는 API, Worker, DB, Redis, 외부 PG 경계로 분리했습니다

결제·구독 운영에 필요한 실행 경계와 배포 확인 지점을 별도로 정리했습니다.

결제·구독 인프라 아키텍처Mermaid

다이어그램을 렌더링하는 중입니다.

  • 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별 운영 성공률·처리량 지표는 공개 가능한 운영 자료가 없어 정량 성과로 사용하지 않습니다.