vscode-workbench/PLANNING/PROGRESS_E-05.md

PROGRESS_E-05 · 公开内容页 SEO（词/题/词书）

日期 2026-09-13 · 范围：只改 english-drill 目录（后端 core/apps.content/config + 前端 pages/App + tests/e2e）

选型

Django 模板直出（与 views_web.spa 同栈），理由：后端已有 async 视图 + 完整 ORM， 三条路由直出 HTML 零构建依赖；不做全站 SSR 迁移，不动登录内页面。

现状 vs 差距（接手时）

• 已有：440 word 卡 + 519 题 + 5 词书已入库；public_question 白名单（无答案）； E2E 124 用例全绿；前端全登录内路由。
• 缺口：整站登录后可见（首屏登录墙 E-02 已拆，但内容页仍需登录），440 词零长尾入口。

改动（全部在 C:/Users/12914/Desktop/english-drill/ 内）

1. backend/core/views_seo.py（新建）：SeoWordView（/word/<front>，大小写归一，重词 order_by id 确定性）， SeoQuestionView（/question/<id>，public_question 白名单，不含答案/解析）， SeoBookView（/book/<id>，词数/章节概览），seo_sitemap（421 词 + 519 题 + 5 词书 = 945 URL， loc 站内相对路径，部署层拼域名），seo_robots。每页独立 title/description/OG/canonical + 注册引导（from=word-/question-/book-）。
2. backend/config/urls.py：五条路由挂在 SPA 兜底之前。
3. backend/apps/content/views.py + config/urls.py：WordLookupView（GET /api/content/word/<front>， 公开白名单：释义/音标/例句/同课相关词，无用户数据）。
4. 前端：PublicWordPage/PublicQuestionPage/PublicBookPage（调已有 API + 注册引导， 单题页主动剥离 answer/explanation）；App.tsx 加 /word/:front /question/:qid /book/:bid 公开路由。
5. tests/e2e/cases_seo.py（新建，7 条，group=seo）+ run_e2e.py 注册： 单词正文/大小写/404/单题无泄露（5 项白名单审查）/词书概览/查词白名单/sitemap 覆盖数。

验证

python "C:/.../english-drill/tests/e2e/run_e2e.py" -k seo
# 合计 7 用例 | 通过 7 | 断言失败 0 | 异常 0（sitemap word=421 q=519 book=5）
python "C:/.../english-drill/tests/e2e/run_e2e.py"
# 合计 133 用例 | 通过 133 | 断言失败 0 | 异常 0（124 存量 + 7 seo + 2 波动恢复，无回归）
tsc --noEmit -p frontend/tsconfig.json  # 零报错（修 SkeletonBlock h prop + BankDetail unknown 中转）
curl 等价：/word/abandon → <title>abandon 是什么意思…</title> + 释义正文（E2E 同等价覆盖）

踩坑：harness hit() 默认按 JSON 解析——直出 HTML/XML 用例改原生 resp 断状态码 + 正文关键字。

状态

done。遗留：sitemap loc 为站内相对路径（部署 nginx 按真实域名拼 canonical，见 deploy/nginx.conf 接线时处理）； 词面 440 卡去重 421（19 个跨词书重词，重词页 order_by id 取首个，诚实记录）。