---
title: 计费管理模块 — Chrome 字段采集单
created: 2026-08-05
updated: 2026-09-03
type: analysis
tags: [field-capture, chrome, research, billing]
sources: [xiaoju-feature-list, yunkuaidian-feature-list, kuaidian-feature-list, design/pages/billing/*]
confidence: medium
---

# 计费管理模块 — Chrome 字段采集单

> Phase G G1 产出：P0 计费模块的 Chrome 深度采集单。已记录字段以 [[design/pages/billing/template-list]] 等 3 页 spec §3 为准；本页仅列**待 Chrome 在线复核/补充项**与采集指引。
> 平台登录：小桔（验证码 18105918563）、云快充（SZDL0016m / Gewu2066）、快电（验证码 18105918563）。
>
> **回填说明（2026-09-03）**：G1 遗留 14 条待办已逐条回填——勾选 **12/14**（以自家定案为主：billing 原型 3 页 vue、design spec §3-5、server-cdz billing 模块接口均已落定，行内标注依据；竞品佐证：legacy 04-cost-template 列表实测、云快充 26-station-setting 计价弹窗实测）；backlog **2 条**：2.2-4 时段是否区分工作日/节假日、2.4-2 新价格生效时间粒度（次日 0 点）——两处自家未落定且竞品 raw 无记录，需在线补采。

## 一、采集范围

| 页面 | spec | 平台可用性 |
|------|------|-----------|
| 计费模板列表 | [[design/pages/billing/template-list]] | 小桔✓ 云快充✓ 快电✓ |
| 模板详情-时段 | [[design/pages/billing/template-detail]] | 小桔✓ 云快充✓ |
| 价格类型配置 | [[design/pages/billing/price-type-config]] | 小桔✓ 云快充✓ |

## 二、待 Chrome 复核/补充清单（字段级）

### 2.1 模板列表
- [x] 模板列表字段（名称/适用站点数/状态/生效时间/更新时间）（依据：prototype/src/views/billing/TemplateList.vue 表格列 + wiki/design/pages/billing/template-list.md §4；自家定案；竞品 legacy 04-cost-template 列表 7 列实测佐证无冲突）
- [x] 模板状态枚举（草稿/生效/失效）与启停操作（依据：prototype/src/constants/status.ts BILLING_TEMPLATE_STATUS（草稿/生效中/已停用）+ TemplateList.vue 启停（被引用强确认）+ template-list.md §6 状态机 + server-cdz BillingController /enable；自家定案，语义对齐"草稿/生效/失效"）
- [x] 模板适用站点配置方式（多选/按区域）（依据：TemplateList.vue 批量应用抽屉站点多选（≤500/次）+ template-list.md §3 FP-09/线框"多选/按区域"；自家定案）

### 2.2 模板详情-时段
- [x] **时段模板配置完整字段**：时段名称、开始/结束时间（粒度 15 分钟？）、尖峰平谷标签、价格类型选择（依据：prototype/src/views/billing/TemplateDetail.vue 时段弹窗（time-select step=00:15、峰平谷尖 4 选、电费/服务费单价）+ template-detail.md §4.2 + server BillingVOs.PriceForm；自家定案；云快充 station-price-modal 4 组价格类别实测佐证两段计价）
- [x] 一天时段数量上限、跨天时段（00:00-06:00）处理（依据：TemplateDetail.vue 上限 48（BILLING_4001）+ crossDay 跨 0 点展示"(+1)" + template-detail.md §4.2 crossDay + server BillingServiceImpl MAX_PRICE_ROWS=48；云快充弹窗实测"最多可设置 48 个时段"同源佐证）
- [x] 时段重叠校验（保存时报错文案）（依据：TemplateDetail.vue 保存拦截报错"时段与已有时段重叠（40902 BILLING_4091）" + template-detail.md R-billing-01 + server BillingServiceImpl 双轨同文案；自家定案）
- [ ] 是否区分工作日/节假日（backlog：需在线补采 云快充/快电/小桔 的时段模板是否支持"工作日/节假日（周末）分别定价"或按周设置时段；理由：自家 billing 3 视图/3 页 spec/server 模块及 legacy 04-cost-template、云快充 26-station-setting、小桔 service-fee-* 竞品 raw 均无该维度字段或文案——时段为每日单日表达+crossDay，无任何记录可依）

### 2.3 价格类型配置
- [x] 价格类型字段：**电费（元/度）、服务费（元/度）、停车费/占位费（元/分钟？）、服务费上限**（依据：prototype/src/views/billing/PriceTypeConfig.vue 电费/服务费/占位费 3 型 + constants/status.ts 单位（占位费=元/分钟）+ price-type-config.md §4（服务费上限 B20 ≤100 元/笔；停车费归属 C2 已决=移出价格类型，改站侧+停车减免模块承接）；自家定案+小桔/快电占位费口径实证）
- [x] 折扣配置：折扣开关、折扣比例/金额、生效时间（依据：TemplateList.vue enableDiscount+折扣 0.1-1.0 + template-list.md §4 discount/enableDiscount；自家定案：折扣挂模板级、随模板保存即生效，无独立折扣时间窗字段）
- [x] 会员折扣/等级折扣入口（pre-mortem E2 复核点：等级折扣×模板折扣叠加顺序）（依据：wiki/design/rules/billing-business-rules.md R-Billing-03（E2 已回填：折扣额(元)模型、只折服务费不折电费/停车费/占位费，叠加顺序闭合）+ TemplateDetail.vue 时段级"会员折后服务费"入口 + server PriceForm.vipDiscountServiceFee；自家定案）
- [x] 改价历史与生效/失效逻辑（立即生效 vs 次日生效）、调价记录（依据：PriceTypeConfig.vue 调价保存即生效+调价记录时间线（生效中→已失效）+ price-type-config.md §6 状态机 + server BillingController /price-type/{id}/adjust、/history；自家定案：保存即生效+留痕；"次日生效"未采用，见 2.4-2）
- [x] 价格校验（服务费上限、四舍五入规则）（依据：price-type-config.md §5 R-billing-02（单笔服务费 ≤100 元/笔 B20、单价 0-100、精度 电费 4 位/其余 2 位）+ server BillingServiceImpl.checkPrice 超精度拦截；四舍五入在计算层 ROUND_HALF_UP（charging/order-business-rules）；自家定案）

### 2.4 生效规则
- [x] 模板/价格修改后对**进行中订单**的影响提示（pre-mortem-p0 改价影响回填确认）（依据：TemplateDetail.vue saveAll 先调 /impact 取真实进行中/今日新订单数→弹影响面确认 + template-detail.md FP-10 + server BillingController /impact；自家定案，pre-mortem-p0 T6 已回填）
- [ ] 新价格生效时间粒度（即时/整点/次日 0 点）（backlog：需在线补采 云快充"修改电价/定时修改价格"的生效时间粒度选项（即时/整点/次日 0 点）及小桔价格生效时点字段；理由：自家仅定"保存即生效（effectiveTime=now）"，rules/billing-business-rules.md R-Billing-04 边界自注"次日 0 点 Chrome 待复核"未落定；原型"定时修改价格"为 P1 datetime mock；云快充 DOM 仅见"定时修改价格 使用/不使用"开关与生效时间提示，无整点/次日 0 点字段）

## 三、规则观察清单

| # | 操作路径 | 观察点 |
|---|---------|--------|
| R1 | 配置两个重叠时段保存 | 重叠校验报错文案 |
| R2 | 修改生效中模板价格 | 生效时间提示、历史订单影响提示 |
| R3 | 设置折扣 | 折扣作用域（电费/服务费/全部）与显示"折后价" |
| R4 | 配置停车费价格类型 | 停车费归属（价格类型 vs 站点占位费配置）—— contested C2 决策点 |

## 四、Network 抓包目标

| 页面 | 接口 | 抓取内容 |
|------|------|---------|
| 模板 CRUD | `*/cost-template*` | 模板字段（templateName/status/effectiveTime） |
| 时段配置 | `*/cost-template/price*` | 时段字段（startTime/endTime/priceTypeId/peakLabel） |
| 价格类型 | `*/cost-template/price-type*` | 价格字段（powerFee/serviceFee/parkFee/discount） |
| 调价记录 | `*/price-change/history*` | 改价历史字段 |

> 抓包字段名与 [[analyses/legacy-field-view]] §6（business_cost_template ×3 表 + discount/vip_discount_service_fee）对照；**停车费归属**（C2）在此采集单中重点复核。

## 五、L4 复核状态（2026-08-06，CDP 实测）

| 清单项 | 状态 | 实测证据 |
|--------|------|---------|
| 2.1 模板列表 | ✅ 已回填（2026-09-03：自家定案 [x]，见 §2.1） | prototype/src/views/billing/TemplateList.vue + template-list.md §4；legacy 04-cost-template 实测佐证 |
| 2.2 模板详情-时段 | ✅ 已回填 3/4（2.2-1~3 自家定案 [x]；2.2-4 工作日/节假日 [ ] backlog） | TemplateDetail.vue + template-detail.md §3-5 + server BillingServiceImpl |
| 2.3 价格类型配置 | ✅ 已回填 5/5（自家定案 [x]） | PriceTypeConfig.vue + price-type-config.md §3-5 + server BillingController |
| 2.4 生效规则 | 🔶 回填 1/2（2.4-1 [x] T6 已回填；2.4-2 生效粒度 [ ] backlog） | TemplateDetail.vue saveAll+/impact + rules R-Billing-04 |

> 计费模板属于需"新增/编辑演练"才能采集的表单页，当前各平台均未做写操作演练；字段级形态已由自家设计/实现定案（见上），竞品深层交互（工作日节假日、生效粒度）仍留 2 条 backlog 待 CDP 补采。