platforms/docs/操作日志_气站标准资源全页改造_20260817.md

气站标准资源全页改造操作日志

操作时间：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：正确重定向到气站登录页，页面完整渲染且控制台无错误；当前浏览器无气站登录态，未提交账号或读取受保护业务数据。

风险评估

• 新增接口均为只读扩展，不改变现有写接口和公共响应结构。
• 每个新详情查询保留气站、合同、服务关系或钱包归属条件，降低越权读取风险。
• 对账资源没有气站归属字段，继续返回不可见，未扩大数据范围。
• 尚需在具备登录态和业务样本的环境验证详情、编辑、新建及未保存提示的完整点击路径。