50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# 气站标准资源全页改造操作日志
|
||
|
||
操作时间：2026-08-17 22:51:57
|
||
操作类型：扩展
|
||
影响模块：气站管理端 5175、气站 API 标准资源详情、资源契约
|
||
|
||
## 操作前状态
|
||
|
||
- 标准资源的新建、详情和编辑位于列表抽屉。
|
||
- 11 类资源只有列表接口，详情抽屉请求单条记录时可能返回 404。
|
||
- 支付、退款前端名称与后端真实资源路径不一致。
|
||
|
||
## 具体操作
|
||
|
||
- 参考 5173 的共享全页框架，为 5175 自动生成新建、详情和编辑路由。
|
||
- 将列表入口改为页面导航，保留短业务动作弹窗。
|
||
- 为可编辑资源增加显式字段白名单，并适配气站工作人员、账户、合同和订单规则。
|
||
- 为 11 类资源增加受当前气站范围保护的详情接口。
|
||
- 同步资源契约，增加独立页面覆盖检查和路由测试。
|
||
|
||
## 操作后状态
|
||
|
||
- 20 类标准资源具有独立详情页。
|
||
- 11 类资源具有独立新建页，8 类资源具有独立编辑页。
|
||
- `/staff/add` 和 `/gasorder/create` 原地址继续可用。
|
||
- 头像和合同文件字段保持 5175 原能力，不访问平台专属端点。
|
||
|
||
## 代码变更
|
||
|
||
- 前端：资源路由构造、列表导航、共享记录页、表单与详情展示、资源能力规则、契约检查。
|
||
- 后端：`gasorder.go`、`finance.go` 新增受限详情处理；`gas_business.go` 注册详情路由；`gas_test.go` 校验路由覆盖。
|
||
- 文档：更新气站需求基线，新增项目文档与本操作日志。
|
||
|
||
## 验证结果
|
||
|
||
- `go test ./internal/routers ./internal/logic/gas`：通过。
|
||
- `pnpm type:check`：通过。
|
||
- `pnpm contract:sync`、`pnpm contract:check`：通过，20 个资源一致。
|
||
- `pnpm resource-pages:check`：通过，详情 20、新建 11、编辑 8。
|
||
- `pnpm lint`：通过，无错误；仓库既有提示保留。
|
||
- `pnpm build`：通过。
|
||
- 浏览器访问 `http://127.0.0.1:5175/delivery/points`：正确重定向到气站登录页，页面完整渲染且控制台无错误；当前浏览器无气站登录态，未提交账号或读取受保护业务数据。
|
||
|
||
## 风险评估
|
||
|
||
- 新增接口均为只读扩展，不改变现有写接口和公共响应结构。
|
||
- 每个新详情查询保留气站、合同、服务关系或钱包归属条件，降低越权读取风险。
|
||
- 对账资源没有气站归属字段，继续返回不可见，未扩大数据范围。
|
||
- 尚需在具备登录态和业务样本的环境验证详情、编辑、新建及未保存提示的完整点击路径。
|