移动应用 — 发布清单

本文档跟踪 MysticX 移动应用公开发布前的所有剩余工作项，涵盖屏幕开发、后端集成、应用商店合规及上线前准备。

最后更新：2026 年 4 月 19 日

屏幕开发

已完成

屏幕	状态
首页标签	✅ 已完成
发现标签	✅ 已完成
我的标签	✅ 已完成
新手引导	✅ 已完成
日志标签	🟡 完成 1/3

待完成屏幕

独立版每日卡牌模块（在塔罗占卜前）— 0.5 天

[ ] 从首页进入的独立入口 / 导航
[ ] 独立的每日卡牌页面
[ ] 结果态优化 + 引导进入完整解读

每日卡牌 — 1 天

[ ] 牌阵卡牌布局
[ ] 抽取一张卡牌交互
[ ] 翻牌动画（Reanimated 3D 翻转）
[ ] 加载动画
[ ] 结果展示页面

塔罗占卜流程 — 4 天

核心体验。全应用最复杂、动画最密集的部分。

[ ] 占卜前置问题 / 问题填写步骤
[ ] 选择牌阵（AI 推荐）加载
[ ] 牌阵卡牌布局
[ ] 抽卡（弧形扇形卡牌轮盘）
[ ] 洗牌动画
[ ] 翻牌动画
[ ] 加载 / 流式传输视图
[ ] 解读结果页面（卡牌解释、总结、指导建议、追问入口）

塔罗解读聊天 — 1 天

[ ] 与塔罗师的流式 AI 对话
[ ] 消息气泡、输入指示器
[ ] 快速回复建议

AI 记忆 — 0.2 天

[ ] 查看已存储的 AI 记忆事实
[ ] 删除单条记忆
[ ] 清除所有记忆

账户 / 资料编辑 — 1 天

[x] 编辑资料（姓名、邮箱、头像上传）
[x] 头像图片选择器 + 上传

设置（优化） — 0.5 天

[x] 主题切换（浅色 / 深色 / 跟随系统）
[ ] 通知偏好开关
[ ] 语言选择器
[ ] 帮助、隐私政策、服务条款链接
[x] 退出登录按钮
[ ] 删除账户流程（选择原因 + 确认）

发现子页面 — 2 天

[ ] 牌阵 — 列表 + 详情（0.5 天）
[ ] 塔罗卡牌 — 网格 + 含义详情（0.5 天）
[ ] 卡牌皮肤 — 网格 + 购买流程（0.5 天）
[ ] 塔罗师 — 列表 + 试听 + 解锁/购买（0.5 天）

日志子标签 — 1.6 天

[ ] 阅读历史列表 — 0.5 天
[ ] 每日卡牌日历视图 — 0.5 天
[ ] 每周指引 — 0.3 天
[ ] 灵魂旅程 — 0.3 天

认证页面 — 1 天

[ ] 登录（Apple、Google、邮箱）
[ ] 注册（Apple、Google、邮箱）
[ ] 忘记密码
风险提示：3 个 OAuth 提供商可能将工期推至 1.5–2 天

付费墙 / 订阅 — 3 天

[ ] 付费墙弹窗（积分不足时触发）
[ ] 订阅方案（黄金周/年度，钻石）
[ ] 订阅管理页面（当前方案 + 跳转至系统设置的管理链接）
风险提示：IAP 集成是移动开发中最容易低估的功能，不使用 RevenueCat 可能需要 4–5 天。

屏幕开发小计：约 15.8 天

屏幕之外的工作

移动端后端适配 — 2–3 天

任务	预估	说明
RevenueCat Webhook 处理器	0.5 天	`POST /api/v1/webhooks/rc` — 将 IAP 订阅同步至数据库
统一订阅服务	0.5 天	合并 RevenueCat（移动端 IAP）+ Stripe（网页端）为统一会员等级
推送通知后端	1 天	存储设备令牌，触发推送（解读完成、每日提醒、订阅事件）
移动端认证接口	0.5 天	网页端 Better Auth 使用 Cookie；移动端需通过 Secure Store 实现 Bearer Token 认证

推送通知 — 1 天

[ ] Expo Notifications 配置（APNs 证书 + FCM 密钥）
[ ] 设备令牌注册至后端
[ ] 通知类型：解读完成、每日卡牌提醒、每周指引就绪、订阅事件
[ ] 从通知深度链接到指定页面
[ ] 通知偏好设置（已含在设置页面中）

应用图标、启动屏幕、字体 — 0.5 天

[ ] 应用图标（1024×1024 源文件 + 所有生成尺寸）
[ ] 启动屏幕（动画或静态）
[ ] 自定义衬线字体用于卡牌名称和解读标题

错误处理与边界情况 — 0.5 天

[ ] 错误边界（全局 + 各页面）
[ ] 网络离线提示横幅
[ ] 空状态（暂无解读、无积分、首次使用）
[ ] 加载骨架屏

深度链接 / 通用链接 — 0.5 天

[ ] URL Scheme：mysticx://reading/123、mysticx://card-of-day 等
[ ] Associated Domains 配置（iOS）
[ ] App Links 配置（Android）
[ ] 推送通知导航和社交分享所需

数据分析与崩溃上报 — 0.3 天

[ ] Mixpanel 事件埋点（关键流程：解读、购买、每日卡牌）
[ ] 崩溃上报配置（Sentry 或同类工具）

本地化（英文 + 简体中文） — 1–2 天

[ ] 将所有硬编码字符串提取为 i18n 字典
[ ] 搭建 i18n 框架（与网页端相同的 useTrans 模式）
[ ] 翻译移动端专属字符串（v1 至少支持英文 + 简体中文）

屏幕之外工作小计：约 6–8 天

应用商店合规与提交

App Store Connect（Apple） — 1.5–2 天

[ ] 应用元数据：名称、副标题、描述、关键词（中英文）
[ ] 所有要求设备尺寸的截图（6.7"、6.5"，如支持 iPad 还需 iPad 截图）
[ ] 应用隐私标签（声明所有收集的数据类型）
[ ] 年龄分级问卷（塔罗内容可能触发"成熟主题"标记，应定位为"自我反思"）
[ ] 出口合规声明（HTTPS 加密）
[ ] 应用内购买产品设置（每个订阅 + 积分包，所有地区定价）
[ ] 每个 IAP 产品的审核截图
[ ] App Review 备注 + 带积分的演示账号
[ ] 税务和银行协议（付费应用协议、W-8BEN（如非美国））

Google Play Console — 2–3 天

[ ] 商店上架信息：描述、截图、精选图片（规格与 Apple 不同）
[ ] 数据安全部分（非常细致 — 需声明每个 SDK：Firebase、分析工具等）
[ ] 内容分级（IARC 问卷，算命类内容可能在某些地区受限）
[ ] 目标受众与内容声明（非儿童应用）
[ ] 金融功能声明（数字商品销售）
[ ] 广告声明（即使无广告也需声明）
[ ] 欧盟数字服务法（DSA）合规 — 商家身份、欧盟联系方式
[ ] 欧盟/英国订阅透明度 — 清晰定价、取消流程
[ ] 应用内产品设置（所有地区的订阅 + 消耗型商品）
[ ] 税务和付款资料（各国税务身份，VAT 由 Google MOSS 处理）
[ ] 应用签名与发布管理（Play App Signing、内部测试轨道）

共同项 — 0.5–1 天

[ ] 隐私政策页面（公开托管，涵盖 GDPR + CCPA）
[ ] 服务条款页面
[ ] 技术支持链接 / 联系邮箱
[ ] GDPR 合规：数据删除接口、同意管理（删除账户页面已覆盖部分）

商店合规小计：约 4–6 天

测试与质量保证 — 2–3 天

[ ] 真机端到端测试（iOS + Android）
[ ] TestFlight IAP 沙盒测试（Apple）
[ ] Google Play 内部测试 IAP 验证
[ ] 跨平台订阅场景（网页端订阅 → 移动端验证，反之亦然）
[ ] 修复测试中发现的 Bug
[ ] 内部团队 Beta 测试

设备矩阵

iOS	Android
iPhone SE（第三代）	Pixel 7a
iPhone 14	Samsung Galaxy A54
iPhone 16 Pro Max	Samsung Galaxy S24

总工作量

类别	天数
屏幕开发	约 15.8
屏幕之外（后端、推送、图标等）	约 6–8
商店合规与提交	约 4–6
测试与质量保证	约 2–3
总计	约 28–33

约 6–7 周（一名开发者 + AI 辅助）。

高风险项

项目	风险	应对措施
付费墙 / IAP	移动开发中最容易低估的功能	使用 RevenueCat 抽象 Apple/Google 计费复杂性
占卜流程动画	弧形轮盘 + 洗牌 + 翻牌动画密集	先原型化轮盘。使用 Reanimated 在 UI 线程运行。
认证（3 个提供商）	OAuth 配置、令牌处理、错误状态	使用 `expo-apple-authentication` + `expo-auth-session`（Google）
Apple 审核	塔罗内容可能触发"算命"审查	定位为"AI 驱动的自我反思与正念"。包含免责声明。
跨平台订阅同步	用户在网页端 vs 移动端订阅	统一订阅服务同时检查 RevenueCat + Stripe

省时技巧

截图：使用 Fastlane snapshot 自动化 — 手动截取多语言截图非常耗时。
隐私政策 / 服务条款：v1 使用生成器（Termly、iubenda），而非从零编写。
先做 Apple：流程更简单。之后再适配 Google。
RevenueCat：可省去约 2 天的 IAP 基础设施工作（收据验证、跨平台同步）。
欧盟 VAT：Apple 和 Google 均代为收取消费者购买的 VAT。