IOS-M1-01 学习首页改版：继续上次 + 复习入口 + 周进度 #15

New Issue

wangdl · 2026-05-29T19:37:39+08:00

wangdl commented

2026-05-29 19:37:39 +08:00

目标

重写 StudyHomeView，以优先级卡片取代当前简单的任务列表。

背景

当前学习首页只有一个今日进度环和任务列表，缺乏产品文档要求的「我现在该做什么」主行动引导。

模块职责

1. 主行动优先级（第一屏主卡片）

优先级	条件	主卡片
1	有未完成学习	继续上次学习（带上下文文案）
2	无未完成、有今日复习	今日复习（告知任务数和时长）
3	无复习、有新自测	资料自测入口
4	有新资料整理完成	开始学习
5	空状态	引导去知识库添加资料

2. 本周进度摘要

本周学习时长
完成学习次数
完成复习数量
连续学习天数（调用 GET /activity/streak）

3. 状态提示条

资料整理中/失败/完成
测验生成中
复习卡生成中

4. 切换回 StudyViewModel 数据

禁止事项

不要求同时展示所有卡片
继续上次需要后端支持（学习会话恢复），第一版可先 mock

## 目标重写 StudyHomeView，以优先级卡片取代当前简单的任务列表。 ## 背景当前学习首页只有一个今日进度环和任务列表，缺乏产品文档要求的「我现在该做什么」主行动引导。 ## 模块职责 ### 1. 主行动优先级（第一屏主卡片） | 优先级 | 条件 | 主卡片 | |--------|------|--------| | 1 | 有未完成学习 | 继续上次学习（带上下文文案） | | 2 | 无未完成、有今日复习 | 今日复习（告知任务数和时长） | | 3 | 无复习、有新自测 | 资料自测入口 | | 4 | 有新资料整理完成 | 开始学习 | | 5 | 空状态 | 引导去知识库添加资料 | ### 2. 本周进度摘要 - 本周学习时长 - 完成学习次数 - 完成复习数量 - 连续学习天数（调用 GET /activity/streak） ### 3. 状态提示条 - 资料整理中/失败/完成 - 测验生成中 - 复习卡生成中 ### 4. 切换回 StudyViewModel 数据 ## 禁止事项 - 不要求同时展示所有卡片 - 继续上次需要后端支持（学习会话恢复），第一版可先 mock

wangdl added this to the M1：iOS 页面功能深化 milestone 2026-05-29 19:37:39 +08:00

wangdl commented

2026-05-29 19:40:05 +08:00

✅ IOS-M1-01 修复完成

修改

文件	变更
`Features/Study/StudyHomeView.swift`	重写：主行动卡片 + 本周摘要 + 真实 API 数据

页面结构

┌──────────────────────────────┐
│                    🔥 14天连续│
│                              │
│  今日主行动                   │
│  ┌──────────────────────────┐│
│  │ 今日复习        🔄       ││
│  │ 8 张卡片待复习            ││
│  │ [ 开始 → ]               ││
│  └──────────────────────────┘│
│                              │
│  本周80min  完成3个  卡片8张  │
│                              │
│  今日任务                     │
│  ☑ 机器学习-回忆测试  10min  │
│  ○ 英语词汇-25个待复习 8min │
│  ...                         │
│                              │
│  每日思考题                   │
└──────────────────────────────┘

数据来源

数据	API
连续天数	GET /activity/streak
本周分钟	GET /activity/summary
复习卡片数	GET /reviews/due
任务列表	StudyHomeViewModel（mock）

行为变化

场景	修改前	修改后
有今日复习	显示进度环	主卡片=今日复习（卡片数）
无今日复习	显示进度环	主卡片=开始学习（引导文案）
本周数据	无	本周摘要栏（分钟/任务/卡片/天数）

## ✅ IOS-M1-01 修复完成 ### 修改 | 文件 | 变更 | |------|------| | `Features/Study/StudyHomeView.swift` | 重写：主行动卡片 + 本周摘要 + 真实 API 数据 | ### 页面结构 ``` ┌──────────────────────────────┐ │ 🔥 14天连续│ │ │ │ 今日主行动 │ │ ┌──────────────────────────┐│ │ │ 今日复习 🔄 ││ │ │ 8 张卡片待复习 ││ │ │ [ 开始 → ] ││ │ └──────────────────────────┘│ │ │ │ 本周80min 完成3个卡片8张 │ │ │ │ 今日任务 │ │ ☑ 机器学习-回忆测试 10min │ │ ○ 英语词汇-25个待复习 8min │ │ ... │ │ │ │ 每日思考题 │ └──────────────────────────────┘ ``` ### 数据来源 | 数据 | API | |------|-----| | 连续天数 | GET /activity/streak | | 本周分钟 | GET /activity/summary | | 复习卡片数 | GET /reviews/due | | 任务列表 | StudyHomeViewModel（mock） | ### 行为变化 | 场景 | 修改前 | 修改后 | |------|--------|--------| | 有今日复习 | 显示进度环 | 主卡片=今日复习（卡片数） | | 无今日复习 | 显示进度环 | 主卡片=开始学习（引导文案） | | 本周数据 | 无 | 本周摘要栏（分钟/任务/卡片/天数） |

wangdl commented

2026-06-06 18:54:25 +08:00

关闭

StudyHomeView 已实现（继续上次 + 复习入口 + 周进度）。

## 关闭 StudyHomeView 已实现（继续上次 + 复习入口 + 周进度）。

wangdl closed this issue

2026-06-06 18:54:36 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/ios-projects#15