场景与技术范围
使用 EasyApp SwiftUI 模板构建宠物训练 iOS 应用,后端基于 Supabase,订阅通过 RevenueCat 与 App Store Connect 接入。功能范围覆盖引导页、登录注册、订阅支付等产品环节。
核心问题是把训练体验、用户身份与订阅权益连接起来。架构将客户端交互、身份校验与权益管理分层组织。
系统分层
| 层级 | 职责 | 需要守住的边界 |
|---|---|---|
| SwiftUI 客户端 | 引导、登录、训练展示、购买交互 | 不把本地购买标志作为唯一授权依据 |
| Supabase 服务 | 身份与应用数据 | 用户之间的数据隔离 |
| 订阅服务 | RevenueCat 权益状态与购买恢复 | 购买成功不等于永久有效 |
| 训练服务 | 校验输入、组织模型请求、返回建议 | 模型密钥与可信规则放在服务端 |
界面只负责展示状态;身份、权益和模型请求的可信校验应放在服务端。客户端缓存可以改善体验,但不能替代权限判断。
数据与状态设计
数据模型围绕用户、宠物、训练记录与订阅权益组织:
User(id)
├─ Pet(id, user_id, profile)
├─ TrainingSession(id, pet_id, goal, status)
└─ Entitlement(user_id, product_id, expires_at)
TrainingSession.status:
idle → loading → success
↘ error
训练记录需要关联宠物与所属用户。若允许删除宠物,应明确历史记录是同时删除、匿名保留还是禁止访问,避免出现失去归属的数据。
关键工程问题
订阅恢复与跨设备状态
启动与恢复购买后重新读取有效权益;退款、取消续订、到期分别处理。取消自动续订通常不应直接等同于当前权益立即失效,具体状态映射须根据实际订阅配置验证。
输入约束与错误恢复
训练目标应有长度限制和结构化字段。网络失败时保留输入,显示重试入口;重试携带请求标识,避免用户连续点击造成重复调用。宠物训练建议还应避免承诺行为改善效果。
验收标准
- 新账号可以完成引导与登录,退出后无法访问其他用户训练记录。
- 沙盒购买、恢复购买和订阅到期分别映射到正确的权益状态。
- 弱网与请求失败不会让页面永久处于加载状态。
- 重复点击不会产生多次无意的训练请求。
参考资料
- RevenueCat / purchases-ios:iOS 订阅 SDK,覆盖购买、恢复购买与订阅权益管理。
- Supabase Swift SDK:Swift 客户端的身份认证、数据库访问与文件存储集成。