ALPHEA_CONNECT_Bug

h3. 현상

Daily Quest 화면에서 목표를 이미 달성한 퀘스트인데도 Claim 버튼이 나오지 않고 보상이 "0 Points" 로 표시됩니다.

h3. 원인

@alphea.connect.v1.QuestService/ListQuests@ 응답에서 해당 퀘스트들이 보상 0 + QUEST_STATE_LOCKED 로 내려옵니다. (2026-08-11 실측)

|. questId |. measured / target |. reward.micros |. state |
| daily-login-1 | 1 / 1 (달성) | 0 | QUEST_STATE_LOCKED |
| daily-foreground-3600 | 10034 / 3600 (달성) | 0 | QUEST_STATE_LOCKED |
| daily-foreground-10800 | 10034 / 10800 | 0 | QUEST_STATE_LOCKED |
| daily-foreground-21600 | 10034 / 21600 | 0 | QUEST_STATE_LOCKED |
| daily-foreground-43200 | 10034 / 43200 | 0 | QUEST_STATE_LOCKED |
| referral-level-5 (정상 비교군) | 0 / 5 | 200000000 | QUEST_STATE_IN_PROGRESS |

보상이 설정된 @referral-level-*@ 만 IN_PROGRESS 로 정상 판정되고, 보상 0 인 퀘스트는 목표를 넘겨도 LOCKED 에 머뭅니다.

API 문서(@docs/api-server-guide/connect-rpc-api.md@ §8)에 따르면:

bq. 퀘스트 정의는 보상 0의 비활성 설정 으로 시드되며, 구성되기 전까지 비활성 상태입니다.

즉 해당 퀘스트 정의가 어드민에서 아직 활성화·보상 설정이 되지 않은 시드 상태입니다. 신규 클레임 조건인 "활성 상태 + 양수 보상 + 측정값이 목표 도달 + 정확한 현재 기간 키" 중 앞의 두 조건이 충족되지 않습니다.

h3. 요청 사항

아래 퀘스트 정의를 활성화하고 보상 micros 를 양수로 설정해 주세요.

• daily-login-1
• daily-foreground-3600 / -10800 / -21600 / -43200
• lifetime-foreground-86400 / -259200 / -604800 / -2592000 / -7776000 / -15552000 / -31536000
• valid-invitee-1 / -5 / -10 / -25 / -50 / -100
• referral-level-1, referral-level-25

h3. 앱 측 조치 (완료)

클라이언트는 서버 @state@ 를 그대로 신뢰하는 설계라 코드 결함은 없습니다. 다만 "진행 바는 100% 인데 0 Points 이고 수령 버튼은 영영 안 나오는" 행이 그대로 노출되는 문제가 있어, 보상이 0 인 미구성 퀘스트를 목록에서 감추도록 수정했습니다. (commit 4acd985)

이 때문에 서버 설정 전까지 Daily Quest 화면은 "No quests available today" 로 비어 보입니다. 위 설정이 반영되면 정상 노출됩니다.