tangweijie
20afae2255
Document the existing REV-002 backend billing-generation path and preserve a conservative partial-implementation judgment so the design stays aligned with current code evidence. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
138 lines
3.8 KiB
Markdown
138 lines
3.8 KiB
Markdown
# Data Model: REV-002 开账计费与账单生成缺口补齐
|
|
|
|
## 1. Billing Trigger
|
|
|
|
### Purpose
|
|
|
|
定义从抄表校验结果进入开账计费流程的正式触发条件。
|
|
|
|
### Key Fields
|
|
|
|
| Field | Description | Rule |
|
|
|---|---|---|
|
|
| `billPeriod` | 账期 | 必填 |
|
|
| `readingBatchNo` | 抄表批次号 | 可为空 |
|
|
| `meterReadIds` | 抄表任务集合 | 至少存在批次或任务范围 |
|
|
| `validatedFlag` | 是否已通过校验 | 必填；未校验不得生成 |
|
|
| `dueDate` | 应收截止日期 | 必填 |
|
|
| `operatorId` | 发起人 | 可为空 |
|
|
|
|
### Relationships
|
|
|
|
- 来源于 `biz_meter_read`、`biz_reading_data`、`biz_last_reading`
|
|
- 可触发一个或多个 `Billing Result`
|
|
|
|
## 2. Billing Rule Source
|
|
|
|
### Purpose
|
|
|
|
定义账单生成过程依赖的价格和费用规则来源。
|
|
|
|
### Key Fields
|
|
|
|
| Field | Description | Rule |
|
|
|---|---|---|
|
|
| `priceCategoryCode` | 价格归属编码 | 必填 |
|
|
| `priceTemplateCode` | 价格模板编码 | 必填 |
|
|
| `tierRuleRef` | 阶梯规则引用 | 可为空；按场景适用 |
|
|
| `costComponentSet` | 费用组成集合 | 至少 1 项 |
|
|
| `waterUseSchemeRef` | 计划用水方案引用 | 可为空；按场景适用 |
|
|
| `ruleEffectiveFlag` | 规则是否完整有效 | 必填；无效时阻断生成 |
|
|
|
|
### Relationships
|
|
|
|
- 一个 `Billing Rule Source` 可服务多个 `Billing Trigger`
|
|
- 一个 `Billing Rule Source` 可生成多个 `Charge Detail`
|
|
|
|
## 3. Billing Result
|
|
|
|
### Purpose
|
|
|
|
定义账单生成后的主结果表达。
|
|
|
|
### Key Fields
|
|
|
|
| Field | Description | Rule |
|
|
|---|---|---|
|
|
| `chargeId` | 账单主键 | 唯一 |
|
|
| `chargeCode` | 账单编号 | 唯一 |
|
|
| `custId` | 客户标识 | 必填 |
|
|
| `accountId` | 账户标识 | 可为空；按账户体系承接 |
|
|
| `billPeriod` | 账期 | 必填 |
|
|
| `totalAmount` | 账单总金额 | 必填 |
|
|
| `sourceType` | 来源类型 | 必填；普通开账/特殊开账等 |
|
|
| `chargeStatus` | 账单状态 | 必填 |
|
|
| `dueDate` | 应收截止日期 | 必填 |
|
|
|
|
### Relationships
|
|
|
|
- 由一个 `Billing Trigger` 触发产生
|
|
- 包含多个 `Charge Detail`
|
|
- 后续可流转到收费、催缴、发票等下游模块
|
|
|
|
## 4. Charge Detail
|
|
|
|
### Purpose
|
|
|
|
定义营业账明细中的费用组成表达。
|
|
|
|
### Key Fields
|
|
|
|
| Field | Description | Rule |
|
|
|---|---|---|
|
|
| `chargeId` | 所属账单 ID | 必填 |
|
|
| `costComponentCode` | 费用组成代码 | 必填 |
|
|
| `usageAmount` | 用量 | 可为空；按费用项适用 |
|
|
| `unitPrice` | 单价 | 可为空；按费用项适用 |
|
|
| `detailAmount` | 明细金额 | 必填 |
|
|
| `detailRemark` | 明细说明 | 可为空 |
|
|
|
|
### Relationships
|
|
|
|
- 归属于一个 `Billing Result`
|
|
- 引用一个 `Billing Rule Source`
|
|
|
|
## 5. Billing Exception Result
|
|
|
|
### Purpose
|
|
|
|
定义账单生成失败时的正式异常返回表达。
|
|
|
|
### Key Fields
|
|
|
|
| Field | Description | Rule |
|
|
|---|---|---|
|
|
| `reasonCode` | 失败原因编码 | 必填 |
|
|
| `reasonText` | 失败说明 | 必填 |
|
|
| `relatedCustomer` | 相关客户 | 可为空 |
|
|
| `relatedMeterRead` | 相关抄表任务 | 可为空 |
|
|
| `blockingFlag` | 是否阻断生成 | 固定为是 |
|
|
|
|
### Relationships
|
|
|
|
- 与一个 `Billing Trigger` 关联
|
|
- 不生成 `Billing Result`
|
|
|
|
## 6. Billing Governance Record
|
|
|
|
### Purpose
|
|
|
|
用于在治理台账中记录 `REV-002` 的设计状态、实现评估和后续建议。
|
|
|
|
### Key Fields
|
|
|
|
| Field | Description | Rule |
|
|
|---|---|---|
|
|
| `requirementCode` | 对应需求编号 | 固定为 `SYS002-REQ-004` |
|
|
| `featureName` | Speckit feature 名称 | 必填 |
|
|
| `designStatus` | 设计状态 | 必填；设计收口中/已收口 |
|
|
| `implementationStatus` | 实现评估 | 必填；当前为部分实现 |
|
|
| `nextAction` | 后续动作 | 必填 |
|
|
| `validationRecord` | 校验记录 | 必填 |
|
|
|
|
### Relationships
|
|
|
|
- 关联 `01_Project_Progress.md`
|
|
- 关联 `03_Task_Checklist.md`
|
|
- 关联 `15_SYS002_Requirement_Breakdown.md`
|