ilaandClaude Opus 4.8
fd37ff6383
- docs/01-vision 核心目标、目标用户、产品原则、非目标 - docs/02-requirements 产品语言需求 + MVP 验收标准（无技术词） - docs/03-tech-stack go-app / 纯CSS / SQLite / Session Cookie / 单二进制部署 - docs/04-architecture 系统结构、前后端职责、真实 episodes.json 数据模型、技术难点 - docs/05-coding-rules AI 写代码前必读的硬约束（防跑偏） - CLAUDE.md AI 入口：文档地图、真实数据 schema、强制必读编码规则 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
4.5 KiB
4.5 KiB
需求
本文只描述要什么与怎么算达成，用产品 / 用户语言表达，不涉及技术实现。 技术方案、数据结构、字段定义见 架构设计；内容数据的字段与校验见
scripts/。
一、素材现状（产品视角）
| 项 | 状态 |
|---|---|
| 音频 | ep1–17 基本齐全；ep18–26 暂缺音频（共 9 集只有文稿） |
| 英文文稿 | 26 集逐句英文文稿，且与音频逐句对齐（可点句定位） |
| 中文翻译 | 行级暂无；仅每集有中文标题 |
| 视频 | 无（本产品不涉及视频） |
音频缺口意味着 MVP 的精听闭环建议先锁定 ep1–17；ep18–26 待补音频后纳入。
二、用户角色
- 登录用户：拥有账号，学习进度与生词本跨设备延续
- 游客是否可浏览：待定（见待确认问题）
三、功能清单
第一版 MVP（最小闭环）
| 功能 | 用户能做什么 | 优先级 |
|---|---|---|
| 课程列表 | 按集 / 幕浏览课程，看到自己学到哪、学了多少 | P0 |
| 音频播放 | 播放 / 暂停 / 拖动进度 | P0 |
| 逐句同步 | 字幕随音频逐句高亮；点任一句，音频跳到该句重听 | P0 核心 |
| 生词本 | 看到生词点一下加入生词本，随时查看列表 | P0 |
| 账号与同步 | 登录后，换设备进度与生词本仍在 | P0 |
| 离线可用 | 无网时也能继续学已缓存的课程，并可装到主屏 | P0 |
后续迭代
| 功能 | 描述 | 阶段 |
|---|---|---|
| 复读 / 精听 | AB 复读、单句循环、变速 | V2 |
| 测验 | 听写 / 选择 / 填空 | V2 |
| 学习打卡 | 记录学到哪、连续天数 | V2 |
| 激励模块 | 「打鸡血」板块：联网时每天推荐一个英语学习成功案例；优先结合用户自身数据（连续天数、精听句数）做真实激励 | V2 |
| 多教材扩展 | 接入新概念英语等更多教材（为多教材预留空间） | V2+ |
| 中英对照 | 补齐行级中文翻译后开启 | V3 |
| 生词复习 | 间隔重复记忆（SRS） | V3 |
四、核心用户故事（MVP）
- 作为学习者，我打开 App 看到课程列表，知道自己学到了哪。
- 我点进一集，音频开始播放，字幕随之逐句高亮。
- 有一句没听懂，我点那句字幕，音频跳回那句重听。
- 遇到生词，我点一下加入生词本。
- 换了平板登录，我的进度和生词本都还在。
- 坐地铁没网，我依然能打开已缓存的课程继续学。
五、验收标准（MVP · 怎么算做到了）
每条 P0 功能对应可验证的判据（产品语言，不含实现细节）：
- 课程列表：打开即见课程清单，每项显示学习进度（如"2/3 幕"或百分比）。
- 音频播放：任选一幕能在约 2 秒内开始播放，可暂停、可拖动进度。
- 逐句同步：播放时高亮的句子与人耳听到的一致；点任一句，音频在约 1 秒内跳到该句开头。
- 生词本：点词后该词出现在生词本列表；刷新或重进后仍在。
- 账号与同步：A 设备登录学习后，B 设备登录同一账号能看到相同的进度与生词本。
- 离线可用：断网后仍能打开已学过的课程并播放；可安装到手机主屏。
六、范围边界与决策
| 问题 | 决策 |
|---|---|
| 平台优先级 | 大屏手机 / 平板优先，按触控 + 中大屏设计 |
| 是否带账号 | 是，需登录账号 |
| 中英对照 | 第一版纯英文（暂无行级中文），后续补齐再开启 |
| 第一版范围 | 列表 + 播放 + 逐句同步 + 生词本跑通，再加测验 / 打卡 |
| MVP 内容范围 | 先锁定有音频的 ep1–17 |
七、待确认 / 风险点
- ❗ 版权：「走遍美国」素材的使用授权。若公开发布或商用，需确认音频与文稿的授权问题。
- ❗ 逐句同步是核心体验，也是实现上最难的一环，建议先单独验证原型再往上搭（技术原因见 架构设计）。
- ❗ 内容缺口：ep18–26 缺音频，需补料；具体清单见数据校验脚本。
- 生词本是否需要查词 / 释义？（MVP 可先只存单词，不接词典）
- ❗ 激励模块内容来源待定：成功案例库需自行精选、可信，避免空洞鸡汤与版权问题；建议以用户真实进步数据为主、名人真实学语经历为辅。
- 📌 本项目定位为长期多教材英语学习平台，「走遍美国」是第一个教材，后续接入新概念英语等。