ALPHEA_CONNECT_Bug

상위 #589(기기를 계속 켜둔 상태에서 퀘스트 리셋 되었을 때)의 서버측 지표 정의 검토 요청입니다.

현재 계약¶

docs/api-server-guide/connect-rpc-api.md §10 '활성(active) 규칙 — 단일 소스' 기준으로 마커는 두 종류입니다.

문제¶

기기를 켜 둔 채 UTC 리셋을 넘기면 Daily Check-in 이 미달성으로 남습니다.

• 하트비트·ListQuests 등이 계속 나가므로 일반 활동 마커는 정상적으로 찍힙니다 (Contribute quest 정상, 타인에게 active 로 보임)
• 그런데 로그인 계열 RPC 4개는 아무도 부르지 않으므로 체크인 지표만 0 으로 남습니다
• 앱을 껐다 켜야(콜드스타트에서 CurrentSession) 달성됩니다

퀘스트 문구가 Open ALPHEA once today 인데, 앱을 실제로 켜서 사용 중인 사용자가 "오늘 앱을 안 열었다"로 판정되는 상태라 지표 정의와 사용자 인식이 어긋납니다.

검토 요청¶

1. Daily Check-in 을 일반 활동 마커(오늘 마커 존재)로도 충족되게 바꿀 수 있는지
   → 이렇게 되면 클라이언트가 퀘스트 목록만 다시 읽어도 정상 반영됩니다
2. 지표 이름·의도상 "인증 로그인"을 유지해야 한다면, 대안 검토
   • 활동 마커 기반의 별도 metric 을 추가하고 Daily Check-in 을 그쪽으로 옮길지
   • 아니면 퀘스트 문구를 실제 판정 기준에 맞게 바꿀지
3. 리셋(UTC 자정) 직후 서버가 이 지표를 어떻게 초기화/판정하는지 (기간 키 전환 시점 동작)

클라이언트 임시 조치¶

퀘스트 목록에서 체크인이 미달성이면 CurrentSession 을 한 번 보내 마커를 남기고 재조회하도록 보정했습니다.

• 커밋: 6218d28 fix(quest): 켜 둔 채 UTC 리셋을 넘기면 체크인이 미달성이던 문제 refs #589
• 중복 방지 기준은 기기 시계가 아니라 서버가 준 periodKey 입니다
• 미달성일 때만 발동하므로, 서버 정의가 바뀌면 발동 자체를 하지 않습니다. 서버 변경이 확정되면 이 보정은 걷어낼 수 있습니다.