57 lines
3.5 KiB
Markdown
57 lines
3.5 KiB
Markdown
# 操作日志：配送点独立资源页面
|
||
|
||
操作时间：2026-08-22 20:18:39
|
||
操作类型：扩展、修改
|
||
影响模块：配送点管理系统标准资源列表、独立记录页、前端路由与资源契约
|
||
|
||
## 操作前状态
|
||
|
||
配送点标准资源的新建、详情和编辑均在 `CrudListPage.vue` 抽屉中完成，没有稳定的记录 URL；支付和退款前端资源名与配送点后端实际路径不一致。
|
||
|
||
## 具体操作
|
||
|
||
1. 新增基于资源能力的路由生成器，为非单例资源生成详情、新建和编辑独立路由。
|
||
2. 新增共享记录页、详情内容、字段表单、业务动作对话框和未保存离开保护。
|
||
3. 新增标准列表页，将新建、详情和编辑入口改为路由跳转，并移除已停用的抽屉页面。
|
||
4. 为可编辑资源增加后端更新字段白名单，保留受控合同编辑限制和危险操作二次确认。
|
||
5. 将配送端支付、退款资源统一为 `payment_order`、`payment_refund`，同步后端契约快照。
|
||
6. 增加页面能力矩阵自动检查，并更新项目文档。
|
||
7. 依据 5173 页面重新对齐灰色页面底、面包屑、分区卡片、详情信息网格、双列表单和底部操作区。
|
||
|
||
## 操作后状态
|
||
|
||
17 类资源具备独立详情页，9 类资源具备独立新建页，5 类资源具备独立编辑页。列表查询来源可以恢复，新建和编辑保存后进入详情，未保存离开会提示确认。配送点资料仍使用专用只读卡片。
|
||
|
||
## 代码变更
|
||
|
||
- 新增：`src/views/resource/` 下 5 个记录页组件与组合函数。
|
||
- 新增：`src/views/shared/ResourceListPage.vue`。
|
||
- 新增：`src/router/routes/modules/resource-route-builder.ts`。
|
||
- 新增：`src/api/resource-display.ts`、`resource-navigation.ts`、`resource-record-form.ts`。
|
||
- 修改：`platform.ts`、`ResourcePage.vue`、`resources.ts`、路由类型、资源契约和包脚本。
|
||
- 删除：`src/views/shared/CrudListPage.vue`（已无活动引用，可由 Git 恢复）。
|
||
|
||
## 行为变化
|
||
|
||
- 变更前：列表抽屉承载记录操作，浏览器地址不随记录变化。
|
||
- 变更后：每个允许的操作拥有独立 URL，详情页集中承载业务动作。
|
||
- 兼容性：现有列表菜单地址、后端接口和配送点数据范围保持不变。
|
||
|
||
## 验证结果
|
||
|
||
- `resource-pages:check`：通过，详情 17、新建 9、编辑 5。
|
||
- `contract:check`：通过，18 个资源与后端契约一致。
|
||
- `profile:check`：通过，资料专用只读页未回退。
|
||
- `type:check`：通过。
|
||
- `build`：通过，2622 个模块完成生产构建。
|
||
- `go test ./internal/logic/delivery`：通过。
|
||
- `lint`：通过；仅报告项目既有警告，未产生失败项。
|
||
- 浏览器回归：工作人员列表、详情、编辑、正式新建地址、返回链路、未保存保护、配送订单新建页、支付列表均通过。
|
||
- 布局回归：工作人员详情、编辑和配送订单新建页已在应用内浏览器逐页截图检查，与 5173 的页面结构和响应式断点一致。
|
||
|
||
## 风险评估
|
||
|
||
- 风险：后端新增可编辑字段后，前端白名单可能未同步。缓解：维护指南要求同步白名单并执行页面契约检查。
|
||
- 风险：旧书签若直接指向抽屉状态无法恢复。缓解：原列表 URL 保持不变，新的记录 URL 可稳定收藏。
|
||
- 风险：支付和退款名称修正可能影响依赖旧错误名称的自定义代码。缓解：仅配送端定义改用后端正式名称，菜单地址不变，并由契约检查持续保护。
|