跳转到内容
IntelliFuture Docs

03-落地与验证

落地与验证

Section titled “落地与验证”

1. 当前实现状态

Section titled “1. 当前实现状态”

当前分支已经完成的是一个 debug-only onboarding shell，入口位于现有 App 内部调试路径，不是正式冷启动入口。

已落地能力：

  • 20 个可见页面 / 18 个实现 step 主链
  • opening 段按 Pencil 坐标和节奏落地
  • 07-20 后半段已按新链路实现
  • 20 Plan Result 已替换为滚动式结果页
  • plan 主按钮已承接到既有全屏 paywall
  • 老用户入口已承接到既有全屏登录

仍是本地壳层的部分：

  • 计划生成仍由本地 fixture 产出
  • 通知授权页当前不触发真实系统权限
  • 还没有接入正式首启 root flow

2. 当前字段模型

Section titled “2. 当前字段模型”

当前实现里已经存在或可直接映射的字段如下：

  • goal
  • level
  • pain
  • startType
  • interestTags
  • dailyCommitmentMinutes
  • weeklyPracticeSessions
  • onboardingPlanVariant

向更稳定的产品字段映射时，建议使用：

  • intent_primary <- goal
  • level_self_assessed <- level
  • pain_primary <- pain
  • interest_cluster_primary <- startType
  • interest_tags <- interestTags
  • daily_commitment_minutes <- dailyCommitmentMinutes
  • weekly_practice_sessions <- weeklyPracticeSessions
  • onboarding_plan_variant <- plan variant

3. 当前计划变体规则

Section titled “3. 当前计划变体规则”

当前代码里仍保留 4 个 plan variant：

  • lightRestartStart
  • easyListeningStart
  • dailyDialogStart
  • structuredProgressStart

当前分配规则以实现为准：

  1. 如果 goal == 重新开始，优先 lightRestartStart
  2. 否则如果 startType == 贴近日常，使用 dailyDialogStart
  3. 否则如果 startType == 更有目标感，或 startType 为空但 level == 基础还行，使用 structuredProgressStart
  4. 其他情况归到 easyListeningStart

4. 当前 plan result 生成规则

Section titled “4. 当前 plan result 生成规则”

20 Plan Result 当前由以下几部分组成：

  • 标题固定：七天，听见进步
  • coach 提示语固定： 我按你的目标、节奏和兴趣，把这一周的开始方式整理好了。
  • 摘要卡 4 项：
    • 开始方式摘要
    • 每日时长摘要
    • 每周频次摘要
    • 兴趣摘要
  • 功能模块 5 项：
    • 真实日语，每天更新
    • 听读同步，高亮注解
    • 逐句精听，啃下难句
    • 点词即查，阅读不断线
    • 逐句 AI 解惑

当前仍是 fixture 规则，不依赖真实后端计划引擎。

5. 登录与支付承接规则

Section titled “5. 登录与支付承接规则”

5.1 登录

Section titled “5.1 登录”
  • 入口：02-05 welcomeShowcase 的 我已有账号
  • 方式：直接复用既有 AuthViewController
  • 展现：全屏 fullScreen

当前行为：

  • 用户取消登录，只关闭登录页，返回 onboarding shell
  • 用户完成登录后，退出 onboarding shell，进入首页

5.2 支付

Section titled “5.2 支付”
  • 入口：20 Plan Result 的 出发吧！
  • 方式：直接复用既有 PaywallViewController
  • 展现：全屏 fullScreen

当前行为：

  • 左上角取消关闭 paywall 后，退出 onboarding shell，进入首页

6. 关键交互收口

Section titled “6. 关键交互收口”

6.1 回退与改选

Section titled “6.1 回退与改选”
  • 返回后保留已选状态
  • 改选会覆盖旧答案
  • 改选后需要重新生成 plan

6.2 单选页继续规则

Section titled “6.2 单选页继续规则”
  • 08 / 09 / 10 / 12 / 14 首次选择时默认自动前进
  • 用户从后续页面返回时，页面会显示 下一步，避免再次点击选项就立即跳走

6.3 Weekly Frequency 特例

Section titled “6.3 Weekly Frequency 特例”
  • 15 的 下一步 当前始终存在
  • 默认频次是 3 次/周
  • 用户不调整也可以继续

7. 当前验证状态

Section titled “7. 当前验证状态”

当前这轮已经验证通过的测试包括：

  • YomiyaOnboardingShellEntryTests
  • YomiyaOnboardingShellCoordinatorTests
  • YomiyaOnboardingShellFixturesTests
  • YomiyaOnboardingPencilRenderTests
  • YomiyaOnboardingBrandIntroTests
  • YomiyaOnboardingShellStateTests
  • YomiyaOnboardingPencilLayoutTests
  • YomiyaOnboardingShellCompletionTests

已知仍未纳入本轮处理的问题：

  • UserService.swift 并发 warning
  • WordDictionaryViewModel.swift 并发 warning
  • 若干 script phase warning

8. 什么时候才算进入下一阶段

Section titled “8. 什么时候才算进入下一阶段”

只有当下面几件事都准备好，才建议把它从 debug shell 往正式首启链路推进：

  • plan 不再依赖本地 fixture
  • notification prompt 接入真实权限策略
  • 入口从 debug-only 切到正式 root flow
  • 埋点补齐并能观测 step 到达率、plan 交付率和 paywall 转化