跳转到内容
IntelliFuture Docs

01-方案总览

方案总览

Section titled “方案总览”

1. 这次要解决什么

Section titled “1. 这次要解决什么”

这套 onboarding 要解决的仍然不是“先卖会员”，而是：

  • 用户第一次进入时，能快速感知产品气质和方法
  • 用户能用很短路径说出目标、起点、卡点和偏好
  • 用户能拿到一份可信、具体、可执行的第一周开始方式
  • 转化页只承担“正式出发”承接，而不是重新定义一套壳层

当前 Aha Moment 仍是：

我现在就能按适合自己的方式，从真实日语内容开始。

2. 事实口径

Section titled “2. 事实口径”

从这版开始，文档统一使用两层口径：

2.1 20 个可见页面

Section titled “2.1 20 个可见页面”

这是用户在 Pencil 和真实体验里能看到的页面序列：

  • 01 Brand Intro
  • 02-05 Welcome Showcase
  • 06 Coach Intro
  • 07 Phase Intro
  • 08 Goal Question
  • 09 Level Question
  • 10 Pain Question
  • 11 Week Intro
  • 12 Start Type Question
  • 13 Interest Tags
  • 14 Daily Time Question
  • 15 Weekly Frequency
  • 16 Notification Prompt
  • 17 Encouragement
  • 18 Explanation
  • 19 Generating
  • 20 Plan Result

2.2 18 个实现 step

Section titled “2.2 18 个实现 step”

这是当前 iOS OnboardingShellState 的真实 step：

  • brandIntro
  • networkWarmup
  • welcomeShowcase
  • coachIntro
  • phaseIntro
  • goalQuestion
  • levelQuestion
  • painQuestion
  • weekIntro
  • startTypeQuestion
  • interestTags
  • dailyTimeQuestion
  • weeklyFrequency
  • notificationPrompt
  • encouragement
  • explanation
  • generating
  • plan

两层口径的差异来源：

  • networkWarmup 是后台预热 step，不计入可见页面
  • welcomeShowcase 在代码里是 1 个 step，但对用户是 4 个可见页面

3. 当前权威来源

Section titled “3. 当前权威来源”

如果文档之间有冲突，以时间轴上最新节点为准。当前优先级如下：

  1. 当前实现分支 feature/yomiya-onboarding-ios
  2. 最新实现提交：
    • 0388fcc feat: refine onboarding motion and bottom anchoring
    • ad6fad7 feat: refine onboarding plan result finale
    • fec8c16 feat: finalize onboarding modal flow and weekly default continue
  3. 主设计文件：
  4. 设计/实现过程文档：

4. 当前结构

Section titled “4. 当前结构”
阶段页面目标
阶段 1 沉浸进入01-06品牌进入、轮播主张、教练开场
阶段 2 先被理解07-10了解目标、起点、卡点
阶段 3 安排第一周11-17确认开始方式、兴趣、时间、频次、提醒、情绪承接
阶段 4 说明开始方式18把前面的选择翻译成可信的开始路径
阶段 5 生成计划19把等待解释成“正在按你的条件生成”
阶段 6 交付第一周20交付一周方案并承接到支付

5. 当前实现边界

Section titled “5. 当前实现边界”

这轮已经做到：

  • opening 段按 Pencil 坐标和节奏落地
  • 07-20 主链已按 Pencil 重排并实现
  • 20 Plan Result 已替换为滚动式结果页
  • 登录页与支付页都改为复用既有全屏组件
  • plan 主按钮承接到外部全屏 paywall
  • 各关键问题页的回退、改选和重生成规则已经跑通

这轮仍未做到：

  • 还没有正式接进冷启动首启 root flow
  • plan 和 generating 仍然基于本地 fixture，而非真实个性化引擎
  • notificationPrompt 目前只做 UI 承接，不触发真实系统通知授权
  • 埋点闭环没有按产品文档完全补齐

6. 为什么不再继续维护旧 13 屏口径

Section titled “6. 为什么不再继续维护旧 13 屏口径”

旧文档的问题不是“完全错”，而是它无法准确描述当前项目状态：

  • 它没有覆盖 07-20 的重排后页面结构
  • 它没有覆盖 20 Plan Result 的最终交付页
  • 它把登录/支付承接仍写成旧行为
  • 它没有区分“可见页面数”和“实现 step 数”

继续在旧口径上打补丁，只会越来越难读。当前版本直接切换成 20 页面 / 18 step 双口径，是为了让设计、工程和产品能说同一件事。