docs: 补全 AI 入口/API/路由/现状文档并对齐一致性
新增(Codex 起草,本次纳入并校对): - AGENTS.md:仓库级 AI 强约束入口 - docs/00-ai-start-here.md:AI 开发入口与导航 - docs/api.md:账号/生词本/进度 API 合约草案 - docs/routes.md:go-app 页面路由与组件归属 - docs/current-state.md:当前实现状态 补充与对齐: - 验证命令补 bash(WSL/Linux 为主,PowerShell 为备):00-ai-start-here、AGENTS - 04-architecture:新增第六节"项目结构(包布局)"+ 3.2 建表 SQL 草案 - docs/README 导航补 06-tasks;CLAUDE 目录树补 AGENTS/scripts/design_mockups - 00-ai-start-here 去除已过时的"需要补齐"段 - 06-tasks:Phase 2/3/4/5 交叉引用 api.md / routes.md / 包布局 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
+7
-3
@@ -49,7 +49,7 @@
|
||||
| --- | --- | --- | --- | --- |
|
||||
| T-200 | UI 效果稿:播放页 + 课程列表(HTML/CSS) | — | 中保真稿覆盖逐句高亮/点句跳转/进度/无音频降级;用真实数据;CSS 可迁移 go-app。见 `design_mockups/` | DONE |
|
||||
|
||||
> 设计 spike,不是生产代码。产出在 `design_mockups/play.html`、`list.html`,作为 T-201/T-203 的视觉依据。
|
||||
> 设计 spike,不是生产代码。产出在 `design_mockups/play.html`、`design_mockups/list.html`,作为 T-201/T-203 的视觉依据;CSS 可迁移,但不要直接把 spike 当生产代码整体搬入。
|
||||
|
||||
## Phase 2 · 课程列表 + 播放页
|
||||
|
||||
@@ -59,6 +59,8 @@
|
||||
| T-202 | 路由:列表 → 选集选幕 → 播放页 | T-201 | 点列表项进入对应播放页,可返回 | TODO |
|
||||
| T-203 | 播放页接入 Phase 1 同步组件 | T-202, T-104 | 任选有音频的幕,播放 + 逐句同步 + 点句跳转全部可用 | TODO |
|
||||
|
||||
> 页面路由与组件归属见 [路由](routes.md);视觉参考 `design_mockups/`;包布局见 [架构设计](04-architecture.md) 第六节。
|
||||
|
||||
## Phase 3 · 后端账号体系(Session Cookie)
|
||||
|
||||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||||
@@ -67,6 +69,8 @@
|
||||
| T-302 | 注册 / 登录 API + httpOnly Session Cookie | T-301 | 注册、登录成功后下发 httpOnly cookie;带 cookie 的请求能识别用户;登出失效 | TODO |
|
||||
| T-303 | 前端登录 / 注册界面 + 登录态 | T-302 | 能注册登录;刷新后保持登录;未登录访问需登录的页面会被引导登录 | TODO |
|
||||
|
||||
> 接口合约见 [API](api.md);建表 SQL 见 [架构设计](04-architecture.md) 第 3.2 节。
|
||||
|
||||
## Phase 4 · 生词本
|
||||
|
||||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||||
@@ -75,7 +79,7 @@
|
||||
| T-402 | 点词加入生词本(播放页交互) | T-401, T-203 | 在字幕里点单词即可加入;有反馈 | TODO |
|
||||
| T-403 | 生词本列表页 | T-401 | 查看自己的生词列表;刷新/重进仍在 | TODO |
|
||||
|
||||
> 对应需求验收:02-requirements 第五节"生词本"。MVP 只存单词,不接词典释义。
|
||||
> 对应需求验收:02-requirements 第五节"生词本"。MVP 只存单词,不接词典释义。接口合约见 [API](api.md) 生词本一节。
|
||||
|
||||
## Phase 5 · 进度同步
|
||||
|
||||
@@ -85,7 +89,7 @@
|
||||
| T-502 | 播放时上报进度 + 列表显示进度 | T-501, T-203, T-201 | 播放中断点被记录;课程列表显示学习进度(如"2/3 幕") | TODO |
|
||||
| T-503 | 跨设备验证 | T-502 | A 设备学习后,B 设备登录同账号看到相同进度与生词本 | TODO |
|
||||
|
||||
> 对应需求验收:02-requirements 第五节"账号与同步"。
|
||||
> 对应需求验收:02-requirements 第五节"账号与同步"。接口合约见 [API](api.md) 学习进度一节。
|
||||
|
||||
## Phase 6 · PWA 离线化
|
||||
|
||||
|
||||
Reference in New Issue
Block a user