MateU 멤버십 구독 및 유료 콘텐츠 관리

<aside> 🛠️

백엔드 프로젝트 상세 페이지

</aside>

Project Overview

한 줄 요약: 크리에이터 멤버십 구독·포스트 결제·콘텐츠 잠금해제·자동 갱신을 처리하는 서버리스 백엔드 API
담당 역할: 백엔드 개발 전담 — Edge Function 설계·구현, DB 트리거/크론 설계, API 명세, 운영 로그 분석
기간: 2025.12.01~ 2025.12.31 (1개월 / 4 Sprint)

| 💰 결제 정합성 100% 포인트 중복 차감 0건 달성 | 🤖 운영 자동화 (Cron/Trigger) 18개+ API & 30개+ 트리거 설계 | ✅ 시나리오 기반 QA 완료 18개 엔드포인트 전수 검토 | | --- | --- | --- |

Tech Stack

영역	기술	역할/비고
Runtime	Deno (TypeScript)	타입 안전성 + 서버리스 네이티브
Edge Functions	Supabase Edge Functions	멤버십·앨범·신고·결제·잠금 등 18개+
Database	Supabase PostgreSQL + RLS	행 수준 보안으로 데이터 격리
Cron	Supabase pg_cron	멤버십 자동 갱신 (매일 KST 01:00)
Trigger	PostgreSQL Trigger + pg_net	포인트 감사 로그, 푸시 알림, 시간 자동화
Auth	Supabase Auth (JWT)	사용자 인증 + 파트너 권한 분기
Storage	Supabase Storage	멤버십 미디어, 앨범 포스트 파일
Tools	Cursor, Postman, Git	AI 보조 개발, API 테스트, 버전관리

Mermaid Chart - Create complex, visual diagrams with text.-2026-02-27-120521.png

Key Contributions

Sprint 1: API 설계 및 인증·권한 체계 구축
- 파트너 권한 분기 — partner_status=approved 체크로 미승인 파트너 멤버십 생성 차단
- JWT 인증 공통화 — getAuthUser() 공통 유틸로 모든 Function 인증 일관성 확보
Sprint 2: 핵심 엔드포인트 구현 및 비즈니스 로직 완성 ****
- 결제 멱등성 보장 — post-purchase: 중복 구매 여부 사전 체크 → 포인트 이중 차감 0건
- 권한별 콘텐츠 노출 — album-posts: 소유자·구독자·단건구매·비구독자별 썸네일 URL 분기
- 구독 라이프사이클 — membership-subscriptions: 가입·조회·취소 및 포인트 자동 차감
- 신고 처리 자동화 — post-reports: 관리자 신고 시 Storage 파일 자동 삭제 연동
Sprint 3: 운영 자동화 및 안정성 강화
- 무인 멤버십 갱신 — cron-membership-renewal: 매일 만료 예정 구독 자동 연장·실패 처리
- 갱신 알림 체계 — expiry·renewal_failed·renewed 3종 알림 + 사용자 dismiss 처리
- DB 트리거 30개+ — 포인트 감사 로그, 푸시 알림(pg_net), 시간 자동 갱신 일관성 확보
- 에러 격리 — 트리거 EXCEPTION 블록으로 알림 실패가 메인 트랜잭션에 영향 없게 처리
Sprint 4: 품질 강화 및 예외 시나리오 전수 검토
- Postman 시나리오 테스트 자동화: 포인트 부족, 구독 만료 직전 접근, 중복 신고 등 50여 개의 엣지 케이스를 시나리오로 구성하여 전수 테스트 수행.
- 로그 가시성 확보: Supabase 로그 캡처가 제한적인 환경에서도 문제를 추적할 수 있도록, 구조화된 로그(Structured Logging) 패턴을 도입하여 에러 발생 시 원인을 즉시 파악 가능하게 설계.
- DB 제약 조건을 통한 2차 방어선: 코드 레벨의 방어 로직 외에도 DB UNIQUE 제약 조건 등을 추가하여 데이터 무결성을 이중으로 보장.

AI-Driven Development (Cursor)

Cursor 활용 작업

작업 유형	세부 내용
반복 로직 생성	Edge Function 기본 골격, CORS 헤더, 에러 핸들링 패턴
타입 정의	TypeScript 인터페이스, Supabase 응답 타입 추론
SQL 트리거	pg_net HTTP 호출 트리거, 감사 로그 트리거 초안
테스트 시나리오	Postman 엣지케이스 케이스 목록 초안 생성

검증 프로세스

Cursor로 초안 코드 생성 (Edge Function 골격, 트리거 SQL, 타입 정의)
직접 요구사항 및 엣지케이스 점검 (포인트 부족, 만료 구독, 중복 결제 시나리오)