루틴 생성 동기화 재조정 대기 중 TTS 준비 조기 포기 문제 수정

[MinHeokChoi]

✨ PR 유형

• 버그 수정

🛠️ 작업내용

새 루틴 생성 후 "루틴 시작하기"를 눌렀을 때 서버 음성이 완전 무음으로 재생되지 않는 문제를 조사했습니다.

원인은 RoutineTTSWarmupCoordinator의 두 판단 함수 간 불일치였습니다.

• hasServerSyncIntent(이 루틴이 "서버 전용 음성"인지 판단): createRoutineGroup/addRoutine 뮤테이션 레코드가 어떤 상태로든 존재하기만 하면 서버 의도가 있다고 정확히 판단합니다.
• hasPendingGroupBinding(루틴 시작 시 바인딩을 더 기다릴지 판단): 내부에서 쓰는 isBindingDeliveryPending이 .waitingForServerContract/.queued/.attempting만 "대기 중"으로 보고, .needsReconciliation은 대기 중이 아니라고 취급했습니다.

그런데 RoutineSyncSender.sendNext를 보면 .needsReconciliation은 죽은 상태가 아니라 서버 반영 여부가 모호해 자동으로 재확인(reconciliation replay)되는 정상 진행 상태입니다. .blocked만 사용자 개입이 필요한 진짜 종결 상태입니다.

루틴 그룹 생성 요청이 타임아웃/네트워크 문제로 ambiguous 처리되어 .needsReconciliation에 들어가면:

1. expectsServerGeneratedIntro는 여전히 "서버 음성 필요함"으로 정확히 판단해 prepareAndWait(최대 30초 폴링)로 보내지만
2. 그 안의 prepareForegroundNow가 hasPendingGroupBinding false를 보고 즉시 missingGroupBinding을 찍고 .unavailable로 포기해버려, 폴링도 재시도 스케줄도 없이 완전 무음으로 끝났습니다.

isBindingDeliveryPending에 .needsReconciliation을 pending으로 포함시켜, 재조정 중에도 다른 대기 상태와 동일하게 최대 30초 폴링 창을 갖고 그래도 안 되면 정상적인 retryScheduled 경로로 빠지도록 수정했습니다.

📋 추후 진행 상황

실기기에서 재현 후 Console.app 로그로 missingGroupBinding 대신 waitingForBinding/foregroundPrepared 등이 찍히는지 확인 예정입니다.

📌 리뷰 포인트

• hasPendingGroupBinding/hasPendingRoutineBinding이 공유하는 isBindingDeliveryPending을 수정한 것이라 group 바인딩과 routine 바인딩 양쪽에 모두 적용됩니다.
• .blocked만 진짜 종결 상태로 남겼습니다 — 이 상태는 여전히 즉시 missingGroupBinding으로 처리되어야 합니다(수동 개입 필요).
• 이 클래스 자체에 대한 단위 테스트 인프라가 없어 별도 테스트는 추가하지 않았습니다(기존에도 없었음).

✅ Checklist

• 커밋 메시지 컨벤션에 맞게 작성했습니다
• 유지-보수를 위해 주석처리를 잘 작성하였는가?

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 02d63fab-cb71-4461-b1a4-a007961c4a17

---

_{Comment @coderabbitai help to get the list of available commands.}

[MinHeokChoi]

이 PR 브랜치에 서로 무관한 변경(TTS 재조정 수정 + DONE/REMIND 음원 수정 + 닉네임 프로필 수정 + Gemini 동의 화면 변경 + 버전 범프)이 섞여 있어 정리 차원에서 아래 PR들로 분리했습니다:

• 루틴 생성 동기화 재조정 대기 중 TTS 준비 조기 포기 문제 수정 #210 루틴 생성 동기화 재조정 대기 중 TTS 준비 조기 포기 문제 수정 (이 PR의 원래 취지)
• DONE/REMIND 공통 음원이 조용히 재생 안 되는 문제 수정 #211 DONE/REMIND 공통 음원이 조용히 재생 안 되는 문제 수정
• 닉네임 없는 프로필 응답을 malformed로 처리하던 문제 수정 #212 닉네임 없는 프로필 응답을 malformed로 처리하던 문제 수정
• Gemini 데이터 동의 화면을 로그인 직후에 띄우도록 변경 #213 Gemini 데이터 동의 화면을 로그인 직후에 띄우도록 변경

버전 범프(2.4.5 → 2.4.6) 커밋은 별도로 확인 후 처리 예정이라 아직 분리하지 않았습니다.