sxngt

올웨이즈 요가: 요가 스튜디오 플랫폼 백엔드

2024.12 ~ 2025.05 · Backend Lead

NestJS, TypeScript, TypeORM, PostgreSQL, Redis, Elasticsearch, AWS S3, Firebase

재직 기업의 저작권·보안 정책에 따라 코드 수준의 서술 없이 아키텍처와 규모 수준에서만 기록.

문제

  • 스튜디오·강사·시간표, 예약·결제, 출석·다이어리, 피드형 커뮤니티까지 도메인 폭이 넓은 플랫폼을 소수 인원으로 감당해야 하는 상황
  • 판단: 기능 속도보다 도메인 경계 설정을 우선

설계·구현

  • 초기의 평면적 구조를 DDD 기반 도메인 계층 구조로 리팩터링해 모듈러 아키텍처 구성
  • 15개 도메인 모듈(인증·유저·스튜디오·예약·결제·출석·피드·검색·알림 등)을 controllers/services/dtos/entities로 일관되게 계층화
  • 인증 권한 이원화: 일반 유저와 스튜디오 운영자(비즈니스 유저)를 별도 JWT 전략·가드로 분리
  • 카카오·네이버 소셜 로그인, Redis 캐시 기반 이메일·휴대폰 2단계 인증 구현
  • 예약·결제 흐름 설계: 예약 검증, 취소 후 재예약, 장바구니
  • PG(PortOne) 결제 검증을 서버사이드에서 수행해 클라이언트를 신뢰하지 않고도 결제 무결성 보장
  • 외부 서비스 통합: Elasticsearch 스튜디오 검색, AWS S3 presigned URL 이미지 업로드, Firebase FCM 푸시, 메일 발송
  • GitHub Actions 기반 자동 배포 파이프라인 구축

배운 점

  • 도메인 경계 리팩터링을 미루면 비용이 복리로 누적, 초반 구조 개편이 이후 개발 속도를 좌우
  • 결제처럼 신뢰가 걸린 흐름에서는 동작 여부와 검증 여부를 따로 판단, 서버사이드 검증을 기본값으로 적용
  • 외부 서비스 통합의 설계 초점은 실패 시나리오: 연동 하나에 장애가 나도 예약 흐름이 멈추지 않도록 경계 설정

성과

  • 5개월, 139커밋
  • 15개 도메인 모듈, 18개 컨트롤러, 약 92개 엔드포인트, 33개 엔티티, 약 1만 줄
  • 커밋 이력에 남은 확장 순서: 인증 → 커뮤니티 → 검색·캐시 → 스튜디오/강사 → 예약·결제 → 출석·활동
  • 서버사이드 결제 검증으로 결제 무결성 확보

발휘 역량

  • 넓은 도메인을 일관된 계층 모듈로 나누는 도메인 주도 설계와 리팩터링
  • 권한 이원화 인증과 서버사이드 결제 검증으로 신뢰 경계 설계
  • 검색·스토리지·푸시·메일 연동과 GitHub Actions 배포 파이프라인 구축
  • 소수 인원 환경에서 플랫폼 백엔드 전체 설계·구현 주도