From 2ae469d187f29fdc6443bf3d795775adfda3fd85 Mon Sep 17 00:00:00 2001 From: songyc macbook Date: Wed, 26 Aug 2026 14:23:56 +0900 Subject: [PATCH] =?UTF-8?q?perf(1.5-p11):=20=EB=93=B1=EA=B0=80=20=EC=84=B1?= =?UTF-8?q?=EB=8A=A5=20=EC=B5=9C=EC=A0=81=ED=99=94=20=E2=80=94=20=EA=B1=B4?= =?UTF-8?q?=EA=B0=95=20=EC=BA=90=EC=8B=9C=20=EC=9D=B8=EB=A9=94=EB=AA=A8?= =?UTF-8?q?=EB=A6=AC=C2=B7=EB=B0=B1=ED=95=84=20=EC=8A=A4=EC=9C=84=ED=94=84?= =?UTF-8?q?=C2=B7=EA=B2=8C=EC=9D=B4=EC=A7=80=20=EB=B2=84=ED=82=B7=ED=99=94?= =?UTF-8?q?=C2=B7=EC=9C=84=EC=A0=AF=20=ED=83=80=EC=9E=84=EB=9D=BC=EC=9D=B8?= =?UTF-8?q?,=20=EB=B9=8C=EB=93=9C=209?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 소킹 중 '1.4 대비 버벅임 증가' 보고의 원인 수정 (동작·수치 완전 불변): - HealthCache/HealthIntervals 인메모리 캐시(세대 카운터 무효화) + workoutKeys 이중 load 제거 - DayMath.calendar 저장 프로퍼티화 (접근마다 Calendar 사본 생성 제거) - 수면 백필 O(400일×샘플수) → 정렬+포인터 스위프 (퍼즈 3,000회 등가 증명) - refreshRecent 캐시 기록 배칭 (일수×2회 → 총 2회) - QuestProgress.spanValue/spanRawValue 하루 버킷화 (게이지의 미래 기록 즉시 반영 스펙 보존) - 위젯 라이브 타임라인 makeEntry refresh 파라미터 (엔트리 7개×컨테이너 오픈 → 1회) - 일기 건강 카드 칩 value() 이중 호출 제거 검증: 옛/새 빌드 A/B — 덤프 3종 값 동일·4화면 픽셀 동일, 자가 검증 62/20/27/10 ALL PASS(26.5+18.5), 벌크 1만 건 렌더 정상, 3종 빌드 그린, 카탈로그 무변경. whats-new-1.5 3언어에 성능 개선 줄 추가. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01WtZwRRjbtM9pZJDM4FkTq6 --- myApp/HaruDanim/CLAUDE.md | 2 +- myApp/HaruDanim/Docs/plan-1.5.md | 8 ++ .../Haru_Danim.xcodeproj/project.pbxproj | 16 ++-- myApp/HaruDanim/IOS/Core/HealthStore.swift | 43 +++++++-- myApp/HaruDanim/IOS/Views/HealthSection.swift | 8 +- .../Marketing/AppStore/whats-new-1.5.txt | 3 + myApp/HaruDanim/Shared/DayMath.swift | 8 +- myApp/HaruDanim/Shared/HealthMetric.swift | 95 +++++++++++++++++-- myApp/HaruDanim/Shared/QuestProgress.swift | 89 ++++++++++++++--- myApp/HaruDanim/Widgets/GoalWidgets.swift | 15 +-- .../HaruDanim/Widgets/LockScreenWidgets.swift | 8 +- myApp/HaruDanim/Widgets/QuestRingWidget.swift | 7 +- 12 files changed, 247 insertions(+), 55 deletions(-) diff --git a/myApp/HaruDanim/CLAUDE.md b/myApp/HaruDanim/CLAUDE.md index 0d3940d..ab8ab34 100644 --- a/myApp/HaruDanim/CLAUDE.md +++ b/myApp/HaruDanim/CLAUDE.md @@ -19,7 +19,7 @@ | 번들 ID | `com.yechan.HaruDanim` / App Group `group.com.yechan.HaruDanim` / CloudKit `iCloud.com.yechan.HaruDanim` | | 수익 모델 | 부분 유료화. 무료 한도(행동 10·목표 2·목표당 다짐 3) + 프리미엄 결제 시 해제 | | 결제 상품 | `com.yechan.HaruDanim.premium.monthly`(월 4,400원) / `.yearly`(년 44,000원) / `.lifetime`(77,000원) — **ASC 등록·판매 중(실제 가격, 2026-07-28)**. 로컬 테스트 구성(HaruDanim.storekit)도 동일 가격. 가격은 코드에 없고 `product.displayPrice`로 동적 표기, 년 구독 절약률 배지도 동적 계산 | -| 현재 상태 (2026-08-22) | **버전 1.5 (빌드 5) — 소킹 사용자 요구·실측 수정 전부 반영 완료(2026-08-22 밤), TestFlight 재업로드·소킹 재개. 사용자 예고: 기능 수정은 이것으로 종료(이후는 버그·오류 수정만)**. ✅**동기화 정지 이슈 해결 확인(2026-08-22 밤, 사용자 실기기)**: 일기에 도형·텍스트 상자(DiaryPageItem)가 있으면 그 기기의 CloudKit 동기화 전체가 정지하던 문제(내보내기 대기열 직렬 — 거부된 아이템 뒤로 전부 막힘) — 원인은 **1.3의 DiaryPageItem 스타일 필드 10종이 프로덕션 스키마에 없었던 것**(1.0 출시 때가 마지막 배포였고, 1.3 이후 개발 빌드가 iCloud 내보내기를 한 적이 없어 개발 스키마에도 미생성이었음). 해결 절차 실행: 시뮬 519869F7(사용자 iCloud 로그인·재인증)에서 일기 요소 시드 포함 전체 내보내기로 개발 스키마 필드 생성(success·error nil) → 사용자가 콘솔 재배포 → **도형·텍스트 상자 있는 상태의 동기화 왕복 정상 확인(사용자)**. 교훈: **새 모델 필드는 배포 전 '개발 빌드로 그 타입 레코드를 실제 내보냈는지'까지 확인할 것** — 콘솔 diff에 타입 이름이 떠도 필드가 전부 실렸는지 봐야 한다. 업로드 검증 실측 2건: 빌드 1=ITMS-90683(HealthKit 엔타이틀먼트 보유 시 읽기 전용이어도 `NSHealthUpdateUsageDescription` 필수 — 쓰기 사유 3언어 추가, 쓰기 요청이 없어 표시될 일 없음), 빌드 2=ITMS-90626(**앱 인텐트 메타데이터에 'iPhone' 단어 금지** — 신규 컴플리케이션 인텐트·위젯 설명에서 '하루 다님 앱'으로 교체. 화면 뷰 문구의 iPhone은 스캔 대상 아님[1.4 전례]) → **빌드 3**으로 재업로드. **1.5 추가분(빌드 4, 2026-08-22 — 소킹 중 사용자 요구, 스키마 무변경·전부 로컬 설정/표시 계층)**: ⑦**아이폰 일기 탭 개방**(§6.7 — AppTab.phoneCases 개방[radialOrder 필터 제거·버블 8개 자동 배치 확인], 노트 필기는 맥 '그리기' 토글 문법 재사용[DeviceLayout.isPhone 신설, drawingPolicy anyInput, 가로 스크롤 도구 줄, 배치↔그리기 상호 배타 — 아이패드 경로 무변경], 일기 잠금 설정 전 기기 노출) ⑧**일기 하루 정리 '건강 데이터' 카드**(§6.7 — DiarySection.health[케이스 마지막이라 기존 사용자 목록 끝에 추가], DiaryHealthCard: 지표 선택 시트 공용화[HealthMetricPickerSheet Binding화], 저장은 기기 로컬 diary.healthMetrics[비면 타일 선택 상속], 맥은 목록·화면 모두 숨김, 인쇄 요약에 값 줄 DiaryPrintHealthRow 동승) ⑨**일기 타임테이블 수면·운동 실구간 블록**(§6.7 — **HealthIntervals 신설**[App Group health.intervals.v1, 400일, 실구간을 논리적 하루로 분할 저장·병합, CloudKit 금지 동일], refreshRecent/백필이 유지, ExportSnapshot.injectingHealthBlocks 주입[캘린더 전례·최하층 렌더 healthBlockView 반투명+실선], 지표 고정색 수면 인디고·운동 주황, 필터 시트 '건강 데이터' 토글[RecordFilterSheet showsHealthSection — 전 날짜 공통 diary.timetableHealthHidden, 기본 켬]+**맥 안내 문구**, 일기 필터 버튼 상시 노출로 변경, 내보내기 렌더러 동일 주입) ⑩**수면 표시 구간 설정**(§6.8 — SleepWindowPrefs[LocalPrefs]: 전체 스펙+요일별 7종[켤 때만], 설정 → 건강 데이터 → '수면 표시 구간'[SleepWindowSettingsView — 시작=끝이면 24시간 창], 평문 'sleep' 캐시 키=그날 유효 구간 값으로 변경[타일·일기 카드 공유], 백필 서명에 요일 매핑 포함[배정만 바뀌어도 재백필], **새 수면 다짐 기본 구간을 여기서 시드**) ⑪일기 목표 카드의 건강 다짐 값 단위 실측 수정("8,432회/8,000보"→지표 단위 — DiaryGoalsCard.valueLabel healthTarget 분기) ⑫**소킹 실기기 실측 버그 2건 수정(빌드 5)**: ⓐ더보기 탭 안 일기 달력에서 날짜 탭이 조용히 무시됨 — `AppRouter.morePath`가 `[AppTab]` 고정 타입이라 Date 푸시 불가 → **NavigationPath로 변경**(회귀 감시 인자 `-morePushDiaryToday`, 라디얼·사이드바는 원래 무사) ⓑ수면 블록이 수면 단계(코어·렘) 로우데이터대로 칸칸이 갈라짐 → **10분 이하의 깸은 이어 붙여 한 덩어리로**(DiaryHealthTimetable.sleepDisplayMergeGap — 표시 전용, 값 무영향. 20분쯤 깼다 자면 나뉘는 게 맞다는 사용자 규칙) ⑬**기록 탭 타임테이블에도 수면·운동 블록**(하루·주간 — DiaryHealthTimetable.blocks 단일 공급 지점·숨김 토글 공유[기록 필터 시트에도 건강 섹션], 내보내기는 `injectingHealthBlocks(forDayKeys:math:)`로 하루·주간 주입 + trim 표시 범위를 블록만큼 확장) ⑭**타임테이블 표시 색 설정**(설정 → 건강 데이터 → '타임테이블 표시 색' — 수면·운동 ColorPicker, 기본 인디고·주황[빈 값], 전 타임테이블·내보내기 공통 적용, 인자 `-healthColorPreview`) ⑮**버블 찌그러짐 실측 수정(빌드 6, 2026-08-23)**: 일기 버블 추가로 8개가 되자 이웃 간격(~9.6pt)이 유리 합체 판정 거리(18pt) 안으로 들어와 정지 상태에서도 원들이 서로를 향해 늘어남 — `glassBlendSpacing` 18→6(펼침 상태 정원 분리, FAB 모핑은 겹침 구간이라 유지. 마케팅 06-bubble 3언어 재촬영) ⑯**건강 다짐 표시 색(빌드 7, 2026-08-23 — 사용자 요구)**: 건강 다짐이 고정 분홍이던 것을 편집기 건강 섹션에서 색 선택(프리셋 12+피커, 기본 분홍=빈 값[시스템 분홍의 다크 적응 유지]) — **Quest 신규 필드 `healthColorHex`**(기본 "", targetColor 단일 지점 분기라 목표 탭·모음 카드·일기·위젯·워치 자동 반영, 행동·꼬리표 다짐은 저장 시 "" 정규화, 타임테이블 블록 색과 별개). ⚠️**CloudKit 스키마 추가 — 배포 절차(개발 내보내기→콘솔 Deploy)가 빌드 7 설치보다 선행 필수**(DiaryPageItem 전례 — 미배포 상태로 다짐 수정 시 그 기기 동기화 정지). → 배포·설치 완료(사용자). ⑰**위젯·워치 색 미반영 실측 수정(빌드 8)**: 위젯 QuestCellSnapshot(WidgetSupport)과 워치 스냅숏(WatchSyncManager)이 targetColor를 안 타고 자체 폴백을 쓰고 있었음 — 위젯은 분홍 #E0558C 하드코딩, **워치는 아예 초록 폴백(1.5 출시분부터 건강 다짐이 일반색으로 보이던 잠복 표시 버그)** → 두 곳 다 healthColorHex 우선·기본 #E0558C로 통일(④ 그리드에서 걸음=파랑·나머지=분홍 실측). 값 라벨은 두 표면 모두 원래 건강 단위 정상. 검증: 61/20/27/10 ALL PASS(26.5), 3종 빌드 그린, 전 카탈로그 missing/stale 0, 시각 QA(아이폰 요약·건강 카드·타임테이블 블록·노트 도구 줄·버블 8개·수면 구간 화면·아이패드·맥 분기·18.5). 스토어 자료: whats-new-1.5에 일기 확장 절 추가·설명 3언어 일기 항목 갱신. 신규 인자 `-sleepWindowPreview`(§14), `-seedHealthCache`가 실구간(수면 자정 분할+달리기)도 시드. 계획·결정 이력은 `Docs/plan-1.5.md`(전 섹션 ✅구현 완료). 1.5 내용: ①**워치 '행동 기록' 컴플리케이션**(§11 — 행동 편집 옵트인+표시 기간 5종[하루/이번 주/이번 달/지난 7일/지난 30일, 롤링은 rollingRange 재사용], 측정 중 노란 타이머, 탭=워치 앱 미니 행동 화면 push[뒤로가기=메인], recommendations 상한 없음) ②**모음 탭 건강 데이터 타일**(무료, §6.1 — 걸음·운동·수면 등 8지표 선택·순서, 접기, 연결 CTA[명시적 탭 권한], 안내 시트, 즐겨찾기·나머지·건강 3섹션 순서 설정[§6.8], 맥은 섹션 숨김) ③**건강 다짐**(프리미엄, §4.2·§6.4 — 8지표+운동 종목 20종[workout. 인코딩], 수면은 다짐별 수면 구간[기본 21:00~09:00]을 '구간 끝이 속한 논리적 하루'에 통귀속[겹침 분할과 다른 의도된 예외], 하루 단위 전용·마감 시각 미지원, QuestProgress 값 공급 단일 지점 3곳만 분기[수학 무변경 — 기존 49건 그린이 증거], HealthCache[App Group, 400일, ⚠️5.1.3: 값은 CloudKit 저장 금지 — 정의만 동기화]·백필·부트스트랩, 데이터 없는 기기는 모수 제외+'데이터 없음' 표기+판정 보류, 구버전 이중 상태는 행동/꼬리표 우선 정규화) ④**신기능 소개 팝업**(WhatsNewView — 버전당 1회, 신규 설치 시드로 미표시, 온보딩 우선, 全기기 업데이트 안내) ⑤**도움말 전면 자연화+신규 주제 3개**(사용자 예약 작업 — 오타·번역투·UI 명칭 정정, en/ja 전면 재번역·용어 통일[Action/アクション 등]) ⑥HealthKit 엔타이틀먼트(iOS 앱만)+NSHealthShareUsageDescription 3언어+PRIVACY.md 건강 문단. 검증: `-progressSelfTest` **61건**(건강 H 시리즈 12 신규)·20·27·10 ALL PASS(26.5+18.5 심), Debug/Store/워치(26.2·11.5) 빌드, 시각 QA 20여 장(워치 컴플리케이션 실데이터·미니 화면·타일·다짐 행·편집기·팝업·ja 도움말), 실버전 업그레이드 팝업 경로·벌크 1만 건+건강 결합 확인. 스토어 자료: whats-new-1.5·promotional-text-1.5·설명 3언어 갱신, **스크린샷 전면 신규 — 아이폰 10·아이패드 10·워치 1 × ko/en/ja 원본 57장+합성 63장 재생성 완료**(09-records→09-health 교체, Marketing/README 절차·주의 갱신). **CloudKit 프로덕션 스키마 배포 완료(2026-08-22, 사용자 콘솔 실행)** — Quest 신규 필드 3종(healthMetricRaw·sleepWindow*)은 개발 스키마에 없어서(디버그 내보내기 이력 없음이 원인) 시뮬 519869F7에 사용자 iCloud 로그인 후 디버그 빌드를 `-premium YES -cloudSync YES -seedHealthQuest YES`로 실행 → Sandbox 환경 전체 내보내기 성공(98레코드, error nil)으로 필드 생성 → 콘솔 배포(이 시뮬은 iCloud 로그인 유지 — 향후 스키마 작업 재사용 가능). **실측 발견: 1.3의 DiaryPageItem 스타일 필드가 프로덕션 미배포 상태였음**(마지막 배포=1.0 출시 시점 — 1.3 출시[8/6] 이후 도형·텍스트 상자 신규 스타일 필드 동기화가 조용히 실패했을 가능성, 이번 배포로 해소·밀린 내보내기는 자동 재시도. 소킹 중 아이패드↔맥 요소 동기화 교차 확인 권장). **남은 출시 절차(사용자)**: ①TestFlight 실기기 소킹(진행 중 — 실제 건강 데이터·워치 컴플리케이션·기기 간 건강 다짐 정의 동기화 중점) ②ASC 심사 제출(스크린샷 framed 세트 교체·whats-new/프로모션/설명 반영). **1.6 후보 보류 기록: `Docs/plan-1.6.md`**(타임테이블 건강 데이터 표시 — 2026-08-22 사용자 "일단 보류", 구현 금지·재논의 시 착수). 운동 종목 목록(20종)은 §3.4 — 사용자 실사용 종목 빠졌으면 추가 요청. **버전 1.4 (빌드 3) App Store 출시 완료(2026-08-13, 사용자 확인)** — 2026-08-13 심사 제출 후 같은 날 출시 확인. TestFlight 실기기 테스트(문제 없음 확인) 후 제출했음. iOS 18 실기기는 미확보로 미테스트(시뮬 검증 106건 ALL PASS로 갈음 — 해당 사용자 유입 시 피드백 대응 예정). 1.4 내용(사용자 A안 승인, 2026-08-11 세션에서 전부 구현·검증): ①**iOS 18.0 하한 인하**(위 플랫폼 행 — 글라스 버블 머티리얼 폴백·사용자 심볼 안전 렌더 `Image(safeSymbol:)`[iOS 55곳+워치 7곳, 18에 없는 카탈로그 심볼 3개 물음표 폴백]·`-symbolAuditDump`. ⚠️하한 18 Release(-O wholemodule)에서 swift-frontend가 제네릭 중첩 Coordinator의 deinit 최적화 중 크래시하는 컴파일러 버그 실측 — DiaryZoomCoordinator를 비제네릭 톱레벨+AnyView 소거로 우회, 되돌리지 말 것) ②**펜슬 저장 디바운스**(§6.7 — 획마다 전체 직렬화·블랍 재기록하던 버벅임 해소) ③**통계 '오늘 기준' 롤링**(§6.6·§10 ⑤ — 지난 7일/30일) ④**CSV 구간 내보내기**(§6.8, 코어 CSVExport 추출) ⑤**일기 내보내기 후 삭제**(§6.7, 렌더 코어 DiaryExportRenderer 추출) ⑥**데이터 정리·초기화**(§6.8 — 전체/처음~날짜까지+백업 3종[CSV·일기 PDF·정리 리포트 ArchiveReport]+**'일기만' 대상 축**[1.4(3), 2026-08-12 — 기록·구조·양식 보존, 백업은 일기 PDF만, `DataReset.deleteDiaries`·`-dataResetScope diary`·자가 검증 27건으로 확장]) ⑧**라디얼 모드 FAB 가림 수정**(1.4(3) — 목록 마지막 행이 FAB에 가려지던 실측 문제: 각 탭 루트에 하단 safeAreaInset 78pt, ⚠️NavigationStack '안쪽'에 붙일 것[바깥은 TabView가 safe area 재설정해 무시됨, 실측]) ⑦도움말 재구성(1.4(2) 검수 후속, 2026-08-12 — 뭉친 주제 3곳 분리: 기록·통계 그룹에 '지난 7일·30일로 보기'·'데이터 정리·초기화' 독립 주제 신설[CSV 주제는 백업·복원만, 비교 주제는 1.3 원문 복귀], 일기 그룹 '펜슬 노트 페이지'에서 '사진·도형·텍스트 꾸미기' 분리. 이미지는 그룹당 대표 1주제 원칙 유지 — 18장 전수 실사로 참조·언어 매칭 무결 확인)·l10n(전 카탈로그 missing/stale 0)·**워치 실행 햅틱 .click→.success 상향**(1.4(2) — 실사용 '너무 약함' 보고)·MARKETING_VERSION 1.4/**빌드 3**(TestFlight 재업로드용 — 같은 버전은 빌드 번호만 올려 업로드하면 1.4(2)로 기존 테스터에 배포됨)·`Marketing/AppStore/whats-new-1.4.txt`. 검증: 자가 검증 `-progressSelfTest` 49·`-csvImportTest` 20·`-intentSmokeTest` 10·`-dataResetTest` 27 ALL PASS(26 심+18.5 심), Debug/Store/워치 빌드 성공, 18.5·26 시각 QA(버블 폴백·일기 줌·롤링 통계·초기화 화면·리포트 PDF 3페이지 실물). **스토어 제출 시**: 하한 인하는 ASC에서 바꿀 것 없음(바이너리에서 자동 파생), 스크린샷 재촬영 불필요(통계 토글·설정 행 추가는 사소 — 교체 여부는 사용자 판단), 심사 특이사항 없음. 스토어 텍스트는 1.4(3)에서 한국어 문장 흐름 자연화(사용자 피드백 — 설명 ko 자연화+3언어에 1.4 기능 2줄 추가, whats-new 전면 재작성, 프로모션 1.4 전용 `promotional-text-1.4.txt`). **📌 다음 버전(1.5) 확정 계획 — 상세는 `Docs/plan-1.5.md`(2026-08-20 사용자 결정 완료)**: ①워치 행동 컴플리케이션(행동 편집에서 옵트인+기간 선택[하루/이번 주/이번 달/지난 7일/지난 30일], 탭=미니 행동 화면 착지·뒤로가기로 메인 복귀) ②건강 데이터 통합(모음 탭 타일 **무료**+건강 다짐 **프리미엄**, HealthCache 구조[값은 CloudKit 저장 금지 — 5.1.3], 수면은 사용자 지정 수면 구간→깨어난 날 귀속, 모음 탭 3섹션[즐겨찾기·나머지·건강] 순서 설정) ③도움말(HelpView) 전체 문구 한국어 기준 자연화(사용자 지시 2026-08-12 — ~해요체 유지·번역투 제거·en/ja 재검토·l10n 루틴) ④업데이트 신기능 소개 팝업(버전당 1회, 全기기 업데이트 안내 — 계획서 §11). 운동 세부 종목 다짐 포함(§3.4), 스크린샷 전면 신규(아이폰·아이패드 각 10장 — §6), 모든 사전 결정 완료(결정 이력 8건·위험 검토 R1~R16). 하위 OS 인하는 검토 후 기각(근거는 계획서 §4 — 재제안 금지). ⚠️**구현은 사용자의 "진행/시작" 지시가 있을 때만 착수** — 그 전까지 코드 무변경, 추가 요구는 계획서에 계속 반영. **버전 1.3 App Store 출시 2026-08-06** — 3일 실사용+심층 검증(2026-08-05: 자가 검증 3종 ALL PASS·벌크 1만 건·일기 내보내기 일치·위젯 스모크·만료 열람·도움말 — 회귀 0) 통과 후 제출. 심층 검증에서 기록한 사소 잔여 엣지 9건은 후속 후보로만 보류(전부 극단 한정·자가 복구형, 필기 blob 동시 편집 한계는 §6.7). 1.3 내용: 아래 소기능 이력의 일기 개선 묶음(양식 펜 색 고정 + 도형·텍스트 상자 편집 개편 + 검토 후속 수정), `Marketing/AppStore/whats-new-1.3.txt`. 잔여 엣지 9건 상세: 최소 크기 커밋 스냅백·일기 상세 이탈 시 빈 텍스트 상자 잔존·페이지 가장자리 손잡이 클리핑·인라인 편집 중 페이지 스와이프 상태 잔존·회전 상자 커서 어색함 등(1.0부터의 구조 한계인 필기 blob 동시 편집 덮어쓰기·열린 캔버스 원격 미갱신은 §6.7, 같은 페이지 동시 필기 회피 권장). 1.2 내용: 주기 몫 완료 상태 표기(§4.2)+도움말 '진행률 읽는 법' 갱신(상세는 아래 소기능 이력). **버전 1.1 출시 2026-07-30.** 1.1 내용: ①**맥 일기 개방**(§6.7 — 사이드바 노출 + '그리기' 토글로 마우스 필기, 텍스트 우선 도구줄. 아이패드 경로 불변. 맥 실기 확인 완료) ②**CSV 가져오기**(§6.8 — 프리미엄, 추가 전용·미리 보기·멱등. 검증 `-csvImportTest` 20건 ALL PASS) ③**일기 기본 표시 설정**(§6.7 — 캘린더·목표·행동 전 날짜 기본값 + 날짜별 재정의, 스키마 무변경 마커 방식) ④**'짧은 기록 무시' iCloud KVS 동기화**(§6.8 — 전 기기 공통) ⑤스크린샷 전면 개편(아이폰 10·아이패드 10·워치 합성 1 × ko/en/ja — ASC 업로드 완료) ⑥스토어 메타데이터 변경(앱 이름·부제목·키워드·프로모션 — 검색·색인 강화, `Marketing/AppStore/app-name-subtitle.txt`·`keywords.txt`·`promotional-text.txt`. 스토어 표기만 변경, 설치 이름 불변) ⑦MARKETING_VERSION 1.1. **버전 1.0 출시 2026-07-28.** 이후 작업은 사용자 실사용 중 발견한 버그 수정·사용자가 원하는 소기능 추가만 한다(선제적 기능 제안·대규모 리팩터링 금지). 출시 후 소기능 이력: **일기 도형·텍스트 상자 UX 2차 개편**(2026-08-03, 사용자 요청 — §6.7. 종류별 모양 손잡이[사각형 꼭짓점 4개·원 상하좌우 4개·선/화살표 양 끝점]와 정사각형·정원 스냅 피드백, 텍스트 상자 제자리 입력[탭→바로 키보드]·테두리 색 독립, '글 수정'→'스타일' 시트로 재편, borderColorHex 필드 추가. 1.3으로 버전 상향)·**일기 도형·텍스트 상자 편집 강화**(2026-08-03, 사용자 요청 — §6.7. "정해진 모양·크기 그대로만 나온다"는 보고: 크기 손잡이(가로세로 자유·맥 마우스 대응)·회전 제스처·'도형 수정' 시트[색·선 굵기·채우기·모서리 둥글기·회전]·텍스트 시트 확장[글자 크기·굵게·정렬·테두리], DiaryPageItem에 기본값 필드 8개 추가)·**양식 페이지 펜 색 고정**(2026-08-03, 사용자 요청 — §6.7. 다크/라이트 잉크 반전으로 맥·아이패드에서 필기가 안 보이던 실사용 보고 해소, 내보내기 라이트 트레잇 고정 포함)·**주기 몫 완료 상태 표기**(2026-08-01, 사용자 요청 — §4.2. 도움말 '진행률 읽는 법' 문구도 갱신. 같은 날 MARKETING_VERSION 1.2(빌드 1)로 상향 + `Marketing/AppStore/whats-new-1.2.txt` 작성·TestFlight 업로드, **심사 통과 → App Store 출시 완료(2026-08-02, 사용자 확인)**). 업데이트 제출: 버전 올려 빌드 업로드 → 심사 제출(IAP는 첫 심사에서 승인됐으므로 첨부 불필요). 출시 전 이력 — RC는 커밋 `f05e611`(버전 1.0 (1)), 이후 실사용 보고 기반 수정 라운드(전부 커밋·푸시·실기기 확인 완료): l10n 누락 일괄·ja 앱 이름 'Haru Danim' 통일·워치 컴플리케이션 추천 캡 제거(§11)·⑥ 위젯 종료 버튼(§10)·진행률 환산 캡+수행일 집계+수행일 아님 표기(§4.2)·파일명/CSV 헤더 현지화(§7)·워치 컴플리케이션 목표 필터(§6.4·§11, 사용자 승인 소기능)·기록 시각 입력 상시 휠 다이얼+분 절사(§6.5)·일기 달력 기분 사진 백레이어(§6.7)·다짐 없는 목표 '다짐 없음' 표기(§4.3)·워치 측정 중 행 탭 종료(§11)·도움말 예시 스크린샷 18장(§6.8)·설정 하루 시작 시간 접힘 행(§6.5)·**모음 탭 즐겨찾기 모아 보기**(§6.1 — 행동 많아질 때 혼잡도 대응, 사용자 승인 소기능. v1 별도 카드 가로 줄[대안 A~F 중 A]이 "따로 노는 느낌" 실사용 피드백으로 v2 그리드 섹션 통합+나머지 접기로 교체, 같은 날 후속 피드백으로 편집 모드 섹션 인지·섹션 간 드래그 지정/해제·"지정 순서대로 뒤에" 규칙 추가, 2026-07-22)·**en 복수형 정리**(2026-07-22 — 수량 1일 때 "1 times/quests" 류 오류를 카탈로그 plural variation으로 14건 전환[iOS 10·위젯 3·워치 1], 모음 탭 섹션 제목 en "Favorite"→"Favorites"로 워치와 통일. ko/ja 무영향). **App Store 등록 자료는 `Marketing/`에 완비**(설명·키워드·구독 메타·스크린샷 원본/합성판, README에 재생성 절차 — 앱 변경이 자료에 영향 주면 요청 없이 함께 갱신할 것. 2026-07-22 즐겨찾기 섹션(v2) 반영해 아이폰·아이패드 01-main과 help-main ko/en/ja 재촬영·합성판 재생성. **2026-07-29 스크린샷 세트 확장** — 아이폰 8장(+위젯·버블 메뉴·iCloud 동기화 합성·다크 모드)/아이패드 7장(+주간 타임테이블·위젯·동기화 합성) × ko/en/ja, 촬영·합성 절차는 Marketing/README '추가 스크린샷' 절. **1.1 제출 때 ASC 업로드 완료**). **사업자 등록·통신판매업 신고 완료(2026-07-22)** — 서류 절차 끝, ASC 등록·유료 계약 진행 가능(순서는 Marketing/README 체크리스트). 사용자는 계속 실사용 테스트 중이며 버그 보고 시: 최소 변경 + 시뮬레이터 재검증 + l10n 루틴(§2.3) + Debug/Store(워치 파일이면 워치까지) 빌드 + 커밋·푸시 | +| 현재 상태 (2026-08-22) | **버전 1.5 (빌드 9) — 소킹 사용자 요구·실측 수정+성능 최적화 반영(2026-08-26), TestFlight 재업로드 대기. 사용자 예고: 기능 수정은 이것으로 종료(이후는 버그·오류 수정만)**. ✅**동기화 정지 이슈 해결 확인(2026-08-22 밤, 사용자 실기기)**: 일기에 도형·텍스트 상자(DiaryPageItem)가 있으면 그 기기의 CloudKit 동기화 전체가 정지하던 문제(내보내기 대기열 직렬 — 거부된 아이템 뒤로 전부 막힘) — 원인은 **1.3의 DiaryPageItem 스타일 필드 10종이 프로덕션 스키마에 없었던 것**(1.0 출시 때가 마지막 배포였고, 1.3 이후 개발 빌드가 iCloud 내보내기를 한 적이 없어 개발 스키마에도 미생성이었음). 해결 절차 실행: 시뮬 519869F7(사용자 iCloud 로그인·재인증)에서 일기 요소 시드 포함 전체 내보내기로 개발 스키마 필드 생성(success·error nil) → 사용자가 콘솔 재배포 → **도형·텍스트 상자 있는 상태의 동기화 왕복 정상 확인(사용자)**. 교훈: **새 모델 필드는 배포 전 '개발 빌드로 그 타입 레코드를 실제 내보냈는지'까지 확인할 것** — 콘솔 diff에 타입 이름이 떠도 필드가 전부 실렸는지 봐야 한다. 업로드 검증 실측 2건: 빌드 1=ITMS-90683(HealthKit 엔타이틀먼트 보유 시 읽기 전용이어도 `NSHealthUpdateUsageDescription` 필수 — 쓰기 사유 3언어 추가, 쓰기 요청이 없어 표시될 일 없음), 빌드 2=ITMS-90626(**앱 인텐트 메타데이터에 'iPhone' 단어 금지** — 신규 컴플리케이션 인텐트·위젯 설명에서 '하루 다님 앱'으로 교체. 화면 뷰 문구의 iPhone은 스캔 대상 아님[1.4 전례]) → **빌드 3**으로 재업로드. **1.5 추가분(빌드 4, 2026-08-22 — 소킹 중 사용자 요구, 스키마 무변경·전부 로컬 설정/표시 계층)**: ⑦**아이폰 일기 탭 개방**(§6.7 — AppTab.phoneCases 개방[radialOrder 필터 제거·버블 8개 자동 배치 확인], 노트 필기는 맥 '그리기' 토글 문법 재사용[DeviceLayout.isPhone 신설, drawingPolicy anyInput, 가로 스크롤 도구 줄, 배치↔그리기 상호 배타 — 아이패드 경로 무변경], 일기 잠금 설정 전 기기 노출) ⑧**일기 하루 정리 '건강 데이터' 카드**(§6.7 — DiarySection.health[케이스 마지막이라 기존 사용자 목록 끝에 추가], DiaryHealthCard: 지표 선택 시트 공용화[HealthMetricPickerSheet Binding화], 저장은 기기 로컬 diary.healthMetrics[비면 타일 선택 상속], 맥은 목록·화면 모두 숨김, 인쇄 요약에 값 줄 DiaryPrintHealthRow 동승) ⑨**일기 타임테이블 수면·운동 실구간 블록**(§6.7 — **HealthIntervals 신설**[App Group health.intervals.v1, 400일, 실구간을 논리적 하루로 분할 저장·병합, CloudKit 금지 동일], refreshRecent/백필이 유지, ExportSnapshot.injectingHealthBlocks 주입[캘린더 전례·최하층 렌더 healthBlockView 반투명+실선], 지표 고정색 수면 인디고·운동 주황, 필터 시트 '건강 데이터' 토글[RecordFilterSheet showsHealthSection — 전 날짜 공통 diary.timetableHealthHidden, 기본 켬]+**맥 안내 문구**, 일기 필터 버튼 상시 노출로 변경, 내보내기 렌더러 동일 주입) ⑩**수면 표시 구간 설정**(§6.8 — SleepWindowPrefs[LocalPrefs]: 전체 스펙+요일별 7종[켤 때만], 설정 → 건강 데이터 → '수면 표시 구간'[SleepWindowSettingsView — 시작=끝이면 24시간 창], 평문 'sleep' 캐시 키=그날 유효 구간 값으로 변경[타일·일기 카드 공유], 백필 서명에 요일 매핑 포함[배정만 바뀌어도 재백필], **새 수면 다짐 기본 구간을 여기서 시드**) ⑪일기 목표 카드의 건강 다짐 값 단위 실측 수정("8,432회/8,000보"→지표 단위 — DiaryGoalsCard.valueLabel healthTarget 분기) ⑫**소킹 실기기 실측 버그 2건 수정(빌드 5)**: ⓐ더보기 탭 안 일기 달력에서 날짜 탭이 조용히 무시됨 — `AppRouter.morePath`가 `[AppTab]` 고정 타입이라 Date 푸시 불가 → **NavigationPath로 변경**(회귀 감시 인자 `-morePushDiaryToday`, 라디얼·사이드바는 원래 무사) ⓑ수면 블록이 수면 단계(코어·렘) 로우데이터대로 칸칸이 갈라짐 → **10분 이하의 깸은 이어 붙여 한 덩어리로**(DiaryHealthTimetable.sleepDisplayMergeGap — 표시 전용, 값 무영향. 20분쯤 깼다 자면 나뉘는 게 맞다는 사용자 규칙) ⑬**기록 탭 타임테이블에도 수면·운동 블록**(하루·주간 — DiaryHealthTimetable.blocks 단일 공급 지점·숨김 토글 공유[기록 필터 시트에도 건강 섹션], 내보내기는 `injectingHealthBlocks(forDayKeys:math:)`로 하루·주간 주입 + trim 표시 범위를 블록만큼 확장) ⑭**타임테이블 표시 색 설정**(설정 → 건강 데이터 → '타임테이블 표시 색' — 수면·운동 ColorPicker, 기본 인디고·주황[빈 값], 전 타임테이블·내보내기 공통 적용, 인자 `-healthColorPreview`) ⑮**버블 찌그러짐 실측 수정(빌드 6, 2026-08-23)**: 일기 버블 추가로 8개가 되자 이웃 간격(~9.6pt)이 유리 합체 판정 거리(18pt) 안으로 들어와 정지 상태에서도 원들이 서로를 향해 늘어남 — `glassBlendSpacing` 18→6(펼침 상태 정원 분리, FAB 모핑은 겹침 구간이라 유지. 마케팅 06-bubble 3언어 재촬영) ⑯**건강 다짐 표시 색(빌드 7, 2026-08-23 — 사용자 요구)**: 건강 다짐이 고정 분홍이던 것을 편집기 건강 섹션에서 색 선택(프리셋 12+피커, 기본 분홍=빈 값[시스템 분홍의 다크 적응 유지]) — **Quest 신규 필드 `healthColorHex`**(기본 "", targetColor 단일 지점 분기라 목표 탭·모음 카드·일기·위젯·워치 자동 반영, 행동·꼬리표 다짐은 저장 시 "" 정규화, 타임테이블 블록 색과 별개). ⚠️**CloudKit 스키마 추가 — 배포 절차(개발 내보내기→콘솔 Deploy)가 빌드 7 설치보다 선행 필수**(DiaryPageItem 전례 — 미배포 상태로 다짐 수정 시 그 기기 동기화 정지). → 배포·설치 완료(사용자). ⑰**위젯·워치 색 미반영 실측 수정(빌드 8)**: 위젯 QuestCellSnapshot(WidgetSupport)과 워치 스냅숏(WatchSyncManager)이 targetColor를 안 타고 자체 폴백을 쓰고 있었음 — 위젯은 분홍 #E0558C 하드코딩, **워치는 아예 초록 폴백(1.5 출시분부터 건강 다짐이 일반색으로 보이던 잠복 표시 버그)** → 두 곳 다 healthColorHex 우선·기본 #E0558C로 통일(④ 그리드에서 걸음=파랑·나머지=분홍 실측). 값 라벨은 두 표면 모두 원래 건강 단위 정상. ⑱**성능 최적화(빌드 9, 2026-08-26 — 소킹 중 '1.4 대비 버벅임 증가' 보고, 동작·수치 완전 불변 원칙)**: 원인 진단 결과 1.5 건강 캐시가 값 1개 읽을 때마다 전체 딕셔너리(지표×400일)를 브리징 — 건강 다짐 행 하나 렌더에 ~38회+, 워치 스냅숏에 다짐당 ~76회가 메인 스레드에서 반복. 적용 7건(전부 등가 최적화): ⓐHealthCache·HealthIntervals **인메모리 캐시**(세대 카운터 `health.cache.gen`/`health.intervals.gen`으로 프로세스 간 무효화 — 쓰기는 메인 앱 단일 작성자, workoutKeys의 load() 이중 호출도 제거) ⓑ**DayMath.calendar 저장 프로퍼티화**(접근마다 Calendar 사본 생성하던 전역 곱셈 비용 제거) ⓒ**수면 백필 포인터 스위프**(400일×전체 수면 샘플 O(n×m) 전수 클리핑 → 정렬+lo/hi 스위프, 무작위 퍼즈 3,000회 등가 증명 — 하루 첫 실행 정지 해소) ⓓrefreshRecent 캐시 기록 배칭(일수×2회→총 2회) ⓔ**QuestProgress.spanValue/spanRawValue 버킷화**(하루 단위 다짐의 주/월 게이지가 날마다 전체 기록 재순회하던 O(일수×기록수) → perDayGaugeValues 1회 순회. ⚠️연속 계산 perDayValues와 달리 **미래 기록을 now로 자르지 않는 게이지 스펙 보존** — spanRawValue는 예전 Aggregator-only 동작 보존 위해 perDayRecordValues 직결) ⓕ위젯 라이브 타임라인 makeEntry에 refresh 파라미터(미래 엔트리 6개가 각각 새 ModelContainer를 열던 것 → 타임라인당 1회, ②③④·잠금 4곳) ⓖ일기 건강 카드 칩 value() 이중 호출 제거. **의도적으로 제외**: 재조회 스로틀(값 신선도가 변해 동작 변화), 워치 스냅숏 백그라운드화(SwiftData 메인 컨텍스트 위험), 모음 탭 셀 오늘 값 버킷화(구조 변경 — 체감 보고 재논의). 검증: A/B 등가(옛/새 빌드를 각각 새 컨테이너+동일 시드로 캡처 — streak·건강·인텐트 덤프 3종 값 동일[정렬 후 diff 0], 목표·모음·위젯④·일기 4화면 **픽셀 동일**[상태바 시계·시뮬 iCloud 배너 제외]), 자가 검증 62/20/27/10 ALL PASS(26.5+**18.5 심 62건도 ALL PASS**), 벌크 1만 건 3탭 렌더 정상, 퍼즈 3,000회, 3종 빌드(Store·워치 포함) 그린, 신규 현지화 문자열 0(카탈로그 무변경). whats-new-1.5 3언어에 성능 개선 줄 추가. 검증: 61/20/27/10 ALL PASS(26.5), 3종 빌드 그린, 전 카탈로그 missing/stale 0, 시각 QA(아이폰 요약·건강 카드·타임테이블 블록·노트 도구 줄·버블 8개·수면 구간 화면·아이패드·맥 분기·18.5). 스토어 자료: whats-new-1.5에 일기 확장 절 추가·설명 3언어 일기 항목 갱신. 신규 인자 `-sleepWindowPreview`(§14), `-seedHealthCache`가 실구간(수면 자정 분할+달리기)도 시드. 계획·결정 이력은 `Docs/plan-1.5.md`(전 섹션 ✅구현 완료). 1.5 내용: ①**워치 '행동 기록' 컴플리케이션**(§11 — 행동 편집 옵트인+표시 기간 5종[하루/이번 주/이번 달/지난 7일/지난 30일, 롤링은 rollingRange 재사용], 측정 중 노란 타이머, 탭=워치 앱 미니 행동 화면 push[뒤로가기=메인], recommendations 상한 없음) ②**모음 탭 건강 데이터 타일**(무료, §6.1 — 걸음·운동·수면 등 8지표 선택·순서, 접기, 연결 CTA[명시적 탭 권한], 안내 시트, 즐겨찾기·나머지·건강 3섹션 순서 설정[§6.8], 맥은 섹션 숨김) ③**건강 다짐**(프리미엄, §4.2·§6.4 — 8지표+운동 종목 20종[workout. 인코딩], 수면은 다짐별 수면 구간[기본 21:00~09:00]을 '구간 끝이 속한 논리적 하루'에 통귀속[겹침 분할과 다른 의도된 예외], 하루 단위 전용·마감 시각 미지원, QuestProgress 값 공급 단일 지점 3곳만 분기[수학 무변경 — 기존 49건 그린이 증거], HealthCache[App Group, 400일, ⚠️5.1.3: 값은 CloudKit 저장 금지 — 정의만 동기화]·백필·부트스트랩, 데이터 없는 기기는 모수 제외+'데이터 없음' 표기+판정 보류, 구버전 이중 상태는 행동/꼬리표 우선 정규화) ④**신기능 소개 팝업**(WhatsNewView — 버전당 1회, 신규 설치 시드로 미표시, 온보딩 우선, 全기기 업데이트 안내) ⑤**도움말 전면 자연화+신규 주제 3개**(사용자 예약 작업 — 오타·번역투·UI 명칭 정정, en/ja 전면 재번역·용어 통일[Action/アクション 등]) ⑥HealthKit 엔타이틀먼트(iOS 앱만)+NSHealthShareUsageDescription 3언어+PRIVACY.md 건강 문단. 검증: `-progressSelfTest` **61건**(건강 H 시리즈 12 신규)·20·27·10 ALL PASS(26.5+18.5 심), Debug/Store/워치(26.2·11.5) 빌드, 시각 QA 20여 장(워치 컴플리케이션 실데이터·미니 화면·타일·다짐 행·편집기·팝업·ja 도움말), 실버전 업그레이드 팝업 경로·벌크 1만 건+건강 결합 확인. 스토어 자료: whats-new-1.5·promotional-text-1.5·설명 3언어 갱신, **스크린샷 전면 신규 — 아이폰 10·아이패드 10·워치 1 × ko/en/ja 원본 57장+합성 63장 재생성 완료**(09-records→09-health 교체, Marketing/README 절차·주의 갱신). **CloudKit 프로덕션 스키마 배포 완료(2026-08-22, 사용자 콘솔 실행)** — Quest 신규 필드 3종(healthMetricRaw·sleepWindow*)은 개발 스키마에 없어서(디버그 내보내기 이력 없음이 원인) 시뮬 519869F7에 사용자 iCloud 로그인 후 디버그 빌드를 `-premium YES -cloudSync YES -seedHealthQuest YES`로 실행 → Sandbox 환경 전체 내보내기 성공(98레코드, error nil)으로 필드 생성 → 콘솔 배포(이 시뮬은 iCloud 로그인 유지 — 향후 스키마 작업 재사용 가능). **실측 발견: 1.3의 DiaryPageItem 스타일 필드가 프로덕션 미배포 상태였음**(마지막 배포=1.0 출시 시점 — 1.3 출시[8/6] 이후 도형·텍스트 상자 신규 스타일 필드 동기화가 조용히 실패했을 가능성, 이번 배포로 해소·밀린 내보내기는 자동 재시도. 소킹 중 아이패드↔맥 요소 동기화 교차 확인 권장). **남은 출시 절차(사용자)**: ①TestFlight 실기기 소킹(진행 중 — 실제 건강 데이터·워치 컴플리케이션·기기 간 건강 다짐 정의 동기화 중점) ②ASC 심사 제출(스크린샷 framed 세트 교체·whats-new/프로모션/설명 반영). **1.6 후보 보류 기록: `Docs/plan-1.6.md`**(타임테이블 건강 데이터 표시 — 2026-08-22 사용자 "일단 보류", 구현 금지·재논의 시 착수). 운동 종목 목록(20종)은 §3.4 — 사용자 실사용 종목 빠졌으면 추가 요청. **버전 1.4 (빌드 3) App Store 출시 완료(2026-08-13, 사용자 확인)** — 2026-08-13 심사 제출 후 같은 날 출시 확인. TestFlight 실기기 테스트(문제 없음 확인) 후 제출했음. iOS 18 실기기는 미확보로 미테스트(시뮬 검증 106건 ALL PASS로 갈음 — 해당 사용자 유입 시 피드백 대응 예정). 1.4 내용(사용자 A안 승인, 2026-08-11 세션에서 전부 구현·검증): ①**iOS 18.0 하한 인하**(위 플랫폼 행 — 글라스 버블 머티리얼 폴백·사용자 심볼 안전 렌더 `Image(safeSymbol:)`[iOS 55곳+워치 7곳, 18에 없는 카탈로그 심볼 3개 물음표 폴백]·`-symbolAuditDump`. ⚠️하한 18 Release(-O wholemodule)에서 swift-frontend가 제네릭 중첩 Coordinator의 deinit 최적화 중 크래시하는 컴파일러 버그 실측 — DiaryZoomCoordinator를 비제네릭 톱레벨+AnyView 소거로 우회, 되돌리지 말 것) ②**펜슬 저장 디바운스**(§6.7 — 획마다 전체 직렬화·블랍 재기록하던 버벅임 해소) ③**통계 '오늘 기준' 롤링**(§6.6·§10 ⑤ — 지난 7일/30일) ④**CSV 구간 내보내기**(§6.8, 코어 CSVExport 추출) ⑤**일기 내보내기 후 삭제**(§6.7, 렌더 코어 DiaryExportRenderer 추출) ⑥**데이터 정리·초기화**(§6.8 — 전체/처음~날짜까지+백업 3종[CSV·일기 PDF·정리 리포트 ArchiveReport]+**'일기만' 대상 축**[1.4(3), 2026-08-12 — 기록·구조·양식 보존, 백업은 일기 PDF만, `DataReset.deleteDiaries`·`-dataResetScope diary`·자가 검증 27건으로 확장]) ⑧**라디얼 모드 FAB 가림 수정**(1.4(3) — 목록 마지막 행이 FAB에 가려지던 실측 문제: 각 탭 루트에 하단 safeAreaInset 78pt, ⚠️NavigationStack '안쪽'에 붙일 것[바깥은 TabView가 safe area 재설정해 무시됨, 실측]) ⑦도움말 재구성(1.4(2) 검수 후속, 2026-08-12 — 뭉친 주제 3곳 분리: 기록·통계 그룹에 '지난 7일·30일로 보기'·'데이터 정리·초기화' 독립 주제 신설[CSV 주제는 백업·복원만, 비교 주제는 1.3 원문 복귀], 일기 그룹 '펜슬 노트 페이지'에서 '사진·도형·텍스트 꾸미기' 분리. 이미지는 그룹당 대표 1주제 원칙 유지 — 18장 전수 실사로 참조·언어 매칭 무결 확인)·l10n(전 카탈로그 missing/stale 0)·**워치 실행 햅틱 .click→.success 상향**(1.4(2) — 실사용 '너무 약함' 보고)·MARKETING_VERSION 1.4/**빌드 3**(TestFlight 재업로드용 — 같은 버전은 빌드 번호만 올려 업로드하면 1.4(2)로 기존 테스터에 배포됨)·`Marketing/AppStore/whats-new-1.4.txt`. 검증: 자가 검증 `-progressSelfTest` 49·`-csvImportTest` 20·`-intentSmokeTest` 10·`-dataResetTest` 27 ALL PASS(26 심+18.5 심), Debug/Store/워치 빌드 성공, 18.5·26 시각 QA(버블 폴백·일기 줌·롤링 통계·초기화 화면·리포트 PDF 3페이지 실물). **스토어 제출 시**: 하한 인하는 ASC에서 바꿀 것 없음(바이너리에서 자동 파생), 스크린샷 재촬영 불필요(통계 토글·설정 행 추가는 사소 — 교체 여부는 사용자 판단), 심사 특이사항 없음. 스토어 텍스트는 1.4(3)에서 한국어 문장 흐름 자연화(사용자 피드백 — 설명 ko 자연화+3언어에 1.4 기능 2줄 추가, whats-new 전면 재작성, 프로모션 1.4 전용 `promotional-text-1.4.txt`). **📌 다음 버전(1.5) 확정 계획 — 상세는 `Docs/plan-1.5.md`(2026-08-20 사용자 결정 완료)**: ①워치 행동 컴플리케이션(행동 편집에서 옵트인+기간 선택[하루/이번 주/이번 달/지난 7일/지난 30일], 탭=미니 행동 화면 착지·뒤로가기로 메인 복귀) ②건강 데이터 통합(모음 탭 타일 **무료**+건강 다짐 **프리미엄**, HealthCache 구조[값은 CloudKit 저장 금지 — 5.1.3], 수면은 사용자 지정 수면 구간→깨어난 날 귀속, 모음 탭 3섹션[즐겨찾기·나머지·건강] 순서 설정) ③도움말(HelpView) 전체 문구 한국어 기준 자연화(사용자 지시 2026-08-12 — ~해요체 유지·번역투 제거·en/ja 재검토·l10n 루틴) ④업데이트 신기능 소개 팝업(버전당 1회, 全기기 업데이트 안내 — 계획서 §11). 운동 세부 종목 다짐 포함(§3.4), 스크린샷 전면 신규(아이폰·아이패드 각 10장 — §6), 모든 사전 결정 완료(결정 이력 8건·위험 검토 R1~R16). 하위 OS 인하는 검토 후 기각(근거는 계획서 §4 — 재제안 금지). ⚠️**구현은 사용자의 "진행/시작" 지시가 있을 때만 착수** — 그 전까지 코드 무변경, 추가 요구는 계획서에 계속 반영. **버전 1.3 App Store 출시 2026-08-06** — 3일 실사용+심층 검증(2026-08-05: 자가 검증 3종 ALL PASS·벌크 1만 건·일기 내보내기 일치·위젯 스모크·만료 열람·도움말 — 회귀 0) 통과 후 제출. 심층 검증에서 기록한 사소 잔여 엣지 9건은 후속 후보로만 보류(전부 극단 한정·자가 복구형, 필기 blob 동시 편집 한계는 §6.7). 1.3 내용: 아래 소기능 이력의 일기 개선 묶음(양식 펜 색 고정 + 도형·텍스트 상자 편집 개편 + 검토 후속 수정), `Marketing/AppStore/whats-new-1.3.txt`. 잔여 엣지 9건 상세: 최소 크기 커밋 스냅백·일기 상세 이탈 시 빈 텍스트 상자 잔존·페이지 가장자리 손잡이 클리핑·인라인 편집 중 페이지 스와이프 상태 잔존·회전 상자 커서 어색함 등(1.0부터의 구조 한계인 필기 blob 동시 편집 덮어쓰기·열린 캔버스 원격 미갱신은 §6.7, 같은 페이지 동시 필기 회피 권장). 1.2 내용: 주기 몫 완료 상태 표기(§4.2)+도움말 '진행률 읽는 법' 갱신(상세는 아래 소기능 이력). **버전 1.1 출시 2026-07-30.** 1.1 내용: ①**맥 일기 개방**(§6.7 — 사이드바 노출 + '그리기' 토글로 마우스 필기, 텍스트 우선 도구줄. 아이패드 경로 불변. 맥 실기 확인 완료) ②**CSV 가져오기**(§6.8 — 프리미엄, 추가 전용·미리 보기·멱등. 검증 `-csvImportTest` 20건 ALL PASS) ③**일기 기본 표시 설정**(§6.7 — 캘린더·목표·행동 전 날짜 기본값 + 날짜별 재정의, 스키마 무변경 마커 방식) ④**'짧은 기록 무시' iCloud KVS 동기화**(§6.8 — 전 기기 공통) ⑤스크린샷 전면 개편(아이폰 10·아이패드 10·워치 합성 1 × ko/en/ja — ASC 업로드 완료) ⑥스토어 메타데이터 변경(앱 이름·부제목·키워드·프로모션 — 검색·색인 강화, `Marketing/AppStore/app-name-subtitle.txt`·`keywords.txt`·`promotional-text.txt`. 스토어 표기만 변경, 설치 이름 불변) ⑦MARKETING_VERSION 1.1. **버전 1.0 출시 2026-07-28.** 이후 작업은 사용자 실사용 중 발견한 버그 수정·사용자가 원하는 소기능 추가만 한다(선제적 기능 제안·대규모 리팩터링 금지). 출시 후 소기능 이력: **일기 도형·텍스트 상자 UX 2차 개편**(2026-08-03, 사용자 요청 — §6.7. 종류별 모양 손잡이[사각형 꼭짓점 4개·원 상하좌우 4개·선/화살표 양 끝점]와 정사각형·정원 스냅 피드백, 텍스트 상자 제자리 입력[탭→바로 키보드]·테두리 색 독립, '글 수정'→'스타일' 시트로 재편, borderColorHex 필드 추가. 1.3으로 버전 상향)·**일기 도형·텍스트 상자 편집 강화**(2026-08-03, 사용자 요청 — §6.7. "정해진 모양·크기 그대로만 나온다"는 보고: 크기 손잡이(가로세로 자유·맥 마우스 대응)·회전 제스처·'도형 수정' 시트[색·선 굵기·채우기·모서리 둥글기·회전]·텍스트 시트 확장[글자 크기·굵게·정렬·테두리], DiaryPageItem에 기본값 필드 8개 추가)·**양식 페이지 펜 색 고정**(2026-08-03, 사용자 요청 — §6.7. 다크/라이트 잉크 반전으로 맥·아이패드에서 필기가 안 보이던 실사용 보고 해소, 내보내기 라이트 트레잇 고정 포함)·**주기 몫 완료 상태 표기**(2026-08-01, 사용자 요청 — §4.2. 도움말 '진행률 읽는 법' 문구도 갱신. 같은 날 MARKETING_VERSION 1.2(빌드 1)로 상향 + `Marketing/AppStore/whats-new-1.2.txt` 작성·TestFlight 업로드, **심사 통과 → App Store 출시 완료(2026-08-02, 사용자 확인)**). 업데이트 제출: 버전 올려 빌드 업로드 → 심사 제출(IAP는 첫 심사에서 승인됐으므로 첨부 불필요). 출시 전 이력 — RC는 커밋 `f05e611`(버전 1.0 (1)), 이후 실사용 보고 기반 수정 라운드(전부 커밋·푸시·실기기 확인 완료): l10n 누락 일괄·ja 앱 이름 'Haru Danim' 통일·워치 컴플리케이션 추천 캡 제거(§11)·⑥ 위젯 종료 버튼(§10)·진행률 환산 캡+수행일 집계+수행일 아님 표기(§4.2)·파일명/CSV 헤더 현지화(§7)·워치 컴플리케이션 목표 필터(§6.4·§11, 사용자 승인 소기능)·기록 시각 입력 상시 휠 다이얼+분 절사(§6.5)·일기 달력 기분 사진 백레이어(§6.7)·다짐 없는 목표 '다짐 없음' 표기(§4.3)·워치 측정 중 행 탭 종료(§11)·도움말 예시 스크린샷 18장(§6.8)·설정 하루 시작 시간 접힘 행(§6.5)·**모음 탭 즐겨찾기 모아 보기**(§6.1 — 행동 많아질 때 혼잡도 대응, 사용자 승인 소기능. v1 별도 카드 가로 줄[대안 A~F 중 A]이 "따로 노는 느낌" 실사용 피드백으로 v2 그리드 섹션 통합+나머지 접기로 교체, 같은 날 후속 피드백으로 편집 모드 섹션 인지·섹션 간 드래그 지정/해제·"지정 순서대로 뒤에" 규칙 추가, 2026-07-22)·**en 복수형 정리**(2026-07-22 — 수량 1일 때 "1 times/quests" 류 오류를 카탈로그 plural variation으로 14건 전환[iOS 10·위젯 3·워치 1], 모음 탭 섹션 제목 en "Favorite"→"Favorites"로 워치와 통일. ko/ja 무영향). **App Store 등록 자료는 `Marketing/`에 완비**(설명·키워드·구독 메타·스크린샷 원본/합성판, README에 재생성 절차 — 앱 변경이 자료에 영향 주면 요청 없이 함께 갱신할 것. 2026-07-22 즐겨찾기 섹션(v2) 반영해 아이폰·아이패드 01-main과 help-main ko/en/ja 재촬영·합성판 재생성. **2026-07-29 스크린샷 세트 확장** — 아이폰 8장(+위젯·버블 메뉴·iCloud 동기화 합성·다크 모드)/아이패드 7장(+주간 타임테이블·위젯·동기화 합성) × ko/en/ja, 촬영·합성 절차는 Marketing/README '추가 스크린샷' 절. **1.1 제출 때 ASC 업로드 완료**). **사업자 등록·통신판매업 신고 완료(2026-07-22)** — 서류 절차 끝, ASC 등록·유료 계약 진행 가능(순서는 Marketing/README 체크리스트). 사용자는 계속 실사용 테스트 중이며 버그 보고 시: 최소 변경 + 시뮬레이터 재검증 + l10n 루틴(§2.3) + Debug/Store(워치 파일이면 워치까지) 빌드 + 커밋·푸시 | | 출시·운영 메모 (2026-07-28) | **ASC 등록·심사·출시 전부 완료** — 제출 1건에 앱 1.0+구독 그룹+상품 3종 동반(신형 ASC는 각 항목의 "심사에 추가"로 하나의 제출 초안에 담는 방식), '앱 개인정보 보호'="데이터 수집 안 함", 유료 앱 계약·대한민국 세금 양식 활성, 소규모 사업자 프로그램 가입. 개발자 본인 프리미엄은 **평생 이용권 특가 코드(무료 Offer Code) 교환**으로 스토어 버전에 적용됨(IAP용 프로모션 코드는 2026-03 폐지 — 이후 무료 지급은 특가 코드만 가능, 생성 후 교환 가능까지 최대 1시간). 상시 참고: `ITSAppUsesNonExemptEncryption=NO`, PrivacyInfo.xcprivacy 4개 번들(수집·트래킹 없음), 개인정보처리방침=`github.com/notalentprogrammer/HaruDanim` PRIVACY.md·이용약관=Apple 표준 EULA(결제 화면·앱 설명 모두 링크). **iCloud 프로덕션 동기화 확인 완료(2026-07-28)** — 아이폰·아이패드·맥 3기기 반나절 실사용에서 기존 데이터 포함 정상 왕복(개발→프로덕션 CloudKit 환경 전환에 따른 재업로드 우려 해소. 향후 동기화 문제 보고 시 이 전환 이력 참고). **정산 계좌 변경 완료** — 1.0 출시 시점에 이미 처리(2026-08-06 사용자 확인). 남은 운영 예정 작업 없음. 절차 상세 기록은 Marketing/README.md 체크리스트 | --- diff --git a/myApp/HaruDanim/Docs/plan-1.5.md b/myApp/HaruDanim/Docs/plan-1.5.md index 38354bf..fbe190e 100644 --- a/myApp/HaruDanim/Docs/plan-1.5.md +++ b/myApp/HaruDanim/Docs/plan-1.5.md @@ -191,3 +191,11 @@ - 시드: -seedHealthQuest 걸음 다짐에 #3E7CB1 시드(신규·멱등 재실행 모두 — 렌더 검증+스키마 내보내기 트리거 겸용). 도움말·whats-new 3언어 갱신, l10n 0/0. - 후속(빌드 8): 위젯·워치 스냅숏이 targetColor 미경유(자체 폴백 — 위젯 분홍 하드코딩, 워치는 초록 폴백[1.5 잠복 표시 버그]) → healthColorHex 우선·기본 #E0558C로 통일. ④ 그리드 실측(걸음 파랑/기본 분홍). 스키마 무변경 — 콘솔 작업 불필요. + +### §12 후속 4 — 성능 최적화 (2026-08-26, 빌드 9) + +- **발단(사용자 소킹 보고)**: 1.5가 1.4 대비 전반적 버벅임 증가(아이폰 15PM·아이패드 3세대 공통, 기능 이상 없음). 원칙: **동작·수치·안정성 완전 불변 — 등가 최적화만** 적용(관찰 가능한 동작이 변하는 항목은 제외). +- **진단(코드 전수 정독)**: 몸통은 건강 캐시 읽기 방식 — `HealthCache.value()`가 호출마다 전체 딕셔너리(지표 10여 종×400일 ≈ 수천 엔트리)를 defaults에서 통째로 브리징. 건강 다짐 진행률이 "하루 값×일수" 구조라 다짐 행 하나 렌더에 ~38회+, 워치 스냅숏(커밋마다·메인 스레드)에 다짐당 ~76회, 여기에 ②수면 백필 O(400일×전체 수면 샘플)의 하루 1회 메인 정지 ③위젯 라이브 타임라인의 엔트리 7개×새 컨테이너 오픈 ④DayMath.calendar 접근마다 Calendar 사본 생성(전역 곱셈) ⑤spanValue의 O(일수×기록수)(1.4부터 있던 것 — 데이터 증가로 악화)가 겹친 그림. +- **적용 7건**: ⓐ건강 캐시 2종 인메모리화(세대 카운터로 프로세스 간 무효화, workoutKeys 이중 load 제거) ⓑDayMath.calendar 저장 프로퍼티화 ⓒ수면 백필 정렬+포인터 스위프 ⓓrefreshRecent 기록 배칭 ⓔspanValue/spanRawValue 하루 버킷화(**게이지의 '미래 기록 즉시 반영' 스펙 보존** — streak의 perDayValues와 별도 헬퍼 perDayGaugeValues/perDayRecordValues) ⓕ위젯 4프로바이더 makeEntry refresh 파라미터(타임라인당 컨테이너 1회) ⓖ일기 건강 카드 칩 value() 1회화. +- **의도적 제외**: 건강 재조회 스로틀(신선도 변화=동작 변화), 워치 스냅숏 백그라운드화(SwiftData 메인 컨텍스트 위험), 모음 탭 셀 오늘 값 버킷화(구조 변경 — 소킹 체감 보고 후 재논의). +- **검증(엄밀 A/B 포함)**: ①옛/새 빌드를 각각 **새 컨테이너+동일 시드**(seedDemo+건강 캐시+건강 다짐+주기 몫)로 캡처 — streak·건강 다짐·인텐트 스모크 덤프 3종 **값 완전 동일**(순서 무관 정렬 diff 0 — fetch 순서 비결정성만 존재), 목표 탭·모음 탭·위젯 ④·일기 4화면 **픽셀 단위 동일**(자작 pixdiff — 상태바 시계·시뮬 iCloud 배너만 제외) ②자가 검증 62/20/27/10 ALL PASS(26.5 심+**18.5 심 62건 별도 ALL PASS**) ③수면 스위프는 무작위 퍼즈 **3,000회 등가 증명**(창 40/400/7개×길이 1분~24h×DST식 겹침 창×구간 0~2,000개×경계 정확 접촉·0길이·전체 덮개) ④벌크 1만 건 시드에서 목표·통계·모음 3탭 렌더 정상(수치 실측 일치) ⑤3종 빌드(Debug·Store·워치) 그린 ⑥신규 현지화 문자열 0(카탈로그 무변경). 스토어: whats-new-1.5 3언어에 성능 개선 1줄 추가. diff --git a/myApp/HaruDanim/Haru_Danim.xcodeproj/project.pbxproj b/myApp/HaruDanim/Haru_Danim.xcodeproj/project.pbxproj index 9111ffa..c52cfc1 100644 --- a/myApp/HaruDanim/Haru_Danim.xcodeproj/project.pbxproj +++ b/myApp/HaruDanim/Haru_Danim.xcodeproj/project.pbxproj @@ -601,7 +601,7 @@ ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; CODE_SIGN_ENTITLEMENTS = IOS/Haru_Danim.entitlements; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; @@ -643,7 +643,7 @@ ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; CODE_SIGN_ENTITLEMENTS = IOS/Haru_Danim.entitlements; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; @@ -686,7 +686,7 @@ CODE_SIGN_ENTITLEMENTS = "Haru_DanimWatch Watch App/Haru_DanimWatch Watch App.entitlements"; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; @@ -722,7 +722,7 @@ CODE_SIGN_ENTITLEMENTS = "Haru_DanimWatch Watch App/Haru_DanimWatch Watch App.entitlements"; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; @@ -758,7 +758,7 @@ CODE_SIGN_ENTITLEMENTS = Haru_DanimWatchWidgets/Haru_DanimWatchWidgetsExtension.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = Haru_DanimWatchWidgets/Info.plist; @@ -794,7 +794,7 @@ CODE_SIGN_ENTITLEMENTS = Haru_DanimWatchWidgets/Haru_DanimWatchWidgetsExtension.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = Haru_DanimWatchWidgets/Info.plist; @@ -827,7 +827,7 @@ buildSettings = { CODE_SIGN_ENTITLEMENTS = Widgets/Haru_DanimWidgets.entitlements; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = Widgets/Info.plist; @@ -853,7 +853,7 @@ buildSettings = { CODE_SIGN_ENTITLEMENTS = Widgets/Haru_DanimWidgets.entitlements; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 8; + CURRENT_PROJECT_VERSION = 9; DEVELOPMENT_TEAM = 5GNS4Z2SYT; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = Widgets/Info.plist; diff --git a/myApp/HaruDanim/IOS/Core/HealthStore.swift b/myApp/HaruDanim/IOS/Core/HealthStore.swift index a98e5df..5bf1c26 100644 --- a/myApp/HaruDanim/IOS/Core/HealthStore.swift +++ b/myApp/HaruDanim/IOS/Core/HealthStore.swift @@ -147,20 +147,32 @@ final class HealthDataStore { let cal = math.calendar let todayKey = math.dayKey(for: now) let keys = questHealthKeys() + // 날짜별로 즉시 쓰지 않고 모아서 저장 1회씩 — 캐시 전체 기록(defaults 직렬화)이 + // 하루당 2회 × 일수에서 총 2회로 줄어든다. 최종 캐시 상태는 완전히 동일 (1.5(9) 최적화) + var cacheBatch: [String: [Date: Double]] = [:] + var intervalBatch: [String: [Date: [[Double]]]] = [:] for offset in 0.. cs 판정이 거르므로 결과 수치는 예전 전수 검사와 완전히 동일하다. let sleepSamples = await categorySamples( .sleepAnalysis, in: lower.addingTimeInterval(-24 * 3600).. cs ? (cs, ce) : nil + if ce > cs { clipped.append((cs, ce)) } } let value = Self.mergedDuration(clipped) if value > 0 { days[key] = value } diff --git a/myApp/HaruDanim/IOS/Views/HealthSection.swift b/myApp/HaruDanim/IOS/Views/HealthSection.swift index f341c83..5d01928 100644 --- a/myApp/HaruDanim/IOS/Views/HealthSection.swift +++ b/myApp/HaruDanim/IOS/Views/HealthSection.swift @@ -499,7 +499,9 @@ struct DiaryHealthCard: View { } private func chip(_ metric: HealthMetric) -> some View { - VStack(alignment: .leading, spacing: 3) { + // 캐시 조회는 칩당 1회만 — 예전엔 본문·접근성 라벨이 각각 value()를 불렀다 (1.5(9)) + let value = value(metric) + return VStack(alignment: .leading, spacing: 3) { HStack(spacing: 5) { Image(safeSymbol: metric.symbolName) .font(.system(size: 11, weight: .semibold)) @@ -509,7 +511,7 @@ struct DiaryHealthCard: View { .foregroundStyle(.secondary) .lineLimit(1) } - if let value = value(metric) { + if let value { // ja "7時間28分"처럼 긴 값이 칩 폭에서 말줄임되지 않게 살짝 축소 허용 (1.5(4) 실측) Text(metric.valueLabel(value)) .font(.system(.subheadline, design: .rounded).weight(.bold).monospacedDigit()) @@ -526,7 +528,7 @@ struct DiaryHealthCard: View { .frame(maxWidth: .infinity, alignment: .leading) .background(Color.primary.opacity(0.045), in: RoundedRectangle(cornerRadius: 12, style: .continuous)) .accessibilityElement(children: .combine) - .accessibilityLabel(Text(verbatim: "\(metric.name) \(value(metric).map(metric.valueLabel) ?? String(localized: "기록 없음"))")) + .accessibilityLabel(Text(verbatim: "\(metric.name) \(value.map(metric.valueLabel) ?? String(localized: "기록 없음"))")) } } diff --git a/myApp/HaruDanim/Marketing/AppStore/whats-new-1.5.txt b/myApp/HaruDanim/Marketing/AppStore/whats-new-1.5.txt index 86bfaca..fc519e4 100644 --- a/myApp/HaruDanim/Marketing/AppStore/whats-new-1.5.txt +++ b/myApp/HaruDanim/Marketing/AppStore/whats-new-1.5.txt @@ -18,6 +18,7 @@ • 측정 중엔 노란 타이머로 바뀌고, 누르면 워치 앱에서 바로 시작·종료할 수 있어요 ● 그리고 +• 앱 곳곳의 반응 속도를 개선했어요 — 목표·다짐 화면과 위젯이 한결 가벼워져요 • 도움말 전체 문구를 더 자연스럽게 다듬고 새 기능 사용법을 더했어요 • 여러 기기를 쓰신다면 모든 기기에서 함께 업데이트해 주세요 @@ -39,6 +40,7 @@ This update brings Haru Danim closer to Apple Health — and your Apple Watch. A • While tracking it turns into a yellow timer — tap to start or stop from the watch app ● And more +• Performance improvements across the app — goals, quests, and widgets feel noticeably smoother • The entire in-app guide has been rewritten to read more naturally, with how-tos for the new features • Using several devices? Please update Haru Danim on all of them @@ -60,5 +62,6 @@ This update brings Haru Danim closer to Apple Health — and your Apple Watch. A • 計測中は黄色いタイマーに変わり、タップするとウォッチアプリからすぐ開始・終了できます ● そのほか +• アプリ全体の反応速度を改善しました — 目標・クエスト画面やウィジェットがより軽快になります • アプリ内ヘルプの文章全体をより自然に磨き直し、新機能の使い方も加えました • 複数の端末をお使いなら、すべての端末で一緒にアップデートしてください diff --git a/myApp/HaruDanim/Shared/DayMath.swift b/myApp/HaruDanim/Shared/DayMath.swift index c8f55f2..30d5cb2 100644 --- a/myApp/HaruDanim/Shared/DayMath.swift +++ b/myApp/HaruDanim/Shared/DayMath.swift @@ -10,13 +10,17 @@ import Foundation /// 논리적 하루(하루 시작 시간 반영), 주/월 범위, 세션 분할 계산 struct DayMath { let settings: TrackingSettings + /// 설정이 반영된 캘린더 — 저장 프로퍼티로 1회만 생성 (1.5(9) 최적화). + /// 예전에는 계산 프로퍼티라 접근할 때마다 Calendar.current 사본 생성+firstWeekday 변경이 + /// 일어났는데, dayKey 한 번에 3회·dayKeys/splitByDay는 일수×수 회 접근이라 모든 집계에 + /// 곱해지는 숨은 비용이었다. settings가 불변이므로 결과는 완전히 동일하다. + let calendar: Calendar init(settings: TrackingSettings = .current()) { self.settings = settings + self.calendar = settings.calendar } - var calendar: Calendar { settings.calendar } - // MARK: 논리적 하루 /// `date`가 속하는 논리적 하루의 키(해당 달력일의 자정 Date). diff --git a/myApp/HaruDanim/Shared/HealthMetric.swift b/myApp/HaruDanim/Shared/HealthMetric.swift index 41489f2..d173a28 100644 --- a/myApp/HaruDanim/Shared/HealthMetric.swift +++ b/myApp/HaruDanim/Shared/HealthMetric.swift @@ -221,8 +221,51 @@ nonisolated enum HealthCache { return "\(y)\(mm)\(dd)" } + // MARK: 인메모리 캐시 (1.5(9) 최적화 — 값·동작 불변) + // + // 예전에는 value() 호출마다 defaults.dictionary가 전체 캐시(지표 10여 종 × 400일 ≈ + // 수천 엔트리)를 통째로 Swift 딕셔너리로 브리징했다. 건강 다짐의 진행률은 "하루 값 × + // 일수"라 월간 게이지 하나에 이 전체 변환이 ~30회, 다짐 행 하나에 ~38회+, 워치 스냅숏 + // 한 번에 다짐당 ~76회 일어나 1.5 버벅임의 몸통이었다. 브리징 결과를 프로세스 안에 + // 캐시하고, 쓰기(메인 앱 단일 작성자)마다 defaults의 세대 카운터를 올려 무효화한다 — + // 위젯 확장(별도 프로세스)이 오래 살아남아도 세대 비교(작은 double 1개 읽기)로 + // 항상 최신 값을 읽으므로 표시 결과는 예전과 완전히 동일하다. + private static let generationKey = "health.cache.gen" + private static let cacheLock = NSLock() + nonisolated(unsafe) private static var cached: [String: [String: Double]]? + nonisolated(unsafe) private static var cachedGeneration: Double = -1 + private static func load() -> [String: [String: Double]] { - (AppGroup.defaults.dictionary(forKey: storageKey) as? [String: [String: Double]]) ?? [:] + let generation = AppGroup.defaults.double(forKey: generationKey) + cacheLock.lock() + if let cached, cachedGeneration == generation { + let result = cached + cacheLock.unlock() + return result + } + cacheLock.unlock() + let fresh = (AppGroup.defaults.dictionary(forKey: storageKey) as? [String: [String: Double]]) ?? [:] + cacheLock.lock() + cached = fresh + cachedGeneration = generation + cacheLock.unlock() + return fresh + } + + /// 전체 저장 + 세대 상향 + 인메모리 반영 (쓰기 3곳의 단일 종점). + /// 데이터를 먼저 쓰고 세대를 올린다 — 다른 프로세스가 새 세대를 본 시점엔 새 데이터가 있다 + private static func store(_ all: [String: [String: Double]]?) { + if let all { + AppGroup.defaults.set(all, forKey: storageKey) + } else { + AppGroup.defaults.removeObject(forKey: storageKey) + } + let generation = AppGroup.defaults.double(forKey: generationKey) + 1 + AppGroup.defaults.set(generation, forKey: generationKey) + cacheLock.lock() + cached = all ?? [:] + cachedGeneration = generation + cacheLock.unlock() } static func value(_ metricRaw: String, dayKey: Date) -> Double? { @@ -243,7 +286,7 @@ nonisolated enum HealthCache { } all[metricRaw] = days } - AppGroup.defaults.set(all, forKey: storageKey) + store(all) } /// 여러 날짜 × 여러 지표 일괄 기록 (백필용 — [지표: [토큰: 값]]) @@ -261,12 +304,12 @@ nonisolated enum HealthCache { } all[metricRaw] = stored } - AppGroup.defaults.set(all, forKey: storageKey) + store(all) } /// 전체 초기화(데이터 정리)용 — 값은 어차피 건강 앱 소유라 캐시만 비운다 static func clearAll() { - AppGroup.defaults.removeObject(forKey: storageKey) + store(nil) HealthIntervals.clearAll() } } @@ -285,8 +328,42 @@ nonisolated enum HealthIntervals { static let sleepKey = "sleep" static func workoutKey(_ kind: HealthWorkoutKind) -> String { "workout.\(kind.rawValue)" } + // 인메모리 캐시 — HealthCache와 같은 세대 무효화 문법 (1.5(9) 최적화, 값·동작 불변). + // 타임테이블 블록은 하루당 3~5회, 기록 탭 주간 보기는 ×7일로 이 저장소를 읽는다 + private static let generationKey = "health.intervals.gen" + private static let cacheLock = NSLock() + nonisolated(unsafe) private static var cached: [String: [String: [[Double]]]]? + nonisolated(unsafe) private static var cachedGeneration: Double = -1 + private static func load() -> [String: [String: [[Double]]]] { - (AppGroup.defaults.dictionary(forKey: storageKey) as? [String: [String: [[Double]]]]) ?? [:] + let generation = AppGroup.defaults.double(forKey: generationKey) + cacheLock.lock() + if let cached, cachedGeneration == generation { + let result = cached + cacheLock.unlock() + return result + } + cacheLock.unlock() + let fresh = (AppGroup.defaults.dictionary(forKey: storageKey) as? [String: [String: [[Double]]]]) ?? [:] + cacheLock.lock() + cached = fresh + cachedGeneration = generation + cacheLock.unlock() + return fresh + } + + private static func store(_ all: [String: [String: [[Double]]]]?) { + if let all { + AppGroup.defaults.set(all, forKey: storageKey) + } else { + AppGroup.defaults.removeObject(forKey: storageKey) + } + let generation = AppGroup.defaults.double(forKey: generationKey) + 1 + AppGroup.defaults.set(generation, forKey: generationKey) + cacheLock.lock() + cached = all ?? [:] + cachedGeneration = generation + cacheLock.unlock() } /// 한 종류·한 날짜의 구간 목록 (시작 오름차순) @@ -301,7 +378,9 @@ nonisolated enum HealthIntervals { /// 그날 저장된 운동 종류 키 목록 (표시 순서는 호출부가 정함) static func workoutKeys(dayKey: Date) -> [String] { let token = HealthCache.dayToken(dayKey) - return load().keys.filter { $0.hasPrefix("workout.") && !(load()[$0]?[token] ?? []).isEmpty } + // load()는 1회만 — 예전에는 필터 클로저 안에서 키 개수만큼 다시 로드했다 (1.5(9)) + let all = load() + return all.keys.filter { $0.hasPrefix("workout.") && !(all[$0]?[token] ?? []).isEmpty } } /// 여러 날짜 × 여러 종류 일괄 기록 (백필·최근 갱신 공용). @@ -325,11 +404,11 @@ nonisolated enum HealthIntervals { } all[key] = stored } - AppGroup.defaults.set(all, forKey: storageKey) + store(all) } static func clearAll() { - AppGroup.defaults.removeObject(forKey: storageKey) + store(nil) } } diff --git a/myApp/HaruDanim/Shared/QuestProgress.swift b/myApp/HaruDanim/Shared/QuestProgress.swift index 01c8cfb..580c783 100644 --- a/myApp/HaruDanim/Shared/QuestProgress.swift +++ b/myApp/HaruDanim/Shared/QuestProgress.swift @@ -263,16 +263,85 @@ struct QuestProgress { } let caps = quest.direction == .atLeast && quest.targetValue > 0 let dailyTarget = quest.targetValue + // 1.5(9) 최적화: 날마다 value(in:)로 전체 기록을 다시 훑던 O(일수×기록수) 루프를 + // 게이지 전용 하루 버킷(perDayGaugeValues — 기록 1회 순회, 클리핑 규칙 동일)으로 교체. + // 수행일 필터·하루 기여 캡은 그대로 이 루프가 담당하므로 수치가 완전히 동일하다 + let daily = perDayGaugeValues(in: range, now: now) var sum = 0.0 for key in math.dayKeys(in: range) where isActiveDay(key) { - // 하루 값은 value(in:) 단일 지점 경유 — 기록 다짐은 기존과 동일한 Aggregator - // 계산이고, 건강 다짐(1.5)은 캐시 하루 값이 그대로 나온다 - let dayValue = value(in: dayMeasurementRange(forKey: key), now: now) + let dayValue = daily[key] ?? 0 sum += caps ? min(dayValue, dailyTarget) : dayValue } return sum } + /// span 게이지용 하루 값 버킷 — "날마다 value(in: dayMeasurementRange)"와 수치가 완전히 + /// 동일하도록 같은 클리핑 규칙(구간 겹침 분할·마감 창·진행 중 세션은 now까지)을 기록을 + /// 한 번만 순회하며 적용한다 (1.5(9) — O(일수×기록수) → O(기록수+일수)). + /// ⚠️ 연속 계산의 perDayValues와 헷갈리지 말 것: 그쪽은 종료 시각을 now로 잘라 미래 + /// 기록을 제외하지만(§6.4 연속 규칙), 게이지는 "미래 시각 기록도 즉시 반영"이 스펙이라 + /// 여기서는 자르지 않는다 — 기존 value(in:) 경로(Aggregator)와 동일한 동작. + private func perDayGaugeValues(in range: Range, now: Date) -> [Date: Double] { + // 건강 다짐: 캐시의 하루 값 그대로 (마감 시각은 건강 다짐 미지원 — 기존 경로도 + // dayMeasurementRange가 캐시의 온전한 하루 값을 돌려줬으므로 동일) + if let health = quest.healthTarget { + var values: [Date: Double] = [:] + for key in math.dayKeys(in: range) { + if let value = HealthQuestValues.dayValue(target: health, quest: quest, dayKey: key) { + values[key] = value + } + } + return values + } + return perDayRecordValues(in: range, now: now) + } + + /// 기록(행동·꼬리표) 다짐의 게이지용 하루 버킷 — perDayGaugeValues의 기록 경로. + /// spanRawValue(마감 시각)가 직접 쓰는 이유: 예전 구현이 Aggregator만 탔으므로 + /// (건강 다짐은 targetActions가 비어 항상 0) 그 동작을 비트 단위로 보존하기 위함 + private func perDayRecordValues(in range: Range, now: Date) -> [Date: Double] { + var values: [Date: Double] = [:] + // 마감 창 끝은 날짜별 캐시 — perDayValues(연속 계산)와 같은 문법 + let clips = quest.hasDeadline + var windowEnds: [Date: Date] = [:] + func windowEnd(_ key: Date) -> Date { + if let cached = windowEnds[key] { return cached } + let end = dayMeasurementRange(forKey: key).upperBound + windowEnds[key] = end + return end + } + for action in quest.targetActions { + switch quest.measure { + case .time: + for session in action.sessions { + // 진행 중 세션은 now까지 — 종료 시각이 미래인 수동 기록은 그대로 반영 + // (Aggregator.seconds의 `session.endAt ?? now`와 동일) + let end = session.endAt ?? now + let start = max(session.startAt, range.lowerBound) + let clippedEnd = min(end, range.upperBound) + guard start < clippedEnd else { continue } + for segment in math.splitByDay(start: start, end: clippedEnd) { + var upper = segment.range.upperBound + if clips { + // 조각 시작은 항상 그날 창의 시작(하루 시작) 이후 — 끝만 자르면 된다 + upper = min(upper, windowEnd(segment.dayKey)) + guard segment.range.lowerBound < upper else { continue } + } + values[segment.dayKey, default: 0] + += upper.timeIntervalSince(segment.range.lowerBound) + } + } + case .count: + for entry in action.countEntries where range.contains(entry.timestamp) { + let key = math.dayKey(for: entry.timestamp) + if clips, entry.timestamp >= windowEnd(key) { continue } + values[key, default: 0] += Double(entry.amount) + } + } + } + return values + } + /// span 구간의 실측 누적값 — 위젯 ③ 누적값 라벨용. /// 진행률 캡(하루 기여 제한)·적용일 여부와 무관한 "원본" 성격의 값이지만, /// 마감 시각 다짐은 각 날의 집계 창(마감까지)만 센다 — 마감 뒤 기록으로 @@ -280,16 +349,10 @@ struct QuestProgress { func spanRawValue(_ span: StatSpan, now: Date = .now) -> Double { let range = spanRange(span, now: now) guard quest.hasDeadline else { return value(in: range, now: now) } - let agg = Aggregator(math: math) - var sum = 0.0 - for key in math.dayKeys(in: range) { - let dayRange = dayMeasurementRange(forKey: key) - switch quest.measure { - case .time: sum += agg.seconds(for: quest.targetActions, in: dayRange, now: now) - case .count: sum += Double(agg.count(for: quest.targetActions, in: dayRange)) - } - } - return sum + // 1.5(9) 최적화: 날짜마다 Aggregator로 전체 기록을 재순회하던 것을 하루 버킷 1회로. + // 예전 구현과 동일하게 기록 경로만 탄다 (perDayRecordValues 주석 참고) + let daily = perDayRecordValues(in: range, now: now) + return math.dayKeys(in: range).reduce(0) { $0 + (daily[$1] ?? 0) } } // MARK: 주기 몫 완료 상태 (§4.2) diff --git a/myApp/HaruDanim/Widgets/GoalWidgets.swift b/myApp/HaruDanim/Widgets/GoalWidgets.swift index 1a1ef7a..3c1fbe3 100644 --- a/myApp/HaruDanim/Widgets/GoalWidgets.swift +++ b/myApp/HaruDanim/Widgets/GoalWidgets.swift @@ -92,8 +92,10 @@ struct GoalProgressProvider: AppIntentTimelineProvider { @MainActor static func makeEntry(_ configuration: GoalProgressConfigIntent, family: WidgetFamily, - now: Date = .now) -> GoalProgressEntry { - IntentStore.refresh() + now: Date = .now, refresh: Bool = true) -> GoalProgressEntry { + // 미래 엔트리(라이브 타임라인)는 같은 시점의 디스크 상태를 봐야 하므로 컨테이너를 + // 다시 열지 않는다 — 예전엔 엔트리 7개가 각각 새 컨테이너를 열었다 (1.5(9) 최적화) + if refresh { IntentStore.refresh() } guard WidgetStore.isUnlocked else { return GoalProgressEntry(date: now, locked: true, theme: configuration.theme, mediumStyle: configuration.mediumStyle, @@ -125,7 +127,7 @@ struct GoalProgressProvider: AppIntentTimelineProvider { func timeline(for configuration: GoalProgressConfigIntent, in context: Context) async -> Timeline { let first = Self.makeEntry(configuration, family: context.family) return WidgetRefresh.timeline(first: first, live: first.isLive) { date in - Self.makeEntry(configuration, family: context.family, now: date) + Self.makeEntry(configuration, family: context.family, now: date, refresh: false) } } } @@ -458,8 +460,9 @@ struct QuestStatusProvider: AppIntentTimelineProvider { @MainActor static func makeEntry(_ configuration: QuestStatusConfigIntent, family: WidgetFamily, - now: Date = .now) -> QuestStatusEntry { - IntentStore.refresh() + now: Date = .now, refresh: Bool = true) -> QuestStatusEntry { + // 미래 엔트리는 컨테이너 재오픈 없이 같은 상태에서 계산 (GoalProgressProvider와 동일) + if refresh { IntentStore.refresh() } guard WidgetStore.isUnlocked else { return QuestStatusEntry(date: now, locked: true, theme: configuration.theme, spanLabel: "", largeStyle: configuration.largeStyle, goals: []) @@ -492,7 +495,7 @@ struct QuestStatusProvider: AppIntentTimelineProvider { func timeline(for configuration: QuestStatusConfigIntent, in context: Context) async -> Timeline { let first = Self.makeEntry(configuration, family: context.family) return WidgetRefresh.timeline(first: first, live: first.isLive) { date in - Self.makeEntry(configuration, family: context.family, now: date) + Self.makeEntry(configuration, family: context.family, now: date, refresh: false) } } } diff --git a/myApp/HaruDanim/Widgets/LockScreenWidgets.swift b/myApp/HaruDanim/Widgets/LockScreenWidgets.swift index 2f7d1b8..0d21de7 100644 --- a/myApp/HaruDanim/Widgets/LockScreenWidgets.swift +++ b/myApp/HaruDanim/Widgets/LockScreenWidgets.swift @@ -60,8 +60,10 @@ struct LockGoalEntry: TimelineEntry { struct LockGoalProvider: AppIntentTimelineProvider { @MainActor - static func makeEntry(_ configuration: LockGoalConfigIntent, now: Date = .now) -> LockGoalEntry { - IntentStore.refresh() + static func makeEntry(_ configuration: LockGoalConfigIntent, now: Date = .now, + refresh: Bool = true) -> LockGoalEntry { + // 미래 엔트리는 컨테이너 재오픈 없이 같은 상태에서 계산 (GoalProgressProvider와 동일) + if refresh { IntentStore.refresh() } guard PremiumGate.isUnlocked(.lockScreenWidgets) else { return LockGoalEntry(date: now, locked: true, spanLabel: "", style: .gauge, goal: nil, ratio: 0) } @@ -92,7 +94,7 @@ struct LockGoalProvider: AppIntentTimelineProvider { func timeline(for configuration: LockGoalConfigIntent, in context: Context) async -> Timeline { let first = Self.makeEntry(configuration) return WidgetRefresh.timeline(first: first, live: first.isLive) { date in - Self.makeEntry(configuration, now: date) + Self.makeEntry(configuration, now: date, refresh: false) } } } diff --git a/myApp/HaruDanim/Widgets/QuestRingWidget.swift b/myApp/HaruDanim/Widgets/QuestRingWidget.swift index 0b115eb..df4cd1f 100644 --- a/myApp/HaruDanim/Widgets/QuestRingWidget.swift +++ b/myApp/HaruDanim/Widgets/QuestRingWidget.swift @@ -56,8 +56,9 @@ struct QuestRingProvider: AppIntentTimelineProvider { @MainActor static func makeEntry(_ configuration: QuestRingConfigIntent, family: WidgetFamily, - now: Date = .now) -> QuestRingEntry { - IntentStore.refresh() + now: Date = .now, refresh: Bool = true) -> QuestRingEntry { + // 미래 엔트리는 컨테이너 재오픈 없이 같은 상태에서 계산 (GoalProgressProvider와 동일) + if refresh { IntentStore.refresh() } guard WidgetStore.isUnlocked else { return QuestRingEntry(date: now, locked: true, theme: configuration.theme, spanLabel: "", cells: []) } @@ -88,7 +89,7 @@ struct QuestRingProvider: AppIntentTimelineProvider { func timeline(for configuration: QuestRingConfigIntent, in context: Context) async -> Timeline { let first = Self.makeEntry(configuration, family: context.family) return WidgetRefresh.timeline(first: first, live: first.isLive) { date in - Self.makeEntry(configuration, family: context.family, now: date) + Self.makeEntry(configuration, family: context.family, now: date, refresh: false) } } }