ALPHEA_CONNECT_Bug

상위 #590(리워드 카드 프로그레스바 오류)의 서버측 원인 확인 요청입니다.

현상¶

Rewards 화면의 레벨 카드 게이지와 'N to go' 표기가 활성 초대 인원이 아니라 전체 초대 인원을 기준으로 계산됩니다.

• 예: Active today 1 / 총 초대 5 인 계정에서 5명 카드가 해금(Tap to claim)돼 보임
• 정상 기대값: 5 - 1 = 4 → '4 to go' 잠금 상태

원인 추정 (클라이언트 조사 결과)¶

클라이언트는 QuestService/ListQuests 의 referral-level-* 퀘스트에서 measuredValue 를 읽어 카드 진행도를 계산했습니다.
해당 퀘스트의 metric 은 QUEST_METRIC_ACTIVE_INVITEE_COUNT 이고, API 문서(connect-rpc-api.md §10 '활성(active) 규칙 — 단일 소스')상

• active_invitees 는 오늘 일일 활동 마커를 가진 피초대자 수
• ACTIVE_INVITEE_COUNT 는 오늘 카운트이며 LIFETIME 기간은 클레임 리셋 케이던스만 고정할 뿐 측정 방식이 아님

으로 정의돼 있으나, 실제 응답의 measuredValue 는 전체 초대 인원과 같은 값으로 관측됩니다.

확인 요청 사항¶

1. referral-level-* 퀘스트의 measuredValue 가 어떤 기준으로 집계되는지 (오늘 활동 마커 기준인지, 누적 초대 수 기준인지)
2. 명세대로 오늘 활동한 피초대자 수로 내려주도록 수정 가능한지
3. 동일 지표를 쓰는 GetReferralRewards.activeInvitees 값도 같은 기준인지 (일관성 확인)
4. measuredValue 가 전체 인원이라면, 그 값으로 판정되는 퀘스트 state(CLAIMABLE/LOCKED)도 함께 어긋나는지 — 미달 카드가 CLAIMABLE 로 내려오는지 확인 필요

클라이언트 임시 조치¶

기준값을 ListFriends 집계(activeCount — 화면 헤더 'Active today: N / M' 와 동일 소스)로 교체했습니다.
퀘스트 measuredValue 는 친구 목록 조회 실패 시 폴백으로만 사용합니다.

• 커밋: c82495e fix(rewards): 레벨 카드 'N to go' 를 활성 초대 인원 기준으로 계산

서버가 명세대로 수정되면 폴백 경로도 정상 동작합니다.