docs(plan-1.5): §8 건강 다짐 × 위젯 전수 점검 추가 — ③ 표시 전용 상속·갱신 경로·데이터 없음 표기·판정 보류(확정 대기 3건)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtZwRRjbtM9pZJDM4FkTq6
This commit is contained in:
songyc macbook 2026-08-21 22:48:39 +09:00
parent 212233b46d
commit d6ff8bb218

View File

@ -101,8 +101,20 @@
① 행동 컴플리케이션 → ② 건강 타일(권한·HealthCache 기반 공사 포함) → ③ 건강 다짐(어댑터→편집기→전 표면) → ④ 도움말 자연화(신규 주제 포함, 문구가 확정된 마지막에) → ⑤ 마무리(§6). 단계마다 빌드+심 검증+커밋.
## 8. 착수 시 사용자에게 확인할 것
## 8. 건강 다짐 × 위젯 전수 점검 (2026-08-20 후속 분석 — 사용자 질문 "③ 인터랙티브 위젯 처리")
- **③ 다짐 링(인터랙티브)**: 건강 다짐 셀은 **꼬리표 대상 다짐과 동일 문법** — 버튼 없는 표시 전용 셀, 탭=앱 열기(§10에 '의도된 동작'으로 기존 문서화). 누적값 줄은 HealthCache 값, atMost·주기 몫 완료 등 표시 상태 전부 상속. 셀에 지표 심볼 소표기(디자인 디테일). ⏳확정 대기
- **무관(행동·세션 전용)**: ① 행동 실행 · ⑥ 현재 진행 중 · 제어 센터 · Live Activity.
- **표시 전용이라 구조 무관, 캐시 값만 소비**: ② 목표 바 · ④ 다짐 그리드 · 잠금화면(다짐 점·게이지 포함).
- **⑤ 행동 통계 = 건강 비대상 선언** — 통계 탭·⑤는 행동 기반, 건강 표시는 모음 탭 타일 담당(범위 못 박기).
- **위젯 공통**: ⓐ갱신 경로 신설 — DataChange.commit 외에 백그라운드 딜리버리→캐시 갱신→reloadAllTimelines(주기 폴링 아님, §10 예산 전략과 충돌 없음. 신선도=시간 단위 감수 §3.1) ⓑ하루 경계는 기존 타임라인 안전망으로 새 날 0 리셋 자동 ⓒ**데이터 없는 기기(맥 데스크톱 위젯·건강 미동기화 아이패드)**: 건강 다짐 셀을 '수행일 아님' 문법 재사용(② 대시·③ 문구·④ 흐림)으로 '데이터 없음' 표시 + **combinedSpanRatio 모수에서 제외**(§4.3 하루 span 선례와 동일 문법) ⏳확정 대기 ⓓ③④ 슬롯 픽커에 건강 다짐 표시명 노출, 과금은 위젯=프리미엄이라 자연 정합.
- **파생 결정 2건**: ⓔ건강 다짐 v1 **마감 시각 옵션 미지원(숨김)** 추천 — 캐시가 하루 단위 값이라 부분 창은 시간대 캐시가 따로 필요, 실익 대비 과함(수면은 자체 구간 보유. §3.4의 "마감 적용 가능" 표기는 이 결정으로 대체) ⏳확정 대기 ⓕ**판정 보류 규칙(중요)**: 건강 다짐 포함 목표의 자동 판정(evaluateIfEnded)은 건강 데이터 가용 기기에서만 실행 — 불가 기기(맥 등)에선 보류해 다음 가용 기기 실행 때 판정(빈 캐시로 미달성 오판→CloudKit 전파 방지) ⏳확정 대기
## 9. 착수 시 사용자에게 확인할 것
1. §3.4 지표 8종 제안 확정(빼기/더하기 — 사용자가 "지표 더 추가"만 선택하고 세트는 미지정)
2. 건강 다짐 프리미엄 만료 시 처리(기존 원칙대로 "이미 만든 건 유지"면 확인만)
3. 도움말 스크린샷 재촬영 범위
4. §8 ③ 처리 — 건강 다짐 셀=꼬리표 다짐과 동일한 표시 전용(탭=앱 열기) 상속
5. §8 ⓒⓕ — 데이터 없는 기기에서 건강 다짐 모수 제외 + 자동 판정 보류 규칙
6. §8 ⓔ — 건강 다짐 v1 마감 시각 옵션 미지원(숨김)