Skip to content

[NM-561] 인앱 리뷰 요청 — 식별 · 타이머 · 묶음 3개 · 기기에만 기록 - #88

Merged
taew0o merged 3 commits into
developfrom
feature/NM-561-in-app-review
Oct 21, 2026
Merged

taew0o merged 3 commits into
developfrom
feature/NM-561-in-app-review

Conversation

@taew0o

@taew0o taew0o commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

식별 · 타이머를 끝낸 뒤 스토어 평가 창을 요청한다. 정본은 spec feature/pill-recognition/README.md §스토어 리뷰 요청(NM-618).

바꾼 것

  • 판정 ReviewPolicy — 묶음 셋 중 하나를 모두 만족하면 요청, 마지막 요청 뒤 30일.
    • ① 식별: 누적 3회 · 첫 사용 3일 · 이번에 수정 없이 고름 · 오늘 한도 안내 안 봄
    • ② 최근 사용: 최근 7일 중 3일 사용(위젯 · 워치만 쓴 날 포함) · 식별 + 타이머 3회
    • ③ 타이머(타이머를 끝냈을 때만): 첫 사용 3일 · 타이머 시작 5회
  • 집계 ReviewTracker (기기 DataStore review_stats)
    • 쓴 날 · 첫 사용: 앱 열기 · 타이머 시작
    • 타이머 시작: TimerAnalyticsReporter.started(폰 · 위젯 · 워치 합류)
    • 식별: 기록 저장 성공
    • 한도 안내: 미리보기 · 알약 탭 배선
  • 요청 ReviewRequester (Play In-App Review review-ktx 2.0.2)
    • 식별 저장 성공 직후
    • 앱 안에서 타이머 완료 직후
    • 앱 밖(알림 · 전체화면 알람 · 워치)에서 끝냈으면 다음에 앱을 열 때
  • TimerAnalytics 를 suspend 로 · ended 에 출처(phone/watch) — 위젯 · 알림 리시버의 goAsync 안에서 기록을 끝내고, 워치 완료는 늘 「앱 밖」으로 본다.
  • 백업 제외 — review_stats 를 자동 백업 · 기기 이전에서 뺀다(「재설치하면 처음부터 센다」).
  • 디버그 — adb shell am start -d nursemate-debug://review 로 조건 없이 요청(창은 Play 설치본에서만 뜸).

하지 않는 것(spec): 평가 창 앞 만족도 질문 · 버튼으로 창 부르기 · 설정 「리뷰 남기기」.

알려진 한계 (받아들임)

폰이 연결되지 않은 동안 워치에서 시작부터 끝까지 쓴 타이머는 폰이 보지 못해 세지 못한다.

확인

  • 로컬: spotlessCheck · detekt · lint · test · app/wear debug · androidTest 빌드

  • 단위: 판정 7(경계값) · 기록 4 · 수정 없음 4 · 타이머 지표 9

  • 코드 리뷰 10건 반영(2017850)

  • S24 debug

    경로 결과
    앱 열기 → 쓴 날 · 첫 사용 ○
    디버그 강제 → Play 요청 ○
    앱 안 타이머 완료(만료 카드) → 즉시 검사 ○
    알림 「완료」(앱 뒤) → timer_ended_outside → 다음 실행 때 검사 · 표시 지움 ○
    식별 저장 성공 → 검사 ○
    워치(Galaxy Watch7)에서 시작 → 폰 집계 ○ 3초 안에 타이머 시작 2 → 3
    워치에서 완료(폰 앱이 앞에 있음) ○ 즉시 검사하지 않고 timer_ended_outside 만 남김
    폰 앱 다시 열기 ○ 표시로 「타이머 완료」 검사 · 표시 지움

🤖 Generated with Claude Code

taew0o and others added 3 commits October 21, 2026 15:01
- spec §스토어 리뷰 요청(NM-618)의 묶음 1(식별) · 2(최근 사용) · 3(타이머)을 ReviewPolicy 로 판정한다
- 식별 저장 성공 뒤 · 앱 안에서 타이머 완료 직후 · 앱 밖에서 끝냈으면 다음에 앱을 열 때 검사한다
- 타이머 시작(폰 · 위젯 · 워치)과 쓴 날(앱 열기 · 타이머 시작)을 기기 DataStore 에 센다
- 오늘 한도 안내를 본 날은 묶음 1 로 요청하지 않는다
- 기록은 자동 백업에서 뺀다 — 재설치하면 처음부터 센다
- 디버그는 nursemate-debug://review 로 조건 없이 요청해 본다

한계: 폰이 연결되지 않은 동안 워치에서 시작부터 끝까지 쓴 타이머는 세지 못한다(받아들임).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- TimerAnalytics 를 suspend 로 · 끝낸 기기(source)를 싣는다 — 위젯 · 알림 리시버 goAsync 안에서 기록을 끝낸다
- 워치에서 끝낸 타이머는 폰 앱이 앞에 있어도 다음에 앱을 열 때 검사한다
- 폰 · 위젯 시작은 지금 시각으로 센다(역산은 늦게 오는 워치 시작에만)
- 판정과 「요청함」을 나눠, 창을 실제로 요청한 뒤에만 30일 간격을 쓴다
- 「수정 없음」을 후보를 고른 순간에 적는다(pickedUntouched)
- 한도 안내 기록을 화면 컴포넌트가 아니라 배선에서 한다
- 쓰기를 한 번으로 합치고 죽은 필드를 지운다 · 디버그 강제 요청을 onStart 뒤로 미룬다
- 기록 · 수정 없음 판정 테스트를 더한다

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@taew0o

taew0o commented Oct 21, 2026

Copy link
Copy Markdown
Contributor Author

통과 기준 대조

기준 (spec §스토어 리뷰 요청 · 티켓 DoD) 근거 판정
묶음 1 · 2 · 3 판정 · 30일 간격 ReviewPolicyTest 7개(경계값) ○
하나라도 빠지면 요청 안 함(수동 추가 · 한도 안내 본 날 포함) 판정 테스트 · PillUntouchedTest(수동 추가 = 수정) · 한도 안내 날짜 ○
식별 저장 성공 뒤 들어온 화면에서 검사 S24 — PUT 204 뒤 리뷰 검사 IDENTIFIED ○
타이머 앱 안 완료 → 즉시 · 앱 밖 → 다음 실행 S24 만료 카드 · 알림 「완료」 · 워치 「완료」(폰 앞에 있어도 즉시 안 함) ○
타이머 시작 집계 — 폰 · 워치 S24 · Galaxy Watch7 — 워치 시작 3초 안에 반영 ○
쓴 날 · 첫 사용 · 마지막 요청은 기기에만 · 재설치 초기화 DataStore review_stats · 자동 백업 · 기기 이전 제외 규칙 ○
만족도 질문 · 버튼 호출 · 설정 행 없음 · 떴는지 분기 없음 코드에 없음 — 간격은 요청 기준 ○
디버그 강제 호출 nursemate-debug://review → Play 요청까지(창은 Play 설치본에서만) ○
코드 리뷰 10건 반영(2017850) ○
CI build SUCCESS(13m38s) — develop(NM-571) 합친 상태 ○

알려진 한계(받아들임): 폰이 연결되지 않은 동안 워치에서만 쓴 타이머는 세지 못한다.

@taew0o
taew0o merged commit 8f73ff0 into develop Oct 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant