Skip to content

[정산하기2] 정산스타 적립·무료스타 교환·현금 출금 신청 PRD (Phase 4~6)

Status: Released created: March 24, 2026 3:45 PM 앱/웹/스튜디오: 앱, 웹

1. 목표 및 배경

  1. 문제: Phase 1~3을 통해 수익창출 디렉터로 승인되었지만, 실제 수익을 적립받고 사용할 수 있는 파이프라인이 없음. 승인만으로는 디렉터의 콘텐츠 제작 동기가 유지되지 않음.
  2. 아이디어: 매월 자동으로 유료스타 수익을 집계·정산하여 정산스타로 적립하고, 디렉터가 이를 무료스타 교환 또는 현금 출금 신청을 통해 실제 보상으로 전환할 수 있는 시스템 구축.
  3. 가설:
    1. 정산스타가 실제로 적립되고 수익 내역이 투명하게 제공되면, 디렉터의 에피소드 제작 빈도와 품질이 향상될 것이다.
    2. 무료스타 교환 경로를 제공하면, 디렉터가 플레이어로서도 서비스를 더 적극 이용할 것이다.
    3. 현금 출금 가능성이 디렉터 유인의 핵심 레버가 되어 외부 창작자 유입을 촉진할 것이다.
  4. 범위: 전체 정산 시스템 6개 Phase 중 Phase 4~6 (정산스타 적립 → 무료스타 교환 → 현금 출금 신청)

2. 타깃 사용자

  • (앱/웹) Phase 3에서 승인된 수익창출 디렉터
  • (어드민) 정산 결과 확인 및 출금 처리하는 운영팀

3. 핵심 기능 요구사항

Phase 4: 정산스타 적립

목적: 매월 수익창출 디렉터의 에피소드 수익을 집계하고, 비용 차감 후 55%를 정산스타로 자동 적립

정산 대상: 유료스타로만 소비된 턴만 (무료 스타, 혼합 스타 턴 제외)

  • 디렉터 본인이 사용한 유료 스타도 포함

정산 사이클:

항목내용
정산 기준일매월 25일
대상 기간전월 1일 ~ 말일
대상 범위디렉터 자격 승인일(시간 기준) 이후 발생한 수익에 한함

수익 산정 프로세스:

Step 1: 유료 턴 집계 → 매출 산출

  • 유료 턴 정의: 100% 유료 스타가 사용된 턴에 한함 (무료 스타만 사용 / 유료·무료 혼합 사용 턴은 정산 대상 제외)
  • 에피소드별로 유료 턴 집계
  • 각 턴의 매출은 결제 건별 크레딧 단가를 기반으로 계산
  • 크레딧 단가 산식:
    • 크레딧 단가 = ((건당 매출 - 부가세) - PG/앱스토어 수수료) ÷ 구매 크레딧 개수
    • 부가세: 건당 매출의 10%
    • PG 수수료: 건당 매출의 3.41% (웹 결제)
    • 앱스토어 수수료: 건당 매출의 30% (인앱 결제)
    • 결제 건 단위로 단가가 산출됨 (패키지/평균 아님)
  • 턴별 매출 = 해당 턴에서 사용된 크레딧 개수 × 사용된 크레딧의 단가
  • 에피소드 매출 = 해당 에피소드 내 유료 턴들의 매출 합산

Step 2: 제반비용 산출 (AI비용 + 인프라비용)

  • ⚠️ 부가세는 Step 1의 크레딧 단가 산식에 이미 포함되어 있어, 본 단계에서 별도 차감하지 않음
  1. AI 직접 비용 차감 (유료 스타로만 이루어진 턴의 실제 메인 모델 API 비용 및 서브 모델 API 비용 합산)
    • 환율: 정산 대상 월 동안 AI 비용에 적용된 환율 중 가장 높은 환율 적용
    • 서브 모델 중에 매턴 발생하는 상태값 모델은 메인 모델과 동일하게 처리, 요약과 선택지는 모두 비용 합산
  2. 인프라 비용 차감 (월 전체 서버비 ÷ 월 전체 턴 수 × 디렉터 에피소드 전체 턴 수) - 유/무료 턴 수 모두 해당됨

Step 3: 순수익 = 매출 - 제반비용 (음수 시 0)

  • 에피소드별 손익은 음수 포함하여 합산. 디렉터 총합이 음수인 경우 0 처리

Step 4: 정산스타 = FLOOR(순수익 × 0.55)

  • 1원 = 1정산 재화
  • 소수점 처리(FLOOR)는 최종 정산스타 산출 단계에서만 1회 적용
    • Step 1의 크레딧 단가, 턴별 매출 등 중간값은 소수점 그대로 유지
    • 디렉터 정산금 산정 신뢰도 확보 목적
  • 분배율: 0.55 (디렉터 55% / 플랫폼 45%)

Step 5: 자동 적립

  • 정산 쿼리 자동 실행 → 적립도 자동 처리

Step 6 — 운영팀 사후 확인

  • 어드민에서 정산 결과 조회 및 크로스체크
    • 수동 이체 및 오류 확인을 위해 현금 인출 신청 정보에서 주민번호 확인이 필요함

정산스타 데이터 모델:

  • 기존 유료/무료 스타와 별개로 정산스타 잔액을 관리하는 데이터 모델 구축
  • 적립/차감(무료스타 교환, 현금 출금) 히스토리 기록

디렉터 정산 내역 화면 (앱/웹)

목적: 디렉터에게 투명한 정산 내역을 제공하여 신뢰도 확보

벤치마크: 유튜브 스튜디오는 크리에이터에게 월별 수익을 분류해 보여주되, 플랫폼 몫이나 비용 차감 세부는 노출하지 않음. 치지직도 정산 금액과 지급 상태만 제공하되, 초기에 세금 공제 내역이 불투명해 불만이 있었고 이후 세액 반영 정산금을 표시하는 방식으로 개선.

노출 항목:

항목노출 여부설명
정산스타 잔액노출현재 보유 정산스타 총량
월별 정산 리스트노출정산월, 대상 기간, 총 정산 스타 양 (디렉터 몫), 적립 상태
정산 스타 사용 내역노출무료스타 교환 / 출금 신청 기록
——
무료 스타 교환 및 현금화 하는 경우 이렇게 됩니다(내역문구는 미정):
무료 스타 교환하는 경우:
• 정산 스타 사용내역: - (정산스타양) / 사유: 무료 스타로 교환
• 스타 사용내역: + (무료 스타양) / 정산 스타를 무료 스타로 교환
현금화 하는 경우:
• 정산 스타 사용내역: - (정산스타양) / 현금 전환
• 스타 사용내역: 없음
에피소드별 내역비공개에피소드명, 전체 턴 수, 유료 턴 수, 정산 스타 양 (차기 업데이트에서 공개 예정)
턴당 비용 / 간접 비용 세부비공개비용 차감 세부 내역은 노출하지 않음. 내부적으로 필요

정산 내역 UI 구성 (수익창출 전용 페이지 내):

  1. 상단 요약: 정산스타 잔액 (큰 숫자) + "무료스타로 교환" / "현금 인출 신청" CTA
  2. 월별 정산 탭: 정산월 리스트 → 탭하면 해당 월의 정산 금액 확인 (에피소드별 내역은 차기 업데이트에서 제공 예정)
  3. 사용 내역 탭: 무료스타 교환 / 출금 신청 내역 시간순 리스트

디렉터 노출 유의사항 (정산 페이지 하단 노출):

  • 스타로 교환하는 경우 무료 스타로 교환되며, 무료 스타의 사용 유효기간은 지급일로부터 30일입니다.
  • 스타 교환 및 인출 신청은 최소 금액 단위 이상인 경우에만 이용 가능합니다.
  • 만 19세 미만의 미성년자는 인출 신청 시 추가 서류가 필요합니다.
  • 크레딧의 사용 유효기간은 적립일로부터 5년이며, 유효기간이 지난 크레딧은 자동 소멸됩니다.
  • 인출 신청 후에는 신청을 취소할 수 없으며, 스타 교환 시 다시 크레딧으로 되돌릴 수 없습니다.
  • 인출 신청 시 비사업자는 3.3% 원천징수 후 지급되며, 사업자는 세금계산서 수취 후 지급됩니다.
  • 최근 3개월 간 공개 발행된 에피소드가 없을 경우 혹은 그 외 커뮤니티 가이드라인을 위반한 경우, 예고 없이 수익 창출 파트너 자격이 해제될 수 있습니다.
    • 수익 창출 파트너 자격이 해제된 월 전체의 수익은 정산되지 않으며, 이미 적립된 크레딧의 사용 유효기간은 30일로 조정됩니다.

디렉터 노출 FAQ (정산 페이지 하단 노출):

  • 정산 비율은 어떻게 되나요?

    디렉터님 에피소드에서 발생한 수익에서 AI 사용료 및 서비스 운영 비용을 차감한 금액의 55%가 크레딧으로 적립됩니다.

  • 정산 날짜는 어떻게 되나요?

    매월 25일에 전월 1일부터 말일까지 발생한 수익이 정산되어 크레딧으로 자동 적립됩니다. 예) 4월 25일에는 3월 1일~31일 수익이 정산됩니다.

  • 인출은 언제 받을 수 있나요?

    매월 말일까지 인출 신청을 하시면 익월 25일에 등록된 계좌로 입금됩니다. 예) 4월 30일까지 신청 → 5월 25일 입금

  • 이번 달에 크레딧이 적립되지 않았어요. 왜 그런가요?

    다음과 같은 경우 크레딧이 적립되지 않을 수 있습니다.

    • 해당 월에 정산 대상이 되는 유료 턴이 없는 경우
    • 수익이 발생하지 않은 경우

자격 박탈 시 FAQ (자격 해제 화면에 노출):

  • 왜 수익창출 자격이 해제됐나요?

    다음과 같은 사유로 디렉터 자격이 해제될 수 있습니다.

    • 최근 3개월 간 공개 발행된 에피소드가 없는 경우
    • 커뮤니티 가이드라인을 위반한 경우
    • 그 외 운영 정책에 따른 사유

    자세한 사유는 [1:1문의]로 문의해주세요.

  • 다시 신청할 수 있나요?

    네, [다시 신청] 버튼을 통해 재신청하실 수 있습니다. 운영팀의 검토 후 승인되면, 승인된 시점부터 새롭게 수익 창출이 가능해집니다.

  • 자격이 박탈된 달의 정산은 받을 수 있나요?

    아니요, 자격이 박탈된 월의 수익은 정산되지 않으며, 재승인 이후에도 정산 대상에 포함되지 않습니다. 예) 4월 15일에 박탈된 경우 → 4월 1일~14일에 발생한 수익도 정산되지 않으며, 5월 25일 정산 시점에 4월 정산 내역은 발생하지 않습니다.

  • 보유한 크레딧은 어떻게 되나요?

    자격 해제 시점부터 30일 이내에 무료 스타로 교환하시거나 현금으로 인출하셔야 합니다. 30일이 지나면 보유한 크레딧은 자동으로 소멸되니 주의해주세요.

  • 다시 승인되면 기존의 크레딧 유효기간이 복구되나요?

    아니요, 재승인되더라도 기존의 크레딧 유효기간은 그대로 유지됩니다. 재승인 후 새로 적립되는 크레딧에는 일반 유효기간(5년)이 적용됩니다.

정산 금액 계산을 위한 데이터 요구사항

1. 정산 계산 공식 요약

  • 유료 턴: 100% 유료 스타가 사용된 턴에 한함 (혼합 턴 제외)
  • 크레딧 단가: 결제 건별로 산출되며, 결제 채널(웹 PG 3.41% / 앱스토어 30%)에 따라 수수료율 상이
  • 소수점 처리: 버림 (FLOOR), 최종 정산스타 산출 시에만 적용 (중간값 소수점 유지)
  • 음수 처리: 에피소드별 손익은 음수 포함하여 합산. 디렉터 총합이 음수일 경우에만 0 처리
    • 예) 에피소드 A: +500, 에피소드 B: -200 → 합산 +300 → 정산 진행
    • 예) 에피소드 A: +100, 에피소드 B: -300 → 합산 -200 → 정산스타 0

이 공식을 실행하려면 아래 4가지 카테고리의 데이터가 필요:

2. 필요 데이터 카테고리

① 매출 산출에 필요한 데이터

핵심 질문: 이 디렉터의 에피소드에서 유료스타로만 소비된 턴이 몇 건이고, 원화로 얼마인가?

필요 데이터필요 이유비고
턴별 스타 소비 유형 (유료만 / 무료만 / 혼합)유료 턴만 정산 대상. 혼합 턴은 전량 무료 취급정산 대상 턴 필터링의 핵심 기준
턴별 소비 스타 수턴당 매출 산출 (소비 스타 × 원화 환산비율)모델별 고정값 (10/60/72)
결제 건별 매출(원화)크레딧 단가 산출의 기준신규: 결제 건 단위 기록 필요
결제 채널 (웹 PG / 앱스토어)수수료율 결정 (3.41% vs 30%)신규 필수 항목
결제 건별 구매 크레딧 개수크레딧 단가 산출의 분모신규 필수 항목
턴별 사용 크레딧의 결제 건 매핑매출 산정 시 어느 결제 건의 단가를 적용할지 결정신규 핵심 항목 — 크레딧 차감 순서 정책(FIFO 등) 확정 필요
턴이 발생한 에피소드에피소드 → 디렉터 매핑으로 수익 귀속 판별-
턴이 발생한 날짜/시각정산 대상 기간 필터링 + 디렉터 승인 기간 내 발생 여부 확인-
턴에 사용된 AI 모델에피소드별·모델별 비용 산출 시 필요플레이 중 모델 변경 가능

② 비용 차감에 필요한 데이터

핵심 질문: 해당 턴을 처리하는 데 실제로 얼마의 비용이 들었는가?

필요 데이터필요 이유비고
턴별 실제 AI API 호출 비용1차 비용 차감 (직접 비용)턴 발생 시점에 기록되어야 함
부가세율 (현재 10%)2차 비용 차감 (간접 비용)설정값으로 관리

③ 정산 대상 판별에 필요한 데이터

핵심 질문: 이 디렉터가 이 기간에 정산을 받을 자격이 있는가?

필요 데이터필요 이유비고
디렉터 수익창출 승인 시각승인 이후 발생한 턴만 정산 대상timestamp 단위
디렉터 자격 해제 시각해제된 월의 정산 제외 처리 + 정산스타 유효기간 단축 트리거nullable
자격 변경 이력 (해제 → 재승인)복수의 승인 기간이 있을 수 있음재승인 시 재승인 시점부터 신규 적립 재시작. 단축된 정산스타 유효기간은 별개 트랙으로 유지
정산스타 별 만료일일반 5년 / 자격 해제 시 30일 단축 트랙 구분신규: 정산스타 단위로 만료일 관리 필요
에피소드-디렉터 소유 관계턴 매출을 어느 디렉터에게 귀속시킬지 결정-

④ 정산 결과 관리에 필요한 데이터

핵심 질문: 정산 결과를 어떻게 기록하고, 사후 검증과 사용자 노출에 활용하는가?

필요 데이터필요 이유비고
월별 정산 결과 (디렉터 단위)디렉터 앱에 노출 + 어드민 사후 확인정산월, 대상 기간, 적립 정산스타, 상태
에피소드별 정산 상세어드민 크로스체크용 (디렉터에게 비공개)에피소드별 유료 턴 수, 매출, AI 비용
정산스타 잔액교환/출금 가능 여부 판단트랜잭션 기반 관리
정산스타 변동 내역 (원장)적립/교환/출금 모든 증감 추적감사 추적(audit trail)

3. 현재 확인이 필요한 항목

#항목질문우선순위
1턴별 API 비용 기록 현황현재 턴 발생 시 실제 API 호출 비용이 기록되고 있는가?🔴 필수 (없으면 데이터 수집부터 시작)
2턴별 스타 유형 구분 현황현재 턴 로그에 유료/무료/혼합 구분이 기록되고 있는가?🔴 필수 (정산 대상 판별 불가)
3디렉터 자격 이력 구조해제/재승인 이력이 현재 어떤 형태로 관리되는가?🟡 중요
4간접 비용 확장부가세 외 추가 간접 비용 항목이 예정되어 있는가?🟢 낮음 (현재 부가세만)

확인 완료 항목

항목결정
유료스타 환산비율1개 = 1원
음수 정산 처리에피소드별 음수는 합산에 포함, 디렉터 총합 음수 시 0 처리
소수점 처리버림 (FLOOR)

Phase 5: 정산스타 → 무료스타 교환

목적: 디렉터가 적립된 정산스타를 무료스타로 교환해서 서비스 내에서 사용

터치포인트: 앱/웹

교환 규칙:

항목내용
교환 비율정산스타 1 = 무료스타 1
최소 교환1,000 정산스타 이상
교환 단위1,000 이상 자유 입력
교환 시점제한 없음, 즉시 자동 처리
횟수 제한없음
비가역무료스타로 교환 후 정산스타로 재변환 불가
  • 유의사항: 무료 스타는 사용기한이 1개월임을 명시

사용자 플로우:

  1. 디렉터가 수익창출 페이지에서 정산스타 잔액 확인
  2. "무료스타로 교환" 버튼 클릭
  3. 교환할 정산스타 수량 입력 (최소 1,000)
  4. 확인 팝업: "정산스타 N개를 무료스타 N개로 교환합니다. 교환 후 되돌릴 수 없습니다."
  5. 확인 → 즉시 처리 → 정산스타 차감 + 무료스타 지급
  6. 사용 내역에 교환 기록 표시

Phase 6: 현금 출금 신청

목적: 디렉터가 정산스타를 현금으로 출금 신청 (4월 MVP에서는 신청 UI만 제공, 실제 이체는 운영팀 수동)

터치포인트: 앱/웹 (신청 UI) + 어드민 (이체 정보 확인 및 이체 완료 처리)

출금 규칙:

항목내용
최소 출금100,000 정산스타 (= ₩100,000)
신청 기한매월 말일까지
지급일익월 25일
비사업자3.3% 원천징수 후 지급
사업자세금계산서 수취 확인 후 지급
출금 취소불가 (신청 후 확정)

사용자 플로우:

  1. 디렉터가 수익창출 페이지에서 "현금 출금 신청" 버튼 클릭
  2. Phase 2 신청 시 입력한 정보 확인 — 본인 확인 절차로 이름·계좌정보(은행+계좌번호+예금주명)·주민번호를 확인 (26.04.28)
    • 출금 계좌: 은행 + 계좌번호 + 예금주명
    • 이름·주민번호 (등록된 정보 재확인)
    • 사업자 여부 (이미 등록된 정보)
  3. 출금할 정산스타 수량 입력 (최소 100,000)
  4. 출금 예상 금액 표시
    • 비사업자: 3.3% 차감 후 금액 표시
    • 사업자: 세금계산서 별도 안내
  5. 확인 팝업: "정산스타 N개를 현금 출금 신청합니다. 신청 후 취소할 수 없습니다."
  6. 확인 → 출금 신청 완료 → 상태 "출금 대기중"
  7. 사용 내역에 출금 신청 기록 표시

수동 운영 프로세스 (운영팀):

  1. 어드민에서 출금 신청 목록 확인
  2. 비사업자: 3.3% 원천징수 계산 / 사업자: 세금계산서 수취 확인
  3. 익월 25일에 직접 계좌 이체
  4. 이체 완료 후 어드민에서 상태 업데이트 → 디렉터 앱에 반영

디렉터 자격 해제 시 정산 처리

목적: 운영팀에 의해 수익창출 자격이 해제된 디렉터에 대한 정산 제외 정책 및 보유 정산스타 처리 기준 명확화

적용 대상: 운영팀의 강제 해제만 해당 (디렉터 본인의 자격 포기는 별도 정책)

  • 디렉터 자격 박탈 조건: 최근 3개월 간 공개 발행된 에피소드가 없을 경우 or 그 외 커뮤니티 가이드라인 위반
    • 회사는 다음 각 호에 해당하는 경우 디렉터 자격을 정지하거나 박탈할 수 있습니다.
      • 프론티아 커뮤니티 가이드를 중대하게 또는 반복적으로 위반한 경우
      • 허위 정보를 제출한 경우
      • 부정한 방법으로 수익을 발생시킨 경우
      • 서비스 이용약관을 위반한 경우
      • 관련 법령을 위반한 경우
      • 자격 유지 조건에 미달하는 경우

자격 해제 시 정산 대상 제외:

  • 자격 해제된 월 전체가 정산 대상에서 제외
    • 예: 4월 15일에 해제 → 4월 1일~4월 15일까지 발생한 수익도 정산 X
    • 5월 25일 정산 시점에 해당 디렉터의 4월 정산 내역은 발생하지 않음
  • 해제 이후 발생하는 모든 턴은 당연히 정산 대상에서 제외

기존 보유 정산스타 유효기간 단축:

  • 자격 해제 시점에 보유 중인 모든 정산스타의 유효기간이 30일로 자동 단축
  • 30일 내에 무료스타 교환 또는 현금 출금 신청을 하지 않은 정산스타는 자동 소멸
  • ⭐️ 재신청 / 재승인 여부와 무관하게 단축된 유효기간은 유지 (원복 없음)
    • 예: 4/15 자격 해제 → 5/15 이전에 모두 사용해야 함
    • 4/20에 재신청해서 4/25에 재승인되어도 단축된 유효기간(5/15)은 그대로 유지
    • 재승인 후 신규 적립되는 정산스타는 별개 트랙으로, 일반 유효기간(5년) 적용

자격 해제 후 화면 노출 (3단계 분기):

수익창출 페이지 진입 시 자격 해제 후 경과일에 따라 3단계로 화면이 분기됨.

① 정산 자격 상실 후 첫 진입

  • 모달 노출: "20NN년 N월부터 정산을 받을 수 없어요"
    • 본문: "20NN년 NN월 NN일에 수익 창출 파트너 자격이 해제되었어요"
    • 버튼: [닫기] / [다시 신청]
  • 모달 뒤 배경에 보유 크레딧 잔액 노출 (모달 닫으면 ②번 화면)
  • [다시 신청] 버튼 클릭 시 → 재신청 플로우로 바로 진입

② 자격 상실 → 30일 미경과

  • 상단 안내: "다시 수익 창출을 신청하시겠어요?"
  • 보조 안내: "20NN년 NN월 NN일에 수익 창출이 해제되었어요"
  • [다시 신청] 버튼 노출
  • 나의 크레딧 영역:
    • 정산스타 잔액 노출
    • [출금 신청] / [스타로 교환] 버튼 활성화 (30일 내 사용 가능)
    • ⚠️ 경고 문구: "NN일 뒤에 {디렉터명}님의 크레딧이 모두 사라져요!"
      • 일자 카운트다운 표시
  • 크레딧 내역: 과거 정산/출금/교환 내역 그대로 노출
  • FAQ / 유의사항: 기존과 동일

③ 자격 상실 → 30일 이상 경과

  • 상단 안내: "다시 수익 창출을 신청하시겠어요?"
  • 보조 안내: "20NN년 NN월 NN일에 수익 창출이 해제되었어요"
  • [다시 신청] 버튼 노출
  • 나의 크레딧 영역:
    • 정산스타 잔액: 0
    • [출금 신청] / [스타로 교환] 버튼은 노출되지만 비활성화 (잔액 0으로 사용 불가)
    • 안내 문구: "수익 창출 해제 후 30일이 지나, 크레딧이 모두 사라졌어요"
  • 크레딧 내역: 과거 정산/출금/교환 내역 그대로 노출 (히스토리 유지)
  • FAQ / 유의사항: 기존과 동일

재신청 플로우 (별도 구분)

  • 기존 Phase 1~3의 첫 신청 플로우와 화면 및 플로우 자체를 분리
  • 재신청 시 정보 입력 플로우 삭제: 이미 등록된 정보(개인정보·계좌정보 등)를 그대로 재사용하므로, 재신청 시 별도의 정보 입력 단계는 두지 않음 (26.04.28)
  • 진입 경로: 자격 상실 모달 또는 수익창출 페이지의 [다시 신청] 버튼

재신청 결과 알림:

  • 푸시 알림 발송
  • 앱 내 수익창출 페이지에서 상태 표시
구분문구
제목수익창출 재신청 결과가 나왔어요 ✅
본문지금 바로 확인해보세요.
랜딩수익창출 페이지 (director/revenue)
분석 라벨revenue_result

재승인 처리:

  • 재승인 완료 시점부터 정산 집계 재시작 (재승인 시점 이후 발생한 유료 턴부터 정산 대상)
  • 자격 해제 기간 동안 발생한 수익은 어떤 경우에도 정산되지 않음
  • 자격 해제 시점의 보유 정산스타 유효기간은 단축 상태 그대로 유지 (재승인되어도 원복 X)
  • 신규 적립되는 정산스타는 일반 유효기간(5년) 적용

내역 노출 정책:

  • 자격 해제 후에도 출금 신청 / 정산스타 사용 내역 화면 진입 가능 (보유 정산스타 사용을 위해)
  • 재승인 완료 후에도 기존 정산/출금/사용 내역 모두 그대로 유지 및 노출

어드민 기능 요구사항

정산 관리:

기능설명
정산 결과 조회월별 정산 목록, 디렉터별 정산 상세 (에피소드별 매출, 비용 차감, 정산 금액)
정산 크로스체크자동 정산 결과와 실제 데이터 비교 확인 기능

출금 관리:

기능설명
출금 신청 목록상태별 필터 (출금 대기중 / 이체 완료), 신청일 기준 정렬
출금 상세 보기디렉터 정보(이름·주민번호 포함), 출금 금액, 계좌 정보, 사업자 여부, 세금 정보 — 수동 이체/오류 대응을 위해 출금 신청 리스트·상세에서 주민번호 확인 가능해야 함 (26.04.28)
이체 완료 처리이체 완료 버튼 → 상태 업데이트 → 디렉터 앱 반영

4. 사용자 플로우

디렉터 플로우 (앱/웹)

정산스타 적립 확인:

  1. 매월 25일, 전월 수익이 자동 정산되어 정산스타 적립
  2. 수익창출 페이지 진입 → 정산스타 잔액 확인
  3. 월별 정산 탭에서 해당 월 정산 내역 확인

무료스타 교환:

  1. 수익창출 페이지 → "무료스타로 교환" 버튼 클릭
  2. 교환 수량 입력 (최소 1,000 정산스타)
  3. 확인 팝업에서 비가역성 안내 확인
  4. 확인 → 즉시 교환 처리 → 무료스타 잔액 증가

현금 출금 신청:

  1. 수익창출 페이지 → "현금 출금" 버튼 클릭
  2. 등록된 계좌 정보 확인
  3. 출금 수량 입력 (최소 100,000 정산스타)
  4. 예상 지급 금액 확인 (세금 차감 후)
  5. 확인 → 출금 신청 완료 → "출금 대기중" 상태
  6. 익월 25일 지급 후 상태 "이체 완료" 전환

운영팀 플로우 (어드민)

정산 확인:

  1. 매월 25일 자동 정산 실행 후 어드민에서 정산 결과 확인
  2. 디렉터별 정산 상세 크로스체크
  3. 이상 있을 시 수동 조정 처리

출금 처리:

  1. 어드민 → 출금 관리 메뉴 진입
  2. "출금 대기중" 필터로 미처리 목록 확인
  3. 비사업자: 원천징수 계산 / 사업자: 세금계산서 수취 확인
  4. 익월 25일 계좌 이체 실행
  5. 이체 완료 처리 → 디렉터 앱 상태 반영

5. 에러 처리 및 예외 상황

상황처리 방식
정산 대상 기간에 유료 턴이 0인 경우정산스타 0으로 적립 처리. 월별 내역에 "해당 기간 정산 대상 없음" 표시
정산스타 잔액 부족 시 교환/출금 시도버튼 비활성화 또는 입력 시 "잔액이 부족합니다" 에러 표시
최소 금액 미달 입력교환: "최소 1,000 정산스타 이상 입력해주세요" / 출금: "최소 100,000 정산스타 이상 입력해주세요"
출금 신청 후 정산스타 차감 타이밍출금 신청 즉시 정산스타 차감 (대기중에도 잔액에서 제외)
승인된 디렉터가 자격 해제된 경우이미 적립된 정산스타는 유지. 신규 적립만 중단. 기존 잔액의 교환/출금은 가능
자세한 처리 정책은 "디렉터 자격 해제 시 정산 처리" 섹션 참조 (해제 월 전체 정산 제외 + 보유 정산스타 유효기간 30일 단축)
자격 해제 후 30일 내 일부만 교환/출금한 경우사용한 만큼 차감, 잔액은 30일 시점에 자동 소멸
자격 해제 후 30일 경과 시점 정산스타 자동 소멸 처리시스템 자동 차감 + 사용 내역에 "유효기간 만료 자동 소멸" 기록
자격 해제 → 재승인 → 다시 자격 해제 케이스두 번째 해제 시점에 보유 중인 모든 정산스타(=재승인 후 신규 적립분)도 30일 단축 적용
동시 교환/출금 요청 (동시성)잔액 차감을 트랜잭션으로 처리하여 중복 차감 방지
정산 자동 실행 실패어드민에 실패 알림 → 운영팀 수동 재실행 또는 원인 확인 후 처리
출금 이체 실패 (계좌 오류 등)운영팀이 디렉터에게 개별 연락하여 계좌 정보 수정 요청. 정산스타는 차감 상태 유지
AI 비용이 매출을 초과하여 디렉터 총합이 음수인 경우정산스타 0 처리 (이월 없음). 에피소드별 음수는 합산에 포함하되, 디렉터 총합 기준으로 판단

유의사항

  • 정산스타는 유료/무료 스타와 별도로 관리되며, 기존 스타 시스템에 영향을 주지 않습니다.
  • 무료스타 교환은 즉시 처리되며 되돌릴 수 없습니다.
  • 현금 출금 신청 시 정산스타가 즉시 차감되며, 신청 취소는 불가합니다.
  • 정산 내역의 비용 차감 세부(턴당 AI 비용, 간접 비용)는 디렉터에게 공개하지 않습니다.
  • 정산 재화의 유효 기간은 지급일로부터 5년입니다. 디렉터는 5년 이내에 정산 재화를 무료 스타로 교환하거나 현금으로 출금하여 사용할 수 있습니다. 유효 기간이 지난 정산 재화는 자동 소멸되며, 사용이 불가능합니다.
  • 단, 디렉터 자격이 해제된 경우 보유 중인 정산 재화의 유효기간은 자격 해제 시점부터 30일로 자동 단축됩니다. (재승인 여부와 무관하게 원복되지 않음 — 자세한 내용은 "디렉터 자격 해제 시 정산 처리" 섹션 참조)

6. 데이터 분석

로깅 이벤트

타입이름용도파라미터비고
Eventview_settlement_page수익창출(정산) 페이지 진입정산 내역 확인 빈도 측정
Eventview_settlement_detail월별 정산 상세 내역 조회settlement_month: 'YYYY-MM'
Eventclick_exchange_free_star무료스타 교환 버튼 클릭
Eventcomplete_exchange_free_star무료스타 교환 완료amount: number교환한 정산스타 수량
Eventclick_cash_withdrawal현금 출금 버튼 클릭
Eventcomplete_cash_withdrawal현금 출금 신청 완료amount: number출금 신청한 정산스타 수량
Eventview_disqualified_modal자격 해제 첫 진입 모달 노출
Eventclick_reapply자격 해제 상태에서 [다시 신청] 버튼 클릭source: 'modal' / 'page'
Eventview_disqualified_page자격 해제 상태에서 수익창출 페이지 진입days_after_disqualified: number
Event~~expire_settlement_star~~자격 해제로 인한 정산스타 자동 소멸amount: number

User Property

이름용도
~~settlement_star_balance~~number현재 정산스타 잔액
~~total_settlement_earned~~number누적 적립 정산스타 총량
~~total_exchanged_to_free~~number누적 무료스타 교환 총량
~~total_cash_withdrawn~~number누적 현금 출금 총량

미확정 사항

항목설명결정 시점
2차 비용 차감 기준간접 비용(서버비 등) 배분 기준 미정 — 현재 부가세 10% 제외만 확정정산 쿼리 설계 전까지
수익창출 페이지 내 메뉴 구조정산 내역 / 무료스타 교환 / 현금 출금 탭 구분 등디자인 착수 시
정산 내역 노출 수준 세부에피소드별 유료 턴 수 외에 추가 지표(예: 총 턴 수 대비 유료 비율) 노출 여부디자인 착수 시
출금 계좌 정보 수정Phase 2에서 입력한 계좌 정보를 수정할 수 있는 기능 필요 여부Phase 6 개발 착수 시
스타 내역 화면 연동기존 스타 내역 화면에 정산스타 적립/교환 내역을 추가 표시할지 여부개발 착수 시
자격 해제 안내 알림 (디렉터 본인)자격 해제 시점에 디렉터에게 발송하는 안내 알림 (푸시/이메일) — 본 PRD 범위 외자격 해제 디렉터 발생 시
정산 크레딧 만료 임박 알림자격 해제 후 30일 만료 임박 시점(D-7, D-1 등) 알림 발송 — 본 PRD 범위 외자격 해제 디렉터 발생 시
재신청 플로우 상세 단계첫 신청에서 어떤 단계를 생략할지, 재확인 항목 정의재신청 플로우 디자인/개발 착수 전
크레딧 차감 순서 정책 (FIFO/LIFO)여러 결제 건으로 크레딧을 보유한 플레이어의 턴 매출 계산 시, 어느 결제 건의 크레딧 단가를 적용할지 정책 수립정산 쿼리 설계 전
재승인 거부 시 처리재신청했으나 운영팀이 거부한 경우의 화면/플로우재신청 플로우 설계 시