# 32 财务运营管理增强包 PRD

## 0. Demo开发摘要

- 一句话定位：财务运营管理增强包负责把 DCIM/DCOM 的客户账单、供应商结算、成本池、成本分摊、发票付款、争议调账、周期关账和财务审计统一成可计算、可对账、可审批、可追溯的经营闭环。
- 菜单挂载：运营中心 / 财务运营 / 财务运营管理增强包；与第一批 12 财务运营管理保持名称和能力承接关系。
- Demo主路径：维护合同条款 -> 生成客户账单 -> 生成供应商结算 -> 导入成本池 -> 执行成本分摊 -> 收入成本对账 -> 处理差异争议 -> 登记发票付款 -> 提交关账 -> 导出审计证据。
- 复用智航能力：CMDB 资源与客户关系、资产容量、维修工单、供应商管理、能耗数据、报表、工作流、权限中心、对象存储、dcim-cli 和审计日志。
- 需要 Mock 的 API：合同、价格条款、客户账单、账单明细、供应商结算、成本池、分摊规则、对账任务、发票、付款、争议调账、审批任务、证据快照和审计日志。

## 1. 制度依据与行业依据

- 制度原文依据状态：本轮本地制度知识库 healthcheck 未定位到 `DATACENTER_OPS_KB_ROOT`，不能把内部制度条文写成已命中依据。以下内容属于基于仓库白皮书、现状盘点、规划文档、IDC/DCIM 财务运营常识和客户供应商结算流程的产品化推导。
- 本地白皮书依据：DCOM 强调统一运营、报表预测和全过程运维闭环；财务运营必须把资源、工单、能耗、供应商服务和客户合同转成经营指标。
- 本地现状依据：智航已有成本、供应商、维修、报表、权限和工作流能力，但缺少客户供应商结算、成本分摊、发票付款、争议调账和关账审计的统一合约。
- 产品化推导：本模块要落成合同价格、账单明细、供应商结算、成本池、分摊规则、对账任务、争议调账、关账和审计证据模型。

## 2. 现有能力复用分析

| 能力 | 复用对象 | 本模块使用方式 | 新增边界 |
|---|---|---|---|
| CMDB/客户资源 | 客户、机柜、空间、电力、网络、设备 | 作为客户账单用量和资源归属依据 | 新增计费快照和证据 hash |
| 供应商管理 | 供应商、合同、服务、SLA | 作为供应商结算和扣罚依据 | 新增应付、扣罚、争议闭环 |
| 维修/EHS/安防工单 | 服务记录、作业记录、完成质量 | 作为供应商服务确认和客户服务扣罚依据 | 新增费用项映射 |
| 能耗/容量 | 电量、PUE、容量使用 | 作为电费和资源成本分摊依据 | 新增成本池和分摊规则 |
| 报表中心 | 经营报表、客户报表、审计报表 | 输出收入、成本、毛利和差异报表 | 新增财务指标口径 |
| 工作流 | 审批、退回、加签、关账 | 承载账单、结算、调账和关账审批 | 新增财务节点和阻断规则 |
| 权限中心 | 角色、组织、客户范围 | 控制金额、合同、发票和导出权限 | 新增金额脱敏和客户范围 |
| dcim-cli | 命令行生成和对账 | 支持账单、结算、分摊、对账、关账和审计 | 新增 finance 命令组 |

## 3. 用户角色与业务场景

| 角色 | 主要动作 | 关注点 |
|---|---|---|
| 财务运营负责人 | 查看收入、成本、毛利、差异和关账 | 经营结果可信、异常可解释 |
| 合同管理员 | 维护客户/供应商合同和价格条款 | 条款准确、版本可追溯 |
| 客户经理 | 生成客户账单并处理客户争议 | 账单准确、客户可解释 |
| 供应商经理 | 核对供应商结算和 SLA 扣罚 | 服务证据、扣罚合理 |
| 成本会计 | 导入成本池并维护分摊规则 | 成本归集和分摊口径一致 |
| 财务专员 | 登记发票、付款和回款 | 账龄、逾期、票款一致 |
| 审计员 | 导出合同、账单、结算、发票、付款和审批证据 | 证据完整、审计可追溯 |

核心业务场景：

1. 客户月账单生成时，系统从 CMDB、资源用量、能耗和服务数据拉取快照，按合同价格条款计算账单明细。
2. 供应商月度结算时，系统汇总服务工单、SLA、质量扣罚和合同条款，生成应付金额。
3. 成本会计导入电费、人工、租赁和维保成本，按功率、面积、客户、设备域或工单分摊。
4. 对账工作台发现客户账单、发票、回款或供应商付款差异，进入争议调账流程。
5. 周期关账前系统检查未审批账单、未处理差异、未登记发票、未完成付款和审计证据缺口。

## 4. 信息架构与页面清单

| 页面 | 路由 | 角色 | 页面目标 | 核心组件 |
|---|---|---|---|---|
| 财务运营驾驶舱 | `/finance-ops/overview` | 财务运营负责人 | 查看收入、成本、毛利、应收、应付、差异和争议闭环 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 客户供应商合同台账 | `/finance-ops/contracts` | 合同管理员 | 维护客户合同、供应商合同、价格条款、SLA扣罚和账期 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 客户账单与收入确认 | `/finance-ops/customer-bills` | 客户经理 | 生成客户账单、核对资源用量、确认收入和交付客户账单 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 供应商结算与应付 | `/finance-ops/supplier-settlements` | 供应商经理 | 核对供应商服务、工单、SLA、扣罚和应付金额 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 成本池与分摊规则 | `/finance-ops/cost-pools` | 成本会计 | 管理电费、租赁、维保、人工、备件、能耗和公共成本分摊 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 收入成本对账工作台 | `/finance-ops/reconciliation` | 财务分析师 | 进行客户账单、供应商结算、成本池、发票和付款差异对账 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 发票付款与回款跟踪 | `/finance-ops/invoices` | 财务专员 | 跟踪发票、付款、回款、账龄、逾期和坏账风险 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 争议与调账闭环 | `/finance-ops/disputes` | 结算专员 | 处理客户争议、供应商争议、调账、补单和审批 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 结算审批与关账 | `/finance-ops/workflow` | 财务负责人 | 审批账单、结算、调账、关账和异常放行 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |
| 财务证据与审计报表 | `/finance-ops/audit` | 审计员 | 导出合同、账单、用量、成本、审批、发票、付款和审计链 | 指标卡、合同树、金额表格、差异抽屉、审批时间线、证据面板 |

### 4.1 财务运营驾驶舱

- 页面目标：查看收入、成本、毛利、应收、应付、差异和争议闭环。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.2 客户供应商合同台账

- 页面目标：维护客户合同、供应商合同、价格条款、SLA扣罚和账期。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.3 客户账单与收入确认

- 页面目标：生成客户账单、核对资源用量、确认收入和交付客户账单。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.4 供应商结算与应付

- 页面目标：核对供应商服务、工单、SLA、扣罚和应付金额。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.5 成本池与分摊规则

- 页面目标：管理电费、租赁、维保、人工、备件、能耗和公共成本分摊。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.6 收入成本对账工作台

- 页面目标：进行客户账单、供应商结算、成本池、发票和付款差异对账。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.7 发票付款与回款跟踪

- 页面目标：跟踪发票、付款、回款、账龄、逾期和坏账风险。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.8 争议与调账闭环

- 页面目标：处理客户争议、供应商争议、调账、补单和审批。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.9 结算审批与关账

- 页面目标：审批账单、结算、调账、关账和异常放行。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

### 4.10 财务证据与审计报表

- 页面目标：导出合同、账单、用量、成本、审批、发票、付款和审计链。
- 顶部指标：收入金额、成本金额、毛利率、对账差异、应收逾期、应付逾期、争议数量、关账阻断项。
- 筛选条件：数据中心、客户、供应商、合同、账期、费用项、发票状态、付款状态、审批状态、差异类型。
- 表格字段：单据编号、交易方、合同、周期、金额、税额、差异、状态、责任人、更新时间、审计ID。
- 主按钮：新建合同、生成账单、生成结算、导入成本、执行分摊、创建对账、登记发票、登记付款、提交关账、导出审计。
- 异常态：用量缺失、价格缺失、SLA扣罚异常、成本未分摊、发票金额不符、回款逾期、争议未处理、关账阻断。
- 权限态：客户经理只看客户范围，供应商经理只看供应商范围，财务负责人可审批，审计员只读导出；金额字段按权限脱敏。

## 5. 业务流程与状态机

| 状态 | 中文名 | 进入条件 | 可执行动作 | 退出条件 |
|---|---|---|---|---|
| draft | 草稿 | 合同、账单、结算单或调账单创建未提交 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| calculated | 已计算 | 系统按规则完成费用、成本或分摊计算 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| reconciling | 对账中 | 进入客户、供应商、成本池、发票或付款对账 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| exception_review | 异常复核 | 用量缺失、价格不匹配、发票差异或付款异常待处理 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| submitted | 已提交 | 提交给业务、财务、客户经理或供应商经理审批 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| reviewing | 审批中 | 审批人进行金额、证据、条款和差异复核 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| approved | 已批准 | 账单、结算或调账可确认 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| issued | 已开票 | 客户发票或供应商发票已开具或登记 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| paid | 已收付 | 回款或付款已完成 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| disputed | 争议中 | 客户或供应商提出金额、用量或 SLA 争议 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| closed | 已关账 | 周期结算完成并固化审计证据 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |
| voided | 已作废 | 单据作废并保留原因和审计 | 计算、对账、提交、审批、开票、付款、争议、关账、作废、导出 | 满足状态规则并写入审计 |

主流程：草稿 -> 已计算 -> 对账中 -> 已提交 -> 审批中 -> 已批准 -> 已开票 -> 已收付 -> 已关账；金额、证据或对账异常进入异常复核或争议中。

关键业务规则：
1. 合同价格条款必须有有效期，同一费用项同一周期不得存在冲突条款。
2. 客户账单必须绑定资源用量快照和合同价格版本。
3. 供应商结算必须绑定服务证据、SLA结果和扣罚规则。
4. 成本池导入后必须经过质量校验，未通过不得分摊。
5. 成本分摊规则必须有版本，关账后不得覆盖历史分摊结果。
6. 发票金额与账单或结算单差异超过阈值必须进入异常复核。
7. 争议调账必须审批，且调账前后金额必须保留审计链。
8. 关账前必须清零阻断项或形成财务负责人放行记录。
9. 金额、发票号、银行流水等敏感字段必须脱敏或 hash。
10. 所有计算、审批、导出、调账、作废和关账必须写入审计日志。

## 6. 字段、数据模型与数据库设计摘要

| 表 | 中文名 | 核心字段 | 研发说明 |
|---|---|---|---|
| finance_contract | 合同台账表 | contract_id PK, contract_code, contract_type, party_id, party_name, price_model, billing_cycle, sla_penalty_rule, tax_rate, contract_status, valid_from, valid_to | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_price_item | 价格条款表 | price_item_id PK, contract_id FK, charge_item_code, charge_item_name, unit_price, unit, tier_rule, minimum_commitment, effective_from, effective_to | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_customer_bill | 客户账单表 | bill_id PK, customer_id, contract_id, billing_period, bill_amount, tax_amount, discount_amount, reconcile_status, invoice_status, payment_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_bill_line | 账单明细表 | line_id PK, bill_id FK, charge_item_code, resource_object_id, usage_qty, unit_price, line_amount, evidence_snapshot_id | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_supplier_settlement | 供应商结算表 | settlement_id PK, supplier_id, contract_id, settlement_period, service_amount, penalty_amount, payable_amount, settlement_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_cost_pool | 成本池表 | cost_pool_id PK, cost_period, cost_type, site_id, cost_amount, source_system, allocation_rule_id, cost_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_allocation_rule | 成本分摊规则表 | allocation_rule_id PK, rule_name, allocation_basis, dimension_set, formula_expr, owner_id, rule_status, version_no | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_reconciliation_task | 对账任务表 | recon_id PK, recon_type, period, object_id, expected_amount, actual_amount, diff_amount, diff_reason, recon_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_invoice | 发票表 | invoice_id PK, invoice_type, party_id, source_object_type, source_object_id, invoice_amount, tax_amount, invoice_no_hash, invoice_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_payment | 收付款表 | payment_id PK, payment_type, party_id, source_object_id, payment_amount, payment_date, bank_flow_hash, payment_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_dispute_adjustment | 争议调账表 | dispute_id PK, object_type, object_id, party_id, dispute_reason, claimed_amount, adjust_amount, decision, dispute_status | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_workflow_task | 财务审批任务表 | task_id PK, object_type, object_id, node_code, node_name, assignee_id, task_status, decision, comment, sla_due_at | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_evidence_snapshot | 财务证据快照表 | snapshot_id PK, object_type, object_id, source_systems, source_hash, file_id, row_count, created_at | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_metric_daily | 财务指标日表 | metric_id PK, metric_date, revenue_amount, cost_amount, gross_margin_rate, ar_overdue_amount, ap_overdue_amount, diff_amount, dispute_count | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |
| finance_audit_log | 财务审计日志表 | audit_id PK, object_type, object_id, actor_id, actor_role, action, before_state, after_state, request_id, ip_addr, created_at | 需要 tenant_id、created_by、updated_by、软删除、金额精度和审计字段 |

字段设计原则：页面字段、数据库字段、接口字段、Mock 字段和报表指标必须同源；金额使用 decimal，所有计算需要保留公式版本、来源快照和审计ID。

## 7. 接口设计与集成契约

| 方法 | 路径 | 用途 | 入参 | 出参 |
|---|---|---|---|---|
| GET | /api/dcim/finance/contracts | 合同台账查询 | contractType,partyId,status,dateRange,page,pageSize | 合同、价格条款、SLA、账期和状态 |
| POST | /api/dcim/finance/contracts | 创建合同 | contractType,partyId,priceModel,billingCycle,taxRate,validFrom,validTo | contractId,workflowTaskId |
| POST | /api/dcim/finance/contracts/{contractId}/price-items | 维护价格条款 | chargeItemCode,unitPrice,unit,tierRule,effectiveFrom | priceItemId,auditId |
| POST | /api/dcim/finance/customer-bills/calculate | 生成客户账单 | customerId,contractId,billingPeriod,usageSnapshotIds | billId,billAmount,diffWarnings |
| GET | /api/dcim/finance/customer-bills/{billId} | 客户账单详情 | billId | 主表、明细、用量、发票、回款、审批、证据 |
| POST | /api/dcim/finance/supplier-settlements/calculate | 生成供应商结算单 | supplierId,contractId,period,serviceEvidenceIds | settlementId,payableAmount,penaltyAmount |
| POST | /api/dcim/finance/cost-pools/import | 导入成本池 | costPeriod,costType,sourceSystem,fileId,allocationRuleId | costPoolId,rowCount,qualityWarnings |
| POST | /api/dcim/finance/cost-pools/{costPoolId}/allocate | 执行成本分摊 | allocationRuleId,dimensionSet,dryRunFlag | allocationBatchId,allocatedAmount,diffAmount |
| POST | /api/dcim/finance/reconciliation-tasks | 创建对账任务 | reconType,period,objectId,expectedAmount,actualAmount | reconId,diffAmount,reconStatus |
| POST | /api/dcim/finance/reconciliation-tasks/{reconId}/resolve | 处理对账差异 | diffReason,adjustFlag,evidenceIds,comment | reconStatus,workflowTaskId |
| POST | /api/dcim/finance/invoices | 登记发票 | invoiceType,partyId,sourceObjectType,sourceObjectId,invoiceAmount,taxAmount,invoiceNoHash | invoiceId,invoiceStatus |
| POST | /api/dcim/finance/payments | 登记收付款 | paymentType,partyId,sourceObjectId,paymentAmount,paymentDate,bankFlowHash | paymentId,paymentStatus |
| POST | /api/dcim/finance/disputes | 创建争议调账 | objectType,objectId,partyId,disputeReason,claimedAmount,evidenceIds | disputeId,workflowTaskId |
| POST | /api/dcim/finance/disputes/{disputeId}/decision | 争议处理决策 | decision,adjustAmount,comment,evidenceIds | disputeStatus,adjustBillId,auditId |
| POST | /api/dcim/finance/workflow/tasks/{taskId}/decision | 审批复核决策 | decision,comment,delegateTo,evidenceIds | nextNode,nextState,auditId |
| POST | /api/dcim/finance/closing/{period}/submit | 提交周期关账 | period,siteId,forceFlag,exceptionList | closingTaskId,blockReasons |
| GET | /api/dcim/finance/metrics/operation | 财务运营指标查询 | siteId,dateRange,customerId,supplierId | 收入、成本、毛利、应收、应付、差异、争议 |
| GET | /api/dcim/finance/evidence/{objectType}/{objectId} | 财务证据包查询 | objectType,objectId | 合同、用量、账单、结算、审批、发票、付款、审计 |
| GET | /api/dcim/finance/audit-logs | 财务审计查询 | objectType,objectId,actorId,action,dateRange | 审计日志分页 |
| POST | /api/dcim/finance/reports/export | 导出财务报表 | reportType,period,siteId,customerId,supplierId,watermark | fileId,auditId |

接口异常码：CONTRACT_PRICE_MISSING、USAGE_SNAPSHOT_MISSING、COST_POOL_INVALID、ALLOCATION_DIFF_OVER_LIMIT、INVOICE_AMOUNT_MISMATCH、PAYMENT_OVERDUE、DISPUTE_NOT_CLOSED、CLOSING_BLOCKED、EXPORT_DENIED。

## 8. 埋点、指标与审计

| 事件名 | 触发时机 | 属性 | 指标用途 |
|---|---|---|---|
| finance_overview_view | 查看财务运营驾驶舱 | site_id/user_role/date_range | 分析财务入口 |
| finance_contract_create | 创建合同 | contract_type/party_id/price_model/billing_cycle | 统计合同治理 |
| finance_price_create | 创建价格条款 | contract_id/charge_item_code/unit_price | 统计价格变更 |
| finance_bill_create | 生成客户账单 | customer_id/billing_period/bill_amount/line_count | 计算账单生成量 |
| finance_bill_submit | 提交客户账单审批 | bill_id/bill_amount/diff_amount | 追踪账单审批 |
| finance_settlement_create | 生成供应商结算 | supplier_id/period/payable_amount/penalty_amount | 统计供应商结算 |
| finance_cost_import | 导入成本池 | cost_type/cost_amount/source_system/row_count | 追踪成本来源 |
| finance_allocation_start | 开始成本分摊 | cost_pool_id/allocation_rule_id/dimension_count | 追踪分摊任务 |
| finance_reconciliation_start | 开始对账 | recon_type/period/object_id/expected_amount | 追踪对账任务 |
| finance_reconciliation_resolved | 对账差异处理完成 | recon_id/diff_reason/adjust_flag/sla_status | 统计差异闭环 |
| finance_invoice_upload | 登记发票 | invoice_type/party_id/invoice_amount/source_object_type | 统计发票 |
| finance_payment_create | 登记收付款 | payment_type/party_id/payment_amount/payment_status | 统计收付款 |
| finance_dispute_submit | 提交争议调账 | object_type/party_id/claimed_amount/dispute_reason | 追踪争议 |
| finance_closing_complete | 周期关账完成 | period/site_id/exception_count/diff_amount | 计算关账质量 |
| finance_audit_export | 导出财务审计 | report_type/period/export_format/watermark | 审计导出行为 |
| finance_cli_command | CLI 调用 | command/user/result/trace_id | 审计自动化调用 |
| finance_agent_suggest | 智能体建议 | intent/source_count/accepted | 评估 AI 建议采纳 |

核心指标：收入金额、成本金额、毛利率、客户账单准确率、供应商结算准确率、对账差异率、争议关闭率、应收逾期金额、应付逾期金额、关账准时率。

## 9. CLI 与智能体设计

| 命令 | 场景 | 输出 |
|---|---|---|
| `zhihang finance contract list --party customer` | 查询合同 | 合同、价格、账期、状态 |
| `zhihang finance bill calculate --customer C001 --period 2026-06` | 生成客户账单 | 账单金额、差异、证据 |
| `zhihang finance settlement calculate --supplier S001 --period 2026-06` | 生成供应商结算 | 应付、扣罚、争议 |
| `zhihang finance cost import --type energy --file FILE-001` | 导入成本池 | 行数、质量、成本金额 |
| `zhihang finance allocate --pool CP-001 --rule RULE-001` | 执行成本分摊 | 分摊批次、差异金额 |
| `zhihang finance reconcile --bill BILL-001 --invoice INV-001` | 执行对账 | 差异、原因、建议动作 |
| `zhihang finance dispute resolve DSP-001 --decision approve` | 处理争议 | 调账金额、审批、审计 |
| `zhihang finance closing submit --period 2026-06` | 提交关账 | 阻断项、异常、关账任务 |
| `zhihang finance audit BILL-001 --trace` | 查询财务审计链 | 合同、用量、账单、审批、发票、付款 |

智能体能力：解释账单差异、识别成本异常、生成争议处理建议、预测逾期回款、输出关账阻断清单和财务审计摘要。

## 10. Demo 验收与非目标范围

Demo 验收脚本：

1. 打开 财务运营驾驶舱，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
2. 打开 客户供应商合同台账，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
3. 打开 客户账单与收入确认，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
4. 打开 供应商结算与应付，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
5. 打开 成本池与分摊规则，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
6. 打开 收入成本对账工作台，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
7. 打开 发票付款与回款跟踪，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
8. 打开 争议与调账闭环，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
9. 打开 结算审批与关账，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。
10. 打开 财务证据与审计报表，筛选账期和交易方，点击主操作，确认弹窗或抽屉出现，金额、状态、时间线、审计ID和指标卡同步变化。

| 验收项 | 通过标准 |
|---|---|
| 名称一致 | Excel、目录、菜单、PRD、Demo 标题均使用财务运营管理增强包 |
| 页面完整 | 10 个页面均有字段、按钮、异常态、权限态和主流程动作 |
| 数据库完整 | 不少于 15 张表覆盖合同、价格、账单、结算、成本、分摊、对账、发票、付款、争议、工作流、证据、指标和审计 |
| 接口完整 | 不少于 20 个接口覆盖合同、账单、结算、成本、分摊、对账、发票、付款、争议、审批、关账、报表和审计 |
| 埋点完整 | 不少于 17 个事件覆盖合同、账单、结算、成本、分摊、对账、发票、付款、争议、关账、导出、CLI 和智能体 |
| 联动完整 | CMDB、供应商、维修、能耗、报表、工作流和权限中心均有集成契约 |
| 安全完整 | 金额脱敏、客户范围、发票银行流水 hash、导出水印和审计留痕均有设计 |

非目标范围：不替代 ERP、不开具真实税控发票、不直接执行银行付款；本模块负责 DCIM/DCOM 场景内的经营数据、结算对账、证据链、审批和审计。
- 深化规则 312：合同条款 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 313：客户账单 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 314：供应商结算 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 315：成本池 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 316：分摊规则 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 317：对账差异 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 318：发票付款 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 319：关账审计 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 320：合同条款 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 321：客户账单 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 322：供应商结算 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 323：成本池 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 324：分摊规则 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 325：对账差异 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 326：发票付款 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 327：关账审计 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 328：合同条款 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 329：客户账单 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 330：供应商结算 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 331：成本池 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 332：分摊规则 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 333：对账差异 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 334：发票付款 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。
- 深化规则 335：关账审计 必须同时映射页面字段、数据库表、接口入参出参、埋点事件、CLI 校验和审计证据，所有金额异常都要能进入工作流处理。