platforms/docs/操作日志_商城订单列表展示修复_20260816.md

# 商城订单列表展示修复操作日志

操作时间：2026-08-16

操作类型：修改

影响模块：平台总后台电商平台管理、商城订单只读列表

## 操作前状态

- 商城订单用户关系按普通唯一标识字段展示，管理员只能看到 UUID。
- Mock 数据误用跨领域通用状态 `10`、`35`，与商城正式实现的独立交易状态不一致。
- 已支付 Mock 订单缺少支付时间，部分 Mock 订单的商品金额和应付金额为零。

## 具体操作

1. 将商城订单用户列改为名称优先展示，并保留 UUID 复制与详情跳转。
2. 保持商城独立交易状态：`16=待支付`、`18=已支付`、`22=已取消`。
3. 将 Mock 待支付订单从 `10` 修复为 `16`，已支付订单从 `35` 修复为 `18`。
4. 补齐 Mock 订单商品金额、应付金额及已支付订单的支付时间。
5. 待支付订单的空支付时间明确显示为“未支付”，不再显示无语义短横线。
6. 补齐 Mock 订单的请求流水号、地址、经纬度、联系人、联系电话和备注快照。
7. 修复第十组既有 Mock 用户名称、电话、地址及经纬度的错误值。
8. 待发货、未收货及无备注字段使用明确业务文案，不再统一显示短横线。
9. 增加独立幂等修复命令，只更新固定十条商城 Mock 订单及其用户、地址快照来源。
10. 增加前端展示契约与后端种子测试，防止跨领域状态再次混入商城订单。
11. 补齐商品评价列表的商城订单、商品和用户关系名称展示，避免相邻电商页面继续直接显示 UUID。

## 行为变化

- 修改前：用户 UUID 作为主要信息；Mock 订单状态、金额和支付时间与商城流程不一致。
- 修改后：用户名称作为主要信息，待支付记录明确显示“未支付”；重新执行 Mock 数据命令时会幂等修复既有 Mock 订单。
- 商城订单仍为只读资源，正式业务接口、权限和非 Mock 订单数据均未改变。

## 代码变更

- `frontend/platform_admin/src/api/resources.ts`：更新商城订单用户展示契约。
- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`：增加商城订单回归检查。
- `backend/api/internal/seed/mock.go`：修正并幂等修复 Mock 商城订单状态、金额和支付时间。
- `backend/api/internal/seed/mock_test.go`：增加商城独立状态回归测试。
- `backend/api/cmd/cli/main.go`：增加 `repair-mock-ec-order` 独立修复命令。
- `docs/项目文档_平台资源中文展示统一_v1.0.md`：记录 v1.4 变更。

## 验证结果

- `pnpm resource-display-contracts:check`：通过。
- `pnpm type:check`：通过。
- `pnpm build`：通过，Vite 成功完成 2621 个模块的生产构建。
- `go test ./internal/seed ./cmd/cli`：通过。
- `go test ./...`：通过。
- `go vet ./...`：通过。
- `go build ./cmd/main/main.go`：通过。
- `go run ./cmd/cli repair-mock-ec-order`：通过，固定十条商城 Mock 订单已全部修复。
- 完整 `mock-data` 命令曾因既有 `mock_producer_010` 用户名冲突失败，事务已整体回滚；随后使用独立修复命令成功处理商城订单，未修改冲突的生产商数据。

## 风险评估

- 仅固定 `MOCK-ECORDER-*` 与 Mock identity 范围的数据会被种子逻辑修复。
- 关系加载失败时继续显示“名称加载失败”，UUID 可用于排障。
- 既有重复生产商 Mock 账号仍需单独排查，不属于本次商城订单展示修复范围。