[Feat] - Apple Watch 건강 데이터 서버 API 연동

[thingineeer]

🌱 작업한 내용

Apple Watch에서 수집하는 건강 데이터(심박수, 칼로리, 심박수 Zone)를 iPhone으로 전달하고, 서버 Health Data API와 연동하여 2-step 저장 흐름을 구현했습니다.

Watch

• WorkoutManager에 심박수 샘플 추적 및 Zone 분포 계산 로직 추가
• WatchSessionManager에 transferUserInfo 기반 건강 요약 데이터 전달 구현
• 5초 간격 실시간 심박수/칼로리 iPhone 전송
• 개별 심박수 샘플(elapsedSeconds, zone) 및 minHeartRate 포함

데이터 수신 및 UI

• WatchSessionService에 didReceiveUserInfo 구현 (건강 요약 수신)
• WatchSessionService에 실시간 심박수/칼로리 수신 및 Combine 바인딩
• RunTrackingVC 러닝 중 실시간 심박수/칼로리 표시
• RunningRecordVC 기록 저장 화면에 건강 데이터 요약 섹션 추가
• HeartRateZoneBarView 신규 컴포넌트 (보라 계열 Zone 바 차트)

서버 API 연동

• RecordRouter에 Health Data API 엔드포인트 4개 추가 (POST/GET/DELETE/GET summary)
• POST /record 응답에서 data.record.id 파싱 → 2-step 저장 흐름
• 409 Conflict 시 DELETE 후 재전송 retry 로직
• ActivityRecordDetailVC에 과거 기록 건강 데이터 조회 및 표시
• ActivityRecord에 optional healthData 필드 추가 (하위 호환)

신규 DTO

• HealthDataSaveRequestDto — POST /record/{id}/health 요청 (flat zone 필드)
• RecordResponseDto — POST /record 응답 recordId 파싱
• HealthDataResponseDto — GET /record/{id}/health 응답 (nested zones)
• HealthSummaryResponseDto — GET /health/summary 기간별 통계

Graceful Degradation

• Watch 미연결 시 기존과 100% 동일하게 동작 (Step 2 스킵)
• Health 저장 실패해도 러닝 기록은 정상 저장됨
• 과거 기록 중 건강 데이터 없는 기록은 건강 섹션 숨김

🌱 PR Point

• 기존 러닝 기록 기능에 영향 없음 (healthData가 optional)
• 기존 브랜드 컬러(m1~m6)/폰트(Pretendard) 시스템 일관성 유지
• 코드 변경: 12개 파일, +484줄 (신규 4개 파일 포함)
• 서버 Health Data API 배포 완료 확인

📮 관련 이슈

• Apple Watch 건강 데이터 서버 연동 (서버 API 설계서 별도 전달 완료)