# 平台资源中文展示统一操作日志

操作时间：2026-08-15

操作类型：修改、扩展

影响模块：平台总后台标准资源列表、详情、关系补载、树形页面和静态检查

## 操作前状态

- 资源总数为 48 类，其中 46 类走通用详情页，2 类使用树形页面。
- 19 类只读资源使用空字段配置，列表主要显示数据库 ID 和 UUID。
- 聚合详情除订单部分集合外仍可能根据响应键追加动态英文列。
- 关系加载失败时会把裸 UUID 当作主要名称展示。

## 具体操作

1. 补齐只读资源的中文字段、关系和业务顺序。
2. 列表移除数据库 ID 主列，将系统唯一标识置于业务列之后。
3. 新增资源详情契约，固定合同与订单聚合子表的列和 JSON 字段。
4. 静态及动态关系统一补载中文名称，并为可导航关系增加详情入口。
5. 树形页面补充业务编码或路径及系统唯一标识。
6. 新增 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仍可用于排障。
- 未声明的新字段不会自动展示；静态检查要求开发者补充中文语义后交付。
- 本次不新增历史名称快照，历史记录在无快照时显示当前名称。
- 浏览器写操作仅允许使用本次创建的测试数据；真实支付、外部通知和设备控制不在未确认的环境中执行。