이찬양Backend Engineer

언어

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

콘텐츠 커머스 백엔드

LiveGlobal

교육 콘텐츠·커뮤니티 서비스

영상 강의 구매, 커뮤니티 소액 보상, 오프라인 패키지 결제 기반 포인트 지급을 하나의 교육 서비스 백엔드로 연결하고, 언어·국가·통화 기준까지 모델에 반영했습니다.

Company
한국심리교육원
Service
굿바이블루
Period
2025.09–2026.05 · 9개월
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
  • AWS
  • NICEPAY · PayPal (PG)
  • Claude · Codex

Project Overview

분산 운영되던 콘텐츠·회원 활동을 하나의 교육 서비스 백엔드로 통합했습니다

초기 과제는 흩어져 있던 영상·리뷰·회원 데이터를 한 서비스로 모으고, 강의 탐색·구매·수강권 발급과 커뮤니티 참여가 같은 사용자 흐름에서 이어지게 만드는 것이었습니다.

프로젝트가 진행되면서 이 흐름은 결제·환불, 포인트 회계, 추천·티어, 이벤트·알림, 운영 인프라까지 확장됐습니다. 그래서 단일 기능 추가가 아니라 콘텐츠, 권한, 주문, 보상, 알림의 책임과 상태 기준을 다시 나누는 백엔드 통합 작업으로 다뤘습니다.

커뮤니티 활동은 소액 포인트 수급 채널이고, 오프라인 패키지 결제 기반 운영 지급은 고액 포인트가 발생하는 주요 경로였습니다. 두 흐름을 별도 로직으로 흩뜨리지 않고 지급·사용·환불 이력이 같은 기준으로 남도록 정산 구조를 통합했습니다.

백엔드 전반을 맡아 회원 가입·이메일 인증·소셜 계정 연동·약관 동의·강의·수강권·커뮤니티·결제·보상·알림·정산, 운영자용 관리 API의 경계를 설계·구현했고, 구매와 활동에서 발생한 이벤트가 운영 정책과 포인트 회계로 이어지되 실패 이후에도 재처리 가능한 구조를 만들었습니다.

Ownership

직접 담당한 범위

  • 기획·운영과 포인트·추천·티어·환불 정책을 구체화하고, 프런트엔드와 Swagger/OpenAPI 기반 API 계약 공유
  • 통합 회원·이메일/소셜 인증·약관 동의와 사용자/관리자 접근 경계, 운영자용 관리 API 구현
  • 강의 탐색·구매·수강권·커뮤니티와 NICEPAY 카드·가상계좌·포인트 결제·환불 흐름 구현
  • 게시글·댓글 소액 보상과 오프라인 패키지 결제 기반 고액 포인트 지급을 하나의 정산 구조로 통합하고, 지급·사용·환불 이력 관리
  • 언어·국가·통화 정책 모델과 PostgreSQL·Redis·AWS 배포·운영 환경 구축

Constraints

먼저 해결해야 했던 제약

  • 기존 회원을 통합하면서 이메일·소셜 인증, 서비스별 접근, 약관 동의를 분리하고 관리자 승인·역할 경계도 별도로 유지해야 했습니다.
  • 커뮤니티 활동 보상과 운영자 지급 포인트는 발생 근거와 금액 규모가 달라 지급 예정, 확정된 변경 이력, 현재 잔액을 분리해야 했습니다.
  • 이벤트·배치가 재실행되거나 적립·사용·환불이 겹쳐도 중복 반영과 원장·잔액 불일치가 없어야 했습니다.
  • 보상·티어·추천·카탈로그·언어·국가·통화 정책은 서로 다른 주기로 바뀌어 변경 이력과 거래 당시 기준을 보존해야 했습니다.
  • 결제·알림 같은 외부 연동이 실패해도 이미 확정된 금전 기록은 유지하고, 실패한 후속 처리만 다시 실행할 수 있어야 했습니다.

Implementation Timeline

영상 강의와 커뮤니티 요구가 결제·보상·운영 구조로 확장된 순서입니다

강의 구매와 커뮤니티 참여가 만든 요구를 설계·아키텍처 문서와 회고 기준으로 Phase별로 정리했습니다. 필요한 Phase를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.

Phase 01 · 회원·인증

회원·인증

Phase 01

분산된 회원 데이터를 인증·동의·서비스 접근 기준으로 통합했습니다

회원 데이터 통합은 단순히 사용자 테이블을 하나로 합치는 일이 아니라, 이메일 인증, 로컬·소셜 로그인, 서비스별 가입 상태, 약관·선택 동의, 토큰 갱신 전략을 같은 사용자 식별 흐름 안에서 맞추는 작업이었습니다. 이후 강의 구매, 커뮤니티 활동, 추천 보상, 알림은 모두 이 식별 기준 위에서 동작해야 했기 때문에 “누가 어떤 서비스에서 어떤 동의와 인증 상태로 활동하는가”를 먼저 고정했습니다.

  • 이메일 가입은 인증 완료 토큰을 먼저 확인하고, 소셜 가입은 OAuth identity와 인증 완료 토큰을 가입 트랜잭션 안에서 보강했습니다.
  • 필수 약관은 버전 ID 기준으로 검증하고, 선택 동의는 목적 ID 기준으로 저장해 약관 문구 변경과 가입 이력을 분리했습니다.
  • 회원 본체와 인증 수단, 서비스별 계정을 분리해 같은 사용자가 여러 로그인 방식과 서비스 접근 상태를 가질 수 있게 했습니다.
  • Refresh token은 원문을 저장하지 않고 hash만 보관하며, 재발급 시 새 token과 hash로 교체했습니다.
회원 가입·인증·동의 경계Mermaid

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

  1. 01

    요구 분석

    기존 회원을 통합 서비스 사용자로 전환하면서, 가입 가능 여부와 로그인 가능 여부를 같은 조건으로 보지 않도록 나눴습니다.

    • 이메일 인증 시도와 메일 발송은 실패·만료·재요청이 가능한 별도 상태이고, 회원 생성은 한 번만 확정되어야 했습니다.
    • 소셜 로그인은 이미 연결된 계정, 같은 이메일을 가진 기존 회원, 새 소셜 가입 사용자를 구분해 중복 회원과 이력 분리를 막아야 했습니다.
    • 한 사용자가 여러 서비스 맥락에서 들어올 수 있어 회원 본체, 가입 출처·전환 상태, 서비스별 계정 모델의 책임을 분리해야 했습니다.
    • 약관과 마케팅 선택 동의는 현재 문구가 아니라 가입 시점의 버전, 동의 여부, 채널, 권역, 요청 맥락을 남겨야 했습니다.
    • Refresh token은 단순 재발급이 아니라 저장된 해시와 비교하고 새 토큰으로 교체하는 회전 전략이 필요했습니다.
    • 관리자 계정은 같은 인증 메커니즘을 쓰더라도 승인 상태와 역할 권한이 있어 사용자 계정과 생명주기를 섞을 수 없었습니다.
  2. 02

    도메인 모델링

    회원 본체, 인증 수단, 서비스별 계정, 약관 동의, 선택 동의를 가입 흐름 안에서 각기 다른 책임으로 나눴습니다.

    • 회원 본체는 이메일, 프로필, 가입 출처, 기본 언어를 보존하고, 인증 수단은 이메일·소셜 provider와 활성 상태로 분리했습니다.
    • 인증 수단 모델은 이메일 인증과 OAuth provider를 같은 사용자 아래의 별도 연결 정보로 두고, provider별 활성 상태와 식별자를 분리했습니다.
    • 서비스별 계정 모델은 서비스 코드, 활성 상태, 가입 당시 인증 수단을 남겨 자격 증명 검증과 서비스 접근 가능 여부를 분리했습니다.
    • 약관 동의는 필수 약관 버전 기준으로, 선택 동의는 목적 기준으로 검증하고 가입 시점의 요청 맥락을 함께 남겼습니다.
  3. 03

    아키텍처 결정

    가입 전 검증은 트랜잭션 밖에서 끝내고, 회원·identity·서비스 계정·동의 이력은 하나의 가입 확정 단위로 묶었습니다.

    • 이메일 인증 토큰 타입, 이메일·닉네임 중복, 필수 약관 버전, 선택 동의 목적을 먼저 확인했습니다.
    • 가입 트랜잭션 안에서는 회원 생성, 이메일 identity 생성, 소셜 가입 시 OAuth identity와 verified signup token 보강, 서비스 계정, 약관·동의를 함께 확정했습니다.
    • 소셜 로그인은 연결된 identity가 없고 같은 이메일 사용자가 있으면 바로 계정 생성하지 않고 LINK_REQUIRED 상태와 link token으로 분기한 뒤, 명시적 연동 후에만 소셜 identity를 추가했습니다.
    • 사용자와 관리자는 JWT·Guard 메커니즘을 공유하되 actor, 시크릿, repository, 관리자 승인 상태와 role guard를 분리했습니다.
    • 로그인 응답은 서비스 접근 가능 여부와 이메일 인증 완료 여부를 통과한 뒤 access token, refresh token, 프로필 응답을 만들었습니다.
    • Access token은 Bearer 헤더에서 actor별로 검증하고, refresh token은 쿠키 또는 전용 헤더에서 받아 token type·actor별 서명·저장된 hash를 확인한 뒤 새 token과 hash로 회전했습니다.
  4. 04

    구현·검증

    가입·로그인·소셜 로그인·소셜 연동·이메일 인증·refresh token 경로를 각각 다른 실패 상태로 두고, 사용자에게는 필요한 다음 행동만 반환하도록 구현했습니다.

    • 이메일 인증 토큰은 가입, 비밀번호 재설정, 소셜 연동처럼 용도가 다른 흐름을 타입으로 구분했습니다.
    • 인증 수단은 provider별 identity로 분리해 이메일 가입, 소셜 가입, 기존 계정 소셜 연동이 같은 사용자 식별 기준을 공유하게 했습니다.
    • 서비스별 계정 상태를 별도로 확인해 로그인 자격 증명은 맞지만 해당 서비스 접근은 불가능한 케이스를 구분했습니다.
    • 로그인 실패는 사용자 없음, 소셜 전용 계정, 비밀번호 불일치, 이메일 미인증처럼 다음 조치가 다른 케이스로 나눴습니다.
    • 소셜 연동은 link token 만료, 기존 이메일 masking, provider 활성 상태, identity 중복을 확인한 뒤 기존 계정과 소셜 provider를 묶었습니다.
  5. 05

    운영·복구

    회원 문의나 로그인 장애는 인증 토큰, identity, 서비스별 계정, 약관 동의, refresh token hash를 순서대로 확인할 수 있게 했습니다.

    • 가입 실패는 이메일 인증 여부, 중복 이메일·닉네임, 필수 약관 동의, 서비스별 계정 생성 여부 순서로 좁혀 볼 수 있습니다.
    • 로그인 실패는 identity 연결 여부, 서비스 접근 가능 여부, 이메일 인증 완료 여부를 분리해 확인합니다.
    • 소셜 로그인 실패는 연결된 identity 없음, 같은 이메일 기존 회원 존재, link token 만료를 서로 다른 운영 상태로 봅니다.
    • 관리자 인증 장애는 actor, 승인 상태, 역할 권한, refresh token hash를 사용자 인증과 분리해 확인합니다.
    • 토큰 갱신 실패는 token type, actor별 signature, 저장된 hash 불일치, 사용자 상태를 분리해 확인합니다.

Project Infrastructure

단일 EC2·공용 ALB에서 전용 ALB·ASG 운영 구조로 전환했습니다

공용 ALB·단일 EC2·SSH 배포를 전용 ALB·ASG·CodeDeploy 구조로 전환하고, 교체·검증·복구 기준을 분리했습니다.

  • Outbox와 NotificationDelivery 상태로 어떤 작업이 확정됐고 어디서 멈췄는지 판단했습니다.
  • DEAD, FAILED, 멈춤 상태는 전체 재실행이 아니라 타입·원인·멱등 기준별 재처리 대상으로 분리했습니다.
  • 큐 백로그, 외부 공급자 장애, FCM 장애는 도메인 트랜잭션 실패와 다른 운영 진단 기준으로 봤습니다.
  • 접근할 수 없는 응답 지연 p95, 오류율, 가동 시간은 성과 수치로 쓰지 않고, 상태·로그·운영 문서 근거만 남겼습니다.
전환 과정

공용 ALB·단일 EC2 → CodeDeploy → 전용 ALB·ASG

먼저 SSH 배포 흐름을 CodeDeploy 배포 파이프라인으로 옮기고, 이후 서비스 전용 ALB와 ASG 기준으로 실행·교체·검증 단위를 정리했습니다.

단계를 선택하면 오른쪽 설명과 아래 인프라 구조가 함께 바뀝니다.

시작점

공용 ALB·단일 EC2·SSH 배포

전환 전에는 공용 ALB에서 Host Header로 서비스를 나누고, 단일 EC2에 SSH 기반으로 배포하는 흐름이 남아 있었습니다.

  • 공용 ALB Host Header 룰에 여러 서비스가 함께 묶여 서비스 간 결합도가 높음
  • 단일 EC2 장애 시 자동 교체가 되지 않아 수동 복구가 필요
  • SSH 배포 흐름이 남아 있어 배포 대상과 실행 결과 추적이 제한적
  • 인스턴스 내부 직접 변경은 교체 시 소실될 수 있어 변경 기준 정리가 필요
시작점 인프라 구조Mermaid

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

Outcome & Review

운영 가능한 정합성 구조와 남은 위험을 함께 정리했습니다

  • 2026.04–07 4개월간 매달 정산 결과를 직접 보고·확인하면서 중복 지급·원장-잔액 불일치·수동 보정 없이 월 정산을 마감했습니다.
  • 커뮤니티 소액 보상과 오프라인 패키지 결제 기반 포인트 지급부터 정산·사용·환불·만료까지 이어지는 흐름을 운영했고, 복구 기준은 상태·로그·운영 문서로 분리했습니다.
  • 적립·사용·환불·만료의 원인과 변경 이력을 확정 이력과 사용 출처 기준으로 추적할 수 있게 했습니다.
  • 재실행·중복 이벤트·동시 잔액 변경에 대한 방어가 서비스 코드와 DB 제약에 함께 존재합니다.
  • 도메인 이벤트와 알림 장애를 분리해 금전성 처리의 실패 범위를 줄였습니다.

Outcome

확인 가능한 결과

  • 커뮤니티 소액 보상과 오프라인 패키지 결제 기반 포인트 지급을 잇는 지급·정산·사용·환불·만료 흐름 운영
  • 조건부 선점·Wallet 행 잠금·Ledger 멱등키로 중복 지급과 잔액 불일치 방어
  • 카테고리·약관·알림·결제 통화가 언어·국가 기준을 공유하도록 모델과 서비스 경계 정리
  • 원거래 Lot 기반 포인트 사용·환불·만료 추적
  • 정책 기반 티어·추천 보상과 Outbox·알림 파이프라인 연결

Limitations

한계와 미구현 범위

  • 정확한 월 처리 레코드 수·TPS·P95 지표는 보존된 운영 자료로 검증하지 못해 공개하지 않습니다.
  • 일부 취소 API의 상태 검증은 조건부 update로 더 원자적으로 개선할 여지가 있습니다.
  • 알림 전달 등급별 retry 정책과 WebSocket 채널은 후속 확장 범위입니다.
  • 멀티 리전 라우팅과 다중 법인 포인트 플랫폼은 구현 완료 범위가 아니라 ADR과 장기 전환 전략으로만 표시합니다.