fix: 모바일 알림 실행·정확 시각 예약 및 로컬 데이터 복구 안정화

[jjoonleo]

현재 PR 범위 — 2026-09-25 갱신

예약 알림·모바일 백업·사용자 설정 보존·준비 시작·일정 저장·초기화 복구의 선행 수정입니다. 현재 head는 ee6c1f8b41fedbafee493791514026eaf669dcb5, 대상은 main입니다.

범위	관련 이슈
Android 예약 receiver, 모바일 백업 저장·선택, 설정 보존	A01 #583, A02 #584, A03 #586, A04 #587
상세 알림 보호, 실제 타이머 단계 알림, 준비 시작 원자성·재시도	A05 #588, A06 #598, A07 #599
일정·장소·준비 aggregate 저장 원자성 및 오래된 저장 요청 거부	A08 #601
알림 개인정보·cold tap·정확/근사 예약·provider 관측·작업 직렬화	A11 #589, A12 #591, A13 #592, A14 #593, A15 #594
초기화 journal 및 중단 후 정리·재시작	D03 #595
백업/초기화 workflow 분리와 홈 overflow의 부분 수정	C01 #600, U08 #597

A08 변경으로 이 PR의 DB 스키마는 버전 3입니다. 아래 과거 본문의 “DB schema를 변경하지 않는다” 및 “A07 미구현” 표기는 과거 단계의 설명이며 현재 범위를 설명하지 않습니다. ignored Dart 생성 파일은 커밋하지 않았습니다.

현재 head의 CI

Flutter Testing와 Android Notification Contract가 성공했습니다. Widgetbook PR 배포는 조건상 skipped입니다. CI 통과는 실제 Android/iOS 알림 전달·파일 provider·접근성 검증 완료를 의미하지 않습니다.

후속 PR과 남은 조건

후속 PR #631은 현재 PR의 head에서 시작합니다. 암호화 staging, 정상·손상 DB 복원, migration v4, 시간대 보정, 최근 일정 조회, 이력 삭제, 상세 알림 상태 및 실패 회귀를 포함합니다. #585 병합 후 #631의 base를 main으로 변경하고 그 기준의 CI를 다시 확인해야 합니다.

이 PR 단독으로는 C01/A08의 A09·D02 전체 복원 통합과 U08 전체 화면 조합이 완료되지 않습니다. 실제 기기 수용조건과 전체 iOS 빌드/네이티브 검증도 별도로 남아 있습니다. 미완료 이슈 자동 종료와 스토어 출시는 수행하지 않습니다.

이전 구현 단계의 상세 기록 — 현재 범위와 CI는 위 갱신 내용을 우선합니다

문제와 결과

예약 알림 전달 누락, 백업 파일 저장·복원 실패, 사용자 설정 덮어쓰기와 로컬 데이터 초기화 후 남는 알림을 수정합니다. Android/iOS local-only 제품 경계를 유지하며 알림의 실제 취소 확인과 재시작 복구를 연결했습니다.

변경 내용

• A01 [P0][A01] Android 예약 알림 receiver와 재부팅·업데이트 복구 연결 복원 #583: Android 예약/부팅 receiver와 release APK·merged manifest CI 검사를 추가했습니다.
• A02 [P0][A02] Android·iOS 암호화 백업 내보내기와 저장 결과·수명주기 보장 #584, A03 [P1][A03] iOS 백업 복원 파일 선택기의 UTI 계약 수정 #586: Android 문서 생성과 iOS export-as-copy 및 UTI를 연결합니다. 암호문 저장 성공·취소·실패를 구별하고 백업 revision과 복원 preview를 보존합니다.
• A04 [P1][A04] Local Profile 부분 갱신으로 알림 설정·점수·백업 revision 보존 #587: 프로필/설정/점수/백업 메타데이터를 목적별 부분 변경으로 분리하여 관련 없는 설정과 revision을 보존합니다.
• A05 [P1][A05] 상세 알림 OFF와 표시 내용 변경을 기존 OS 예약에 반영 #588, A11 [P1][A11] 준비 원문의 DB 외부 복제 제거 및 legacy runtime·알림 payload 전환 #589: 알림 내용 정책 변경을 digest로 추적하고 기존 예약을 교체합니다. DB 밖 준비 원문을 최소 route/ownership 정보로 줄이고 legacy 기록을 정리합니다.
• A12 [P1][A12] 종료 상태 알림 탭 보존 및 준비 완료 후 정확한 일정으로 단일 진입 #591: cold tap과 선택한 준비의 화면 전환·재개를 처리합니다. 오래된 타이머·알림이 확인 없이 자동 시작하지 않습니다.
• A13 [P1][A13] Android 정확 시각 권한 분리와 실제 exact/inexact 예약 결과 반영 #592, A14 [P1][A14] 현재 권한·선택 provider·플랫폼 예약 관측을 대조하고 확인되지 않은 예약을 정상으로 표시하지 않기 #593: 권한, 정확/근사 시각, 실제 provider 관측과 정리 필요 상태를 분리합니다. plugin cache와 OS 관측의 증명 범위를 구별합니다.
• A15 [P1][A15] 진행 중 재조정에 들어온 변경을 유실 없이 반영하고 데이터 교체와 알림 작업을 직렬화 #594: 공통 owner가 예약·취소·복원·초기화 경합을 직렬화합니다. 처리 중 들어온 최신 요청을 다음 pass에서 수행하고 실제 platform ID별 ownership을 보존합니다.
• D03 [P1][D03] 알림 취소 실패의 소유권을 보존하고 중단된 로컬 초기화를 재개 #595: DB/키와 독립된 최소 journal에 OS 호출 전 ownership과 명시적 초기화 의도·단계를 저장합니다. 취소 실패는 기록을 남기고, 완료된 단계만 건너뛰어 재시작합니다. 완료 journal→marker 제거 확인→journal 정리 순서를 유지하며 늦은 화면 연결이 데이터 삭제를 다시 시작하지 않습니다.
• D03 손상 복구: JSON/UTF-8 손상만 원본을 격리하고 registry/A14 관측으로 재구성합니다. I/O 실패·미래 버전·모순된 상태는 덮어쓰지 않습니다. reset 의도가 없으면 사용자 데이터를 삭제하지 않습니다. Android에서 부재를 확인할 수 없는 legacy 예약은 unknown으로 남깁니다.
• D03 화면: DB/DI 이전 startup recovery와 KO/EN 초기화 진행·부분 결과·재시도를 연결했습니다. 기존 DB/bloc/timer를 무효화하고 미완료 초기화를 성공 화면으로 보내지 않습니다. 반환하지 않은 OS 호출은 UI 대기 시간이 지나도 owner를 유지합니다.
• A06 [P1][A06] 실제 준비 타이머 경로에서 단계 전환 알림을 판정하고 지연·복귀 알림 재생 방지 #598: 실제 periodic Refresh에서 연속 paused·단조시간2초 이하의 인접 단계 전환만 시도합니다. wall/monotonic 차이는250ms 이하로 제한하고 run/회차/세대별 중복과 resume·restore·skip·지연 재생을 막습니다. 표시 권한/setup 뒤 현재성을 다시 검사하며 공통 owner가 show와 reset을 직렬화합니다.
• U08 [P2][U08] 큰 글자·작은 화면·긴 이름에서 홈·준비 타이머·결과·상세의 읽기와 핵심 조작을 보장 #597: 홈 overflow 선행 수정이 포함됩니다. 전체 접근성·기기 행렬은 후속입니다.

DB schema/backup version을 변경하지 않습니다. ignored Dart 생성 산출물은 커밋하지 않았고, tracked localization 출력은 ARB와 함께 갱신했습니다. 전체 감사64개 중26개는 전담 grill 문답을 포함한 상세 이슈가 게시됐으며, 이 PR이64개 모두를 구현했다는 뜻은 아닙니다.

검증

A06 구현 d06474d4c645794644075173f76afb9ff4445047의 최종 전체929개, 신규 경계47개, coverage88.74%(13092/14753), analyze·generated/local-only·Python11·manifest를 통과했습니다. 수정 전 실제 타이머 회귀 실패를 확인했고, 수정 후 실제 timer→서비스→plugin MethodChannel 제출까지 검증했습니다.7개 커밋blob이 검증 freeze와 일치합니다. A06 근거. 실기기 표시 증거는 별도입니다.

D03 구현 5f3adf11aaaa3e36d6e4e25c41be6c06e4105480에서 전체872개와 손상 복구 집중71개 테스트가 통과했습니다. coverage87.99%(12253/13926), analyzer, generated/local-only 정책 및 manifest/Python11개 검사 통과.579파일 고정 목록을 재해시했고 제품/test 소스는 동일합니다. QA probe의 대역 설정만 명시적unknown으로 정정한 뒤 analyzer와 host 검증을 재실행했습니다.

별도 호스트 프로세스 SIGKILL 후 새 프로세스 복구11지점이 통과했습니다.6개 완료-write 지점과5개 손상 bytes fixture/격리 복구 지점을 검사했으며 provider/deletion adapter는 대역입니다. 모바일 OS kill, write syscall 중단, 전원손실의 증거는 아닙니다. 실제 iOS26.5 SDK Swift typecheck와 Android36/Flutter Kotlin compile도 통과했습니다.

증거: 최종 검증 manifest, 검증 로그. 직전 A15 원격HEAD818e99c9는 Flutter795/87.66% 및 Android release APK CI 통과. 최신 main c7184b2a Figma 화면을 통합한 074d5fd6의 원격 Flutter run35944442338은882개/88.50%(13015/14706)/analyze 통과했습니다. 같은 HEAD Android run35944442335도release APK/manifest를 통과했고 artifact10786008849의실제 APK digest를 D03 CI 검증에 기록했습니다. A06의 원격 CI는 새 HEAD에서 별도로 확인합니다.

KO/EN 실제 widget·번들 글꼴·200% text 캡처는 직접 확인했습니다. synthetic receipt이며 기기 OS 화면이 아닙니다.

상태	한국어	영어
정리 미완료	캡처	캡처
초기화 완료	캡처	캡처

남은 수용조건

실제 Android/iOS 예약 전달·권한 변경·프로세스 중단 복구·backup exclusion과 picker/provider 교차 플랫폼 복원은 기기 검증이 남았습니다. 일반 손상 DB 복구(D01/D02), 전체 복원 runtime(A09), 준비 시작 원자성(A07) 등 미구현 항목은 연결 이슈에서 계속합니다. 자동검증 통과와 병합·store 업로드·출시는 구별하며 이슈를 자동 종료하지 않습니다.

[github-actions]

Visit the preview URL for this PR (updated for commit ee6c1f8):

https://on-time-front-widgetbook--pr-585-lx6437p2.web.app

_{(expires Mon, 28 Sep 2026 10:04:07 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: e53128a376fed0209d449279de9c0d94c83cdd8b}