大橘为重 (Juju) - 技术支持 | Notion

1. App 概述

项目	说明
App 名称	大橘为重（中文）/ Juju（英文）
类型	健康与健身 (Health & Fitness)
平台	iOS（iPhone），支持 iPad 适配
用途	以虚拟猫咪「大橘」为陪伴的健康习惯养成与记录应用。用户通过记录饮食、饮水、运动、体重、经期、心情、专注等数据获得能量与成长反馈，并可选择与 Apple 健康读写同步。

2. 技术架构 (Technical Architecture)

语言与框架：Swift 6，SwiftUI，SwiftData，RealityKit（3D 猫咪展示）
架构模式：MVVM + Repository，逻辑与 UI 分离
数据策略：Local-First — 本地以 SwiftData 为主存储，登录用户通过后台任务将数据同步至 Supabase
不使用 CloudKit：同步由自研 SyncEngine 与 Supabase 完成

主要技术栈：

SwiftData：本地持久化（用户、记录、状态等）
Supabase：认证（Sign in with Apple）、后端数据库与同步
HealthKit：读取/写入运动、饮水、体重、经期等（见下文权限说明）
StoreKit 2：Pro 订阅与一次性内购（保留今天、补回陪伴）
Firebase：Analytics、Crashlytics（可随用户设置关闭分析）
User Notifications：本地提醒（喝水、习惯等），需用户授权

3. 核心功能说明 (Core Features)

3.1 账号与数据

Sign in with Apple：可选。用于跨设备恢复数据与云端同步。