Sprint 05 (시즌 시스템) — 2026-06-29 ~ 2026-07-13

작성: 2026-05-02 (project-manager) · 상태: 킥오프 대기 (D-58) 정식 킥오프: 2026-06-29 / 종료: 2026-07-13 (Phase 2 MVP 종료 [m]) 선행 드라이런: sprint-05-dry-run-2026-04-21.md (Yellow / GO 권장) 정합 메모리: project_sprint05_season_research.md · project_volume2_synopsis_v2_decisions.md (TBD 메인 세션 신설분)

한 줄 맥락

Phase 2 MVP 종착 스프린트. 60일 시즌 / Round 50% retain / Firebase 첫 도입 / MigrateSeasonalToPermanent 5 사이드이펙트 + Smoke Test. 2권 v2.1 시즌 시험 매핑(시즌1 노동의 박자 / 시즌2 박자/봉인 / 시즌3 의리/충심) 정합 검증 W2 추가.

이월 후보

• (Sp04 종료 시점에 채움 — 현재 비어있음)

목표 (최대 3줄)

1. Firebase 인프라 + 시즌 전환 Backend (W1, T1~T5) — SeasonConfigSO / ISeasonClock / PrestigeSaveDto_V2 마이그 / Firebase Auth+Firestore / ILeaderboardRepository 추상화
2. 시즌 컨텐츠 + Smoke Test (W2, T6~T10) — SetItemCatalogSO / IMythicConstraint / PlayerWalletState 50% retain / SeasonEndModal / 전체 루프 Smoke
3. 2권 v2.1 시즌 시험 매핑 정합 검증 (W2 추가) — GDD v4 시즌1=노동의박자 / 시즌2=박자/봉인 / 시즌3=의리/충심 메인 퀘스트 매핑 충돌 점검

W2 추가 작업 — GDD v4 시즌 시험 매핑 정합 검증 (2권 v2.1 후속)

출처: 박세린 v2.1 시놉시스 (2026-05-02 PD 채택). v3 의리/충심(시즌2) → v4 박자/봉인(시즌2) + 의리/충심(시즌3 신규 분리).

작업 (TodoWrite 초기 리스트, 10건 + W2 정합검증 1건)

원천: 드라이런 §1 10건 (Q4 권장 3건 적용 시 14.0h) + W2 정합 1건. 16.5~22.0h 밴드 (Firebase 러닝커브 +3~6h 가변).

W1 — Firebase 인프라 + 시즌 전환 Backend (10.0h)

• T1 SeasonConfigSO + ISeasonClock + ManualSeasonClock (디버그 메뉴) (담당: code-lead, 1.5h)
• T2 PrestigeSaveDto_V2 + Migrate v1→v2 스위치 (담당: code-lead, 1.5h)
• T3 SeasonController + OnSeasonEnd 발화자 + 이중 발화 플래그 (담당: code-lead, 2.0h)
• T4 Firebase SDK 통합 + 익명 Auth + Firestore 초기화 (담당: code-lead, 3.0h, 하드 캡 6.0h A2)
• T5 ILeaderboardRepository + LocalLeaderboardRepository + FirestoreLeaderboardRepository 스켈레톤 (담당: code-lead, 2.0h)

W2 — 시즌 컨텐츠 + Smoke Test + GDD 정합 (9.0h + 0.5~1h)

• T6 SetItemCatalogSO + SetItemImporter + SetEffectEvaluator 스켈레톤 (담당: code-lead, 2.5h)
• T7 IMythicConstraint + NoDuplicateSlotConstraint + equip() validator (담당: code-lead, 2.0h)
• T8 PlayerWalletState + MythicEssence(long) + 시즌 종료 50% retain (담당: code-lead, 1.5h)
• T9 SeasonEndModal UI + OnSeasonEndMigrationCompleted 구독 (담당: code-lead, 1.5h)
• T10 Smoke Test — 전체 루프 (담당: code-lead, 1.5h)
• T11 (신규 W2 정합) GDD v4 시즌 시험 매핑 정합 검증 (담당: game-designer + code-lead 합동, 0.5~1h, 충돌 0건 확인 시 종료 섹션 부록 1쪽)

의존성 (순차 그래프)

T1 ──┐
T2 ──┼──> T3 ──> T8 ──> T9 ──┐
     │                        ├──> T10
T4 ──> T5 ─────────────────> ─┤
                              │
T6 ───────────────────────────┤
T7 ───────────────────────────┘

T11 (정합 검증) — T3/T9 시작 전 1회 점검 → 메인 퀘스트 카피 충돌 시 W2 분기

외부 의존성:

• Sp02 W2 MigrateSeasonalToPermanent(float retainRatio) — 머지본 시그니처 (A1 실측)
• Sp03 IdleTicker.FlushCatchUp(forceImmediate=true) — 5 사이드이펙트 순서 #2
• Sp04 affix_pool.tsv Mythic 행 — T7 IMythicConstraint validator 입력
• GDD v4 시즌 시험 매핑 — T11 신규 (2권 v2.1 후속)
• Firebase Unity SDK — Unity 6 호환성 (A2 하드 캡 6.0h)

리스크 (3건)

드라이런 §0.2 R-DR-S01/S02/S03 + 2권 v2.1 W2 정합 위험 R-V2.1-02 식별만(해소 Sp05 킥오프 시점).

1. R-DR-S01 [High] Firebase 첫 도입 러닝커브: T4 3.0h 예산 낙관적. Sp03 R-DR-08 OnApplicationPause 플랫폼 의존과 동급. 완화: A2 하드 캡 6.0h. 초과 시 T5 스켈레톤만 유지 + 실 Firebase write Sp06 이월. PR 본문에 리스크 명시 의무.
2. R-DR-S02 [Critical] MigrateSeasonalToPermanent 5 순서 위반: 순서 뒤집히면 PP 영구 유실 가능. 특히 2(FlushCatchUp) ↔ 3(백업) 순서 위반 시 백업이 미반영 상태로 저장 → 복구 시 최근 방치 PP 유실. 완화: §6 표 엄수 + CP-M25/M26 Mock 호출 순서 검증. T3 P3 wiring 시 코드 리뷰 필수.
3. R-DR-S03 [Medium] 시즌 Round 부동소수점 누적 오차: (total 50) / 100 정수 연산 강제 안 하면 1 PP 단위 오차 축적. 완화: T3/T8에서 long int / int 강제. float/double 사용 금지 PR 리뷰 체크.

식별만 (해소 시점 Sp05 킥오프):

• R-V2.1-02 [Med/Med] GDD v4 시즌 매핑 충돌 — T11 정합 검증으로 흡수

D+14 종료 체크리스트 (2026-07-13 작성 예정, Phase 2 MVP 종료 [m])

• T1~T11 11건 Green / Red 분포
• T11 GDD v4 시즌 매핑 충돌 0건 확인
• Firebase T4 실공수 (3.0h 예산 vs 실측, 6.0h 하드 캡 도달 여부)
• 5 사이드이펙트 순서 위반 발생 여부 (R-DR-S02 회귀)
• prestige.v1.json → v2.json 마이그 라운드트립 통과
• LocalLeaderboardRepository fallback 독립 동작 보장
• Phase 2 MVP 골격 완성도 — Sp00~Sp05 통합 회고 + Phase 3 Sp06~Sp09 킥오프 전 휴식/Firebase 준비 V3 통합 1주(2026-07-13~07-20)

종료 섹션 (D+14 채움 예정 2026-07-13)

완료

• (TBD)

미완 / 이월

• (TBD)

회고

• 잘됨: (TBD)
• 안됨: (TBD)
• 다음 액션: (TBD) — Phase 3 Sp06+ 차별화 레버 5대 결정 재확인

(킥오프 문서 v0.1 — 2026-05-02 project-manager 작성 / 2권 v2.1 후속 W2 정합 검증 T11 등록 완료)