## 文档概述 ### 文档目的 *（说明编写文档目的, 如：本文档主要为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图 ```mermaid 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图 ```mermaid 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图 ```mermaid 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图 ```mermaid 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图 ```mermaid 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 : "方案代码关联阶梯" ``` ### 水价调整关系图 ```mermaid erDiagram %% 顶层：水价归属和调价快照 biz_price_category["biz_price_category
水价归属表"] { 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
水价调整快照表"] { 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
水价模版表"] { 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
费用组成表"] { 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
水价费用调整表"] { 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
水价阶梯调整表"] { 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
系统部门表"] { 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
水价模版部门关系表"] { 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[水表厂家表](###水表厂家表-biz_meter_maker) | | name | 型号名称 | string / varchar(100) | 否 | 否 | | | code | 型号代码 | string / varchar(100) | 是 | 是 | | | caliber_range | 口径范围 | string / varchar(200) | 否 | 否 | 如：DN15-DN200 | | remark | 备注 | string / varchar(500) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) | | account_id | 水司账户id | number / bigint(64) | 否 | 是 | 关联[水司账户表](###水司账户表-biz_company_account) | | remark | 备注 | string / varchar(500) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) | | template_code | 水价调整模版代码 | string / varchar(100) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) | | adjustment_snap_code | 调价快照code | string / varchar(100) | 否 | 是 | 关联[水价调整快照（历史）表](###水价调整快照（历史）表-biz_price_adjustment_snap) | | is_default | 是否默认 | boolean / bit(1) | 否 | 默认0 | 该部门是否默认使用此水价模版 | | remark | 备注 | string / varchar(500) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 是 | 是 | 关联[水价归属表](###水价归属表-biz_price_category) | | adjustment_snap_code | 调价快照code | string / varchar(100) | 否 | 是 | 关联[水价调整快照（历史）表](###水价调整快照（历史）表-biz_price_adjustment_snap) | | meter_start | 起开量 | number / int | 是 | 否 | | | sort | 排序 | number / int | 否 | 默认0 | | | remark | 备注 | string / varchar(500) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) | | cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 是 | 关联[费用组成表](###费用组成表-biz_cost_component) | | calculation_mode | 计算类型 | number / int | 否 | 默认1 | 详见常量说明[计算类型](###计算类型-calculation_mode) | | is_tiered | 是否阶梯 | boolean / bit(1) | 否 | 默认0 | 0-非阶梯，1-阶梯 | | tiered_mode | 阶梯类型 | number / int | 否 | 默认0 | 详见常量说明[阶梯类型](###阶梯类型-tiered_mode) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[水价费用调整表](###水价费用调整表-biz_price_cost_adjustment) | | cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 是 | 关联[费用组成表](###费用组成表-biz_cost_component) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) | | discount_type | 优惠方式 | number / int | 否 | 是 | 详见常量说明[优惠方式](###优惠方式-discount_type) | | effective_date | 生效日期 | date | 否 | 是 | | | expiry_date | 失效日期 | date | 否 | 否 | 为空表示长期有效 | | scheme_description | 方案描述 | string / varchar(1000) | 否 | 否 | | | sort | 排序 | number / int | 否 | 默认0 | | | remark | 备注 | string / varchar(500) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[水价优惠方案表](###水价优惠方案表-biz_price_discount_scheme) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 否 | 是 | 关联[水价优惠阶梯表](###水价优惠阶梯表-biz_price_discount_tier) | | cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 是 | 关联[费用组成表](###费用组成表-biz_cost_component) | | discount_price | 优惠价格 | number / decimal(10,4) | 否 | 是 | 单位：元/立方米或元（固定费用） | | sort | 排序 | number / int | 否 | 默认0 | | | remark | 备注 | string / varchar(500) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) | | 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) | 是 | 是 | 关联[水价归属表](app://obsidian.md/index.html###水价归属表-biz_price_category) | | scheme_cycle | 开账/计划周期 | number / int | 否 | 否 | [计划用水周期（scheme_cycle）](计划用水周期（scheme_cycle）) | | scheme_type | 计划模式 | number / int | 否 | 否 | [计划模式（scheme_type）](计划模式（scheme_type）) | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) | | 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) | 否 | 是 | 关联[计划用水方案](app://obsidian.md/index.html###计划用水方案-biz_water_use_scheme) | | level | 级别 | string / varchar(64) | 否 | 否 | | | start_water | 阶梯下限 | number / int | 否 | 否 | | | end_water | 阶梯上限 | number / int | 否 | 否 | | | price | 价格 | number / decimal(10,4) | 否 | 否 | | | status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) | | 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_type）)枚举值 | | cust_group_code | 客户组编号 | string / varchar | 否 | 是 | 关联客户组 | | cust_collect_code | 集收编号 | string / varchar | 否 | 是 | 关联集收 | | certificate_type | 证件类型 | number / int | 否 | 是 | 详见[证件类型](#证件类型（certificate_type）)枚举值 | | certificate_account | 证件号码 | string / varchar | 否 | 是 | | | org_id | 营业站点Id | number / int | 否 | 否 | | | area_id | 所属小区Id | number / int | 否 | 是 | | | price_category_code | 水价归属 | string / varchar(100) | 是 | 否 | 关联[水价归属表](app://obsidian.md/index.html###水价归属表-biz_price_category) | | 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 | 否 | 否 | 详见[自助机缴费方式](#自助机缴费方式（counter_am_type）)枚举值 | | 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 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) | | 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 | 否 | 否 | 详见常量说明[客户组类型](###客户组类型（cust_group_type）) | | legal_person | 法人 | string / varchar(100) | 否 | 否 | | | credit_code | 统一社会信用代码 | string / varchar(100) | 否 | 否 | | | certificate_type | 证件类型 | number / int | 否 | 否 | 详见常量说明[证件类型](###证件类型（certificate_type）) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 否 | 否 | 详见常量说明[缴费方式](#payment_method) | | 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 | 否 | 否 | 详见常量说明[收费状态](#charge_status) | | 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 | 否 | 否 | 详见常量说明[计算类型](#calculation_mode) | | level_type | 阶梯模式 | number / int | 否 | 否 | 详见常量说明[阶梯类型](#tiered_mode) | | 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 | 否 | 否 | 详见常量说明[分摊方式](#allocation_method) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | 详见常量说明[默认状态](###默认状态-default_status) | | 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 | | ## 数据库备份与安全 *（说明数据备份方式备份周期以及数据安全控制等等）*