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:
+20
@@ -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 随后。
|
||||
|
||||
Reference in New Issue
Block a user