## 文档概述
### 文档目的
*（说明编写文档目的, 如：本文档主要为xxx项目的数据库设计说明，为用户设计接口及研发提供参照）*
### 适用范围
*（说明文档使用范围, 如：本文档适用于研发、运维人员等。。。）*
### 参考资料
*（列举参考的文献来源）*
| 序号 | 文献名称 |
| -------------------------------------- | --------------------------------------------------- |
| *[1]* | *《软件架构设计》* |
| | |
## 术语、缩略语说明
| 术语、缩写 | 解释 | 更多说明 |
| ----- | -------------------- | ---------------------- |
| 水司 | 水务集团下的各个地区公司 | 在系统里表示租户，不同水司对应不同租户 |
| 分公司 | 水司下的各个分公司 | 在系统里表示部门，一般是顶级部门，下面是站点 |
| 站点 | 全名：营业站点，用于划分用户所属管辖区域 | 在系统里表示部门，对应部门管理，支持数据隔离 |
| 待补充 | | |
## 公共常量约定
### 默认状态-default_status
> 默认状态
| 编码 | 中文含义 |
| --- | ---- |
| 0 | 是 |
| 1 | 否 |
### 部门类型-dept_type
> 默认状态
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 分公司 |
| 1 | 站点 |
---
## 客户相关字典
### 客户组类型（cust_group_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 居民 |
| 2 | 单位 |
| 3 | 特业 |
### 客户类型（cust_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 居民 |
| 2 | 非居民 |
### 客户状态（cust_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 正常 |
| 1 | 新装 |
| 2 | 停用 |
| 3 | 注销 |
| 4 | 欠费停水 |
### 主副卡客户类型（cust_bill_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 普通客户 |
| 2 | 主客户 |
| 3 | 附属客户 |
### 联系人类型（contact_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 主联系人 |
| 2 | 副联系人 |
### 停用类型（deactivate_method）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户报停 |
| 2 | 内部停用 |
| 3 | 司法停用 |
### 证件类型（certificate_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 身份证 |
| 2 | 军人证 |
| 3 | 户口本 |
| 4 | 护照 |
| 5 | 营业执照 |
### 更名原因（rename_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 产权变更 |
| 2 | 房屋买卖 |
| 3 | 输入错误 |
| 4 | 其他 |
### 过户原因（transfer_reason）
| 编码 | 中文含义 |
| ---- | ------------------ |
| 1 | 用户资料信息有误 |
| 2 | 用户申请 |
| 3 | 其他 |
### 表卡停用原因（stop_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户申请 |
| 2 | 无人使用 |
### 表卡注销原因（logout_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户申请 |
| 2 | 拆迁 |
| 3 | 其他 |
### 表卡恢复原因（restore_reason）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 用户申请 |
| 2 | 欠费停水恢复 |
| 3 | 其他 |
### 表卡恢复类型（restore_type）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 内部停用恢复 |
| 2 | 用户保停恢复 |
---
## 抄表相关字典
### 抄表周期（meter_cycle）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 每月抄 |
| 2 | 单月抄 |
| 3 | 双月抄 |
| 4 | 季度抄 |
| 5 | 一月多抄 |
| 6 | 每隔二月抄 |
| 7 | 半年抄 |
| 8 | 一年抄 |
### 抄表周期类型（meter_cycle_type）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 当前周期 |
| 2 | 全部 |
| 3 | 非当前周期 |
### 抄表算法（reading_algorithm）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 正常算法 |
| 2 | 过圈算法 |
| 3 | 水量无关 |
| 4 | 倒装算法 |
| 5 | 无量算法 |
| 6 | 估表算法 |
### 抄表方式（read_method）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 手工抄表 |
| 2 | 抄表机 |
| 3 | 远传表上传 |
| 4 | excel导入 |
| 5 | 客户自抄 |
### 抄表类型（read_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 正常抄表 |
| 2 | 追加抄表 |
| 3 | 销户拆表 |
### 抄表进度（record_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 未抄 |
| 1 | 已抄 |
| 3 | 外复 |
### 开账状态（check_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 已开账 |
| 2 | 已抄表 |
| 3 | 已复核 |
| 4 | 未抄表 |
### 加抄原因（append_reason）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 抄表员抄表错误 |
| 2 | 水表检测不合格 |
---
## 水表相关字典
### 水表关系分类（meter_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 单表 |
| 2 | 总表 |
| 3 | 分表 |
| 4 | 子母表 |
| 5 | 虚表 |
| 6 | 无表 |
### 水表类型（meter_oth_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 普通表 |
| 2 | 消防表 |
| 5 | 远传表 |
| 6 | 校对表 |
### 水表功能分类（meter_sort）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 开账 |
| 2 | 计量 |
### 水表状态（meter_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 正常 |
| 1 | 新装 |
| 2 | 换表 |
| 3 | 拆下 |
### 换表原因（replace_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户申请 |
| 2 | 水司定检 |
| 3 | 其它 |
### 换表类型（replace_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 故障换表 |
| 2 | 批量换表 |
### 移表原因（move_meter_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 客户自报 |
| 2 | 施工 |
| 3 | 其它 |
### 拆表原因（remove_meter_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 销户拆表 |
| 2 | 欠费拆表 |
| 3 | 临时停用 |
| 4 | 其它 |
### 表务状态（mw_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 入库 |
| 2 | 出库 |
| 3 | 水表上线 |
| 4 | 水表下线 |
| 5 | 报废 |
| 6 | 报损 |
| 7 | 报修 |
| 8 | 丢失 |
---
## 收费相关字典
### 收费途径（charge_method）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 柜台 |
| 2 | 第三方 |
| 3 | 自动销账 |
### 收费渠道（charge_way）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 现金 |
| 2 | POS |
| 3 | 凭证 |
| 4 | 扫码支付 |
| 5 | 自动机缴费 |
| 6 | 实时收费 |
| 7 | 银行代扣 |
| 8 | 银行托收 |
| 9 | 支付宝 |
| 10 | 微信 |
| 11 | 预存抵扣 |
### 缴费方式（pay_method）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 现金 |
| 2 | 代扣 |
| 3 | 托收 |
### 收费状态（pay_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 未收 |
| 1 | 已收 |
| 2 | 已结 |
| -1 | 呆账 |
| -2 | 坏账 |
| -3 | 纠纷账 |
### 收费类型（fee_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 账单 |
| 2 | 预存 |
| 3 | 特账 |
| 4 | 退款 |
| 5 | IC卡 |
### 凭证类型（cheque_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 转账凭证 |
| 2 | 转账支票 |
### 自助机缴费方式（counter_am_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 微信 |
| 2 | 支付宝 |
| 3 | 银行卡 |
| 4 | 现金 |
| 5 | 其它 |
### pos收费类型（counter_pos_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 银行卡 |
| 2 | 支付宝 |
| 3 | 微信 |
### 扫码付款方式（counter_scan_type）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 微信扫码 |
| 2 | 支付宝扫码 |
| 3 | 银行卡 |
| 4 | 其它 |
---
## 发票相关字典
### 发票分类（invoice_category）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 增值税普票 |
| 2 | 增值税专票 |
| 4 | 财政发票 |
### 发票种类（invoice_type）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 增值税普票 |
| 2 | 增值税专票 |
### 发票类型（invoice_way）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 账单发票 |
| 2 | 红冲发票 |
| 3 | 增值税发票 |
### 发票状态（invoice_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 正常 |
| 1 | 作废 |
### 发票推送方式（invoice_push_method）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 短信 |
| 2 | 微信 |
| 3 | 邮件 |
| 4 | 邮寄 |
### 合并方式（invoice_merge_way）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 全部 |
| 2 | 客户编号 |
| 3 | 付款户号 |
| 4 | 集收编号 |
| 5 | 托收合同号 |
| 6 | 代扣合同号 |
| 7 | 银行帐号 |
### 零税率标识（tax_rate_mark）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 免税 |
| 2 | 不征税 |
| 3 | 普通零税率 |
| 4 | 非零税率 |
---
## 账务相关字典
### 特账状态（emporary_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 未收 |
| 1 | 已收 |
| 2 | 已结 |
### 特账类型（special_bill）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 稽查补交 |
| 2 | 其它 |
### 阶梯模式（ladder_mode）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 年度阶梯 |
| 2 | 月度阶梯 |
| 3 | 季度阶梯 |
### 预存调整原因（deposit_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 充值错误 |
| 2 | 动迁销户 |
| 3 | 其它 |
### 预存调整类型（deposit_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 预存退款 |
| 2 | 预存转账 |
### 调整减免原因（amount_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 抄表错误 |
| 2 | 用户协商 |
| 3 | 其它 |
### 调整减免类型（amount_type）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 按水量 |
| 2 | 按费用组成 |
### 违约金减免原因（late_fee_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户协商 |
| 2 | 其它 |
### 违约金减免类型（late_fee_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 按金额 |
| 2 | 按日期 |
### 价差调整原因（price_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户协商 |
| 2 | 定价错误 |
| 3 | 其它 |
### 分账调整原因（separate_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 一表多户 |
| 2 | 其它 |
### 分账调整类型（separate_type）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 按水量 |
| 2 | 按费用组成 |
### 呆坏账原因（knotty_reason）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 用户争议 |
| 2 | 长期未收回 |
| 3 | 动迁销户 |
| 4 | 其它 |
### 呆坏账类型（knotty_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 呆账 |
| 2 | 坏账 |
| 3 | 纠纷账 |
### 已销调整原因（payment_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 多抄误抄 |
| 2 | 充错用户 |
| 3 | 其它 |
### 账务处理方式（proc_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 转预存 |
| 2 | 转退款 |
| 3 | 转销账 |
| 4 | 线下退款 |
### 分摊方式（settle_method）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 按水量 |
| 2 | 按比例 |
| 3 | 其它 |
| 4 | 按累计水量 |
### 结算方案（settle_type）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 按实际水量 |
| 2 | 按固定水量 |
| 3 | 按人口数 |
| 4 | 按最低消费水量 |
### 进出标志（acc_in_out）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 进 |
| 2 | 出 |
### 暂收类型（acc_log_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 扣款 |
| 2 | 预存 |
| 3 | 转预存 |
---
## 系统相关字典
### 机构类型（org_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 集团 |
| 2 | 总公司 |
| 3 | 分公司 |
| 4 | 营业所 |
| 5 | 收费站 |
### 日志类型（log_type）
| 编码 | 中文含义 |
| ---- | ---------------- |
| 1 | 基础资料变更 |
| 2 | 水表信息变更 |
| 3 | 客户更名 |
| 4 | 客户过户 |
| 5 | 客户销户 |
| 6 | 客户停用 |
| 7 | 客户恢复 |
| 8 | 水价变更 |
| 9 | 低保申请 |
| 10 | 修改上期抄码 |
| 11 | 修改累积量 |
| 12 | 新增客户 |
| 13 | 客户分组信息变更 |
| 14 | 集收信息变更 |
| 15 | 册本信息变更 |
| 16 | 抄表数据调整 |
| 17 | 撤销抄表数据 |
| 18 | 复核 |
| 19 | 开账 |
| 20 | 取消复核 |
| 21 | 撤销开账 |
| 22 | 费用组成调整 |
| 23 | 用户信息变更 |
| 24 | 重置用户密码 |
| 25 | 角色信息变更 |
| 26 | 权限信息变更 |
| 27 | 抄表状态信息变更 |
| 28 | 词语信息变更 |
| 29 | 系统参数信息变更 |
| 30 | 用户登录 |
| 31 | 用户登出 |
| 32 | 修改用户密码 |
| 33 | 用户基础信息变更 |
### 权限模块（purview_mode）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 客户资料 |
| 2 | 抄表开账 |
| 3 | 营业收费 |
| 4 | 综合查询 |
| 5 | 代收业务 |
| 6 | 账务处理 |
| 7 | 系统配置 |
| 8 | 发票管理 |
| 9 | 微客服 |
| 10 | 业务工单 |
| 11 | 手机抄表 |
| 12 | 催缴停水 |
| 13 | 工程管理 |
| 14 | 表务管理 |
| 15 | 消息系统 |
| 16 | 环卫系统 |
### 权限分类（purview_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 查询 |
| 2 | 操作 |
| 3 | 报表 |
### 用户分组（user_category）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 企业内 |
| 2 | 外聘人员 |
| 3 | 其它 |
### 柜台查询条件（search_types）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 客户编号 |
| 2 | 集收编号 |
| 7 | 模糊查询 |
---
## 工单相关字典
### 工单类型（work_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 换表工单 |
| 2 | 维修工单 |
| 3 | 移表工单 |
| 4 | 拆表工单 |
### 问题上报类型（qus_report_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 换表申请 |
| 2 | 停水申请 |
| 3 | 复水申请 |
| 4 | 用户纠纷 |
| 5 | 其它 |
### 工程申请类型（project_apply_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 一户一表 |
| 2 | 批量立户 |
| 3 | 临时用水 |
| 4 | 其它 |
---
## 其他字典
### 计算方式（calc_method）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 按水量计算 |
| 2 | 按人口数计算 |
| 3 | 固定金额 |
| 4 | 按户数计算 |
### 业务类型（business_type）
| 编码 | 中文含义 |
| ---- | ------------ |
| 101 | 更名 |
| 102 | 过户 |
| 103 | 停用 |
| 104 | 启用 |
| 105 | 注销 |
| 106 | 恢复 |
| 107 | 水价变更 |
| 108 | 低保申请 |
| 109 | 联系方式变更 |
| 110 | 人口数变更 |
| 111 | 优惠申请 |
| 112 | 发票信息变更 |
| 113 | 阶梯量调整 |
| 114 | 垃圾费基数变更 |
| 115 | 托收资料 |
| 116 | 签订供水合同 |
| 117 | 电子档案 |
| 140 | 水表图片 |
| 141 | 问题上报 |
| 142 | 换表工单 |
| 143 | 移表工单 |
| 144 | 停水复水 |
| 145 | 稽查工单 |
| 146 | 拆表工单 |
| 160 | 用户报装 |
| 161 | 入库出库 |
| 201 | 预存调整 |
| 202 | 调整减免 |
| 203 | 呆坏账 |
| 204 | 违约金减免 |
| 205 | 价差调整 |
| 206 | 已销调整 |
| 207 | 分账调整 |
| 208 | 疑难 |
| 209 | 重笔 |
| 210 | 垃圾费减免 |
| 305 | 自助抄表 |
### 低保申请原因（lowinsured_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 定位变化 |
| 2 | 水价减免 |
| 3 | 用户申请 |
### 人口数变更原因（person_change_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 定位变化 |
| 2 | 水价减免 |
| 3 | 用户申请 |
### 水价变更原因（price_change_reason）
| 编码 | 中文含义 |
| ---- | ------------------------ |
| 1 | 查勘定价错误 |
| 2 | 用户实际用水性质变更 |
| 3 | 其它 |
### 优惠方式（preferential_type）
| 编码 | 中文含义 |
| ---- | -------------- |
| 1 | 按次优惠 |
| 2 | 按月优惠 |
| 3 | 按季优惠 |
| 4 | 按年优惠 |
| 5 | 无限期定量优惠 |
### 优惠模式（preferential_mode）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 按水量 |
| 2 | 按价格 |
### 优惠原因（preferential_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 用户申请 |
| 2 | 其它 |
### 计划用水周期（plan_cycle）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 月 |
| 2 | 季 |
| 3 | 年 |
### 计划模式（plan_type）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 超计划 |
| 2 | 非居民阶梯 |
### 垃圾费单价（garbage_price）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 1 |
### 垃圾费类型（garbage_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 居民户数 |
| 2 | 商铺面积 |
| 3 | 单位人数 |
| 4 | 宾馆床位 |
| 5 | 其它 |
### 环卫退补原因（garbage_adjust_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 店铺停业 |
| 2 | 低保户 |
| 3 | 退还 |
| 4 | 其它 |
### 催缴方式（arrearage_rreminder_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 催缴单 |
| 2 | 短信 |
| 3 | 电话 |
| 4 | 微信 |
| 5 | 其它 |
### 催缴原因（arrearage_rreminder_reason）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 长期未缴费 |
| 2 | 过户拆迁 |
| 3 | 法律纠纷 |
| 4 | 其它 |
### 册本调整类型（book_adjust_type）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 新卡入册 |
| 2 | 册内序号调整 |
| 3 | 册本间调整 |
### 册本标识（book_mark）
| 编码 | 中文含义 |
| ---- | ------------ |
| 1 | 机械表册本 |
| 2 | 远传表册本 |
| 3 | IC卡表册本 |
### 册本状态（book_state）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 正常 |
| 1 | 停用 |
### 表册类型（book_type）
| 编码 | 中文含义 |
| ---- | -------- |
| 0 | 临时册本 |
| 1 | 正式册本 |
### 附件类型（business_file_type）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 身份证正面 |
| 2 | 身份证反面 |
| 3 | 房产证 |
| 4 | 供用水合同 |
| 5 | 营业执照 |
| 6 | 业务申请单 |
| 7 | 户口本 |
| 8 | 护照 |
| 9 | 其它附件 |
### 打印模板（bill_model）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1001 | 账单打印 |
| 1002 | 催缴单打印 |
### 停水原因（stopwater_reason）
| 编码 | 中文含义 |
| ---- | ---------- |
| 1 | 长期未缴费 |
| 2 | 房屋动迁 |
| 3 | 其它 |
### 复水原因（recoverwater_reason）
| 编码 | 中文含义 |
| ---- | -------- |
| 1 | 欠费缴清 |
| 2 | 恢复用水 |
| 3 | 其它 |
### 统计分类（statistical_type）
| 编码 | 中文含义 |
| ---- | -------- |
| | |
## 数据库环境说明
*（说明部署环境、工具、存放位置等）*
### 命名规范
* 表名前面加上特定业务模块名称，例如：
* 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图说明实体及实体间 一对一、一对多、多对多的关系）*
## 物理设计
*（说明是否采用分布式数据库、数据库表分部，存储空间等安排）*
## 表结构设计
### 水表厂家表-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) | 否 | 否 | |
| code | 口径代码 | 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 | |
### 水表出/入库单-biz_meter_in_out
> 水表入库出库单，负者水表的出入库
| 字段名 | 说明 | 类型 | 是否唯一 | 是否必填 | 备注 |
| -------------- | ------ | --------------------- | ---- | ---- | ------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| dept_id | 营业站点 | number / bigint(64) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) |
| pay_code | 采购单编号 | varchar | 是 | 否 | |
| stock_code | 库存单编号 | varchar | 是 | 是 | RK/CK + 6位随机 |
| stock_type | 库存单类型 | int | 否 | 是 | 1=入库，2=出库 |
| operation_user | 出/入库人 | char | 否 | 是 | 记入用户名 |
| operation_time | 出/入库时间 | 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_meter_in_out_rel
> 水表入库出库单详情，多对多关联具体水表
| 字段名 | 说明 | 类型 | 是否唯一 | 是否必填 | 备注 |
| --------------- | --------- | --------------------- | ---- | ---- | --------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| meter_in_out_id | 水表出/入库单id | number / bigint(64) | 否 | 是 | 关联[水表出入库单](###水表出/入库单-biz_meter_in_out) |
| meter_id | 水表id | string / varchar(100) | 是 | 否 | 关联[水表信息表](###水表信息表-biz_meter) |
| 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 | 主键 | number / bigint(64) | 是 | 是 | |
| dept_id | 营业站点/当前所属站点 | number / bigint(64) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) |
| 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 / int | 否 | 是 | 详见常量说明[水表分类](###水表分类（meter_type）) |
| 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(10,6) | 否 | 否 | |
| gpsy | GPSY坐标 | number / decimal(10,6) | 否 | 否 | |
| latitude | 纬度 | number / decimal(10,6) | 否 | 否 | |
| longitude | 经度 | number / decimal(10,6) | 否 | 否 | |
| highly | 高度 | number / decimal(10,2) | 否 | 否 | 单位：米 |
| 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) | 否 | 否 | |
| measure_no | 计量编号 | string / varchar(100) | 否 | 否 | |
| cust_code | 客户 | string / varchar(100) | 否 | 否 | |
| project_code | 工程编码 | string / varchar(100) | 否 | 否 | |
| meter_status | 水表状态 | number / int | 否 | 默认0 | 详见常量说明[表务状态](###表务状态（mw_state）) |
| 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_log
> 水表基础信息、出入库信息变更日志
| 字段名 | 说明 | 类型 | 是否唯一 | 是否必填 | 备注 |
| --------------- | ------- | --------------------- | ---- | ---- | ------------------------------------ |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| meter_id | 水表id | number / bigint(64) | 否 | 否 | 关联水表信息 |
| meter_in_out_id | 水表出入库id | number / bigint(64) | 否 | 否 | 为出入库时有值 |
| type | 日志类型 | int | 否 | 否 | 关联日志类型 |
| result | 操作结果 | varchar | 否 | 否 | 成功/失败 [默认状态](###默认状态-default_status) |
| 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_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_company_account
> 水司账户信息管理，记录水司的银行账户信息，用于收费缴费
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------------------- | ------ | --------------------- | ---- | ---- | ------------------------------------ |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| account_name | 账户名称 | string / varchar(200) | 否 | 是 | |
| tax_number | 纳税人识别号 | string / varchar(50) | 否 | 是 | |
| account_address | 账户地址 | string / varchar(500) | 否 | 否 | |
| phone | 电话 | string / varchar(50) | 否 | 否 | |
| bank_name | 开户行名称 | string / varchar(200) | 否 | 是 | |
| bank_code | 开户行代码 | string / varchar(100) | 否 | 是 | |
| bank_account | 开户行账户 | string / varchar(100) | 否 | 是 | |
| special_invoice_account | 专票开户账号 | string / varchar(100) | 否 | 否 | |
| payee | 收款人 | string / varchar(100) | 否 | 否 | |
| reviewer | 复核人 | string / varchar(100) | 否 | 否 | |
| drawer | 开票人 | 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 | 主键 | number / bigint(64) | 是 | 是 | 自增主键 |
| account_id | 水司账户id | number / int | 否 | 否 | 关联[水司账户表](###水司账户表-biz_company_account) |
| supplier | 供应商 | number / int | 否 | 否 | 开票供应商ID |
| supplier_name | 供应商名称 | string / longtext | 否 | 否 | 供应商名称 |
| limit | 开票限额 | number / decimal(15,4) | 否 | 默认0.0000 | 单次开票最大金额 |
| before_charge | 收费前开票 | boolean / bit(1) | 否 | 默认0 | 是否在收费前开票 |
| ex_cost_component_codes | 排除费用组成code | string / varchar(500) | 否 | 否 | 排除的费用组成，多个用逗号分隔 |
| extra_properties | 开票平台参数 | string / longtext | 否 | 否 | 开票平台的扩展参数，JSON格式 |
| auto_invoice | 自动开票 | boolean / bit(1) | 否 | 默认0 | 是否启用自动开票 |
| invoice_type | 开票类型 | number / int | 否 | 否 | 发票种类：1-普通发票，2-专用发票 |
| include_invoice_special | 是否包含专票客户 | boolean / bit(1) | 否 | 否 | 是否包含专用发票客户 |
| 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_taxrate
> 发票税率管理表，记录不同项目和商品的税率信息，支持多种发票类型
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ------------------ | ----------------- | --------------------- | -------- | -------- | ------------------------------------------------------ |
| id | 主键Id | number / bigint(64) | 是 | 是 | 自增主键 |
| account_id | 销售方/水司账户id | number / int | 否 | 是 | 关联[水司账户表](###水司账户表-biz_company_account) |
| code | 编码 | string / varchar(100) | 否 | 是 | 唯一编码 |
| name | 名称 | string / varchar(200) | 否 | 是 | 显示名称 |
| product_code | 商品编码 | string / varchar(100) | 是 | 否 | 商品唯一编码 |
| tax_rate_mark | 零税率标识 | string / varchar(50) | 否 | 是 | [零税率标识](###零税率标识（tax_rate_mark）) |
| specification_type | 规格型号 | string / varchar(200) | 否 | 否 | 商品规格型号 |
| tax_rate | 税率 | number / decimal(5,2) | 否 | 默认0.00 | 税率百分比，如13.00表示13% |
| project_unit | 项目单位 | string / varchar(50) | 否 | 否 | 项目计量单位 |
| invoice_type | 开票类型 | string / varchar(200) | 否 | 否 | 多个用逗号分隔,[发票种类](###发票种类（invoice_type）) |
| 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) | 否 | 否 | 单位：立方米，为空表示无上限 |
| start_month | 开始月份 | number / int | 否 | 否 | |
| end_month | 结束月份 | number / int | 否 | 否 | |
| 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) | 是 | 是 | |
| template_code | 水价模版代码 | string / varchar(100) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) |
| name | 方案名称 | string / varchar(200) | 否 | 是 | 如：居民用户优惠方案2024 |
| code | 方案代码 | string / varchar(100) | 是 | 是 | |
| mode | 方案模式 | number / int | | | 详见常量说明[优惠方案模式]() |
| discount_type | 优惠方式 | number / int | 否 | 是 | 详见常量说明[优惠方式](###优惠方式-discount_type) |
| effective_date | 生效日期 | date | 否 | 是 | |
| expiry_date | 失效日期 | date | 否 | 否 | 为空表示长期有效 |
| 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 | |
### **用户表单字段配置-system_user_form_config**
| **字段名** | **中文含义** | **字段类型** | **是否唯一** | **是否必填** | **字段说明** |
| ------------ | -------- | --------------------- | -------- | -------- | ------------- |
| id | 主键ID | number / bigint(64) | 是 | 是 | |
| obj_id | 对象ID | number / bigint(64) | 否 | 是 | 用户id/角色id等 |
| config_type | 配置类型 | number / tinyint | 否 | 是 | 1-个人配置，2-角色配置 |
| code | 表格标识/模版号 | string / varchar(100) | 否 | 是 | |
| column_key | 列字段标识 | string / varchar(100) | 否 | 是 | |
| column_title | 自定义列标题 | string / varchar(100) | 否 | 否 | |
| column_width | 列宽度 | number / int | 否 | 否 | |
| is_visible | 是否显示 | number / int | 否 | 默认0 | 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_dept_cust_no_rule_rel
> 户号规则与组织站点的绑定关系
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ------------ | ---------- | --------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| dept_code | 部门代码 | string / varchar(50) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) |
| cust_rule_id | 户号规则id | number / bigint(64) | 否 | 是 | 关联[户号规则表](###户号规则表-biz_cust_no_rule) |
| 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_cust_no_rule
> 户号规则
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------- | ------ | --------------------- | ---- | ---- | ------------------------------------ |
| id | 主键 | number / bigint(64) | 是 | 是 | 自增主键 |
| code | code | string / varchar(100) | 否 | 否 | 规则编码 |
| seq_no | 最大值 | number / int | 否 | 否 | |
| seq_regex | 规则代码 | string / varchar(500) | 否 | 否 | 规则的正则表达式 |
| is_bind | 是否绑定站点 | 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 | |
### 参数配置表-infra_config
> 参数配置管理表，记录系统各种参数的配置信息，支持分组管理和可见性控制
>
> 参数配置和抄表参数也使用该表（通过category（参数分组）区分），type=1系统内置（删除）、type=2自定义=可删除
>
> 添加red（是否标红）、edit（是否编辑）走单
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------- | -------- | --------------------- | -------- | -------- | ------------------------------------------------------------ |
| id | 参数主键 | number / int | 是 | 是 | 自增主键 |
| category | 参数分组 | string / varchar(50) | 否 | 是 | 参数分组，用于分类管理 |
| type | 参数类型 | number / int | 否 | 是 | 参数类型标识 |
| name | 参数名称 | string / varchar(100) | 否 | 否 | 参数显示名称 |
| config_key | 参数键名 | string / varchar(100) | 否 | 否 | 参数配置键名 |
| value | 参数键值 | string / varchar(500) | 否 | 否 | 参数配置值 |
| visible | 是否可见 | boolean / bit(1) | 否 | 是 | 参数是否在界面可见详见常量说明[默认状态](###默认状态-default_status) |
| red | 是否标红 | boolean / bit(1) | 否 | 默认1 | 参数是否在界面标红详见常量说明[默认状态](###默认状态-default_status) |
| edit | 是否编辑 | boolean / bit(1) | 否 | 默认0 | 参数是否在界面编辑详见常量说明[默认状态](###默认状态-default_status) |
| 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_dict_type
> 字典类型管理表，定义系统中各种字典的分类和类型信息
>
> 词语信息使用字典类型表和字典数据表代替，添加category（来源系统分类）
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ------------ | -------- | --------------------- | -------- | -------- | ---------------------------------- |
| id | 字典主键 | number / bigint(64) | 是 | 是 | 自增主键 |
| category | 参数分组 | string / varchar(50) | 否 | 是 | 参数分组，用于分类管理（来源系统） |
| type | 字典类型 | string / varchar(100) | 否 | 否 | 字典类型的唯一标识 |
| name | 字典名称 | string / varchar(100) | 否 | 否 | 字典类型的显示名称 |
| status | 状态 | number / int | 否 | 默认0 | 0-正常，1-停用 |
| remark | 备注 | string / varchar(500) | 否 | 否 | 字典类型备注说明 |
| deleted_time | 删除时间 | datetime | 否 | 否 | 逻辑删除时间 |
| 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_dict_data
> 字典数据管理表，存储各种字典类型的具体数据项，支持排序和样式配置
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------- | -------- | --------------------- | -------- | -------- | ------------------------------------------------------------ |
| id | 字典编码 | number / bigint(64) | 是 | 是 | 自增主键 |
| sort | 字典排序 | number / int | 否 | 默认0 | 字典项的显示排序 |
| label | 字典标签 | string / varchar(100) | 否 | 否 | 字典项的显示标签 |
| value | 字典键值 | string / varchar(100) | 否 | 否 | 字典项的实际值 |
| dict_type | 字典类型 | string / varchar(100) | 否 | 否 | 关联[字典类型表](###字典类型表-system_dict_type) |
| color_type | 颜色类型 | string / varchar(100) | 否 | 否 | 字典项的颜色类型 |
| css_class | css样式 | string / varchar(100) | 否 | 否 | 字典项的CSS样式类 |
| remark | 备注 | string / varchar(500) | 否 | 否 | 字典项备注说明 |
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-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_read
> 抄表状态数据管理表
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| -------------------- | ---------- | ---------------------- | -------- | -------- | ------------------------------------------------------------ |
| id | 主键 | number / bigint(64) | 是 | 是 | 自增主键 |
| category | 分类 | string / varchar(50) | 否 | 是 | 预留 |
| type | 类型 | string / varchar(100) | 否 | 默认1 | 1-大类 2小类 |
| name | 名称 | string / varchar(100) | 否 | 是 | |
| code | 抄表编码 | string / varchar(100) | 否 | 是 | |
| sort | 字典排序 | number / int | 否 | 默认0 | |
| value | 字典键值 | string / varchar(100) | 否 | 否 | |
| meter_read_algorithm | 抄表算法 | string / varchar(100) | 否 | 否 | 小类时必填，关联[ 抄表算法](### 抄表算法（reading_algorithm）) |
| parent_id | 父级小区id | number / bigint(64) | 否 | 否 | 层级管理（正常两级，多级扩展） |
| ancestor_list | 祖级列表 | string / varchar(1000) | 否 | 否 | 格式：1,2,3 表示祖级小区id列表 |
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) |
| 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_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 | 否 | 是 | 关联[客户组](###客户组表-biz_cust_group) |
| cust_hub_mark_code | 集收编号 | string / varchar | 否 | 是 | 关联[集收号](###集收号表-biz_hub_marks) |
| 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_cust_hub_marks
> 集收号管理表，用于管理集中收费的集收户信息，支持一个集收户代收多个客户的费用
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| -------------------- | ------------ | --------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| concentrated_code | 集收号 | string / varchar(100) | 是 | 是 | |
| pay_custodian_name | 付款人姓名 | string / varchar(100) | 否 | 否 | |
| address | 地址 | string / varchar(500) | 否 | 是 | |
| contact | 联系人 | string / varchar(100) | 否 | 是 | |
| mobile | 联系电话 | string / varchar(20) | 否 | 是 | |
| state | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
| 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_contact
> 联系人信息管理表，记录客户相关的联系人信息，支持一个客户关联多个联系人
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ------------ | ---------- | --------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| cust_id | 客户id | number / bigint(64) | 否 | 是 | 关联[客户资料表](###客户资料-biz_cust) |
| contact_type | 联系人类型 | number / int | 否 | 否 | 联系人类型枚举值 |
| contact | 联系人 | string / varchar(100) | 否 | 否 | |
| mobile | 联系电话 | string / varchar(20) | 否 | 否 | |
| telephone | 座机 | string / varchar(20) | 否 | 否 | |
| sex | 性别 | number / int | 否 | 否 | 性别枚举值 |
| date_birth | 出生日期 | datetime | 否 | 否 | |
| email | 邮箱 | string / varchar(100) | 否 | 否 | |
| fax | 传真 | string / varchar(20) | 否 | 否 | |
| address | 联系地址 | string / varchar(500) | 否 | 否 | |
| 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_info
> 发票信息管理表，记录系统开具的各类发票信息，包括电子发票、纸质发票等，支持发票状态跟踪和查询
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| --------------------- | ---------------------- | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| fee_id | 费用id | number / bigint(64) | 否 | 否 | 关联费用表 |
| member_id | 会员Id | string / varchar(100) | 否 | 否 | 关联会员表 |
| supplier | 开票供应商 | number / int | 否 | 否 | 开票供应商枚举值 |
| serial_no | 交易流水号 | string / varchar(100) | 否 | 是 | |
| invoice_type | 开票类型 | number / int | 否 | 否 | 发票种类枚举值 |
| operation_type | 开票业务操作类型 | string / varchar(100) | 否 | 是 | |
| invoice_site | 开票点 | string / varchar(100) | 否 | 是 | |
| drawer | 开票人 | string / varchar(100) | 否 | 是 | |
| payee | 收款人 | string / varchar(100) | 否 | 是 | |
| reviewer | 复核人 | string / varchar(100) | 否 | 是 | |
| invoice_state | 发票状态 | number / int | 否 | 否 | 发票状态枚举值 |
| return_code | 返回码 | string / varchar(100) | 否 | 是 | |
| return_message | 返回消息 | string / longtext | 否 | 是 | |
| order_no | 订单号 | string / varchar(100) | 否 | 是 | 每笔唯一 |
| order_date | 订单日期 | datetime | 否 | 否 | |
| total_amount | 价税合计 | number / decimal(15,2) | 否 | 否 | |
| seller_tax_id | 销售方税号 | string / varchar(100) | 否 | 是 | |
| seller_name | 销售方名称 | string / varchar(200) | 否 | 是 | |
| seller_address | 销售方地址 | string / varchar(500) | 否 | 是 | |
| seller_tel | 销售方电话 | string / varchar(20) | 否 | 是 | |
| seller_bank | 销售方开户行 | string / varchar(200) | 否 | 是 | |
| seller_bank_account | 销售方开户账号 | string / varchar(100) | 否 | 是 | |
| buyer_type | 购买方客户类型 | string / varchar(50) | 否 | 是 | |
| buyer_tax_id | 购买方纳税人识别号 | string / varchar(100) | 否 | 是 | |
| buyer_name | 购买方名称 | string / varchar(200) | 否 | 是 | |
| buyer_address | 购买方地址 | string / varchar(500) | 否 | 是 | |
| buyer_tel | 购买方电话 | string / varchar(20) | 否 | 是 | |
| buyer_phone | 购买方手机 | string / varchar(20) | 否 | 是 | |
| buyer_bank | 购买方开户行 | string / varchar(200) | 否 | 是 | |
| buyer_bank_account | 购买方开户账号 | string / varchar(100) | 否 | 是 | |
| buyer_email | 购买方Email | string / varchar(100) | 否 | 是 | |
| is_send | 是否发送电子邮件 | string / varchar(10) | 否 | 是 | |
| invoice_code | 发票代码 | string / varchar(100) | 否 | 是 | |
| invoice_number | 发票号码 | string / varchar(100) | 否 | 是 | |
| invoice_jym | 校验码 | string / varchar(100) | 否 | 是 | |
| invoice_date | 发票日期 | datetime | 否 | 是 | |
| invoice_year | 发票年份 | number / int | 否 | 否 | |
| invoice_path | 电子票地址 | string / varchar(500) | 否 | 是 | |
| cndn_code | 原发票代码 | string / longtext | 否 | 是 | |
| cndn_number | 原发票号码 | string / longtext | 否 | 是 | |
| curr_stamp | 并发时间戳 | string / varchar(100) | 否 | 是 | |
| lock_time | 锁定时间 | datetime | 否 | 否 | |
| remark | 备注 | string / longtext | 否 | 否 | |
| invoice_class | 发票类型 | number / int | 否 | 默认1 | |
| is_give_up | 是否放弃 | boolean / tinyint | 否 | 默认0 | |
| last_try_time | 最后一次尝试查询时间 | datetime | 否 | 否 | |
| next_try_time | 下一次尝试查询时间 | datetime | 否 | 默认0001-01-01 00:00:00 | |
| try_count | 尝试查询的次数 | number / int | 否 | 默认0 | |
| identification | 开票标识 | string / char(1) | 否 | 是 | |
| special_open_account | 专票开户账号 | string / varchar(100) | 否 | 是 | |
| 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_cust_meter
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ---------------- | ------- | ---------------------- | ---- | ---- | ------------------------------------------ |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| cust_id | 客户id | number / bigint(64) | 否 | 否 | 关联[客户资料表](###客户资料-biz_cust) |
| maker_code | 水表厂家代码 | string / varchar(100) | 否 | 是 | 关联[水表厂家表](###水表厂家表-biz_meter_maker) |
| model_code | 水表型号代码 | string / varchar(100) | 否 | 否 | 关联[水表型号表](###水表型号表-biz_meter_model) |
| caliber_code | 水表口径代码 | number / bigint(64) | 否 | 是 | 关联[水表口径表](###水表口径表-biz_meter_caliber) |
| range_code | 水表量程代码 | number / bigint(64) | 否 | 是 | 关联[水表量程表](###水表量程表-biz_meter_range) |
| type | 水表分类/类型 | number / int | 否 | 是 | 详见常量说明[水表分类](###水表分类（meter_type）) |
| oth_type | 其他分类 | number / int | 否 | 否 | 详见常量说明[水表其他类型](###水表其他类型（meter_oth_type）) |
| func_type | 功能分类 | number / int | 否 | 否 | 详见常量说明[水表功能分类](###水表功能分类（meter_func_type）) |
| steel_mark | 钢印号 | string / varchar(100) | 是 | 是 | |
| seal_number | 水表编号 | string / varchar(100) | 是 | 否 | |
| bar_code | 条形码 | string / varchar(100) | 是 | 否 | |
| check_code | 强检编号 | string / varchar(100) | 是 | 否 | |
| rate | 水表倍率 | number / decimal(10,4) | 否 | 否 | 默认1.0 |
| new_read | 新表起码 | number / decimal(15,3) | 否 | 否 | 单位：立方米 |
| new_child_read | 新子表起码 | number / decimal(15,3) | 否 | 否 | 单位：立方米 |
| old_read | 旧表底码 | number / decimal(15,3) | 否 | 否 | 单位：立方米 |
| old_child_read | 旧子表底码 | number / decimal(15,3) | 否 | 否 | 单位：立方米 |
| install_date | 安装日期 | datetime | 否 | 否 | |
| replace_date | 换表日期 | datetime | 否 | 否 | |
| install_location | 安装位置 | string / varchar(200) | 否 | 否 | |
| validity_date | 有效期 | datetime | 否 | 否 | |
| remove_date | 拆表日期 | datetime | 否 | 否 | |
| check_date | 强检日期 | datetime | 否 | 否 | |
| collect_code | 采集号 | string / varchar(100) | 否 | 否 | |
| gpsx | GPSX坐标 | number / decimal(10,6) | 否 | 否 | |
| gpsy | GPSY坐标 | number / decimal(10,6) | 否 | 否 | |
| latitude | 纬度 | number / decimal(10,6) | 否 | 否 | |
| longitude | 经度 | number / decimal(10,6) | 否 | 否 | |
| highly | 高度 | number / decimal(10,2) | 否 | 否 | 单位：米 |
| 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 / int | 否 | 默认0 | 详见常量说明[水表状态](###水表状态（meter_state）) |
| 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_account
> 账户信息管理表，记录客户的账户余额、透支额度等账户状态信息
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| -------------- | ------------ | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| cust_id | 客户id | number / bigint(64) | 否 | 是 | 关联[客户资料表](###客户资料-biz_cust) |
| deposit | 预存款余额 | number / decimal(15,2) | 否 | 否 | |
| uncheck_money | 未到账金额 | number / decimal(15,2) | 否 | 否 | |
| account_state | 账户状态 | number / int | 否 | 默认0 | 账户状态枚举值 |
| overdraft | 透支额度 | number / decimal(15,4) | 否 | 默认0.0000 | |
| 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_account_log
> 账户流水管理表，记录账户的所有收支流水明细，包括预存款变动、费用扣减等
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| --------------- | ------------ | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| account_id | 账户id | number / bigint(64) | 否 | 是 | 关联[账户信息表](###账户信息表-biz_account) |
| pay_detail_id | 来源编号 | number / bigint(64) | 否 | 是 | 关联支付明细表 |
| acc_log_type | 暂收类型 | number / int | 否 | 否 | 暂收类型枚举值 |
| acc_in_out | 进出标志 | number / int | 否 | 否 | 进出标志枚举值 |
| last_deposit | 上次余额 | number / decimal(15,2) | 否 | 否 | |
| in_out_money | 收支金额 | number / decimal(15,2) | 否 | 否 | |
| deposit | 本次余额 | number / decimal(15,2) | 否 | 否 | |
| 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 | |
### IC卡表-biz_smartcard
> IC卡信息管理表，记录IC卡水表的相关信息，包括购水量、余额、开卡状态等
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------------------- | ---------------- | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| meter_id | 水表Id | number / bigint(64) | 否 | 否 | 关联[水表信息表](###水表信息表-biz_meter) |
| cust_id | 客户ID | number / bigint(64) | 否 | 默认0 | 关联[客户资料表](###客户资料-biz_cust) |
| self_meter_id | 表id | string / varchar(100) | 否 | 是 | |
| buy_times | 购买次数 | number / int | 否 | 默认0 | |
| total_water | 总购水量 | number / int | 否 | 默认0 | 单位：立方米 |
| balance | 结余 | number / decimal(15,4) | 否 | 默认0.0000 | |
| state | 状态 | number / int | 否 | 默认0 | 0-正常，-1-作废 |
| total_money | 总购买金额 | number / decimal(15,4) | 否 | 默认0.0000 | |
| buy_area | 写卡区域 | number / int | 否 | 是 | |
| is_open | 是否开卡 | number / int | 否 | 默认0 | 0-未开卡，1-已开卡 |
| open_id | 开户人 | string / char(1) | 否 | 是 | |
| open_date | 开户时间 | datetime | 否 | 是 | |
| meter_card_type | IC卡水表类型 | number / int | 否 | 是 | |
| level_type | 阶梯类型 | number / int | 否 | 是 | |
| remark | 备注 | string / varchar(500) | 否 | 是 | |
| charge_count | 充值次数 | number / int | 否 | 默认0 | |
| 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 | |
### IC卡充退表-biz_smartcard_log
> IC卡充退记录管理表，记录IC卡的充值、退费等相关操作信息
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------------------- | ---------------- | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| cust_id | 客户Id | number / bigint(64) | 否 | 否 | 关联[客户资料表](###客户资料-biz_cust) |
| areas_id | 所属小区Id | number / int | 否 | 是 | 关联小区表 |
| caliber_id | 水表口径 | number / int | 否 | 是 | 关联水表口径表 |
| in_out | 出入标识 | number / int | 否 | 默认0 | 1-购入，2-退 |
| in_out_water | 进出水量 | number / int | 否 | 默认0 | 单位：立方米 |
| last_water | 上次水量 | number / int | 否 | 默认0 | 单位：立方米 |
| water | 本次水量 | number / int | 否 | 默认0 | 单位：立方米 |
| price_list_id | 调价号 | number / int | 否 | 否 | |
| price_code | 用水性质 | number / int | 否 | 否 | |
| water_money | 金额 | number / decimal(15,4) | 否 | 默认0.0000 | |
| buy_code | 充值码 | string / varchar(100) | 否 | 是 | |
| log_state | 状态 | number / int | 否 | 默认0 | 0-正常，-1-作废 |
| subtotal_id | 小计编号 | number / int | 否 | 是 | |
| remark | 备注 | string / varchar(500) | 否 | 是 | |
| purchase_type | 购买类型 | number / int | 否 | 否 | 1-按水量，2-按金额 |
| bill_amount | 应收金额 | number / decimal(15,4) | 否 | 默认0.0000 | |
| cashier_id | 收费人 | string / char(1) | 否 | 否 | |
| invoice_code | 发票代码 | string / varchar(100) | 否 | 是 | |
| invoice_date | 开票日期 | datetime | 否 | 是 | |
| invoice_error | 开票错误 | string / longtext | 否 | 是 | |
| invoice_number | 发票编号 | string / varchar(100) | 否 | 是 | |
| invoice_state | 开票状态 | number / int | 否 | 默认0 | 发票状态 |
| pay_date | 收费时间 | datetime | 否 | 是 | |
| checkout_date | 结账时间 | datetime | 否 | 是 | |
| cust_type | 用户类型 | number / int | 否 | 是 | 客户类型 |
| meter_oth_type | 其它分类 | number / int | 否 | 是 | 水表类型 |
| meter_type | 水表分类 | number / int | 否 | 是 | 水表关系分类 |
| statistical_type | 用户类型 | string / varchar(100) | 否 | 是 | 统计分类 |
| invoicing_state | 待开票种类 | number / int | 否 | 默认0 | |
| cust_invoice_type | 发票类型 | number / int | 否 | 是 | |
| charge_invoice_state | 营业账发票状态 | number / int | 否 | 是 | |
| 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 | |
### IC卡充退帐明细表-biz_smartcard_log_detail
> IC卡充退明细管理表，记录IC卡充退的详细费用组成和阶梯信息
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ------------------ | -------- | ---------------------- | ---- | -------- | ---------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| smart_log_id | IC卡充退表ID | number / bigint(64) | 否 | 否 | 关联[IC卡充退表](###IC卡充退表-biz_smartcard_logs) |
| price_item_id | 费用组成Id | number / bigint(64) | 否 | 否 | 关联费用组成表 |
| price_list_id | 调价号 | number / int | 否 | 否 | 关联调价表 |
| level_type | 阶梯模式 | number / int | 否 | 否 | |
| level_index | 阶梯级别 | number / int | 否 | 否 | |
| start_month | 开始月份 | number / int | 否 | 否 | |
| end_month | 结束月份 | number / int | 否 | 否 | |
| start_water | 开始水量 | number / int | 否 | 否 | 单位：立方米 |
| end_water | 结束水量 | number / int | 否 | 否 | 单位：立方米 |
| price | 价格 | number / decimal(15,4) | 否 | 默认0.0000 | |
| water | 水量 | number / int | 否 | 否 | 单位：立方米 |
| money | 金额 | number / decimal(15,4) | 否 | 默认0.0000 | |
| settle_method | 分摊方式 | number / int | 否 | 是 | 分摊方式 |
| settle_values | 分摊值 | number / float | 否 | 是 | |
| price_code | 用水性质 | number / int | 否 | 否 | |
| water_num | 水量系数 | number / decimal(15,4) | 否 | 默认0.0000 | |
| basic_number | 基数 | number / decimal(15,4) | 否 | 默认0.0000 | |
| calc_mode | 计算方式 | number / int | 否 | 默认0 | |
| invoiced_state | 开票状态 | number / int | 否 | 是 | |
| item_invoice_error | 明细开票错误 | string / varchar(500) | 否 | 是 | |
| item_invoice_state | 明细开票状态 | number / int | 否 | 是 | |
| item_invoice_type | 明细开票类型 | number / int | 否 | 是 | |
| 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 | |
### IC卡结余记录-biz_smartcard_odd_log
> IC卡结余记录管理表，记录IC卡每次操作后的结余变化情况
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------------------- | ---------------- | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| smart_log_id | IC卡充退表ID | number / bigint(64) | 否 | 否 | 关联[IC卡充退表](###IC卡充退表-biz_smartcard_logs) |
| cust_id | 客户Id | number / bigint(64) | 否 | 否 | 关联[客户资料表](###客户资料-biz_cust) |
| last_balance | 上次结余 | number / decimal(15,4) | 否 | 默认0.0000 | |
| balance | 本次结余 | number / decimal(15,4) | 否 | 默认0.0000 | |
| change | 本次零头 | number / decimal(15,4) | 否 | 默认0.0000 | |
| last_change | 上次零头 | number / decimal(15,4) | 否 | 默认0.0000 | |
| 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 | |
### IC卡操作日志-biz_smartcard_operate_log
> IC卡操作日志管理表，记录IC卡的补卡、清卡、解锁等操作信息
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
| ----------------------- | ---------------- | ---------------------- | -------- | -------- | -------------------------------------------------- |
| id | 主键 | number / bigint(64) | 是 | 是 | |
| cust_id | 客户Id | number / bigint(64) | 否 | 是 | 关联[客户资料表](###客户资料-biz_cust) |
| producer_id | 水表厂家 | number / int | 否 | 是 | 关联水表厂家表 |
| water | 补卡水量 | number / int | 否 | 是 | 单位：立方米 |
| operate_type | 操作类型 | number / int | 否 | 否 | 1-补卡，2-清卡，3-解锁 |
| buy_times | 购买次数 | number / int | 否 | 默认0 | |
| buy_waters | 购买水量 | number / int | 否 | 默认0 | 单位：立方米 |
| remark | 备注 | string / varchar(500) | 否 | 是 | |
| buy_amount | 金额 | number / decimal(15,4) | 否 | 默认0.0000 | |
| cost_money | 工本费 | number / decimal(15,4) | 否 | 默认0.0000 | |
| apply_type | 申请原因 | number / int | 否 | 是 | |
| cheque_type | 小类 | number / int | 否 | 是 | 凭证类型 |
| new_self_meter_id | 新水表自编号 | string / varchar(100) | 否 | 是 | |
| new_steel_mark | 新水表厂家 | string / varchar(100) | 否 | 是 | |
| old_self_meter_id | 原水表自编号 | string / varchar(100) | 否 | 是 | |
| old_steel_mark | 原水表钢印号 | string / varchar(100) | 否 | 是 | |
| making_type | 制卡类型 | number / int | 否 | 是 | |
| transfer_amount | 转移金额 | number / decimal(15,4) | 否 | 默认0.0000 | |
| 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 | |