2624 lines
174 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 文档概述
### 文档目的
*<span style="color: blue">(说明编写文档目的, 如本文档主要为xxx项目的数据库设计说明为用户设计接口及研发提供参照</span>*
### 适用范围
*<span style="color: blue">(说明文档使用范围, 如:本文档适用于研发、运维人员等。。。)</span>*
### 参考资料
*<span style="color: blue">(列举参考的文献来源)</span>*
| 序号 | 文献名称 |
| -------------------------------------- | --------------------------------------------------- |
| *<span style="color: blue">[1]</span>* | *<span style="color: blue">《软件架构设计》</span>* |
| | |
## 术语、缩略语说明
| 术语、缩写 | 解释 | 更多说明 |
| ----- | -------------------- | ---------------------- |
| 水司 | 水务集团下的各个地区公司 | 在系统里表示租户,不同水司对应不同租户 |
| 分公司 | 水司下的各个分公司 | 在系统里表示部门,一般是顶级部门,下面是站点 |
| 站点 | 全名:营业站点,用于划分用户所属管辖区域 | 在系统里表示部门,对应部门管理,支持数据隔离 |
| 待补充 | | |
## 公共常量约定
### 默认状态-default_status
> <a id="default_status">默认状态</a>
| 编码 | 中文含义 |
| --- | ---- |
| 0 | 是 |
| 1 | 否 |
### 部门类型-dept_type
> <a id="default_status">默认状态</a>
| 编码 | 中文含义 |
| ---- | -------- |
| 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
| 编码 | 中文含义 |
| ---- | -------- |
| | |
## 数据库环境说明
*<span style="color: blue">(说明部署环境、工具、存放位置等)</span>*
### 命名规范
* 表名前面加上特定业务模块名称,例如:
* biz_业务配置相关
* mw_表务相关
## 逻辑设计
### 数据实体关系图
*<span style="color: blue">说明本数据库反映的显示世界中的实体、属性和他们之间的关系等ER图</span>*
#### 水表参数模块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<br/>水价归属表"] {
bigint id PK
varchar name "归属名称"
varchar code UK "归属代码"
bigint parent_id "父级归属id"
varchar ancestor_list "祖级列表"
int sort "排序"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
biz_price_adjustment_snap["biz_price_adjustment_snap<br/>水价调整快照表"] {
bigint id PK
int code UK "快照编号/版本号"
datetime effective_date "生效日期"
datetime expiry_date "失效日期"
varchar adjuster "调价人"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间/调价时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
%% 中层左:水价模版
biz_price_template["biz_price_template<br/>水价模版表"] {
bigint id PK
int sort "排序"
varchar name "用水性质"
varchar code UK "模版代码"
varchar price_category_code FK "水价归属代码"
bigint adjustment_snap_id FK "调价快照id"
int adjustment_snap_code FK "调价快照code"
int meter_start "起开量"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
%% 中层右:费用组成
biz_cost_component["biz_cost_component<br/>费用组成表"] {
bigint id PK
varchar name "费用名称"
varchar code UK "费用代码"
decimal penalty_coefficient "违约金系数"
bit zero_usage_calculation "零用量是否计算"
int sort "排序"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
%% 下层左:费用调整
biz_price_cost_adjustment["biz_price_cost_adjustment<br/>水价费用调整表"] {
bigint id PK
bigint template_id FK "水价模版id"
varchar cost_component_code FK "费用组成代码"
int calculation_mode "计算类型"
bit is_tiered "是否阶梯"
int tiered_mode "阶梯类型"
int tier_level "阶梯级别"
decimal volume_coefficient "水量系数"
bit charge_penalty "是否收取违约金"
int sort "排序"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
%% 下层中:阶梯调整
biz_price_tier_adjustment["biz_price_tier_adjustment<br/>水价阶梯调整表"] {
bigint id PK
bigint cost_adjustment_id FK "水价费用调整id"
varchar cost_component_code FK "费用组成代码"
int tier_level "阶梯级别"
decimal start_volume "开始水量m3"
decimal end_volume "结束水量m3"
decimal price "价格元"
decimal volume_coefficient "水量系数"
int sort "排序"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
%% 右侧:部门管理
system_dept["system_dept<br/>系统部门表"] {
bigint id PK
varchar name "部门名称"
bigint parent_id "父级部门id"
varchar code UK "部门代码"
varchar type "部门类型"
varchar phone "联系电话"
varchar email "邮箱"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人"
varchar updater "更新人"
int deleted "是否删除"
bigint tenant_id "租户id"
}
%% 右下:模版部门关系
biz_template_dept_rel["biz_template_dept_rel<br/>水价模版部门关系表"] {
bigint id PK
varchar dept_code FK "部门代码"
varchar template_code FK "水价调整模版代码"
bigint adjustment_snap_id FK "调价快照id"
int adjustment_snap_code FK "调价快照code"
bit is_default "是否默认"
varchar remark "备注"
int status "状态"
datetime create_time "创建时间"
datetime update_time "更新时间"
varchar creator "创建人id"
varchar updater "更新人id"
bit deleted "是否删除"
bigint tenant_id "租户id"
}
%% 核心业务关系链
biz_price_category ||--o{ biz_price_template : "code = price_category_code"
biz_price_adjustment_snap ||--o{ biz_price_template : "code = adjustment_snap_code"
biz_price_template ||--o{ biz_price_cost_adjustment : "id = template_id"
biz_cost_component ||--o{ biz_price_cost_adjustment : "code = cost_component_code"
biz_price_cost_adjustment ||--o{ biz_price_tier_adjustment : "id = cost_adjustment_id"
biz_cost_component ||--o{ biz_price_tier_adjustment : "code = cost_component_code"
%% 部门关系链
system_dept ||--o{ biz_template_dept_rel : "code = dept_code"
biz_price_template ||--o{ biz_template_dept_rel : "code = template_code"
biz_price_adjustment_snap ||--o{ biz_template_dept_rel : "code = adjustment_snap_code"
```
### 实体及关系描述
*<span style="color: blue">按照ER图说明实体及实体间 一对一、一对多、多对多的关系)</span>*
## 物理设计
*<span style="color: blue">(说明是否采用分布式数据库、数据库表分部,存储空间等安排)</span>*
## 表结构设计
### 水表厂家表-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 | |