3.9 KiB
3.9 KiB
平台资源中文展示统一操作日志
操作时间：2026-08-15
操作类型：修改、扩展
影响模块：平台总后台标准资源列表、详情、关系补载、树形页面和静态检查
操作前状态
- 资源总数为 48 类，其中 46 类走通用详情页，2 类使用树形页面。
- 19 类只读资源使用空字段配置，列表主要显示数据库 ID 和 UUID。
- 聚合详情除订单部分集合外仍可能根据响应键追加动态英文列。
- 关系加载失败时会把裸 UUID 当作主要名称展示。
具体操作
- 补齐只读资源的中文字段、关系和业务顺序。
- 列表移除数据库 ID 主列，将系统唯一标识置于业务列之后。
- 新增资源详情契约，固定合同与订单聚合子表的列和 JSON 字段。
- 静态及动态关系统一补载中文名称，并为可导航关系增加详情入口。
- 树形页面补充业务编码或路径及系统唯一标识。
- 新增 48 类资源展示契约检查，并同步既有订单和 JSON 检查脚本。
代码变更
frontend/platform_admin/src/api/resources.ts：补齐中文字段和 19 类只读资源字段。frontend/platform_admin/src/api/resource-display.ts：扩展状态、枚举、动态关系和未知字段保护。frontend/platform_admin/src/api/resource-detail-contract.ts：新增固定子表与 JSON 契约。frontend/platform_admin/src/views/resource/ResourceDetailContent.vue：消费资源契约并统一关系展示。frontend/platform_admin/src/views/resource/use-resource-relations.ts：补载动态主体关系。frontend/platform_admin/src/views/shared/CrudListPage.vue：业务列优先并移除数据库 ID。frontend/platform_admin/src/views/shared/resource-list-field-display.ts：专属列表列序。frontend/platform_admin/src/views/shared/RelationNameText.vue：关联名称跳转和 UUID 复制。frontend/platform_admin/src/views/shared/TreePage.vue：树节点业务标识与 UUID。frontend/platform_admin/scripts/check-resource-display-contracts.mjs：新增静态契约检查。
行为变化
- 修改前：数据库 ID、UUID 优先，部分列表没有业务列，关联表可能出现英文键。
- 修改后：中文名称和业务单号优先，UUID 为次要复制信息，未知字段不再直接显示。
- 既有接口、权限、不脱敏字段内容和业务动作协议保持不变。
验证结果
- 资源中文展示契约检查：通过。
- TypeScript 类型检查：通过。
- 配送订单列表与详情检查：通过。
- 资源详情 JSON 检查：通过。
- 前端生产构建：通过。
- 后端
go test ./...：通过。 - 后端
go vet ./...：通过。 - 后端临时目录构建：通过。
- 全仓 Biome：本次变更文件无新增错误；全仓仍有 2 个既有错误，均位于未改动的
protected-list-avatar-loader.ts回调返回值规则。 - Codex 内置浏览器回归：通过。实测订单列表、订单详情、分配记录、订单明细、状态记录和分配联动弹窗，整页无水平溢出。
- 浏览器回归补充修复：业务订单号改为完整展示，不再被系统标识组件截断；配送合同详情优先使用服务端返回的中文名称；配送人员占位文案与已锁定配送点的场景保持一致。
- 分配联动实测：已分配订单的配送点锁定为当前点，配送人员候选只包含该点下符合条件的人员，未提交任何业务动作。
风险评估
- 关系资源被归档或加载失败时显示“名称加载失败”，UUID仍可用于排障。
- 未声明的新字段不会自动展示；静态检查要求开发者补充中文语义后交付。
- 本次不新增历史名称快照，历史记录在无快照时显示当前名称。
- 浏览器写操作仅允许使用本次创建的测试数据；真实支付、外部通知和设备控制不在未确认的环境中执行。