교육 콘텐츠·커뮤니티 서비스
영상 강의 구매, 커뮤니티 소액 보상, 오프라인 패키지 결제 기반 포인트 지급을 하나의 교육 서비스 백엔드로 연결하고, 언어·국가·통화 기준까지 모델에 반영했습니다.
- 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를 선택하면 해당 단계에서 어떤 문제를 보고 어떤 구조와 검증 기준으로 이어졌는지 확인할 수 있습니다.
회원·인증
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 배포 흐름이 남아 있어 배포 대상과 실행 결과 추적이 제한적
- 인스턴스 내부 직접 변경은 교체 시 소실될 수 있어 변경 기준 정리가 필요
다이어그램을 렌더링하는 중입니다.
Outcome & Review
운영 가능한 정합성 구조와 남은 위험을 함께 정리했습니다
- 2026.04–07 4개월간 매달 정산 결과를 직접 보고·확인하면서 중복 지급·원장-잔액 불일치·수동 보정 없이 월 정산을 마감했습니다.
- 커뮤니티 소액 보상과 오프라인 패키지 결제 기반 포인트 지급부터 정산·사용·환불·만료까지 이어지는 흐름을 운영했고, 복구 기준은 상태·로그·운영 문서로 분리했습니다.
- 적립·사용·환불·만료의 원인과 변경 이력을 확정 이력과 사용 출처 기준으로 추적할 수 있게 했습니다.
- 재실행·중복 이벤트·동시 잔액 변경에 대한 방어가 서비스 코드와 DB 제약에 함께 존재합니다.
- 도메인 이벤트와 알림 장애를 분리해 금전성 처리의 실패 범위를 줄였습니다.
Outcome
확인 가능한 결과
- 커뮤니티 소액 보상과 오프라인 패키지 결제 기반 포인트 지급을 잇는 지급·정산·사용·환불·만료 흐름 운영
- 조건부 선점·Wallet 행 잠금·Ledger 멱등키로 중복 지급과 잔액 불일치 방어
- 카테고리·약관·알림·결제 통화가 언어·국가 기준을 공유하도록 모델과 서비스 경계 정리
- 원거래 Lot 기반 포인트 사용·환불·만료 추적
- 정책 기반 티어·추천 보상과 Outbox·알림 파이프라인 연결
Limitations
한계와 미구현 범위
- 정확한 월 처리 레코드 수·TPS·P95 지표는 보존된 운영 자료로 검증하지 못해 공개하지 않습니다.
- 일부 취소 API의 상태 검증은 조건부 update로 더 원자적으로 개선할 여지가 있습니다.
- 알림 전달 등급별 retry 정책과 WebSocket 채널은 후속 확장 범위입니다.
- 멀티 리전 라우팅과 다중 법인 포인트 플랫폼은 구현 완료 범위가 아니라 ADR과 장기 전환 전략으로만 표시합니다.