Sp05 Season System Preflight — D-7 본격 착수 절차서

작성: 2026-05-02 박세린 (game-designer) version: 1.1 (D-56 시점 R-V2.3-01 PD 결정 락 흡수, v1.0 = D-57 시점 신규 작성, Sp04 preflight v1.2 패턴 답습) 대상 D-Day: 2026-06-22 (Sp05 킥오프 D-7) 본격 착수 마감: 2026-06-28 (Sp05 킥오프 D-1) 정식 킥오프: 2026-06-29 입력 자료: - designs/sprint-05-season-research.md v1.0 APPROVED (Q1~Q7 7결정 + 5+1 사이드이펙트) - sprints/sprint-05-dry-run-2026-04-21.md v1.0 (§5 ISeasonClock 시그니처 / §6 5순서 / §11 Round 정수) - designs/affix_pool_sp04_supplement_v1.md v1.3 (36어픽스 + 시즌 패스 Tier 매핑 9건) - designs/webnovel/volume_2_synopsis_v2.md v2.4 (§4.3 Tier 70 영구 보유 정정 v2.4 흡수) - 메모리 project_sprint05_season_research.md (7결정) / project_volume2_synopsis_v2_decisions.md (8결정 + v2.4 D-2.15) / project_affix_pool_supplement_5_decisions.md - sprints/shared-checkpoints.md (CP-M01~M28) 목적: Sp05 W1·W2 본격 착수 시 즉시 가동 가능한 절차서. PRINT-AND-CHECK 양식 + 회귀 가드 (R-DR-S01~S03) + 시놉 v2.4 변동 흡수 + 어픽스 v1.3 정합 + Tier 매핑 9건 + R-V2.3-01 PD 결정 락 (옵션 a 영구 보유). D-57 시점 작성 = ROI 입증 (1.5h 투자 → 2~3h 절감 + Critical 리스크 사전 방어).

0. 한 줄 맥락

Sp03 → Sp04 → Sp05 (시즌 시스템) 사이클의 D-7 본격 착수 절차서. 7결정 (60일 / Manual→Firebase / 리셋+스냅샷 / 이월3건 / Firestore / Round / Wallet 50% retain) 정식 락 후 Sp05 W1 (T1~T6 = 10h) + W2 (T7~T13 = 9h) 총 14h/2주 예산. 2026-06-22 (D-7) 시점 game-designer 가 책상에 펴 놓고 즉시 가동 가능한 절차서 + R-DR-S02 Critical (5+1 순서 위반) 가드 + 시놉 v2.4 신규 5건 흡수 (Tier 60 / Tier 75 / W7 유교 드래곤 / Tier 70 영구 보유 락) + R-V2.3-01 PD 결정 락 (2026-05-03 옵션 (a) 영구 보유 채택) — 시놉 v2.3 → v2.4 §4.3 Tier 70 정정 (시즌 1회 영구 보유, 다음 시즌엔 다른 어픽스 보상 X1 안). 박세린 비권장 안이었으나 PD 결정 존중.

1. W1 절차서 — Firebase 인프라 + 시즌 전환 Backend (T1~T6 게이트 6건)

1.1 W1 작업 표 (Sp05 dry-run §1 W1 5건 + Tier 매핑 정합 1건 추가 = 6건)

v1.0 신규: T6 = 시즌 패스 Tier 매핑 표 신설 (시놉 v2.4 §4.3 9건 매핑 + 어픽스 풀 v1.3 정합 검증). dry-run §1 5건 + T6 1건 = 11.0h. Q4 권장 14h 예산 내 (W2 T7~T13 = 4h 잔여 가능).

1.2 ISeasonClock 시그니처 (dry-run §5.1 90% 정의 그대로 + ITimeProvider 주입)

namespace GodBlade.Runtime.Season {
  public interface ISeasonClock {
    string CurrentSeasonId { get; }                     // "s1", "s2", ...
    System.DateTime GetSeasonStartUtc();
    System.DateTime GetSeasonEndUtc();
    bool IsSeasonEnded();                               // ITimeProvider.UtcNow >= GetSeasonEndUtc()
    event System.Action<string> OnSeasonRolledOver;    // Phase 5 Remote Config 이벤트 훅
  }

  // Sprint 05 W1 T1 구현
  public sealed class ManualSeasonClock : ISeasonClock {
    readonly SeasonConfigSO _config;
    readonly ITimeProvider _timeProvider;               // 결정론 주입
    public ManualSeasonClock(SeasonConfigSO config, ITimeProvider timeProvider) { ... }
    // ...
  }

  // Sprint 06+ Phase 5 이월
  public sealed class RemoteConfigSeasonClock : ISeasonClock { /* Firebase.RemoteConfig */ }
}

W1 T1 합/불합 판정:

1. ISeasonClock interface 5 멤버 모두 정의 (CurrentSeasonId / Start / End / IsEnded / OnRolledOver)
2. ManualSeasonClock 생성자 = (SeasonConfigSO, ITimeProvider) 주입 (DateTime.UtcNow 직접 호출 금지)
3. SeasonConfigSO ScriptableObject = seasonId (string) / startUtc (long unix ms) / endUtc (long unix ms) / displayName (string) 4 필드
4. IsSeasonEnded() 단위 테스트 = ITimeProvider Mock 으로 결정론 검증

1.3 ITimeProvider 주입 패턴 (Sp03 IdleTicker 시계 가드 패턴 재활용)

namespace GodBlade.Runtime.Common {
  public interface ITimeProvider {
    System.DateTime UtcNow { get; }
    long UtcNowUnixMs { get; }
  }
  public sealed class SystemTimeProvider : ITimeProvider {
    public System.DateTime UtcNow => System.DateTime.UtcNow;
    public long UtcNowUnixMs => System.DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
  }
}

왜 신설하는가: dry-run §5.1 결정론 주의 — IsSeasonEnded()는 DateTime.UtcNow 직접 비교 금지 → ITimeProvider 주입으로 테스트 가능화. Sp03 IdleTicker 가 이미 동일 패턴 사용 중일 가능성 = D-1 (2026-06-28) code-lead B1 실측으로 확인. 미적용 시 신설 +0.5h.

T1 의존: ITimeProvider 가 Sp03 에 이미 존재하면 재활용 (0h) / 미존재 시 신설 (+0.5h)

1.4 시즌 패스 30 Tier 매핑 정합 표 (T6 신규 산출, 시놉 v2.4 §4.3 9건 + Tier 60·75 신규 + Tier 70 영구 보유)

T6 합/불합 판정:

1. 9 Tier 매핑 = 시놉 v2.4 §4.3 일치 (Tier 60 / Tier 75 v2.3 신규 + Tier 70 v2.4 정정 표기 포함)
2. 어픽스 풀 정합 = G-3.1~G-3.6 6건 모두 매핑 (G-3.1 Tier 30 / G-3.2 Tier 15 / G-3.3 Tier 50 / G-3.4 Tier 70 / G-3.5 Tier 90 / G-3.6 Tier 60)
3. 글로벌 명칭 6건 락 일치 (D-A.2 / D-A.3' / G-3.6 supplement v1.3 §1.4~§1.6) + Tier 70 v2.4 영문 표기 갱신 ("1-Per-Season Permanent, Different Affix Next Season")
4. R-V2.3-01 (Tier 70 영구 보유 정책) = §4.2 PD 결정 락 표시 (2026-05-03 옵션 a 채택, X1 안 = 시즌 1회 영구 보유 + 다음 시즌 다른 어픽스 로테이션)
5. TSV 30 Tier × 6 컬럼 (tier / reward_key / reward_en / affix_id / season_only_flag / permanent_retain_flag) UTF-8 / 탭 구분. Tier 70 행: season_only_flag = false / permanent_retain_flag = true (v2.4 정정)
6. 30 Tier 중 9 정의 + 21 미정 (마케팅팀장 TBD 합류 후 결정 = Sp06+ 이월)

2. W2 절차서 — 시즌 컨텐츠 + Smoke Test (T7~T13 게이트 7건)

2.1 W2 작업 표 (Sp05 dry-run §1 W2 5건 + Tier 70 R-V2.3-01 가드 1건 + 정합 검증 1건 = 7건)

v1.1 갱신 (R-V2.3-01 PD 옵션 (a) 영구 보유 락 흡수):

• T12 = R-V2.3-01 PD 결정 옵션 (a) 영구 보유 코드 분기 = if (affixId == TIER_70_SEASON_AFFIX) Skip(retain50) 1줄 (영구 보유 + 50% retain 예외 처리). 박세린 비권장 안이었으나 PD 결정 존중.
• T13 = 5+1 사이드이펙트 통합 테스트 6건 = §2.2 표 6건 모두 Edit-mode 검증. 6번째 = "Tier 70 영구 보유 정상 동작" (시즌 종료 후 Tier 70 어픽스 인벤토리 100% 잔존 + Permanent 채널 미이동 + 다음 시즌 시작 시 보유 상태 유지). R-DR-S02 Critical 가드 직결.

W1 11h + W2 10h = 21h → Q4 권장 예산 14h 초과 7h. 완화책: T4 Firebase 통합 하드 캡 6h 적용 시 이론치 14h 가능. T6 / T12 / T13 = 신규 +2.5h 는 ROI 입증 (Critical 리스크 1건 + 시놉 v2.4 정합 1건 + 통합 테스트 1건).

2.2 MigrateSeasonalToPermanent 5+1 사이드이펙트 표 (dry-run §6 5순서 + 신규 6번째 = R-V2.3-01 PD 락)

v1.1 변경 사유 (R-V2.3-01 PD 결정 락):

• 시놉 v2.4 §4.3 Tier 70 = "9,860원의 박자 어픽스 Legendary 1회 (시즌 1회 영구 보유, 다음 시즌엔 다른 어픽스 보상)" 정정 락
• 7결정 Q7 = PlayerWalletState + 50% retain (어픽스 자체는 retain 정책 미명시)
• PD 결정 (2026-05-03): 옵션 (a) 영구 보유 채택 = Tier 70 어픽스만 50% retain 예외 처리 (Skip(retain50)) + 100% 잔존 + 다음 시즌엔 다른 Legendary 어픽스로 보상 로테이션
• 박세린 비권장 안 (b 삭제 / d MythicEssence 환원) 폐기. PD 결정 존중
• 코드 분기: T12 작업 0.5h = if (affixId == TIER_70_SEASON_AFFIX) Skip(retain50) 1줄 + 다음 시즌 Tier 70 보상 = 다른 Legendary 어픽스 ID 발급 로테이션 (시즌 패스 매력 유지 X1 안)
• 5번 → 6번 순서 변경: T12 분기는 T11 (UI 트리거) 이전 실행. UI 모달에서 Tier 70 어픽스 보유 표기를 위해 retain 처리가 선행되어야 함

2.3 Round 정수 나눗셈 + MythicEssence 음수 보호 (dry-run §11 R-DR-S03 가드)

// PlayerPrestigeState.MigrateSeasonalToPermanent(float retainRatio = 0.5f)
public void MigrateSeasonalToPermanent(float retainRatio) {
  // ... (1~3 순서) ...

  // Step 4: Round 정수 연산 강제 (Q6 결정 = B Round)
  long seasonalTotal = SeasonalPp + Σ slot.investedPp where channel=Seasonal;
  long convertedPermanent = (seasonalTotal * 50L) / 100L;  // (long * 50) / 100 = Round 자연 처리

  // 음수 보호 (R-DR-S03)
  if (convertedPermanent < 0L) {
    Debug.LogError($"[Season] Migrate convertedPermanent < 0: {convertedPermanent}, seasonalTotal={seasonalTotal}");
    convertedPermanent = 0L;  // Fail-safe = 0 로 처리, throw 안 함 (유저 PP 보호 우선)
  }

  PermanentPp += convertedPermanent;
  SeasonalPp = 0L;
  RemoveAll(s => s.channel == Seasonal);
}

// PlayerWalletState.RetainMythicEssenceForNextSeason(float retainRatio = 0.5f)
public void RetainMythicEssenceForNextSeason(float retainRatio) {
  long retained = (MythicEssence * 50L) / 100L;
  if (retained < 0L) {
    Debug.LogError($"[Season] MythicEssence retain < 0: {retained}");
    retained = 0L;
  }
  MythicEssence = retained;
}

// v1.1 신규 — R-V2.3-01 PD 옵션 (a) 영구 보유 락 (2026-05-03)
// PlayerWalletState.RetainAffixForNextSeason(string affixId, float retainRatio = 0.5f)
public void RetainAffixForNextSeason(string affixId, float retainRatio) {
  // R-V2.3-01 PD 옵션 (a) 영구 보유 분기 — Tier 70 어픽스만 retain 예외 처리
  if (affixId == TIER_70_SEASON_AFFIX) {
    // Skip(retain50) — 100% 잔존 (시즌 1회 영구 보유, 다음 시즌엔 다른 어픽스 로테이션)
    return;
  }

  // 기본 50% retain (다른 어픽스)
  // ... (생략) ...
}

R-DR-S03 가드 4건:

1. (long * 50L) / 100L 정수 연산 강제 → 부동소수 오차 0% (1 PP 단위 누적 오차 차단)
2. 음수 검출 시 Debug.LogError + 0L Fail-safe (throw 안 함, 유저 PP 보호)
3. retainRatio 파라미터 = 0.5f 기본값 + 향후 시즌별 조정 가능 (시즌 6+ 운영 레버)
4. T13 통합 테스트 = SeasonalPp = 100 → Permanent +50 / SeasonalPp = 101 → Permanent +50 (Round 50.5 → 50 정수 잘림, Q6 B Round 정합) + Tier 70 어픽스 영구 보유 검증 (v1.1 신규) = 시즌 종료 후 인벤토리 100% 잔존 / 다음 시즌 시작 시 보유 유지

2.4 ILeaderboardRepository 추상화 (dry-run §5.2 그대로)

namespace GodBlade.Runtime.Season {
  public interface ILeaderboardRepository {
    System.Threading.Tasks.Task<bool> SubmitAsync(SeasonLeaderboardEntry entry);
    System.Threading.Tasks.Task<System.Collections.Generic.IReadOnlyList<SeasonLeaderboardEntry>>
      GetTopAsync(string seasonId, int limit);
    System.Threading.Tasks.Task<SeasonLeaderboardEntry?> GetMyEntryAsync(string seasonId, string playerId);
  }

  // Sp05 W1 T5 구현 3종
  public sealed class LocalLeaderboardRepository : ILeaderboardRepository { /* JSON */ }      // 항상 동작 (fallback)
  public sealed class InMemoryLeaderboardRepository : ILeaderboardRepository { /* Edit-mode */ }
  public sealed class FirestoreLeaderboardRepository : ILeaderboardRepository { /* orderBy+limit */ } // Firebase 의존
}

T5 합/불합 판정:

1. Interface 3 메서드 모두 정의 (Submit / GetTop / GetMyEntry)
2. 3 구현 모두 컴파일 성공 (Local / InMemory / Firestore)
3. CP-M27 = Firebase 초기화 실패 시 자동 fallback → LocalLeaderboardRepository 사용 (NRE 0건)
4. Sp06+ 주간 이벤트 (project_sp06_plus_lever_decisions.md) ILeaderboardRepository 동일 인터페이스 재투입 가능

3. 회귀 가드 (드라이런 R-DR-S01 / S02 / S03 사전 정렬)

3.1 R-DR-S01 가드 [High] (Firebase 첫 도입 러닝커브)

참조: dry-run §9.2 R-DR-S01 + 메모리 feedback_codelead_review_compile_verify.md 위험: Firebase SDK 통합 3h 예산 낙관적. 실제 8~12h 가능 → Sp05 W1 블로킹

FAIL 시 분기:

• G-S01.1 T4 6h 초과 = T5 스켈레톤만 유지 + T11 Smoke Test에서 Firebase 부분 skip
• G-S01.2 NRE 발생 = LocalLeaderboardRepository 강제 주입 + Firestore 부분 Sp06 이월
• G-S01.3 단계별 초과 = 다음 Phase 자동 skip (cascade)
• G-S01.4 SDK 파일 미배치 = T4 P1 재시작 (15분)

3.2 R-DR-S02 가드 [Critical] (5+1 사이드이펙트 순서 위반)

참조: dry-run §6 5순서 + §7 S2 Critical 위험: 순서 뒤집힘 = PP 영구 유실 또는 Seasonal/Permanent 비율 위반

FAIL 시 분기:

• G-S02.1 순서 위반 = 즉시 PR 차단 + T3 P3 재작업 (1h)
• G-S02.2 / G-S02.3 = CP-M25 / CP-M26 회귀 = code-lead 재작업
• G-S02.4 통합 테스트 6건 중 1건 FAIL = 즉시 game-designer 에스컬레이션 → 5+1 표 재검증
• G-S02.5 R-V2.3-01 분기 동작 FAIL = T12 재작업 (15분, 1줄 분기 정정)

3.3 R-DR-S03 가드 [Medium] (Round 정수 나눗셈 + 음수 보호)

참조: dry-run §11 R-DR-S03 + §11 정수 연산 강제 위험: (total * 50f) / 100f 부동소수 사용 시 1 PP 단위 누적 오차 / 음수 발생 시 throw

FAIL 시 분기:

• G-S03.1 float 사용 발견 = 즉시 정정 (15분)
• G-S03.2 throw 잔존 = Fail-safe 변환 (15분)
• G-S03.4 통합 테스트 케이스 미커버 = T13 재작업 (30분)

4. 변동 흡수

4.1 시놉 v2.4 신규 5건 흡수 영향 평가

총 흡수 부하: T6 1.0h + T12 0.5h + T13 0.5h = 2.0h (v1.0 동일, v1.1 추가 부하 0h). D-56 시점 즉시 흡수로 D-7 시점 부하 감소 입증.

4.2 R-V2.3-01 PD 결정 락 (2026-05-03) — 옵션 (a) 영구 보유 채택

상태: ✅ PD 락 (2026-05-03) 결정 사유: 시놉 v2.3 Tier 70 9,860원 박자 Legendary "시즌 한정" vs 7결정 Q7 50% retain 정책 충돌 → PD 옵션 (a) 영구 보유 채택

4안 결과 표 (PD 결정 락):

박세린 비권장 사유 (1줄):

• 시즌 한정 약속 위배 + ARPU -10% 장기 위험 (디아4 S15 시즌 패스 conversion 35% 벤치 대비 -5% 이상 하락 가능)
• 단 PD 결정 존중 — X1 안 (시즌 1회 영구 보유 + 다음 시즌엔 다른 어픽스 로테이션) 으로 시즌 패스 매력 유지 + ARPU 충격 완화 가능

ARPU 모니터링 트리거 (필수):

• 시점: 출시 후 6개월 시점 (2028-07 추정 = Phase 7 Live Ops)
• 분석 대상: Tier 70 영구 보유 안의 시즌 패스 conversion (실측) vs 가상 시즌 한정 안의 시뮬 conversion 비교 분석
• 벤치마크: 디아4 S15 시즌 패스 conversion 35% 평균
• 트리거 조건: 출시 후 6개월 시점 시즌 패스 conversion 30% 이하 (벤치 대비 -5% 이상 하락) → game-designer 후속 정책 검토 발주 (Tier 70 보상 변경 / 시즌 패스 가격 조정 / 추가 마케팅 캠페인)
• 책임: game-designer 박세린 (출시 후 6개월 시점 자동 발주)

4.3 차기 16~17화 도착 시 추가 어픽스 후보 영향 평가

Sp05 영향: 차기 16~17화 도착 = 5/9~5/16 = D-44~D-37 시점. T6 시즌 패스 매핑 표 = D-7 (6/22) 시점 작성 = 5주 여유 = 차기 16~17화 도착 후 흡수 충분 가능. 추가 어픽스 1건 시 Tier 매핑 1건 추가 = T6 부하 +0.2h 추정 (전체 부하 미영향).

5. D-Day 체크리스트 (D-7 본격 착수 시 PRINT-AND-CHECK 양식, 게이트 16/16)

사용법: 2026-06-22 (D-7) 책상에 출력. 항목별 체크박스 표시. GO/NO-GO 표 1행 작성.

5.1 W1 게이트 (T1~T6 = 6건)

[ ] G-W1.1 (T1) : SeasonConfigSO + ISeasonClock + ManualSeasonClock 정의
              → 검증: ISeasonClock 5 멤버 / ManualSeasonClock(SeasonConfigSO, ITimeProvider) 생성자
              → FAIL 시 §1.2 시그니처 표 재참조 (15분)

[ ] G-W1.2 (T2) : PrestigeSaveDto_V2 + Migrate v1→v2 스위치
              → 검증: schemaVersion=2 / lastMigratedSeasonId / currentSeasonId / seasonStartUnixMs 3 신규 필드
              → FAIL 시 CP-M24 재참조 + Tests.Editor v1 JSON 하드코딩 라운드트립 추가

[ ] G-W1.3 (T3) : SeasonController + OnSeasonEnd 발화자 + 5+1 순서 배선
              → 검증: §2.2 표 6건 순서 일치 + CP-M25 이중 발화 차단 + CP-M26 호출 순서
              → FAIL 시 §3.2 R-DR-S02 가드 절차 (즉시 PR 차단)

[ ] G-W1.4 (T4) : Firebase SDK 통합 + Auth + Firestore 초기화 (하드 캡 6h)
              → 검증: P1~P4 단계별 타임박스 통과 + Ping read/write 성공
              → FAIL 시 §3.1 R-DR-S01 가드 절차 (T5 스켈레톤만 유지)

[ ] G-W1.5 (T5) : ILeaderboardRepository + 3 구현 (Local / InMemory / Firestore)
              → 검증: 3 구현 컴파일 성공 + CP-M27 fallback NRE 0건
              → FAIL 시 §2.4 시그니처 재참조

[ ] G-W1.6 (T6, v1.1 갱신) : 시즌 패스 30 Tier 매핑 표 + season_pass_s2.tsv 신설 + Tier 70 permanent_retain_flag 컬럼
              → 검증: 9 Tier 정의 (Tier 60 / Tier 75 v2.3 + Tier 70 v2.4 영구 보유 락 표기 포함) + 어픽스 풀 v1.3 정합 + R-V2.3-01 PD 락 표시 + permanent_retain_flag = true (Tier 70 행)
              → FAIL 시 §1.4 매핑 표 재참조 + §4.2 R-V2.3-01 PD 결정 락 표 재참조

5.2 W2 게이트 (T7~T13 = 7건)

[ ] G-W2.1 (T7) : SetItemCatalogSO + SetItemImporter + SetEffectEvaluator
              → 검증: TSV→SO Importer + 장비 변경 이벤트 구독 + Dictionary 비직렬화 (CP-M09)
              → FAIL 시 dry-run §1 W2 T6 재참조

[ ] G-W2.2 (T8) : IMythicConstraint + NoDuplicateSlotConstraint + equip() validator
              → 검증: equip() 훅 = Mythic 중복 슬롯 차단 + EquipResult.Blocked(reason) 반환
              → FAIL 시 sprint-05-research §4.3 재참조

[ ] G-W2.3 (T9) : PlayerWalletState + MythicEssence(long) + 50% retain
              → 검증: 시즌 종료 시 MythicEssence × 50L / 100L = 정수 retain (R-DR-S03 G-S03.3)
              → FAIL 시 §2.3 정수 연산 패턴 재참조

[ ] G-W2.4 (T10) : SeasonEndModal UI + OnSeasonEndMigrationCompleted 구독
              → 검증: 이벤트 수신 + PP 전후 비교 표시 + "확인" 버튼 닫힘
              → FAIL 시 sprint-05-research §3.5 재참조

[ ] G-W2.5 (T11) : Smoke Test 전체 루프 (Force End → Migrate → 리더보드 제출 → 모달 → v2.json)
              → 검증: Editor Play Mode 6 단계 (dry-run §4 P1~P6) 모두 통과
              → FAIL 시 R-DR-S01 / S02 / S03 가드 재실행

[ ] G-W2.6 (T12, v1.1 갱신) : R-V2.3-01 PD 옵션 (a) 영구 보유 락 반영 = Tier 70 retain 예외 처리 분기
              → 검증: `if (affixId == TIER_70_SEASON_AFFIX) Skip(retain50)` 1줄 동작 + Edit-mode 케이스 검증 = 시즌 종료 후 Tier 70 어픽스 인벤토리 100% 잔존
              → FAIL 시 §4.2 PD 결정 락 표 재참조 + 1줄 분기 정정 (15분)

[ ] G-W2.7 (T13, v1.1 갱신) : MigrateSeasonalToPermanent 5+1 사이드이펙트 통합 테스트 (§2.2 표 6건, 6번째 = Tier 70 영구 보유 정상 동작 1건 포함)
              → 검증: 6건 모두 Edit-mode PASS + 음수 케이스 (-1) = 0L Fail-safe 검증 + Tier 70 어픽스 다음 시즌 시작 시 보유 유지 검증
              → FAIL 시 §3.2 R-DR-S02 가드 절차 + §3.3 R-DR-S03 가드 절차

5.3 R-DR 회귀 가드 게이트 (R-DR-S01 / S02 / S03 = 3건)

[ ] G-R-DR.S01 : Firebase 첫 도입 러닝커브 가드
              → 검증: G-S01.1 (하드 캡 6h) + G-S01.2 (fallback NRE 0건) + G-S01.4 (SDK 파일 배치)
              → FAIL 시 §3.1 분기 (T5 스켈레톤만 + Firestore 부분 Sp06 이월)

[ ] G-R-DR.S02 : 5+1 사이드이펙트 순서 위반 가드 (Critical)
              → 검증: G-S02.1 (코드 리뷰) + G-S02.4 (T13 통합 테스트 6건) + G-S02.5 (R-V2.3-01 PD 옵션 a 분기)
              → FAIL 시 §3.2 분기 (즉시 PR 차단 + T3 P3 재작업)

[ ] G-R-DR.S03 : Round 정수 나눗셈 + 음수 보호 가드
              → 검증: G-S03.1 (float 0건) + G-S03.2 (Fail-safe 0L) + G-S03.4 (T13 6 케이스)
              → FAIL 시 §3.3 분기 (정정 15~30분)

5.4 GO/NO-GO 의사결정 표

+----------------------------------------------------------+
|  Sp05 W1·W2 GO/NO-GO 의사결정 (D-7 ~ D-1, 2026-06-22~28) |
+----------------------------------------------------------+
| 일자       | 게이트 통과 | 비고                          |
| 2026-06-22 | __/6 W1     | (G-W1.1~6, T6 신규 게이트 포함)|
| 2026-06-23 | __/7 W2     | (G-W2.1~7, T12·T13 신규 포함) |
| 2026-06-24 | __/3 R-DR   | (G-R-DR.S01·S02·S03)         |
| 2026-06-25 | (변동 흡수) | (시놉 v2.4 추가 변동 확인)     |
| 2026-06-26 | (재시뮬)    | (FAIL 발생 시)                |
| 2026-06-27 | (PD 보고)   | (W1·W2 종합 보고)             |
| 2026-06-28 | (D-1 마감)  | code-lead B1 실측              |
+----------------------------------------------------------+
| 최종 결정  | [ ] GO     [ ] NO-GO     [ ] 재검토 PD 호출 |
| 결정자     | PD                                          |
| 결정일     | 2026-06-28 18시                             |
+----------------------------------------------------------+

GO 조건: G-W1.1~6 (6/6) + G-W2.1~7 (7/7) + G-R-DR.S01·S02·S03 (3/3) = 16/16 통과 NO-GO 조건: 1건 이상 FAIL 잔존 + §1~§3 분기 절차 미완료 재검토 PD 호출 조건: G-S01.1 (Firebase 6h 초과)

5.5 R-V2.3-01 게이트 (v1.1 갱신 = 해소됨)

[v1.0 → v1.1 변경] R-V2.3-01 PD 결정 게이트 = 해소됨 (2026-05-03 PD 옵션 (a) 영구 보유 락)
   → v1.0: 4안 중 1안 채택 마감 = 2026-06-28 (D-1) 18시 → 박세린 default = (b) 삭제
   → v1.1: PD 결정 락 (옵션 (a) 영구 보유) = D-1 마감 게이트 X
   → T12 코드 분기 = `if (affixId == TIER_70_SEASON_AFFIX) Skip(retain50)` 1줄 + 다음 시즌 다른 어픽스 로테이션 (X1 안)
   → 박세린 비권장 안이었으나 PD 결정 존중. ARPU 모니터링 트리거 = 출시 후 6개월 시점 (game-designer 후속 발주)

6. 의존성·블로커

6.1 Sp04 종료 = 6/29 (Sp05 킥오프 직전)

의존 그래프:

Sp02 W2 (5/31) ───> Sp03 (6/14) ───> Sp04 (6/28) ───> Sp05 W1 킥오프 (6/29)
       │                  │                  │
       ▼                  ▼                  ▼
   Migrate(float)    FlushCatchUp(bool)  affix_pool v1.3
                                          + Calculator

6.2 어픽스 v1.3 36어픽스 정합 (Tier 매핑 9건)

정합 게이트: T6 산출물 = 9 Tier × 6 컬럼 TSV (v1.1: permanent_retain_flag 컬럼 신규). 6 어픽스 매핑 + 3 비-어픽스 매핑 (Tier 5 PDA 스킨 / Tier 75 슬레이어 스킨 / Tier 100 NPC 호감도). Tier 70 행: permanent_retain_flag = true (v2.4 정정).

6.3 시놉 v2.4 ↔ Sp05 직접 영향 5건

6.4 Firebase Phase 5+ 위임 (T4 하드 캡 6h)

Sp05 도입 범위 (최소):

• Firebase SDK 통합 + Auth 익명 로그인 + Firestore 초기화
• seasonEndUtc Remote Config (Phase 5+ 승격 대비 인터페이스만)
• 시즌 리더보드 쓰기/읽기 (Firestore orderBy + limit)
• 명예의 전당 영구 스냅샷 (Cloud Function = Sp06 이월)

Sp05 도입 범위 외 (Phase 5+ 이월):

• 프레스티지 세이브 동기 (Phase 5+ 유지)
• Firebase Remote Config currentSeasonId 발화 = RemoteConfigSeasonClock 구현 (Phase 5+)
• Cloud Function 서버 검증 (Sp06+)
• Security Rules 작성 (Sp06+)

T4 하드 캡 6h 초과 시 cascade 이월:

1. T5 FirestoreLeaderboardRepository 스켈레톤만 유지 (실 Firebase write는 Sp06)
2. T11 Smoke Test = LocalLeaderboardRepository 만 검증 (Firestore 부분 skip)
3. Sp05 W2 잔여 시간 = T6·T12·T13 신규 작업에 재배치

6.5 블로커 시나리오 (PD 에스컬레이션 트리거)

박세린 책임 범위: B-4 / B-6 (game-designer 영역) / B-1·B-3 = code-lead 책임 / B-5 = PM 책임 (단순 보고). B-2 = v1.1 해소.

7. 변경 이력

(끝, v1.1 2026-05-03 박세린)