--- title: 订单管理模块 — Chrome 字段采集单 created: 2026-08-05 updated: 2026-09-03 type: analysis tags: [field-capture, chrome, research, order] sources: [xiaoju-feature-list, yunkuaidian-feature-list, kuaidian-feature-list, design/pages/order/*] confidence: medium --- # 订单管理模块 — Chrome 字段采集单 > Phase G G1 产出:P0 订单模块的 Chrome 深度采集单。已记录字段以 [[design/pages/order/history]] 等 5 页 spec §3 为准;本页仅列**待 Chrome 在线复核/补充项**与采集指引。 > 平台登录:小桔(验证码 18105918563)、云快充(SZDL0016m / Gewu2066)、快电(验证码 18105918563)。 > > **回填说明(2026-09-03)**:G1 遗留 16 条待办已逐条回填——勾选 **13/16**、backlog **3 条**(均在 2.3 订单详情:② SOC/充电损耗、④ 退款区三字段同屏、⑤ 开发票入口——关键子项在自家原型/spec/server 与四平台 raw 中均无记录,见行内标注)。勾选依据:自家原型 prototype/src/views/order/*、design spec §3-5、server-cdz order 模块、竞品 raw(xiaoju orders-list、legacy 02/01、kuaidian 01/l4、yunkuaichong 26-occupy)。backlog 明细: > > | 条目 | 需补采内容 | 理由 | > |------|-----------|------| > | 2.3-2 电量信息 | 竞品订单详情是否展示起始/结束 SOC、充电损耗 | 我方详情仅充电量+时段表;SOC 仅旧版列表列实证、损耗仅站点级电损,无订单级记录 | > | 2.3-4 退款区 | 竞品详情"退款区"(退款状态/金额/单号同屏)形态 | 全源无同屏三字段;我方仅顶部支付状态+退款向导(结果含退款单号),完整流转在 payment/refund | > | 2.3-5 操作-开发票 | 竞品订单详情页是否有开发票入口 | 我方详情仅退款+查看时段明细入口;四平台订单页操作与发票模块均无"详情挂开发票"记录 | ## 一、采集范围 | 页面 | spec | 平台可用性 | |------|------|-----------| | 历史订单 | [[design/pages/order/history]] | 小桔✓ 云快充✓ 快电✓ | | 异常订单 | [[design/pages/order/abnormal]] | 小桔✓ 云快充✓ | | 订单详情 | [[design/pages/order/detail]] | 小桔✓ 云快充✓ 快电✓ | | 占位费订单 | [[design/pages/order/occupancy-fee]] | 小桔✓(占位费) | | 时段明细 | [[design/pages/order/time-period-detail]] | 云快充✓(计费明细) | ## 二、待 Chrome 复核/补充清单(字段级) ### 2.1 历史订单 - [x] 列表筛选全量(时间范围粒度、订单状态枚举、场站、枪号、订单号、手机号)(依据:prototype/src/views/order/History.vue 筛选区(时间日粒度、状态 6-Tab、场站/枪号/订单号/用户手机号)+ wiki/design/pages/order/history.md §2/§4;竞品小桔 9 项筛选实测(orders-list-analysis)) - [x] 列表列字段与金额展示格式(元/分、小数位)(依据:History.vue 9 列金额以 (元).toFixed(2) 展示 + history.md §4(金额 2 位小数、元口径)+ legacy 22 列/小桔 9 列实测基线) - [x] 订单状态**枚举文案**(如 已完成/已取消/退款中/异常),与 spec/10 态对照(依据:constants/status.ts ORDER_STATUS 10 态 + History.vue 6-Tab↔10 态映射(已完成=已支付、已取消≈已关闭、退款中、异常走 isAbnormal)+ history.md §4;竞品快电 8 态实测见 kuaidian l4 §1) - [x] 导出功能(格式/范围上限/异步提示)(依据:History.vue 异步导出(≤10000 条、完成站内通知)+导出记录弹窗 + history.md FP-03/04;小桔 orders-list 导出/导出记录实测佐证) ### 2.2 异常订单 - [x] 异常类型枚举(启动失败/结算失败/支付失败/设备离线中断/退款异常)(依据:Abnormal.vue ABNORMAL_TYPES 5 类(桩故障中断/离线中断/欠费停机/通讯异常/人为结束异常)+ abnormal.md §4(5 类枚举权威);自家定案——spec 注明取值阈值开发期按桩错误码映射校准;竞品无异常数据触发) - [x] 异常原因字段与详情查看方式(依据:Abnormal.vue 异常原因列+处理向导"异常快照" + Detail.vue F 区块异常快照(类型/原因)+ abnormal.md;自家定案) - [x] 异常处理操作(重试/人工结算/标记)(依据:Abnormal.vue 处理向导 4 类(补单/退款/标记已处理/手动结算)+批量处理(≤50 条)+ abnormal.md FP/状态机;自家定案——无字面"重试",以补单/手动结算/退款承接(R-order-06/10)) ### 2.3 订单详情 - [x] **金额拆分完整字段**:电费、服务费、占位费、优惠(券/折扣/会员)、实收 —— 逐一记录展示项(依据:Detail.vue E 区块计费规则明细(电费/服务费/停车费/占位费/优惠逐项 7 行)+ detail.md R-order-02(totalPrice=…−discountAmount)+ api FeeBreakdownVO;自家定案——优惠顺序"基础费用先行、优惠后扣",叠加顺序见 rules T1-1) - [ ] 电量信息(充电量/损耗/起始 SOC/结束 SOC)(backlog:需在线补采 竞品订单详情电量区块是否展示起始/结束 SOC 与充电损耗;理由:我方详情仅充电量+时段电量表(Detail.vue),SOC 仅旧版订单列表列实证(legacy dom-text),损耗仅站点级电损(legacy 37)——订单级 SOC/损耗展示全源无记录) - [x] 时间线(下单/启动/结束/支付)字段(依据:Detail.vue C 区块操作日志时间线(mock 含下单/启动/结束/支付事件)+ detail.md FP-07;自家定案——注明:真后端日志接口未实现(api/order.ts 返回空),时间线为 mock 演示) - [ ] 退款区:退款状态、退款金额、退款单号(backlog:需在线补采 竞品订单详情"退款区"(退款状态/金额/单号同屏)形态与字段;理由:全源无同屏三字段记录——我方详情仅顶部支付状态+退款向导(提交结果 toast 含退款单号),退款单号/状态完整流转承接 payment/refund 模块) - [ ] 操作:开发票/退款申请/查看时段明细入口(backlog:需在线补采 竞品订单详情操作区是否有"开发票"入口;理由:退款申请(Detail.vue 退款入口)与查看时段明细(链接跳 /order/time-period-detail)已实证,但开发票入口在 5 个 order vue/spec 及四平台订单页均无记录——发票入口在财务/开票模块,未挂订单详情) ### 2.4 占位费订单 - [x] 占位费计算字段展示:免费时长、超时费率、单次扣费上限、已扣金额(依据:OccupancyFee.vue 规则卡(免费时长 freeMinutes/超时费率 unitPrice 元/分钟/日封顶 dailyCap)+订单列(应收/减免/实收金额)+ occupancy-fee.md §4(规则快照+应收=超时×单价封顶生效);云快充 26-occupy DOM 佐证;自家定案——"单次扣费上限"语义=日封顶 dailyCap) - [x] 占位费状态(待扣/已扣/减免)(依据:OccupancyFee.vue 扣费状态(减免联动)+ api/order.ts deductStatus(待扣/已扣/减免)+ occupancy-fee.md §4 deductStatus + server OrderDO;自家定案——与占位费单主状态 5 态(计费中/待支付/已支付/已减免/已关闭)层级分离) ### 2.5 时段明细 - [x] 明细粒度(按价格时段分段:每段 时段/电费单价/服务费单价/电量/金额)(依据:TimePeriodDetail.vue 时段表列(时段/电费单价 4 位/服务费单价/电量/金额)+ time-period-detail.md §4 + api PeriodDetailDTO;自家定案——竞品云快充"计费明细"未做写操作采集) - [x] 时段划分依据(尖峰平谷)展示(依据:TimePeriodDetail.vue 峰平谷尖 4 口径统计卡+时段名称列 + time-period-detail.md §4/时段颜色编码;自家定案) ## 三、规则观察清单 | # | 操作路径 | 观察点 | |---|---------|--------| | R1 | 详情页看金额拆分 | 优惠顺序:会员折扣/券/占位费谁先谁后(pre-mortem T1 复核点) | | R2 | 对已支付订单申请退款 | 退款流程步骤、审批与否、到账时间说明 | | R3 | 导出大范围订单 | 是否转异步、是否有行数上限提示 | | R4 | 查看异常订单详情 | 是否可一键重新结算 | ## 四、Network 抓包目标 | 页面 | 接口 | 抓取内容 | |------|------|---------| | 历史订单 | `*/order/page*` | 筛选参数(status/dateRange/stationId)、响应字段(金额拆分字段名) | | 订单详情 | `*/order/detail*` | 金额结构字段(powerFee/serviceFee/parkFee/discount/realAmount) | | 退款 | `*/refund*` | 退款申请体字段 | | 时段明细 | `*/order/details*` | 时段分段字段(priceType/startTime/endTime/amount) | > 抓包金额字段名与 [[analyses/legacy-field-view]] §4.1(business_order 金额族)对照,映射关系记入 schema 文件。 ## 五、L4 复核状态(2026-08-06,CDP 实测) | 清单项 | 状态 | 实测证据 | |--------|------|---------| | 2.1 历史订单 筛选/列/导出 | ✅ 已回填(2026-09-03,[x]×4) | History.vue + history.md §3-5;小桔 9 列/legacy 22 列实测佐证 | | 2.1 历史订单 金额格式 | ✅ 已回填([x],元 2 位小数) | History.vue + history.md §4;快电充电账单 10 个月真实金额佐证 | | 2.2 异常订单 | ✅ 已回填([x]×3,自家定案) | Abnormal.vue + abnormal.md §3-5;各平台无异常数据触发(维持自家定案口径) | | 2.3 订单详情 | 🔶 已回填 2/5 + backlog 3(SOC/损耗、退款区三字段、开发票入口) | Detail.vue + detail.md §3-5;backlog 见 §2.3 行内 | | 2.4 占位费订单 | ✅ 已回填([x]×2,自家定案) | OccupancyFee.vue + occupancy-fee.md §3-5;快电 9 列实测 + 云快充 26-occupy DOM 佐证 | | 2.5 时段明细 | ✅ 已回填([x]×2,自家定案) | TimePeriodDetail.vue + time-period-detail.md §3-5 | > 快电占位费订单支付状态枚举(8 态):运营商取消/进行中/待支付/已支付/已退款/退款中/快电取消/全部(l4-capture-20260806.md §1 实测,作为竞品对照非主状态机)。