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:
ila
2026-06-21 19:30:14 +08:00
co-authored by Claude Opus 4.8
parent 39713eb8ac
commit b9bcbf7e6b
11 changed files with 710 additions and 13 deletions
+7 -3
View File
@@ -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 离线化