From e8f207f8ae5757977c96ae37fd6dde64f6ebbf1f Mon Sep 17 00:00:00 2001 From: tangweijie <877588133@qq.com> Date: Fri, 8 Aug 2025 09:46:51 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E6=88=90=E6=BA=90=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E5=BA=93=E8=AE=BE=E8=AE=A1=E5=AF=B9=E9=BD=90=E5=B7=A5=E4=BD=9C?= =?UTF-8?q?=EF=BC=8C=E6=98=8E=E7=A1=AE=E4=BB=A5`parsed=5Fdocs=5Fnew/?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=BA=93=E8=AE=BE=E8=AE=A1.md`=E4=B8=BA?= =?UTF-8?q?=E5=9F=BA=E5=87=86=E7=9A=84=E8=A7=84=E5=88=99=EF=BC=8C=E8=A1=A5?= =?UTF-8?q?=E5=85=85`biz=5Fmeter=5Fcaliber`=E7=9A=84`code`=E5=AD=97?= =?UTF-8?q?=E6=AE=B5=E5=92=8C`meter=5Finfo`=E7=BC=BA=E5=A4=B1=E5=AD=97?= =?UTF-8?q?=E6=AE=B5=EF=BC=8C=E6=96=B0=E5=A2=9E=E6=A0=87=E5=87=86=E8=A1=A8?= =?UTF-8?q?`system=5Fuser=5Fform=5Fconfig`=E5=B9=B6=E4=BF=9D=E7=95=99?= =?UTF-8?q?=E5=85=BC=E5=AE=B9=E8=AF=B4=E6=98=8E=E3=80=82=E5=9C=A8=E8=AF=A6?= =?UTF-8?q?=E7=BB=86/=E6=A6=82=E8=A6=81=E8=AE=BE=E8=AE=A1=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E4=B9=A6=E4=B8=AD=E5=8A=A0=E5=85=A5=E7=BB=9F=E4=B8=80?= =?UTF-8?q?=E5=AF=B9=E9=BD=90=E5=A3=B0=E6=98=8E=EF=BC=8C=E6=8F=90=E5=8D=87?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=BA=93=E5=AE=9A=E4=B9=89=E4=B8=80=E8=87=B4?= =?UTF-8?q?=E6=80=A7=EF=BC=8C=E5=87=8F=E5=B0=91=E5=90=8E=E7=BB=AD=E8=BF=94?= =?UTF-8?q?=E5=B7=A5=E9=A3=8E=E9=99=A9=EF=BC=8C=E7=AC=A6=E5=90=88=E7=94=B2?= =?UTF-8?q?=E6=96=B9A=E7=BA=A7=E4=BA=A4=E4=BB=98=E6=A0=87=E5=87=86?= =?UTF-8?q?=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- parsed_docs_new/数据库设计.md | 2623 +++++++++++++++++++++++++++++++++ project_progress.md | 1 + task_checklist.md | 8 + 新-数据库设计说明书.md | 40 +- 4 files changed, 2670 insertions(+), 2 deletions(-) create mode 100644 parsed_docs_new/数据库设计.md diff --git a/parsed_docs_new/数据库设计.md b/parsed_docs_new/数据库设计.md new file mode 100644 index 0000000..e245a1f --- /dev/null +++ b/parsed_docs_new/数据库设计.md @@ -0,0 +1,2623 @@ +## 文档概述 + +### 文档目的 + +*(说明编写文档目的, 如:本文档主要为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 | | diff --git a/project_progress.md b/project_progress.md index 3b7fabd..71d3088 100644 --- a/project_progress.md +++ b/project_progress.md @@ -156,6 +156,7 @@ | 2024-12-19 | 数据库系统变更为达梦数据库 | 将三个设计文档中的数据库从OpenGauss 5.0+替换为达梦数据库 8.0+,包括:1. 详细设计说明书中的13处架构图和技术描述更新;2. 概要设计说明书中的13处分布式架构和容器配置更新;3. 数据库设计说明书中的数据库系统描述更新。同时更新所有文档版本至V1.3,完善版本历史记录 | 用户要求采用达梦数据库而不是OpenGauss | 正面影响,采用国产达梦数据库作为主力数据库方案,符合国产化替代要求。达梦数据库8.0+具有良好的性能和稳定性,支持主从架构和分布式部署,满足水务营收系统的高可用性和扩展性需求。文档的一致性得到保证,为后续的数据库选型和部署提供了明确指导 | | 2024-12-19 | 单点登录采用OAuth2.0协议 | 在三个设计文档中完善单点登录设计,明确采用OAuth2.0协议实现。包括:1. 详细设计说明书中新增OAuth2.0授权码模式流程、6个OAuth2.0接口设计、4个相关数据表;2. 概要设计说明书中更新单点登录模块描述,强调基于OAuth2.0协议;3. 数据库设计说明书中新增OAuth2.0客户端信息表、访问令牌表、刷新令牌表、授权码表。所有文档版本更新至V1.4 | 用户要求单点登录采用OAuth2.0协议 | 正面影响,OAuth2.0是业界标准的开放授权协议,具有良好的安全性和扩展性。支持授权码模式和客户端凭证模式,满足不同应用场景需求。完善的数据表设计支持令牌管理、客户端管理等功能,为系统的安全认证和第三方集成提供了标准化的技术基础 | | 2024-12-19 | OAuth2.0表设计修正 | 根据实际SQL文件(oauth_table.sql)修正OAuth2.0表设计,确保文档与实际表结构保持一致。包括:1. 数据库设计说明书中更新5个OAuth2.0表的详细字段定义:system_oauth2_client、system_oauth2_access_token、system_oauth2_refresh_token、system_oauth2_code、system_oauth2_approve;2. 详细设计说明书中更新OAuth2.0数据表引用,修正表名为system_oauth2_*系列;3. 文档版本更新至V1.5 | 用户提供实际的OAuth2.0表SQL文件 | 正面影响,确保设计文档与实际SQL表结构完全一致,避免开发过程中的混乱。实际的表结构更加完善,包含了OAuth2.0批准表(system_oauth2_approve),支持用户授权记录管理,字段设计更加规范,符合PostgreSQL数据库特性,为OAuth2.0功能的实现提供了准确的数据模型指导 | +| 2025-08-01 | 数据库对齐 | 明确约定:若`parsed_docs_new/数据库设计.md`存在对应表,以其为准;并完成关键对齐:`biz_meter_caliber`新增`code`字段,`meter_info`补充源设计字段,新增标准表`system_user_form_config`并保留`infra_user_form_config`兼容说明;在`新-详细/概要设计说明书.md`中加入统一对齐声明 | 对齐源数据库设计 | 正面影响,数据库定义一致性提升,开发实施口径统一,减少后续返工 | | 2024-12-19 | 业务工单模块设计整合 | 参考营收系统详细设计说明书,在新版设计文档中新增业务工单模块,并将表务系统的工单管理功能整合到业务工单中。包括:1. 详细设计说明书中新增营收系统模块9-业务工单,包含业务清单管理、上报清单管理、稽查工单管理、换表工单管理4个功能模块;2. 概要设计说明书中同步新增业务工单模块描述,调整表务系统模块结构;3. 数据库设计说明书中新增4个业务工单相关表:business_work_order、report_work_order、audit_work_order、work_order_log,并更新总表数量为147个 | 用户要求参考营收系统详细设计说明书添加业务工单模块,并将表务工单管理整合到业务工单中 | 正面影响,实现了工单管理的统一化设计,避免了功能重复。业务工单模块覆盖了客户服务、账务处理、投诉建议、故障报修等全业务场景,支持工单全生命周期管理。表务系统专注于仓库管理和设备档案管理,功能边界更加清晰。新增的4个工单表设计完善了工单数据模型,支持不同类型工单的差异化管理需求 | ## 项目完成总结 diff --git a/task_checklist.md b/task_checklist.md index fb782ec..1a7dd40 100644 --- a/task_checklist.md +++ b/task_checklist.md @@ -597,6 +597,14 @@ - [x] **增加模块分类** - 按业务功能重新分类表结构 ✅ - [x] **完善表前缀说明** - 明确各模块的表前缀规范 ✅ +## 📋 源数据库设计对齐(新增任务 - 2025-08-01) + +- [x] 明确对齐规则:如`parsed_docs_new/数据库设计.md`存在对应表,以其为准 ✅ +- [x] `biz_meter_caliber`补充`code`字段 ✅ +- [x] `meter_info`补充源设计缺失字段(steel_mark、check_code、caliber_code、range_code、type、定位与设备字段等)✅ +- [x] 新增`system_user_form_config`(标准表),保留`infra_user_form_config`兼容说明 ✅ +- [x] 在`新-详细设计说明书.md`与`新-概要设计说明书.md`加入数据库对齐声明 ✅ + ## 📊 数据库设计补完总结 ### ✅ 补完效果 diff --git a/新-数据库设计说明书.md b/新-数据库设计说明书.md index b93020f..0f7e223 100644 --- a/新-数据库设计说明书.md +++ b/新-数据库设计说明书.md @@ -498,6 +498,27 @@ | deleted | int2 | N | 0 | 是否删除 | | tenant_id | int8 | N | 0 | 租户id | +### system_user_form_config (用户表单字段配置表-标准) + +| 字段名 | 类型 | 是否可空 | 默认值 | 注释 | +| :--- | :--- | :--- | :--- | :--- | +| id | int8 | N | nextval() | 主键ID | +| obj_id | int8 | Y | | 对象ID(用户id/角色id等) | +| config_type | int2 | N | | 配置类型:1-个人配置,2-角色配置 | +| code | varchar(100) | N | | 表格标识/模版号(与菜单或功能标识关联) | +| column_key | varchar(100) | N | | 列字段标识 | +| column_title | varchar(100) | Y | | 自定义列标题 | +| column_width | int4 | Y | | 列宽度 | +| is_visible | int2 | N | 0 | 是否显示:0-显示,1-隐藏 | +| is_printable | int2 | N | 0 | 是否可打印:0-是,1-否 | +| sort_order | int4 | N | 0 | 排序序号 | +| creator | varchar(64) | Y | | 创建人 | +| create_time | timestamp(6) | N | pg_systimestamp() | 创建时间 | +| updater | varchar(64) | Y | | 更新人 | +| update_time | timestamp(6) | N | pg_systimestamp() | 更新时间 | +| deleted | int2 | N | 0 | 是否删除 | +| tenant_id | int8 | N | 0 | 租户编号 | + ### biz_company_account (水司账户表) | 字段名 | 类型 | 是否可空 | 默认值 | 注释 | | :--- | :--- | :--- | :--- | :--- | @@ -554,6 +575,7 @@ | :--- | :--- | :--- | :--- | :--- | | id | int8 | N | nextval() | 主键 | | name | varchar(100) | Y | | 口径名称 | +| code | varchar(100) | N | | 口径代码 | | value | numeric(10,2) | Y | | 口径值(单位:毫米) | | check_period | int4 | Y | | 强检周期(单位:年) | | replace_period | int4 | Y | | 定换周期(单位:年) | @@ -974,8 +996,12 @@ | customer_id | int8 | Y | | 客户ID | | maker_code | varchar(100) | N | | 厂家代码 | | model_code | varchar(100) | N | | 型号代码 | -| caliber_id | int8 | N | | 口径ID | -| range_id | int8 | N | | 量程ID | +| caliber_code | varchar(100) | Y | | 口径代码(与源设计对齐,优先使用) | +| range_code | varchar(100) | Y | | 量程代码(与源设计对齐,优先使用) | +| type | int4 | Y | | 水表分类/类型(见字典) | +| steel_mark | varchar(100) | Y | | 钢印号(源设计字段) | +| seal_number | varchar(100) | Y | | 水表编号(源设计字段) | +| check_code | varchar(100) | Y | | 强检编号(源设计字段) | | install_date | timestamp(6) | Y | | 安装日期 | | install_address | varchar(500) | Y | | 安装地址 | | meter_status | int2 | N | 0 | 水表状态:0-正常,1-故障,2-停用,3-拆除 | @@ -983,6 +1009,16 @@ | last_reading | numeric(15,3) | Y | 0 | 上次读数 | | check_date | timestamp(6) | Y | | 检定日期 | | expire_date | timestamp(6) | Y | | 到期日期 | +| gpsx | numeric(10,6) | Y | | GPSX坐标 | +| gpsy | numeric(10,6) | Y | | GPSY坐标 | +| latitude | numeric(10,6) | Y | | 纬度 | +| longitude | numeric(10,6) | Y | | 经度 | +| highly | numeric(10,2) | Y | | 高度(米) | +| imei | varchar(100) | Y | | 设备识别码 | +| imsi | varchar(100) | Y | | IMSI | +| module_code | varchar(100) | Y | | 模块号 | +| nfc_code | varchar(100) | Y | | NFC编号 | +| qr_code | varchar(100) | Y | | 二维码编号 | | remark | varchar(500) | Y | | 备注 | | create_time | timestamp(6) | N | pg_systimestamp() | 创建时间 | | update_time | timestamp(6) | N | pg_systimestamp() | 更新时间 |