fujian_water_biz_doc/sql/lhc_数据库设计.md

文档概述

文档目的

（说明编写文档目的, 如：本文档主要为xxx项目的数据库设计说明，为用户设计接口及研发提供参照）

适用范围

（说明文档使用范围, 如：本文档适用于研发、运维人员等。。。）

参考资料

（列举参考的文献来源）

序号	文献名称
[1]	《软件架构设计》

术语、缩略语说明

术语、缩写	解释	更多说明
水司	水务集团下的各个地区公司	在系统里表示租户，不同水司对应不同租户
分公司	水司下的各个分公司	在系统里表示部门，一般是顶级部门，下面是站点
站点	全名：营业站点，用于划分用户所属管辖区域	在系统里表示部门，对应部门管理，支持数据隔离
待补充

公共常量约定

默认状态-default_status

默认状态

编码	中文含义
0	是
1	否

部门类型-dept_type

默认状态

编码	中文含义
0	分公司
1	站点

阶梯类型-tiered_mode

阶梯类型

编码	中文含义
0	无阶梯
1	年度阶梯
2	月度阶梯
3	季度阶梯

计算类型-calculation_mode

计算类型

编码	中文含义
1	按水量计算
2	按人口数计算
3	固定金额
4	按户数计算

优惠方式-discount_type

优惠方式

编码	中文含义
1	按次优惠
2	按月优惠
3	按季优惠
4	按年优惠
5	无限期定量优惠

计划用水周期（scheme_cycle）

词语值	词语文本
1	月
2	季
3	年

---

计划模式（scheme_type）

词语值	词语文本
1	超计划
2	非居民阶梯

客户类型（cust_type）

词语值	词语文本
1	居民
2	非居民

证件类型（certificate_type）

词语值	词语文本
1	身份证
2	军人证
3	户口本
4	护照
5	营业执照

自助机缴费方式（counter_am_type）

词语值	词语文本
1	微信
2	支付宝
3	银行卡
4	现金
5	其它

缴费方式（payment_method）

缴费方式

编码	中文含义
1	现金
2	代扣
3	托收

收费状态（charge_status）

收费状态

编码	中文含义
0	未收
1	已收
2	已结
-1	呆账

优惠模式（preferential_mode）

优惠模式

编码	中文含义
1	按水量
2	按价格

优惠原因（preferential_reason）

优惠原因

编码	中文含义
1	用户申请
2	其它

价差调整原因（price_adjust_reason）

价差调整原因

编码	中文含义
1	用户协商
2	定价错误
3	其它

账务处理方式（account_process_type）

账务处理方式

编码	中文含义
1	转预存
2	转退款
3	转销账
4	线下退款

问题上报类型（issue_report_type）

问题上报类型

编码	中文含义
1	换表申请
2	停水申请
3	复水申请
4	用户纠纷

抄表进度（meter_reading_progress）

抄表进度

编码	中文含义
0	未抄
1	已抄
3	外复

复水原因（water_restore_reason）

复水原因

编码	中文含义
1	欠费缴清
2	恢复用水
3	其它

拆表原因（meter_remove_reason）

拆表原因

编码	中文含义
1	销户拆表
2	欠费拆表
3	临时停用
4	其它

换表原因（meter_change_reason）

换表原因

编码	中文含义
1	用户申请
2	水司定检
3	其它

换表类型（meter_change_type）

换表类型

编码	中文含义
1	故障换表
2	批量换表

表卡恢复原因（card_restore_reason）

表卡恢复原因

编码	中文含义
1	用户申请
2	欠费停水恢复
3	其他

表卡恢复类型（card_restore_type）

表卡恢复类型

编码	中文含义
1	内部停用恢复
2	用户保停恢复

分账调整原因（separate_adjust_reason）

分账调整原因

编码	中文含义
1	一表多户
2	其它

分账调整类型（separate_adjust_type）

分账调整类型

编码	中文含义
1	按水量
2	按费用组成

分摊方式（allocation_method）

分摊方式

编码	中文含义
1	按水量
2	按比例
3	其它
4	按累计水量

收费方式（charge_method）

收费方式

编码	中文含义
1	按实际水量
2	按固定水量
3	按人口数
4	按最低消费水量

表卡停用原因（card_stop_reason）

表卡停用原因

编码	中文含义
1	用户申请
2	无人使用

停水原因（water_stop_reason）

停水原因

编码	中文含义
1	长期未缴费
2	房屋动迁
3	其它

零税率标识（zero_tax_flag）

零税率标识

编码	中文含义
1	免税
2	不征税
3	普通零税率
4	非零税率

用户分组（user_group）

用户分组

编码	中文含义
1	企业内
2	外聘人员
3	其它

工单类型（work_order_type）

工单类型

编码	中文含义
1	换表工单
2	维修工单
3	移表工单
4	拆表工单

客户组类型（cust_group_type）

词语值	词语文本
1	居民
2	单位
3	特业

数据库环境说明

（说明部署环境、工具、存放位置等）

命名规范

• 表名前面加上特定业务模块名称，例如：
  • biz_（业务配置相关）
  • mw_（表务相关）

逻辑设计

数据实体关系图

（说明本数据库反映的显示世界中的实体、属性和他们之间的关系等ER图）

水表参数模块ER图

erDiagram
    biz_meter_maker {
        bigint id PK
        varchar name
        varchar code UK
        varchar recharge_type
        varchar address
        varchar contact
        varchar contact_number
        varchar remark
    }
    
    biz_meter_model {
        bigint id PK
        varchar maker_code FK
        varchar name
        varchar code UK
        varchar caliber_range
        varchar remark
    }
    
    biz_meter_caliber {
        bigint id PK
        varchar name
        decimal value
        int check_period
        int replace_period
        decimal high_coefficient
        decimal low_coefficient
    }
    
    biz_meter_range {
        bigint id PK
        varchar name
        varchar code UK
        decimal value
        varchar remark
    }
    
    biz_meter_maker ||--o{ biz_meter_model : "厂家代码关联型号"

地址参数模块ER图

erDiagram
    system_dept {
        bigint id PK
        varchar name
        bigint parent_id
        varchar type
        varchar code UK
        varchar phone
        varchar email
    }
    
    biz_company_account {
        bigint id PK
        varchar account_name
        varchar account_address
        varchar bank_name
        varchar bank_code
        varchar bank_account
    }
    
    biz_dept_account_rel {
        bigint id PK
        varchar dept_code FK
        bigint account_id FK
        varchar remark
    }
    
    biz_community {
        bigint id PK
        varchar name
        varchar code UK
        varchar address
        varchar contact_number
        varchar dept_code FK
        bigint parent_id
        varchar ancestor_list
    }
    
    biz_price_category {
        bigint id PK
        varchar name
        varchar code UK
        bigint parent_id
        varchar ancestor_list
    }
    
    biz_price_dept_rel {
        bigint id PK
        varchar dept_code FK
        varchar price_category_code FK
        bit is_default
        varchar remark
    }
    
    system_dept ||--o{ system_dept : "部门层级"
    system_dept ||--o{ biz_dept_account_rel : "部门配置账户"
    biz_company_account ||--o{ biz_dept_account_rel : "关联账户"
    system_dept ||--o{ biz_community : "管辖小区"
    biz_community ||--o{ biz_community : "小区层级"
    system_dept ||--o{ biz_price_dept_rel : "部门配置价格归属"
    biz_price_category ||--o{ biz_price_dept_rel : "价格归属关联部门"
    biz_price_category ||--o{ biz_price_category : "价格归属层级"

价格体系核心表ER图

erDiagram
    biz_cost_component {
        bigint id PK
        varchar name
        varchar code UK
        decimal penalty_coefficient
        bit zero_usage_calculation
    }
    
    biz_price_cost_adjustment {
        bigint id PK
        varchar price_category_code FK
        varchar cost_component_code FK
        int calculation_mode
        bit is_tiered
        int tiered_mode
        int tier_level
        decimal volume_coefficient
        bit charge_penalty
    }
    
    biz_price_tier_adjustment {
        bigint id PK
        bigint cost_adjustment_id FK
        varchar cost_component_code FK
        int tier_level
        decimal start_volume
        decimal end_volume
        decimal price
        decimal volume_coefficient
    }
    
    biz_cost_component ||--o{ biz_price_cost_adjustment : "费用组成调整"
    biz_price_cost_adjustment ||--o{ biz_price_tier_adjustment : "包含阶梯"
    biz_cost_component ||--o{ biz_price_tier_adjustment : "费用组成阶梯"

价格体系历史记录ER图

erDiagram
    biz_price_adjustment_history {
        bigint id PK
        varchar price_category_code FK
        varchar adjustment_name
        date effective_date
        date expiry_date
        varchar adjustment_reason
        varchar adjuster
        datetime adjustment_time
    }
    
    biz_price_cost_adjustment_history {
        bigint id PK
        bigint history_id FK
        varchar price_category_code FK
        varchar cost_component_code FK
        int calculation_mode
        bit is_tiered
        int tiered_mode
        int tier_level
        decimal volume_coefficient
        bit charge_penalty
    }
    
    biz_price_tier_adjustment_history {
        bigint id PK
        bigint cost_adjustment_history_id FK
        varchar cost_component_code FK
        int tier_level
        decimal start_volume
        decimal end_volume
        decimal price
        decimal volume_coefficient
    }
    
    biz_price_adjustment_history ||--o{ biz_price_cost_adjustment_history : "调价记录包含费用历史"
    biz_price_cost_adjustment_history ||--o{ biz_price_tier_adjustment_history : "费用历史包含阶梯历史"

优惠方案ER图

erDiagram
    biz_price_discount_scheme {
        bigint id PK
        varchar scheme_name
        varchar scheme_code UK
        varchar price_category_code FK
        int discount_type
        date effective_date
        date expiry_date
        varchar scheme_description
    }
    
    biz_price_discount_tier {
        bigint id PK
        varchar scheme_code FK
        int tier_level
        decimal start_volume
        decimal end_volume
        bit include_in_tier
    }
    
    biz_price_discount_scheme ||--o{ biz_price_discount_tier : "方案代码关联阶梯"

水价调整关系图

erDiagram
    %% 顶层：水价归属和调价快照
    biz_price_category["biz_price_category<br/>水价归属表"] {
        bigint id PK
        varchar name "归属名称"
        varchar code UK "归属代码"
        bigint parent_id "父级归属id"
        varchar ancestor_list "祖级列表"
        int sort "排序"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    biz_price_adjustment_snap["biz_price_adjustment_snap<br/>水价调整快照表"] {
        bigint id PK
        int code UK "快照编号/版本号"
        datetime effective_date "生效日期"
        datetime expiry_date "失效日期"
        varchar adjuster "调价人"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间/调价时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 中层左：水价模版
    biz_price_template["biz_price_template<br/>水价模版表"] {
        bigint id PK
        int sort "排序"
        varchar name "用水性质"
        varchar code UK "模版代码"
        varchar price_category_code FK "水价归属代码"
        bigint adjustment_snap_id FK "调价快照id"
        int adjustment_snap_code FK "调价快照code"
        int meter_start "起开量"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 中层右：费用组成
    biz_cost_component["biz_cost_component<br/>费用组成表"] {
        bigint id PK
        varchar name "费用名称"
        varchar code UK "费用代码"
        decimal penalty_coefficient "违约金系数"
        bit zero_usage_calculation "零用量是否计算"
        int sort "排序"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 下层左：费用调整
    biz_price_cost_adjustment["biz_price_cost_adjustment<br/>水价费用调整表"] {
        bigint id PK
        bigint template_id FK "水价模版id"
        varchar cost_component_code FK "费用组成代码"
        int calculation_mode "计算类型"
        bit is_tiered "是否阶梯"
        int tiered_mode "阶梯类型"
        int tier_level "阶梯级别"
        decimal volume_coefficient "水量系数"
        bit charge_penalty "是否收取违约金"
        int sort "排序"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 下层中：阶梯调整
    biz_price_tier_adjustment["biz_price_tier_adjustment<br/>水价阶梯调整表"] {
        bigint id PK
        bigint cost_adjustment_id FK "水价费用调整id"
        varchar cost_component_code FK "费用组成代码"
        int tier_level "阶梯级别"
        decimal start_volume "开始水量m3"
        decimal end_volume "结束水量m3"
        decimal price "价格元"
        decimal volume_coefficient "水量系数"
        int sort "排序"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 右侧：部门管理
    system_dept["system_dept<br/>系统部门表"] {
        bigint id PK
        varchar name "部门名称"
        bigint parent_id "父级部门id"
        varchar code UK "部门代码"
        varchar type "部门类型"
        varchar phone "联系电话"
        varchar email "邮箱"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人"
        varchar updater "更新人"
        int deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 右下：模版部门关系
    biz_template_dept_rel["biz_template_dept_rel<br/>水价模版部门关系表"] {
        bigint id PK
        varchar dept_code FK "部门代码"
        varchar template_code FK "水价调整模版代码"
        bigint adjustment_snap_id FK "调价快照id"
        int adjustment_snap_code FK "调价快照code"
        bit is_default "是否默认"
        varchar remark "备注"
        int status "状态"
        datetime create_time "创建时间"
        datetime update_time "更新时间"
        varchar creator "创建人id"
        varchar updater "更新人id"
        bit deleted "是否删除"
        bigint tenant_id "租户id"
    }

    %% 核心业务关系链
    biz_price_category ||--o{ biz_price_template : "code = price_category_code"
    biz_price_adjustment_snap ||--o{ biz_price_template : "code = adjustment_snap_code"
    biz_price_template ||--o{ biz_price_cost_adjustment : "id = template_id"
    biz_cost_component ||--o{ biz_price_cost_adjustment : "code = cost_component_code"
    biz_price_cost_adjustment ||--o{ biz_price_tier_adjustment : "id = cost_adjustment_id"
    biz_cost_component ||--o{ biz_price_tier_adjustment : "code = cost_component_code"

    %% 部门关系链
    system_dept ||--o{ biz_template_dept_rel : "code = dept_code"
    biz_price_template ||--o{ biz_template_dept_rel : "code = template_code"
    biz_price_adjustment_snap ||--o{ biz_template_dept_rel : "code = adjustment_snap_code"

实体及关系描述

（按照ER图说明实体及实体间 一对一、一对多、多对多的关系）

物理设计

（说明是否采用分布式数据库、数据库表分部，存储空间等安排）

表结构设计

待补表清单（TODO）

说明：以下清单基于 docs/design/04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md 与当前 backend 真实表扫描结果整理，用于标识“数据字典或后端已出现，但当前文档尚未展开详细字段设计”的表或表组。

当前表结构设计已覆盖部分核心基础表、价格表、客户主表、抄表主表、营业账主表、托收/代扣主表、开票配置主表、统一工单主表；以下对象为后续优先补充范围。

已设计范围（当前文档）

当前已在本章展开设计的表包括：

• 水表基础：biz_meter_maker、biz_meter_model、biz_meter_caliber、biz_meter_range、biz_meter
• 组织账户：system_dept、biz_company_account、biz_dept_account_rel
• 基础主数据：biz_community、biz_cust、biz_cust_group
• 价格与方案：biz_price_category、biz_cost_component、biz_price_adjustment_snap、biz_template_dept_rel、biz_price_template、biz_price_cost_adjustment、biz_price_tier_adjustment、biz_price_discount_scheme、biz_price_discount_tier、biz_price_discount_cost、biz_water_use_scheme、biz_water_use_scheme_tier
• 页面配置：infra_user_form_config
• 抄表与账务：biz_meter_book、biz_reading_data、biz_last_reading、biz_charge、biz_charge_detail
• 银行与发票：biz_collection、biz_withholding、biz_invoice
• 业务办理：biz_process

待补设计范围（按领域归类）

1. 客户信息扩展域

• biz_account（账户信息）
• biz_cust_contact（联系人）
• biz_cust_app_binds（客户应用绑定关联）
• biz_cust_collection_rel（客户托收中间关系）
• biz_cust_withholding_rel（客户代扣中间关系）
• biz_cust_invoice（客户开票信息）
• biz_cust_meter（客户与水表关系）
• biz_cust_bill_type（客户开账类型）
• biz_cust_no_rule、biz_dept_cust_no_rule_rel（客户编号规则）
• biz_cust_hub_marks（集收号/集收标记类）
• biz_cust_water_use_scheme、biz_cust_water_scheme_rel（客户计划用水关系）

2. 抄表与表务扩展域

• biz_meter_read（抄表状态/抄表任务状态）
• biz_reading_logs（抄表日志）
• biz_meter_log（表务/抄表日志）
• biz_meter_in_out、biz_meter_in_out_rel（水表出入库及关联）

3. 账务与收费处理扩展域

• 跨周期水量
• 特账 / 特账明细
• 退款账
• 阶梯累计量
• 收费汇总 / 收费小计 / 实时收费日志
• 红冲表
• 预存退款 / 预存退款详情
• 催缴登记 / 催缴停水 / 催缴明细
• 价差调整汇总 / 明细
• 分账调整汇总 / 明细
• 呆坏账汇总 / 明细
• 已销调整汇总 / 明细
• IC卡充退账 / 结余 / 操作日志

4. 发票域扩展

• biz_invoice_taxrate（发票税率）
• 发票明细表
• 营业账开票关系表
• 发票信息关联表
• 发票修改记录
• biz_process_invoice_modifys（发票变更流程）

5. 业务办理与工单子表域

• biz_process_transfer（流程流转）
• biz_process_cust_contact（流程联系人）
• biz_process_meter_install（装表流程信息）
• biz_business_types（业务类型）
• biz_business_datas（业务扩展数据）
• biz_content、biz_content_attach（资料与附件）
• 更名 / 过户 / 停复水 / 低保 / 换表 / 自助抄表等业务子表
• 稽查工单 / 移表工单 / PDA派单 / 上报清单 / 换表记录表

6. 参数、页面与系统配置域

• biz_parameter_settings（系统参数/业务参数）
• biz_page_settings、biz_page_settings_detail（页面基础配置）
• biz_extend_propertys（扩展信息）
• biz_bank、biz_bank_branch（银行及分行）
• 账务年月表 / 抄表年月表
• 编号生成配置 / 编号生成记录
• 导出任务 / 站内消息 / 报表 / 日志管理
• 系统菜单表 / 权限表 / 词语字典表

7. 银行代收与对账域

• bk_payment_channel
• bk_channel_api_config
• bk_channel_route_rule
• bk_channel_statistics
• bk_transaction
• bk_transaction_callback
• bk_transaction_exception
• bk_withholding_agreement
• bk_withholding_batch
• bk_withholding_item
• bk_reconcile_batch
• bk_reconcile_diff
• bk_settlement_batch

8. 报装、微网厅与移动侧补充域

• 报装用户信息 / 报装工程项目 / 报装踏勘 / 工程验收信息
• 微网厅账户绑定、微信支付订单、网点门店、文章公告、页面配置等表
• 手机记录表 / PDA版本控制表

后续补充原则

1. 优先补充“后端已有真实表且业务价值高”的对象。
2. 对于数据字典中的旧系统表，若已被当前后端重构为统一模型，应在设计说明中注明“已合并映射”，而非机械按旧名重复建表。
3. 若某类对象仅在 sw-module-system、sw-module-infra、sw-module-pay 等模块中存在，后续应结合对应模块再次核对后补入。

表模块归属说明

说明：以下归属依据 output/preview/福建水务营收系统整体架构图.html 的业务子系统划分整理，用于明确“当前已设计表、真实后端表、待补表”在总体架构中的主归属模块。若某张表被多个子系统共同使用，以“主数据维护方、核心业务责任方”作为唯一主归属。

模块归属原则

1. 客户、账单、价格、收费等核心营收主数据，归属 SYS-002 营收业务子系统。
2. 水表设备主档、库存、出入库、设备日志等表务对象，归属 SYS-006 表务管理子系统。
3. 统一受理、流转、附件、业务办理过程数据，归属 SYS-005 工单管理子系统。
4. 发票主数据、税率、开票关系、回执与红冲作废，归属 SYS-008 发票服务子系统。
5. 支付渠道、交易、回调、代扣、对账、结算等资金链路数据，归属 SYS-009 支付与银行结算子系统。
6. SYS-003 手机抄表APP 与 SYS-004 微网厅子系统 原则上作为前端渠道，不单独持有核心业务主表，主要复用营收、工单、发票、支付等后端核心表；仅在出现终端同步、授权绑定、日志等专属数据时，才单独归入对应渠道子系统。

当前已设计表的模块归属

SYS-001 统一平台

• system_dept

SYS-002 营收业务子系统

• 客户与基础主数据：biz_cust、biz_cust_group、biz_community
• 价格与用水方案：biz_price_category、biz_cost_component、biz_price_adjustment_snap、biz_template_dept_rel、biz_price_template、biz_price_cost_adjustment、biz_price_tier_adjustment、biz_price_discount_scheme、biz_price_discount_tier、biz_price_discount_cost、biz_water_use_scheme、biz_water_use_scheme_tier
• 抄表开账：biz_meter_book、biz_reading_data、biz_last_reading
• 营业收费与账务：biz_charge、biz_charge_detail

SYS-005 工单管理子系统

• biz_process

SYS-006 表务管理子系统

• biz_meter_maker
• biz_meter_model
• biz_meter_caliber
• biz_meter_range
• biz_meter

SYS-008 发票服务子系统

• biz_invoice

SYS-009 支付与银行结算子系统

• biz_collection
• biz_withholding

基础设施/页面配置能力

• infra_user_form_config

说明：infra_user_form_config 更偏表单与页面配置能力，建议作为基础设施支撑表看待，不直接归入单一营收业务子系统。

后续待补表的建议归属

SYS-002 营收业务子系统

• 客户扩展：biz_account、biz_cust_contact、biz_cust_app_binds、biz_cust_meter、biz_cust_bill_type、biz_cust_no_rule、biz_dept_cust_no_rule_rel、biz_cust_hub_marks、biz_cust_water_use_scheme、biz_cust_water_scheme_rel
• 抄表与开账扩展：biz_meter_read、biz_reading_logs
• 账务处理扩展：跨周期水量、特账/特账明细、退款账、阶梯累计量、收费汇总/收费小计/实时收费日志、红冲、预存退款、催缴登记、价差调整、分账调整、已销调整、呆坏账、IC卡账务等对象
• 参数配置扩展：biz_parameter_settings

SYS-005 工单管理子系统

• biz_process_transfer
• biz_process_cust_contact
• biz_process_meter_install
• biz_business_types
• biz_business_datas
• biz_content
• biz_content_attach
• 更名、过户、停复水、低保、换表、自助抄表、稽查工单、PDA派单等业务子表

SYS-006 表务管理子系统

• biz_meter_log
• biz_meter_in_out
• biz_meter_in_out_rel

SYS-008 发票服务子系统

• biz_invoice_taxrate
• biz_cust_invoice
• biz_process_invoice_modifys
• 发票明细表
• 营业账开票关系表
• 发票回执/作废/红冲/存证相关表

SYS-009 支付与银行结算子系统

• biz_cust_collection_rel
• biz_cust_withholding_rel
• biz_bank
• biz_bank_branch
• bk_payment_channel
• bk_channel_api_config
• bk_channel_route_rule
• bk_channel_statistics
• bk_transaction
• bk_transaction_callback
• bk_transaction_exception
• bk_withholding_agreement
• bk_withholding_batch
• bk_withholding_item
• bk_reconcile_batch
• bk_reconcile_diff
• bk_settlement_batch

SYS-003 / SYS-004 渠道子系统专属补充对象

• 微信绑定、默认账户、公众号配置、前台申请单、终端同步日志、PDA版本控制、移动端缓存同步等专属表

模块-表清单-状态总表

模块	表清单	状态
SYS-001 统一平台	system_dept	已设计
SYS-002 营收业务子系统	biz_cust、biz_cust_group、biz_community	已设计
SYS-002 营收业务子系统	biz_price_category、biz_cost_component、biz_price_adjustment_snap、biz_template_dept_rel、biz_price_template、biz_price_cost_adjustment、biz_price_tier_adjustment、biz_price_discount_scheme、biz_price_discount_tier、biz_price_discount_cost、biz_water_use_scheme、biz_water_use_scheme_tier	已设计
SYS-002 营收业务子系统	biz_meter_book、biz_reading_data、biz_last_reading	已设计
SYS-002 营收业务子系统	biz_charge、biz_charge_detail	已设计
SYS-002 营收业务子系统	biz_account、biz_cust_contact、biz_cust_app_binds、biz_cust_meter、biz_cust_bill_type、biz_cust_no_rule、biz_dept_cust_no_rule_rel、biz_cust_hub_marks、biz_cust_water_use_scheme、biz_cust_water_scheme_rel	待补
SYS-002 营收业务子系统	biz_meter_read、biz_reading_logs	待补
SYS-002 营收业务子系统	跨周期水量、特账/特账明细、退款账、阶梯累计量、收费汇总/收费小计/实时收费日志、红冲、预存退款、催缴登记、价差调整、分账调整、已销调整、呆坏账、IC卡账务等对象	待补
SYS-002 营收业务子系统	biz_parameter_settings	待补
SYS-005 工单管理子系统	biz_process	已设计
SYS-005 工单管理子系统	biz_process_transfer、biz_process_cust_contact、biz_process_meter_install、biz_business_types、biz_business_datas、biz_content、biz_content_attach	待补
SYS-005 工单管理子系统	更名、过户、停复水、低保、换表、自助抄表、稽查工单、PDA派单等业务子表	待补
SYS-006 表务管理子系统	biz_meter_maker、biz_meter_model、biz_meter_caliber、biz_meter_range、biz_meter	已设计
SYS-006 表务管理子系统	biz_meter_log、biz_meter_in_out、biz_meter_in_out_rel	待补
SYS-008 发票服务子系统	biz_invoice	已设计
SYS-008 发票服务子系统	biz_invoice_taxrate、biz_cust_invoice、biz_process_invoice_modifys、发票明细表、营业账开票关系表、发票回执/作废/红冲/存证相关表	待补
SYS-009 支付与银行结算子系统	biz_collection、biz_withholding	已设计
SYS-009 支付与银行结算子系统	biz_cust_collection_rel、biz_cust_withholding_rel、biz_bank、biz_bank_branch、bk_payment_channel、bk_channel_api_config、bk_channel_route_rule、bk_channel_statistics、bk_transaction、bk_transaction_callback、bk_transaction_exception、bk_withholding_agreement、bk_withholding_batch、bk_withholding_item、bk_reconcile_batch、bk_reconcile_diff、bk_settlement_batch	待补
基础设施/页面配置能力	infra_user_form_config	已设计
SYS-003 / SYS-004 渠道子系统	微信绑定、默认账户、公众号配置、前台申请单、终端同步日志、PDA版本控制、移动端缓存同步等专属表	待补

水表厂家表-biz_meter_maker

水表厂家基础信息管理，记录水表生产厂商的详细信息，支持水表型号的厂家归属管理

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	厂家名称	string / varchar(100)	否	否
code	厂家代码	string / varchar(100)	是	是
recharge_type	充值类型	string / varchar(10)	否	否
address	地址	string / varchar(500)	否	否
contact	联系人	string / varchar(100)	否	否
contact_number	联系号码	string / varchar(100)	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水表型号表-biz_meter_model

水表型号管理，记录各厂家的水表型号信息

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
maker_code	厂家代码	string / varchar(100)	否	是	关联水表厂家表
name	型号名称	string / varchar(100)	否	否
code	型号代码	string / varchar(100)	是	是
caliber_range	口径范围	string / varchar(200)	否	否	如：DN15-DN200
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水表口径表-biz_meter_caliber

水表口径管理，涉及到抄表录入时的量高量低提醒

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	口径名称	string / varchar(100)	否	否
value	口径值	number / decimal(10,2)	否	否	单位：毫米(mm)
check_period	强检周期	number / int	否	否	单位：年
replace_period	定换周期	number / int	否	否	单位：年
high_coefficient	量高系数	number / decimal(10,4)	否	否	抄表量高提醒系数
low_coefficient	量低系数	number / decimal(10,4)	否	否	抄表量低提醒系数
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水表量程表-biz_meter_range

水表量程管理

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	量程名称	string / varchar(100)	否	否
code	量程代码	string / varchar(100)	是	是
value	量程值	number / decimal(15,3)	否	否	单位：立方米
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

系统部门表-system_dept

系统部门管理表，原营业站点功能由此表承担，用于划分用户所属管辖区域，支持数据隔离

注意：在原表里添加了部门类型和部门代码字段

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	部门名称	string / varchar(30)	否	否
parent_id	父级部门id	number / bigint(64)	否	默认0	支持部门层级管理
sort	排序	number / int	否	默认0
leader_user_id	负责人用户id	number / bigint(64)	否	否
phone	联系电话	string / varchar(11)	否	否
email	邮箱	string / varchar(50)	否	否
longitude	经度	numeric(10, 6)	否	否
latitude	纬度	numeric(10, 6)	否	否
remark	备注	string / varchar(500)	否	否
type	部门类型	string / varchar(10)	否	否
code	部门代码	string / varchar(50)	否	否
status	状态	number / int	否	是
creator	创建人	string / varchar(64)	否	否
create_time	创建时间	timestamp	否	否	默认当前时间
updater	更新人	string / varchar(64)	否	否
update_time	更新时间	timestamp	否	否	默认当前时间
deleted	是否删除	number / int	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水司账户表-biz_company_account

水司账户信息管理，记录水司的银行账户信息，用于收费缴费

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
account_name	账户名称	string / varchar(200)	否	是
account_address	账户地址	string / varchar(500)	否	否
bank_name	开户行名称	string / varchar(200)	否	是
bank_code	开户行代码	string / varchar(100)	否	是
bank_account	开户行账户	string / varchar(100)	否	是
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

部门和水司账户关系表-biz_dept_account_rel

部门与水司账户的关联关系，一个部门可以关联多个水司账户

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
dept_code	部门代码	string / varchar(50)	否	是	关联系统部门表
account_id	水司账户id	number / bigint(64)	否	是	关联水司账户表
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

所属小区表-biz_community

所属小区信息管理，支持小区层级结构，用于客户地址归属管理

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	小区名称	string / varchar(200)	否	是
code	小区代码	string / varchar(100)	是	是
address	小区地址	string / varchar(500)	否	否
contact_number	联系号码	string / varchar(100)	否	否
dept_code	部门代码	string / varchar(50)	否	是	关联系统部门表
parent_id	父级小区id	number / bigint(64)	否	否	支持小区层级管理
ancestor_list	祖级列表	string / varchar(1000)	否	否	格式：1,2,3 表示祖级小区id列表
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价归属表-biz_price_category

水价归属类别管理，支持层级结构，用于水价分类和用水性质管理

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	归属名称	string / varchar(100)	否	否
code	归属代码	string / varchar(100)	是	是
parent_id	父级归属id	number / bigint(64)	否	否	支持水价归属层级管理
ancestor_list	祖级列表	string / varchar(1000)	否	否	格式：1,2,3 表示祖级归属id列表
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

费用组成表-biz_cost_component

费用组成管理，定义水费的组成部分，如基本水费、污水处理费、垃圾处理费等

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	费用名称	string / varchar(100)	否	否
code	费用代码	string / varchar(100)	是	是
penalty_coefficient	违约金系数	number / decimal(10,4)	否	否	违约金计算系数，默认为0表示不收取违约金
zero_usage_calculation	零用量是否计算	boolean / bit(1)	否	默认0	0-不计算，1-计算
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价调整快照（历史）表-biz_price_adjustment_snap

水价调整历史记录表，记录每次调价的历史信息

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
code	快照编号/版本号	number / int	是	是	1 -> 2 -> 3 首个版本为1
effective_date	生效日期	datetime	否	是
expiry_date	失效日期	datetime	否	否	为空表示长期有效
adjuster	调价人	string / varchar(100)	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间/调价时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价调整模版和部门关系表-biz_template_dept_rel

水价调整模版与部门的关联关系，不同部门可以配置不同的水价调整模版

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
dept_code	部门代码	string / varchar(50)	否	是	关联系统部门表
template_code	水价调整模版代码	string / varchar(100)	否	是	关联水价调整模版表
adjustment_snap_code	调价快照code	string / varchar(100)	否	是	关联水价调整快照（历史）表
is_default	是否默认	boolean / bit(1)	否	默认0	该部门是否默认使用此水价模版
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价调整模版表-biz_price_template

水价调整模版表，记录每个水价归属下的模版配置

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
name	用水性质	string / varchar(100)	是	否
code	模版代码/简号	string / varchar(100)	是	是
price_category_code	水价归属代码	string / varchar(100)	是	是	关联水价归属表
adjustment_snap_code	调价快照code	string / varchar(100)	否	是	关联水价调整快照（历史）表
meter_start	起开量	number / int	是	否
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价费用调整表-biz_price_cost_adjustment

水价费用调整表，记录每个水价归属下各费用组成的当前调价配置

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
template_id	水价模版id	number / bigint(64)	否	是	关联水价调整模版表
cost_component_code	费用组成代码	string / varchar(100)	否	是	关联费用组成表
calculation_mode	计算类型	number / int	否	默认1	详见常量说明计算类型
is_tiered	是否阶梯	boolean / bit(1)	否	默认0	0-非阶梯，1-阶梯
tiered_mode	阶梯类型	number / int	否	默认0	详见常量说明阶梯类型
tier_level	阶梯级别	number / int	否	默认0	第几阶梯，如1、2、3等 限制子表条数
volume_coefficient	水量系数	number / decimal(10,4)	否	默认1	用于特殊计算场景
charge_penalty	是否收取违约金	boolean / bit(1)	否	默认1	0-不收取，1-收取
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价阶梯调整表-biz_price_tier_adjustment

水价阶梯调整表，记录每个费用组成在不同阶梯下的当前收费规则

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
cost_adjustment_id	水价费用调整id	number / bigint(64)	否	是	关联水价费用调整表
cost_component_code	费用组成代码	string / varchar(100)	否	是	关联费用组成表
tier_level	阶梯级别	number / int	否	默认0	第几阶梯，如1、2、3等
start_volume	开始水量	number / decimal(15,3)	否	否	单位：立方米
end_volume	结束水量	number / decimal(15,3)	否	否	单位：立方米，为空表示无上限
price	价格	number / decimal(10,4)	否	是	单位：元/立方米或元（固定费用）
volume_coefficient	水量系数	number / decimal(10,4)	否	默认1	用于特殊计算场景
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价优惠方案表-biz_price_discount_scheme

水价优惠方案表，针对某个水价归属制定优惠方案，管理不同费用组成的优惠配置

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
scheme_name	方案名称	string / varchar(200)	否	是	如：居民用户优惠方案2024
scheme_code	方案代码	string / varchar(100)	是	是
template_code	水价模版代码	string / varchar(100)	否	是	关联水价调整模版表
discount_type	优惠方式	number / int	否	是	详见常量说明优惠方式
effective_date	生效日期	date	否	是
expiry_date	失效日期	date	否	否	为空表示长期有效
scheme_description	方案描述	string / varchar(1000)	否	否
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价优惠方案阶梯表-biz_price_discount_tier

水价优惠阶梯表，定义优惠方案的水量阶梯区间配置

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
scheme_id	优惠方案id	number / bigint(64)	否	是	关联水价优惠方案表
tier_level	阶梯级别	number / int	否	默认0	第几阶梯，如1、2、3等
start_volume	开始水量	number / decimal(15,3)	否	否	单位：立方米
end_volume	结束水量	number / decimal(15,3)	否	否	单位：立方米，为空表示无上限
include_in_tier	是否计入阶梯	boolean / bit(1)	否	默认1	0-不计入阶梯，1-计入阶梯
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水价优惠方案阶梯费用表-biz_price_discount_cost

水价优惠费用表，记录每个阶梯下各费用组成的具体优惠价格配置

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
tier_id	优惠阶梯id	number / bigint(64)	否	是	关联水价优惠阶梯表
cost_component_code	费用组成代码	string / varchar(100)	否	是	关联费用组成表
discount_price	优惠价格	number / decimal(10,4)	否	是	单位：元/立方米或元（固定费用）
sort	排序	number / int	否	默认0
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

用户表单字段配置-infra_user_form_config

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
user_id	用户ID	number / bigint(64)	否	否	个人配置时使用
role_id	角色ID	number / bigint(64)	否	否	角色配置时使用
config_type	配置类型	number / tinyint	否	是	1-个人配置，2-角色配置
menu_id	表格标识	string / varchar(100)	否	是	关联system_menu
column_key	列字段标识	string / varchar(100)	否	是
column_title	自定义列标题	string / varchar(100)	否	否
column_width	列宽度	number / int	否	否
is_visible	是否显示	number / int	否	默认1	0-隐藏，1-显示
is_printable	是否可打印	number / int	否	默认0	0-否，1-是
sort_order	排序序号	number / int	否	默认0
creator	创建人	string / varchar(64)	否	否
create_time	创建时间	datetime	否	默认当前时间
updater	更新人	string / varchar(64)	否	否
update_time	更新时间	datetime	否	默认当前时间	自动更新
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户编号	number / bigint(64)	否	默认0

计划用水方案-biz_water_use_scheme

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
name	方案名称	string / varchar(64)	否	否
price_category_code	水价归属	string / varchar(100)	是	是	关联水价归属表
scheme_cycle	开账/计划周期	number / int	否	否	计划用水周期（scheme_cycle）
scheme_type	计划模式	number / int	否	否	计划模式（scheme_type）
status	状态	number / int	否	默认0	详见常量说明默认状态
creator	创建人	string / varchar(64)	否	否
create_time	创建时间	datetime	否	默认当前时间
updater	更新人	string / varchar(64)	否	否
update_time	更新时间	datetime	否	默认当前时间	自动更新
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户编号	number / bigint(64)	否	默认0

计划用水方案阶梯-biz_water_use_scheme_tier

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
scheme_id	计划用水方案id	string / varchar(100)	否	是	关联计划用水方案
level	级别	string / varchar(64)	否	否
start_water	阶梯下限	number / int	否	否
end_water	阶梯上限	number / int	否	否
price	价格	number / decimal(10,4)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
creator	创建人	string / varchar(64)	否	否
create_time	创建时间	datetime	否	默认当前时间
updater	更新人	string / varchar(64)	否	否
update_time	更新时间	datetime	否	默认当前时间	自动更新
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户编号	number / bigint(64)	否	默认0

客户资料-biz_cust

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
cust_code	客户编号	string / varchar	否	否
cust_name	客户名称	string / varchar	否	否
cust_address	客户地址	string / varchar	否	否
cust_type	用户类型	number / int	否	否	详见客户类型枚举值
cust_group_code	客户组编号	string / varchar	否	是	关联客户组
cust_collect_code	集收编号	string / varchar	否	是	关联集收
certificate_type	证件类型	number / int	否	是	详见证件类型枚举值
certificate_account	证件号码	string / varchar	否	是
org_id	营业站点Id	number / int	否	否
area_id	所属小区Id	number / int	否	是
price_category_code	水价归属	string / varchar(100)	是	否	关联水价归属表
book_id	册本Id	number / int	否	否	关联册本
book_sort_index	册本序号	number / int	否	否
unit_no	单元号	string / varchar	否	是
contract_no	供水合同号	string / varchar	否	是
contract_date	供水合同签订日期	datetime	否	否
meter_id	启用水表ID	number / int	否	是	关联水表
pay_method	缴费方式	number / int	否	否	详见自助机缴费方式枚举值
pay_cust_code	付款户号	string / varchar	否	否
bill_type	开账类型	number / int	否	否
invoice_id	发票id	number / int	否	是	关联发票
statistical_type	统计分类	string / varchar	否	是	统计分类枚举值
population	人口数	number / int	否	否
is_over	是否超计划	boolean / tinyint	否	否	默认值: 0
is_preferential_scheme	是否低保优惠	boolean / tinyint	否	否	默认值: 0
preferential_scheme_id	优惠低保方案	number / int	否	是
is_we_chat	是否绑定微信	boolean / tinyint	否	否	默认值: 0
credit_rate	信用等级	number / int	否	否	默认值: 0
cust_state	客户状态	number / int	否	否	客户状态枚举值
build_date	立户时间	datetime	否	否
book_date	入册时间	datetime	否	是
transfer_date	过户时间	datetime	否	是
deactivate_date	停用时间	datetime	否	是
unregister_date	注销时间	datetime	否	是
garbage_remark	垃圾费备注	string / varchar	否	是
remark	备注	string / varchar	否	是
extra_properties	扩展字段内容	string / longtext	否	是
status	状态	number / int	否	默认0	详见常量说明默认状态
creator	创建人	string / varchar(64)	否	否
create_time	创建时间	datetime	否	默认当前时间
updater	更新人	string / varchar(64)	否	否
update_time	更新时间	datetime	否	默认当前时间	自动更新
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户编号	number / bigint(64)	否	默认0

客户组表-biz_cust_group

客户组管理表，用于管理集团客户或批量客户的分组信息，支持统一管理和批量操作

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键	number / bigint(64)	是	是
code	客户组编号	string / varchar(100)	是	是
name	客户组名称	string / varchar(200)	否	是
address	客户组地址	string / varchar(500)	否	否
type	客户组类型	number / int	否	否	详见常量说明客户组类型
legal_person	法人	string / varchar(100)	否	否
credit_code	统一社会信用代码	string / varchar(100)	否	否
certificate_type	证件类型	number / int	否	否	详见常量说明证件类型
certificate_account	证件号码	string / varchar(100)	否	否
contact	联系人	string / varchar(100)	否	否
mobile	联系电话	string / varchar(20)	否	否
telephone	座机	string / varchar(20)	否	否
email	邮箱	string / varchar(100)	否	否
fax	传真	string / varchar(20)	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

水表信息表-biz_meter

水表主档信息表，用于管理实物水表、远传采集标识、库存归属及表务状态，是客户挂表、抄表、换表、远传接入的核心基础表。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
dept_id	仓库/部门ID	number / bigint(64)	否	否	关联组织或仓库
maker_code	水表厂家代码	string / varchar(100)	否	否	关联biz_meter_maker
model_code	水表型号代码	string / varchar(100)	否	否	关联biz_meter_model
caliber_code	水表口径代码	string / varchar(100)	否	否	关联biz_meter_caliber
range_code	水表量程代码	string / varchar(100)	否	否	关联biz_meter_range
type	水表分类	number / tinyint	否	否	普通表/远传表等
cust_code	客户编号	string / varchar(100)	否	否	当前绑定客户
project_code	工程编码	string / varchar(100)	否	否	报装/工程来源标识
steel_mark	钢印号	string / varchar(100)	否	否
seal_number	水表编号	string / varchar(100)	否	否	表具编号
bar_code	条形码	string / varchar(100)	否	否
check_code	强检编号	string / varchar(100)	否	否
make_date	生产日期	datetime	否	否
check_date	强检日期	datetime	否	否
collect_code	采集号	string / varchar(100)	否	否	远传采集设备编号
gpsx	GPSX坐标	number / decimal(18,6)	否	否
gpsy	GPSY坐标	number / decimal(18,6)	否	否
latitude	纬度	number / decimal(18,6)	否	否
longitude	经度	number / decimal(18,6)	否	否
imei	设备识别码	string / varchar(100)	否	否	远传设备识别码
imsi	IMSI	string / varchar(100)	否	否
module_code	模块号	string / varchar(100)	否	否
nfc_code	NFC编号	string / varchar(100)	否	否
qr_code	二维码编号	string / varchar(100)	否	否
meter_status	表务状态	number / tinyint	否	否	水表生命周期状态
remark	备注	string / varchar(500)	否	否
status	状态	number / tinyint	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

抄表册本表-biz_meter_book

抄表册本主表，用于按站点、抄表员、周期组织客户抄表任务，是生成抄表数据与后续开账批次的基础对象。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
code	册本编码	string / varchar(100)	是	是
name	册本名称	string / varchar(200)	否	是
dept_id	站点ID	number / bigint(64)	否	是	关联部门/站点
meter_read_id	抄表员ID	number / bigint(64)	否	否
urger_id	催缴员ID	number / bigint(64)	否	否
read_cycle	抄表周期	number / tinyint	否	否	月/季/年等
start_date	起抄时间	datetime	否	否
next_read_date	下次抄表时间	datetime	否	否
read_method	抄表方式	number / tinyint	否	否	人工/远传等
is_temp	册本类型	number / tinyint	否	否	正式/临时
book_mark	册本标识	number / tinyint	否	否	特殊业务分类
work_times	工次	number / int	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / tinyint	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

抄表数据表-biz_reading_data

抄表作业数据表，承载每次抄表过程中的读数、状态、审核、复核、退补等信息，是开账与异常处理的直接数据来源。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
cust_id	客户ID	number / bigint(64)	否	是	关联客户资料
cust_meter_id	客户水表ID	number / bigint(64)	否	否	关联客户挂表关系
cust_meter_status	客户水表状态	number / int	否	否
dept_id	站点ID	number / bigint(64)	否	否
bill_month	抄表期间	number / int	否	是	格式YYYYMM
meter_reader_id	抄表员ID	string / varchar(100)	否	否
book_id	册本ID	number / bigint(64)	否	否	关联biz_meter_book
book_code	册本编号	string / varchar(100)	否	否
read_cycle	抄表周期	number / int	否	否
read_method	抄表方式	number / int	否	否
read_type	抄表类型	number / int	否	否	正常抄表/补抄等
read_times	抄表次数	number / int	否	否
last_reading	上次读数	number / decimal(18,4)	否	否
last_child_reading	上次子读数	number / decimal(18,4)	否	否
last_read_date	上次抄表日期	datetime	否	否
last_read_water	上次抄表水量	number / decimal(18,4)	否	否
last_read_state_id	上次抄表状态ID	number / bigint(64)	否	否
reading	本次读数	number / decimal(18,4)	否	否
child_reading	本次子读数	number / decimal(18,4)	否	否
read_date	抄表日期	datetime	否	否
read_water	抄表水量	number / decimal(18,4)	否	否
read_state_id	抄表状态ID	number / bigint(64)	否	否
is_estimate	是否估算	boolean / bit(1)	否	默认0
replace_water	替代表量	number / decimal(18,4)	否	否	换表或估算修正
avg_water	平均水量	number / decimal(18,4)	否	否
review_state	审核状态	number / int	否	否
review_user	审核人	string / varchar(100)	否	否
review_date	审核日期	datetime	否	否
check_water	复核水量	number / decimal(18,4)	否	否
check_state	复核状态	number / int	否	否
check_user	复核人	string / varchar(100)	否	否
check_date	复核日期	datetime	否	否
read_remark	抄表备注	string / varchar(500)	否	否
refund_reason	退费原因	number / int	否	否
refund_water	退费水量	number / decimal(18,4)	否	否
status	状态	number / int	否	默认0	抄表记录状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

上次抄表表-biz_last_reading

上次抄表快照表，用于为下一期抄表、开账、阶梯累计和异常核算提供基线数据。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
cust_id	客户ID	number / bigint(64)	否	是
cust_code	客户编号	string / varchar(100)	否	是
bill_month	抄表年月	number / int	否	是	格式YYYYMM
read_date	抄表时间	datetime	否	否
reading	抄码	number / decimal(18,4)	否	否
child_reading	子表抄码	number / decimal(18,4)	否	否
read_water	抄见水量	number / decimal(18,4)	否	否
replace_water	换表水量	number / decimal(18,4)	否	否
read_state_id	抄表状态	number / bigint(64)	否	否
state_times	状态连续次数	number / int	否	否
check_water	开账水量	number / decimal(18,4)	否	否
change	零头	number / decimal(18,4)	否	否
check_times	开账次数	number / int	否	否
month_total_water	月度累计量	number / decimal(18,4)	否	否
quarter_total_water	季度累计量	number / decimal(18,4)	否	否
year_total_water	年度累计量	number / decimal(18,4)	否	否
his_read_water	历史抄见水量	string / longtext	否	否	历史轨迹记录
remark	备注	string / varchar(500)	否	否
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

营业账表-biz_charge

营业账主表，是营收系统最核心的账务表之一，汇总客户、册本、抄表、用水量、金额、收费、开票、优惠等信息。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
meter_id	水表ID	number / bigint(64)	否	是	关联水表
record_id	抄表ID	number / bigint(64)	否	否	关联biz_reading_data
bill_month	账务年月	number / int	否	是	格式YYYYMM
dept_id	站点ID	number / bigint(64)	否	否
book_id	册本ID	number / bigint(64)	否	否
book_sort_index	册内顺序	number / int	否	否
cust_id	客户ID	number / bigint(64)	否	是
cust_code	客户编号	string / varchar(100)	否	否
cust_name	客户名称	string / varchar(200)	否	否
cust_address	客户地址	string / varchar(500)	否	否
population	人口数	number / int	否	否
pay_method	缴费方式	number / int	否	否	详见常量说明缴费方式
last_reading	上次抄码	number / decimal(18,4)	否	否
reading	本次抄码	number / decimal(18,4)	否	否
read_water	本次抄见水量	number / decimal(18,4)	否	否
read_date	本次抄表时间	datetime	否	否
adjustment_snap_code	调价快照编码	string / varchar(100)	否	否	关联biz_price_adjustment_snap
price_template_code	水价模板编码	string / varchar(100)	否	否	关联biz_price_template
bill_water	开账水量	number / decimal(18,4)	否	否
bill_amount	开账金额	number / decimal(18,4)	否	否
extended_amount	应收金额	number / decimal(18,4)	否	否
late_fee	滞纳金	number / decimal(18,4)	否	否
pay_date	收费时间	datetime	否	否
checkout_date	结账时间	datetime	否	否
charge_method	收费途径	number / int	否	否	柜台/线上/批量等
charge_way	收费渠道	number / int	否	否	渠道分类
pay_state	收费状态	number / int	否	否	详见常量说明收费状态
invoice_code	发票代码	string / varchar(100)	否	否
invoice_date	开票日期	datetime	否	否
invoice_number	发票编号	string / varchar(100)	否	否
invoice_state	开票状态	number / int	否	否
subtotal_id	收费小计ID	number / bigint(64)	否	否
task_id	流程任务ID	string / varchar(100)	否	否
water_fee	用水费	number / decimal(18,4)	否	否
sewage_fee	污水处理费	number / decimal(18,4)	否	否
garbage_fee	垃圾费	number / decimal(18,4)	否	否
over_plan_fee	超计划费	number / decimal(18,4)	否	否
discount_money	优惠金额	number / decimal(18,4)	否	否
original_money	优惠前金额	number / decimal(18,4)	否	否
refund_water	退补水量	number / decimal(18,4)	否	否
used_over_total	超计划累计量	number / decimal(18,4)	否	否
community_id	所属小区ID	number / bigint(64)	否	否
cust_type	用户类型	number / int	否	否
status	状态	number / int	否	默认0
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

营业账明细表-biz_charge_detail

营业账明细表，用于分解营业账中的费用组成、阶梯区间、分摊方式、金额构成，是计费规则落地的明细层对象。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
fee_id	费用ID	number / bigint(64)	否	是	关联biz_charge
adjustment_snap_code	调价快照编码	string / varchar(100)	否	否
price_template_code	水价模板编码	string / varchar(100)	否	否
cost_adjustment_id	费用调整ID	number / bigint(64)	否	否	关联biz_price_cost_adjustment
cost_component_code	费用组成代码	string / varchar(100)	否	否	关联biz_cost_component
calc_mode	计算方式	number / int	否	否	详见常量说明计算类型
level_type	阶梯模式	number / int	否	否	详见常量说明阶梯类型
level_index	阶梯级别	number / int	否	否
start_month	开始月份	number / int	否	否
end_month	结束月份	number / int	否	否
start_water	开始水量	number / decimal(18,4)	否	否
end_water	结束水量	number / decimal(18,4)	否	否
settle_method	分摊方式	number / int	否	否	详见常量说明分摊方式
settle_values	分摊值	number / decimal(18,4)	否	否
price	单价	number / decimal(18,4)	否	否
water	应收水量	number / decimal(18,4)	否	否
discount_water	优惠水量	number / decimal(18,4)	否	否
water_num	水量系数	number / decimal(18,4)	否	否
money	金额	number / decimal(18,4)	否	否
state	状态	number / int	否	否	明细状态
is_preferential	是否优惠	boolean / tinyint	否	默认0
basic_number	基数	number / decimal(18,4)	否	否
invoiced_state	开票状态	number / int	否	否
discount_money	优惠金额	number / decimal(18,4)	否	否
original_money	优惠前金额	number / decimal(18,4)	否	否
is_water_over	是否超计划	boolean / tinyint	否	默认0
item_invoice_error	明细开票错误	string / varchar(500)	否	否
item_invoice_state	明细开票状态	number / int	否	否
item_invoice_type	明细开票类型	number / int	否	否
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

托收资料表-biz_collection

托收资料主表，用于维护用户托收协议、银行账户、签约联系方式等信息，支撑批量托收与银行送盘业务。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
contract_no	托收合同号	string / varchar(100)	否	否
agreement_no	托收协议号	string / varchar(100)	否	否
bank_id	总行ID	number / bigint(64)	否	否	关联biz_bank
branchs_id	分行ID	number / bigint(64)	否	否	关联biz_bank_branch
account_no	银行账号	string / varchar(100)	否	否
account_name	开户户名	string / varchar(200)	否	否
account_address	开户地址	string / varchar(500)	否	否
contact	联系人	string / varchar(100)	否	否
mobile	联系电话	string / varchar(100)	否	否	可脱敏/加密存储
telephone	座机	string / varchar(100)	否	否	可脱敏/加密存储
contract_date	签约日期	datetime	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

代扣资料表-biz_withholding

银行代扣资料主表，用于维护代扣合同、账户、银行分支和签约信息，支撑批量代扣与银行代扣协议管理。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
bank_id	总行ID	number / int	否	否	关联biz_bank
branchs_id	分行ID	number / int	否	否	关联biz_bank_branch
account_no	银行账号	string / varchar(100)	否	否
account_name	开户户名	string / varchar(200)	否	否
account_address	开户地址	string / varchar(500)	否	否
contract_date	签约日期	datetime	否	否
contract_no	代扣合同号	string / varchar(100)	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0	详见常量说明默认状态
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

开票配置表-biz_invoice

开票配置主表，用于维护水司账户维度的发票供应商、开票限额、自动开票策略和扩展参数。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
account_id	水司账户ID	number / bigint(64)	否	是	关联biz_company_account
supplier	供应商ID	number / int	否	否
supplier_name	供应商名称	string / varchar(200)	否	否
limit	开票限额	number / decimal(18,4)	否	否	单次开票最大金额
before_charge	收费前开票	boolean / tinyint	否	默认0	0-否，1-是
ex_cost_component_codes	排除费用组成代码	string / varchar(500)	否	否	多个逗号分隔
extra_properties	扩展参数	string / longtext	否	否	JSON扩展字段
auto_invoice	自动开票	boolean / tinyint	否	默认0	0-否，1-是
invoice_type	开票类型	number / tinyint	否	否	普票/专票
include_invoice_special	包含专票客户	boolean / tinyint	否	默认0
status	状态	number / tinyint	否	默认0
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

基础工单信息表-biz_process

统一业务工单主表，用于承载更名、过户、停复水、换表、发票变更等业务办理流程，是当前后端流程化业务模型的核心表。

字段名	中文含义	字段类型	是否唯一	是否必填	字段说明
id	主键ID	number / bigint(64)	是	是
request_source_code	来源编码	string / varchar(100)	否	否	申请来源
applicant	申请人	string / varchar(100)	否	否
mobile	申请人手机号码	string / varchar(100)	否	否
telephone	座机	string / varchar(100)	否	否
cust_id	客户ID	number / int	否	否
cust_code	客户编号	string / varchar(100)	否	否
org_name	营业站点名称	string / varchar(200)	否	否
cust_name	客户名称	string / varchar(200)	否	否
cust_address	客户地址	string / varchar(500)	否	否
contact	联系人信息	string / varchar(200)	否	否
apply_type	申请原因	number / int	否	否
apply_date	申请时间	datetime	否	否
acceptance_name	受理人姓名	string / varchar(100)	否	否
acceptance_id	受理人ID	string / varchar(100)	否	否
acceptance_time	受理时间	datetime	否	否
state	工单状态	number / int	否	否
review_reasons	审批备注	string / varchar(500)	否	否
review_opinion	审批意见	string / varchar(500)	否	否
business_type	业务类型	number / int	否	否
business_id	业务单ID	number / int	否	否	关联具体业务单
process_state	流程状态	string / varchar(100)	否	否	工作流状态
business_code	业务类型编码	string / varchar(100)	否	否
process_instance_id	流程实例ID	string / varchar(100)	否	否	工作流实例
contact_mobile	主联系人手机	string / varchar(100)	否	否
affairs_project_code	一网通办项目编码	string / varchar(100)	否	否
affairs_project_content	一网通办内容	string / longtext	否	否	JSON内容
affairs_project_state	一网通办状态	string / varchar(100)	否	否
affairs_project_type	一网通办类型	number / int	否	否
cust_type	客户类型	number / int	否	否
user_id	小程序用户ID	string / varchar(100)	否	否
remark	备注	string / varchar(500)	否	否
status	状态	number / int	否	默认0
create_time	创建时间	datetime	否	否
update_time	更新时间	datetime	否	否
creator	创建人id	string / varchar(100)	否	否
updater	更新人id	string / varchar(100)	否	否
deleted	是否删除	boolean / bit(1)	否	默认0
tenant_id	租户id	number / bigint(64)	否	默认0

数据库备份与安全

（说明数据备份方式备份周期以及数据安全控制等等）