docs: plan django-admin 中文化 (T-602 层1-3 / T-603 层4)

- 06-tasks.md 新增 T-602(LANGUAGE_CODE=zh-hans + app/模型 verbose_name)与 T-603(字段级 verbose_name)
- progress.md 追加两条决策记录;均为显示层、无 DB schema 变更

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
QiuSW
2026-07-04 14:51:55 +08:00
co-authored by Claude Opus 4.8
parent de92a584ad
commit 521b1434b6
2 changed files with 22 additions and 0 deletions
+20
View File
@@ -1029,3 +1029,23 @@
- 小点(不用改):`prices` 按分辨率字符串排序,`512` 排在 `4K` 之后,纯展示层顺序,无功能影响。
- 保留:本轮完整套件未单次全绿(远程 MySQL 间歇超时),T-601 相关测试本身通过,非断言失败。
- 结论:达标,无 P1/P2,不需要修补任务。
## 2026-07-04 决策:django-admin 中文化(T-602 立项,先文档)
- 背景:运营反馈 admin 后台表名/字段名是英文,希望显示中文。按「需求先改文档再改代码」规矩,先立任务。
- 范围:本次只做**第 1-3 层(显示层,不动业务逻辑与 DB 结构)**:
- 第 1 层 `LANGUAGE_CODE='zh-hans'` + `USE_I18N=True`:Django 自带 admin 与内置 auth(用户/组/权限)界面中文化(无迁移,性价比最高)。
- 第 2 层 各 app `AppConfig.verbose_name`:中文分组名(无迁移)。
- 第 3 层 各模型 `Meta.verbose_name`/`verbose_name_plural`:中文表名(产出 `AlterModelOptions` **无 DB 变更**迁移)。
- 明确**不含第 4 层**字段级 `verbose_name`(字段列名暂保持英文),如需另立任务。
- 验收:`makemigrations`(仅 options)→ `migrate` → `check`/`test` 全绿 → `/admin/` 目视中文化,留证据。
- 决策依据:第 1 层一行配置即可中文化 Django 自身 + auth 约 60-70%;自建模型的表名靠第 2/3 层 verbose_name;字段级(第 4 层)体力大、单独评估。任务见 `06-tasks.md` T-602。
- 下一步:按 T-602 实现第 1-3 层。
## 2026-07-04 决策补充:admin 中文化第 4 层立为 T-603
- 承接上条:应要求把「第 4 层·字段级 `verbose_name`」也纳入计划,立为独立任务 T-603(依赖 T-602,在 1-3 层之上做)。
- 范围:各模型业务字段加中文 `verbose_name`(如 `points_balance`→点数余额、`amount_money`→金额、`points_granted`→到账点数等),admin 自定义显示方法同步中文。
- 约束不变:**仅显示层**,`verbose_name` 只改展示、不改字段名与代码引用;产出 `AlterField`(metadata-only,无 DB schema 变更)迁移。
- 拆两个任务的原因:第 4 层字段多、机械体力大,独立成 T-603 便于单独实现与复核;T-602(1-3 层)可先落地看效果。
- 下一步:T-602 先行,T-603 随后。