Files
uniprop-manual/prop-acc/concepts/meter/multiplier-and-tiered-pricing.md

245 lines
6.8 KiB
Markdown
Raw Normal View History

2026-05-25 23:53:01 +08:00
---
title: prop-acc · meter · 倍率与阶梯计价
aliases:
- 倍率
- 阶梯计价
- multiplier
- tiered pricing
- min max 封顶
tags:
- 概念
- prop-acc
- 计量表
- 计费
audience:
- 业务人员
- 财务
- 架构师
status: 已发布
sub_feature: meter
last_review: 2026-05-25
code_version: 2026-05-22
---
# 倍率与阶梯计价
抄表生成账单的金额由三层叠加算出:**倍率(multiplier)** × **阶梯计价(tiered)** + **min/max 封顶**。这三层都在 `MeterBillCalculator` 内实现(纯算,无 DB IO),是 prop-acc 模块中**最严谨的算法之一**。
## 一句话总览
```
本月用量 = (current_reading - previous_reading) × multiplier
本月金额 = 阶梯计价(本月用量, RatePlan)
最终金额 = clamp(本月金额, min, max)
```
详见下文每层展开。
## 第 1 层:倍率(multiplier)
### 用途
工业 / 集团表的**实际计量值远大于表头数字**:
| 表型 | 表头读数 | multiplier | 实际用量 |
|---|---|---|---|
| 家用单相表 | 280 度 | 1 | 280 度 |
| 三相工业表 | 28 度 | **10** | 280 度 |
| 大型集团表(高压侧)| 28 度 | **100** | 2,800 度 |
物理原理:工业表为了在小表头显示大用量,内部有变压 / 分流比。multiplier 就是这个比值。
### 字段精度
```php
// migration
$table->decimal('multiplier', 10, 4);
// model casts
'multiplier' => 'decimal:4',
```
decimal(10,4) 精度足够工业场景(常见 1.0 / 10.0 / 100.0 / 1000.0,极少数 0.5 / 1.25 等特殊变比)。
### 用量计算
```
consumption = (current_reading - previous_reading) × multiplier
```
例:三相表上月 280,本月 308,multiplier=10:
```
consumption = (308 - 280) × 10 = 280 度
```
业户账单按"280 度"算,不是"28 度"。
## 第 2 层:阶梯计价(Tiered Pricing)
### 用途
水电气**阶梯递增**:用得越多,单价越高。鼓励节约,符合国家政策。
例:某市水阶梯计价:
| 阶梯 | 月用水(吨)| 单价 |
|---|---|---|
| 第一阶梯 | 0-20 | 3.0 元/吨 |
| 第二阶梯 | 21-30 | 4.5 元/吨 |
| 第三阶梯 | 30 以上 | 6.0 元/吨 |
业户本月用 35 吨:
| 段 | 用量 | 单价 | 段金额 |
|---|---|---|---|
| 0-20 吨(第一阶梯) | 20 | 3.0 | 60 |
| 21-30 吨(第二阶梯) | 10 | 4.5 | 45 |
| 31-35 吨(第三阶梯) | 5 | 6.0 | 30 |
| **合计** | **35** | | **135** |
### Progressive 累进 vs Full-tier 简陋实现
> [!info] 本系统采用 **progressive 累进**(正确算法),不是 full-tier 简陋实现。
| 算法 | 35 吨水 |
|---|---|
| **Progressive 累进**(本系统)| 20 × 3 + 10 × 4.5 + 5 × 6 = 135 元 ✅ |
| Full-tier 简陋(错)| 35 × 6 = 210 元 ❌(整月用量按最高阶梯计)|
| Mixed(更错)| 35 × 4.5 = 157.5 元 ❌ |
progressive 是国家政策标准做法,简陋实现是市场上劣质系统的常见 bug。`MeterBillCalculator::calculateTiered()` 实现得对,所以我们的账单准确。
### RatePlan + RateTier 模型
阶梯定义在 `RatePlan` + `RateTier` 模型里(不属于本子模块,在更通用的费率模块):
```
RatePlan ─── RateTier (1..n)
├── tier=1, lower=0, upper=20, unit_price=3.0
├── tier=2, lower=20, upper=30, unit_price=4.5
└── tier=3, lower=30, upper=null, unit_price=6.0
```
`fee_type_id`(在 Meter 上)指向 RatePlan,Calculator 拿到 RatePlan → 按 tier 累加段金额。
## 第 3 层:min / max 封顶
### 用途
防止**极端用量**导致离谱账单:
| 场景 | 问题 | 封顶方案 |
|---|---|---|
| 业户家漏水,1 月用 1000 吨 | 按阶梯算 ~ 6000+ 元 | `max=2000` 封顶,差额走维修保险 |
| 表故障读 0 度 | 业户不付钱了 | `min=20` 兜底(至少收基础费)|
| 业户家整月没人(零用量)| 看物业政策 | `min=20` 仍要收(物业服务费性质)|
### 实现
`RatePlan` 上有 `min_amount` / `max_amount` 字段:
```
final_amount = max(min_amount, min(calculated_amount, max_amount))
```
例:计算出 ¥6,000 但 `max_amount=2000` → 实际收 ¥2,000,差额 ¥4,000 由物业 / 维修保险承担(账面体现为"封顶减免")。
### 业务上的取舍
> [!warning] 封顶不是万能的
> max 封顶让业户感激,但物业要承担差额。建议:
>
> - 设合理的 max(覆盖正常波动范围)
> - 异常用量先排查([[exception-high-consumption]])再决定是否减免
> - 封顶降低收入,需评估对物业财务可持续性影响
min 类似:
> [!info] min 的政策意义
> min 通常对应"管网维护费 / 基础服务费",即使零用量也要分摊管网成本。但在国家政策严格的地区,要明确告知业户"min 是什么"。
## 完整算法流程
```mermaid
flowchart TD
A[抄表 current_reading] --> B[查询上次 reading]
B --> C[计算 consumption =<br/>(current - previous) × multiplier]
C --> D[加载 RatePlan + RateTier]
D --> E[Calculator.calculateTiered<br/>按阶梯累加段金额]
E --> F{有 min/max?}
F -->|有 max & 金额超| G[封顶到 max]
F -->|有 min & 金额低| H[补到 min]
F -->|正常范围| I[原值]
G --> J[最终账单金额]
H --> J
I --> J
```
## 完整算例
电费阶梯(假设):
| 阶梯 | 用电度数 | 单价 |
|---|---|---|
| 1 | 0-200 | 0.5 |
| 2 | 200-400 | 0.6 |
| 3 | 400+ | 0.8 |
`min_amount=10`,`max_amount=500`
工业表(三相,multiplier=10),5 月抄表 308,上月 280:
```
1. consumption = (308 - 280) × 10 = 280 度
2. 阶梯:200 × 0.5 + 80 × 0.6 = 100 + 48 = 148 元
3. 封顶:10 ≤ 148 ≤ 500 → 不动
4. 最终账单:148 元
```
家用表(multiplier=1),5 月抄表 1100,上月 800:
```
1. consumption = (1100 - 800) × 1 = 300 度
2. 阶梯:200 × 0.5 + 100 × 0.6 = 100 + 60 = 160 元
3. 封顶:10 ≤ 160 ≤ 500 → 不动
4. 最终账单:160 元
```
漏水 case(家用表,水阶梯,multiplier=1),本月用 1000 吨:
```
1. consumption = 1000 吨
2. 阶梯:20 × 3 + 10 × 4.5 + 970 × 6 = 60 + 45 + 5820 = 5925 元
3. 封顶:5925 > max_amount(假设 2000)→ 封到 2000
4. 最终账单:2000 元(差额 3925 由物业 / 维修保险承担)
```
## 业务人员视角
- **配置阶梯**:在 RatePlan + RateTier 模型里设置(不在 meter 子模块,通常运营 / 财务总监来设)
- **配置倍率**:建表时 / 后续编辑表时填(`MeterForm`,默认 1)
- **核对账单**:看到异常金额时,顺着 Calculator 算法手工验算
## 财务视角
- 阶梯计价 = 政策合规
- 倍率确保工业表账单正确
- min/max 封顶 = 风险控制 + 业户友好(max)
## 业户视角
业户**不需要懂这套算法**,看到的是账单金额。但**对账时**要能理解:
- 上月读数 → 本月读数 → 用量(度 / 吨 / 立方米)
- 用量 → 阶梯单价 → 金额
- 如有封顶 → 凭证显示
## 相关文档
- [[meter-vs-meter-reading]]
- [[bill-generation-pipeline]]
- [[generate-bill-tiered-pricing]]
- [[generate-bill-with-multiplier]]
- [[generate-bill-min-max-cap]]
- [[exception-high-consumption]]