온보딩 및 HealthKit 권한 전환 실험 설계

[gaeng2y]

📝 Summary

#216 온보딩 및 HealthKit 권한 전환 개선 실험 설계를 문서화했습니다.

온보딩 완료부터 HealthKit 권한 요청/허용, 첫 수분 기록까지의 baseline funnel과 성공/중단 기준을 정리하고, MVP 실험을 2개로 좁혔습니다.

🎯 Type of Change

• ✨ New feature (새로운 기능 추가)
• 🐛 Bug fix (버그 수정)
• 🔧 Configuration (설정 변경)
• ♻️ Refactoring (코드 리팩토링)
• 📝 Documentation (문서 수정)
• 🎨 UI/UX (디자인 변경)
• ⚡ Performance (성능 개선)
• 🛡️ Security (보안 강화)
• 🧪 Test (테스트 추가/수정)
• 🔨 Build (빌드 시스템 수정)

🔗 Related Issues

• Closes 온보딩 및 HealthKit 권한 전환 개선 실험 설계 #216
• Related to 제품 이벤트 분석 및 퍼널 측정 추가 #200
• Related to Firebase 분석 퍼널 및 대시보드 운영화 #210

📋 Changes Made

Added

• Docs/product-specs/onboarding-healthkit-conversion-experiments.md 추가
• HealthKit 권한 전환 baseline funnel, baseline window, success metrics, guardrail 정의
• MVP 실험 후보 2개 정의
  • HealthKit gate trust copy
  • denied recovery step copy
• 동시 A/B 테스트가 필요할 때 추가할 experiment_key, experiment_variant 후속 파라미터 후보 정리

Changed

• 제품 스펙 인덱스와 문서 허브에 새 실험 설계 문서 링크 추가
• sign-in-onboarding-healthkit.md에 실험 기준 문서 참조 추가
• analytics-operations.md의 의사결정 규칙에 실험 기준 문서 연결

Fixed

• 없음

Removed

• 없음

🔍 Technical Details

• 코드 변경 없이 문서만 갱신했습니다.
• #210에서 정의된 Firebase funnel을 baseline으로 삼았습니다.
• 초기 MVP는 새 이벤트 파라미터 없이 release before/after 분석으로 운영하고, 동시 A/B 테스트는 후속 이슈로 분리하도록 명시했습니다.

📸 Screenshots / Videos

Before

첨부 없음

After

첨부 없음

✅ Testing

Test Plan

• 앱 빌드 성공
• Debug 모드 정상 작동
• Release 모드 정상 작동
• 기존 기능 영향 없음
• Widget Extension 정상 작동 (해당시)

Test Environment

• iOS Version: 해당 없음
• Device: 해당 없음
• Xcode Version: 해당 없음

Test Results

• git diff --check 통과
• make lint 통과
• make arch-check 통과
• 문서 전용 변경이라 앱 빌드와 런타임 QA는 수행하지 않았습니다.

🚨 Breaking Changes

• Yes (아래에 설명)
• No

📌 Additional Notes

• MVP 변경안은 HealthKit gate 카피와 denied recovery 안내로 제한했습니다.
• 온보딩 전체 리디자인, 권한 요청 시점 변경, 외부 A/B 테스트 플랫폼 도입은 MVP 범위에서 제외했습니다.

👀 Review Checklist

• 코드가 프로젝트의 코딩 컨벤션을 따르고 있나요?
• 새로운 의존성이 필요한가요?
• 문서 업데이트가 필요한가요?
• 데이터베이스 마이그레이션이 필요한가요?
• 환경 설정 변경이 필요한가요?