Spoclip Server Docs

스포클립 서버의 내부 기술 문서입니다. 서비스의 주요 기능과 동작 방식을 설명합니다.

전체 도메인 간 관계는 도메인 맵에서, 서버의 근간이 되는 영상 처리 흐름은 영상 파이프라인에서 확인할 수 있습니다.

이 문서에서 다루는 내용

멤버십 & 결제

사용자의 구독 상태와 서비스 이용 권한을 관리하는 시스템입니다.

• 패스 — FREE/PLUS 두 가지 패스 타입의 혜택, 가격 정책, PassSnapshot 불변 정책
• 구독 — PLUS 패스 구독 생명주기 (결제, 갱신, 취소, 환불), 결제 재시도 로직
• 권한 — Entitlement 기반 O(1) 권한 조회, Guard 접근 제어

재화 시스템

서비스 내 재화(캐쉬, 리워드)의 충전, 소비, 전환을 관리합니다.

• 캐쉬 — 유료 구매 가능한 프리미엄 재화, FIFO 소비, 자동 충전
• 리워드 — 활동으로 획득하는 보조 재화, 캐쉬 1:1 전환

핵심 서비스

스포클립의 주요 기능입니다.

• 예약 & 영상 — 체육관 녹화 예약, 10분 단위 영상 세그먼트, 멀티카메라, 영상 구매
• 일정 — 사용자의 녹화 참여 기록 (서비스의 Hub), 생성 경로, 소유권, 접근 상태
• 일정 공유 — 공유 링크를 통한 접근 권한 관리, 사용자 상태별 처리 흐름 (7개 케이스)
• 콕 개요 — 녹화 중 중요한 순간 마킹, 타임슬롯 기반 구조, Pass별 제한
• 포인트 적립 대상 선정 — Hamilton's Method를 활용한 공정한 포인트 배분 알고리즘
• 마이콕 — PLUS 전용 영구 클립 보관소, 배치 클립 생성 파이프라인
• 활동 보상 — 규칙 기반 보상 엔진, 콕 시청/광고 시청/운동 조건 보상

문서 업데이트

이 문서는 기능 변경 시 함께 업데이트됩니다. 문서에 대한 문의나 수정 요청은 개발팀에 전달해 주세요.