vscode-workbench/PLANNING/PROGRESS_C-06.md

PROGRESS — C-06 · 关注 feed + 首页签到卡 + 学习数据钩子

• 状态：done

日期 2026-09-13 · 范围：chunyu_project/article+learn+user（后端只加字段/修bug/加用例，不改契约）+ chunyu_project_react

现状 vs 差距（接手时）

• 已有：Follow 模型 + POST /user/follow/<id>/ + GET /api/article/list?feed=following（后端）+ 详情页关注按钮（ArticleDetail.handleFollow）+ 桌面端 Home 签到卡（含未登录引导态）+ 课程 students_count（ChapterRead 去重）双端显示。
• 缺口：article/learn 零用例；列表接口缺 author_user_id/is_following（卡上无法关注）； 列表无关注空态；HomeMobile 无签到条；无 total_minutes 字段； get_author_name 在 ASGI 下同步碰 obj.author 外键 → 课程列表 500（本轮真抓到的 bug）。

改动

后端（chunyu_project/）：

1. article/serializers.py：ArticleListSerializer 加 author_user_id + is_following（登录态关注判定）。
2. learn/serializers.py：
   • get_author_name 改 sync_to_async 线程取数（修课程列表 500 真 bug，list/detail 双处）；
   • 新增 parse_duration_minutes（中文“30分钟”/纯数字解析，不可解析返回 None 不伪造）+ total_minutes 字段（list/detail 双序列化器，可解析章节求和）。
3. article/tests/（新建包 + test_following_feed.py 7 条）：仅关注作者可见/未关注空态/ 双关注全可见/取关移除/匿名空态/普通列表不受影响/草稿不进 feed。
4. learn/tests/（新建包 + test_c06_hooks.py 8 条）：签到双签 400+积分不变+单记录/ status 已签/匿名 401；聚合 2 用户交叉去重=2/零阅读=0/detail 对齐； total_minutes 求和 75/全不可解析 null。

前端（chunyu_project_react/src/）： 5. pages/Articles/Articles.tsx：Article 接口加 author_user_id/is_following； handleToggleFollow（关注切换 + feed=5 下取关即时移除）；grid/list 双卡作者行加关注按钮； 空态（关注态 vs 普通态两套文案）。 6. pages/Articles/Articles.css：.articles-follow-btn + .articles-empty（含 dark）。 7. locales/{en,zh,zh-TW,ja,ko,ru}.json：articles.empty.{title,hint,followingTitle,followingHint}。 8. pages/Home/HomeMobile.tsx + .css：移动签到条（状态/周进度/一键签到/未登录引导，与桌面同口径）。 9. pages/Learn/Learn.tsx + LearnMobile.tsx：total_minutes 映射 + 有值才显示时长徽标； locales 六语言加 learn.minutes；Learn 加缺失的 ClockCircleOutlined 引入。

口径说明

• total_minutes 只对可解析 duration 求和；存量中文字符串解析不出 → null → 前端不显示。
• 签到幂等：第二次 400（今日已签到），积分不变（单测锁定）。
• 未动：推荐算法（无）、Follow/签到字段与契约（无）、弹窗动画（无）。

验证

DB_ENGINE=django.db.backends.sqlite3 DB_NAME=".../dev_db.sqlite3" python manage.py test article learn tool -v 1
# Ran 30 tests … OK（15 存量 + 15 新增；中途一次 sqlite 锁表抖动，重跑即绿）
tsc --noEmit -p chunyu_project_react/tsconfig.json   # 零报错
pnpm build  # ✓ built in 14.99s

手工等价：A 关注 B → feed=following 只见 B 文（单测同等价 7 条）；连签两次 → 第二次 400 积分不变（单测锁定）。

状态

done。遗留：user 滑块验证码既有红（3 失败+9 错误，与本任务无关，未动）； dev_db.sqlite3 曾缺 aitool 表已补迁移（migrate aitool），验证残留已清零。