diff --git a/docs/操作日志_内容类型与发布状态中文展示修复_20260817.md b/docs/操作日志_内容类型与发布状态中文展示修复_20260817.md new file mode 100644 index 0000000..6218fcb --- /dev/null +++ b/docs/操作日志_内容类型与发布状态中文展示修复_20260817.md @@ -0,0 +1,45 @@ +# 内容类型与发布状态中文展示修复操作日志 + +操作时间:2026-08-17 + +操作类型:修改 + +影响模块:平台总后台、内容管理 + +## 操作前状态 + +- 内容类型直接显示 `notice` 等后端编码。 +- 字符串发布状态被通用数字状态格式化误判,显示“未知状态(published)”。 +- 新建和编辑页面允许手工输入未定义编码。 + +## 具体操作 + +1. 内容类型按模型与需求文档明确的范围配置为“公告”“协议”。 +2. 发布状态配置为“草稿”“已发布”,新建默认使用草稿。 +3. 列表、详情、新建和编辑共用同一字段枚举;历史未知值显示明确提示。 +4. 增加静态展示契约,防止英文编码重新进入业务页面。 + +## 行为变化 + +- `notice` 显示为“公告”。 +- `draft`、`published` 分别显示为“草稿”“已发布”。 +- 不修改接口字段、数据库存储值或客户端已发布内容查询规则。 + +## 代码变更 + +- `frontend/platform_admin/src/api/resources.ts`:补齐内容类型和发布状态中文枚举。 +- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`:增加内容管理中文展示契约。 +- `docs/项目文档_平台资源中文展示统一_v1.0.md`:记录 v1.17 变更。 + +## 验证结果 + +- `pnpm resource-display-contracts:check`:通过。 +- `pnpm contract:check`:通过,48 个资源契约一致。 +- 修改文件定向 Biome lint:通过,无错误和警告。 +- `pnpm type:check`:通过。 +- `pnpm build`:通过,TypeScript 类型检查及 Vite 生产构建完成,共转换 2621 个模块。 + +## 风险评估 + +- 仅将文档与模型已明确的公告、协议纳入下拉,未知历史类型不会被静默改写。 +- 发布状态保持后端 `draft`、`published` 编码,用户端已发布内容筛选逻辑不变。 diff --git a/docs/项目文档_平台资源中文展示统一_v1.0.md b/docs/项目文档_平台资源中文展示统一_v1.0.md index 8c87017..fab1a98 100644 --- a/docs/项目文档_平台资源中文展示统一_v1.0.md +++ b/docs/项目文档_平台资源中文展示统一_v1.0.md @@ -79,3 +79,4 @@ frontend/platform_admin/ - v1.14:日期时间统一按字段类型格式化,财务结算周期完整显示为 `YYYY-MM-DD HH:mm:ss`,不再回显带 `T` 的截断 RFC3339 文本。 - v1.15:财务结算主体类型改为气站、配送点、工作人员中文枚举,并按类型联动对应主体资源,切换类型时清空旧主体。 - v1.16:财务对账渠道统一显示余额支付、支付宝、微信支付;账单日期按 `YYYY-MM-DD` 展示,不再回显时间和时区。 +- v1.17:内容类型统一显示公告、协议,发布状态统一显示草稿、已发布;新建和编辑改用中文下拉并保留未知值提示。 diff --git a/frontend/platform_admin/scripts/check-resource-display-contracts.mjs b/frontend/platform_admin/scripts/check-resource-display-contracts.mjs index dac5b74..5aa58cc 100644 --- a/frontend/platform_admin/scripts/check-resource-display-contracts.mjs +++ b/frontend/platform_admin/scripts/check-resource-display-contracts.mjs @@ -343,6 +343,19 @@ assertIncludes( "unknownValueLabel: '未知对账渠道'", '财务对账渠道必须使用中文枚举并保留未知值提示', ); +for (const contentContract of [ + "{ label: '公告', value: 'notice' }", + "{ label: '协议', value: 'agreement' }", + "{ label: '草稿', value: 'draft' }", + "{ label: '已发布', value: 'published' }", + "unknownValueLabel: '未知发布状态'", +]) { + assertIncludes( + resources, + contentContract, + `内容管理缺少中文枚举契约:${contentContract}`, + ); +} assertIncludes( detailPage, '!hasResourceFieldLabel(props.definition, actualKey)', diff --git a/frontend/platform_admin/src/api/resources.ts b/frontend/platform_admin/src/api/resources.ts index 4dc730e..b42054d 100644 --- a/frontend/platform_admin/src/api/resources.ts +++ b/frontend/platform_admin/src/api/resources.ts @@ -881,7 +881,27 @@ export const resources: ResourceUiDefinition[] = [ }), f('bill_date'), f('difference_amount'), ]), - define('cms_content', '内容', 'writable', [f('content_type', { required: true }), f('title', { required: true }), f('body', { required: true }), f('version_no'), f('publish_status')]), + define('cms_content', '内容', 'writable', [ + f('content_type', { + required: true, + type: 'select', + options: [ + { label: '公告', value: 'notice' }, + { label: '协议', value: 'agreement' }, + ], + unknownValueLabel: '未知内容类型', + }), + f('title', { required: true }), f('body', { required: true }), f('version_no'), + f('publish_status', { + type: 'select', + options: [ + { label: '草稿', value: 'draft' }, + { label: '已发布', value: 'published' }, + ], + defaultValue: 'draft', + unknownValueLabel: '未知发布状态', + }), + ]), define('cs_ticket', '客服工单', 'writable', [relation('user_account_identity', '/user_account', true), f('ticket_no', { required: true }), f('category', { required: true }), f('priority', { required: true })]), define('platform_account', '平台账户', 'writable', [f('username', { required: true }), f('password', { required: true }), f('display_name'), f('avatar'), f('platform_role_code', { required: true, unknownValueLabel: '未知角色' }), f('phone')]), define('platform_role', '平台角色', 'writable', [f('role_code', { required: true }), f('name', { required: true }), f('location_scope', { required: true, type: 'select', options: resourceSearchEnumOptions('platform_role', 'location_scope') })], 'list', [