platforms/docs/项目文档_配送点订单金额调整上下文_v1.0.md

项目文档：配送点订单金额调整上下文 v1.0

1. 项目概述

5176 配送点后台的“调整金额”弹窗从当前订单详情读取配送费和优惠金额，按页面金额单位预填，操作员只需在现值基础上修改并填写原因。

2. 展示与提交规则

• 当前详情响应中的金额单位为分，动作输入框单位为元。
• 打开弹窗时将 delivery_fee、discount_amount 分别除以 100 后预填。
• 保存时沿用现有表单协议，将元乘以 100 后提交服务端。
• “原因”不从历史记录预填，仍要求本次操作单独填写。
• 标记异常、取消订单等其他动作不读取无关字段，不受本次修改影响。

3. 核心文件

frontend/delivery_admin/src/
├── api/resources.ts                         # 声明动作上下文字段
└── views/resource/
    ├── ResourceRecordPage.vue               # 传入当前订单记录
    └── ResourceActionDialog.vue             # 读取上下文并执行分转元

4. 验证

npm.cmd run type:check
npm.cmd run resource-pages:check
npm.cmd run contract:check
npm.cmd run build

5. 变更记录

• v1.0（2026-08-29）：调整金额弹窗预填当前配送费和优惠金额。