1955 lines
118 KiB
Markdown
1955 lines
118 KiB
Markdown
## 文档概述
|
||
|
||
### 文档目的
|
||
|
||
*<span style="color: blue">(说明编写文档目的, 如:本文档主要为xxx项目的数据库设计说明,为用户设计接口及研发提供参照)</span>*
|
||
|
||
### 适用范围
|
||
|
||
*<span style="color: blue">(说明文档使用范围, 如:本文档适用于研发、运维人员等。。。)</span>*
|
||
|
||
### 参考资料
|
||
|
||
*<span style="color: blue">(列举参考的文献来源)</span>*
|
||
|
||
| 序号 | 文献名称 |
|
||
| -------------------------------------- | --------------------------------------------------- |
|
||
| *<span style="color: blue">[1]</span>* | *<span style="color: blue">《软件架构设计》</span>* |
|
||
| | |
|
||
|
||
## 术语、缩略语说明
|
||
|
||
|
||
| 术语、缩写 | 解释 | 更多说明 |
|
||
| ----- | -------------------- | ---------------------- |
|
||
| 水司 | 水务集团下的各个地区公司 | 在系统里表示租户,不同水司对应不同租户 |
|
||
| 分公司 | 水司下的各个分公司 | 在系统里表示部门,一般是顶级部门,下面是站点 |
|
||
| 站点 | 全名:营业站点,用于划分用户所属管辖区域 | 在系统里表示部门,对应部门管理,支持数据隔离 |
|
||
| 待补充 | | |
|
||
|
||
## 公共常量约定
|
||
|
||
### 默认状态-default_status
|
||
|
||
> <a id="default_status">默认状态</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| --- | ---- |
|
||
| 0 | 是 |
|
||
| 1 | 否 |
|
||
|
||
### 部门类型-dept_type
|
||
|
||
> <a id="default_status">默认状态</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 0 | 分公司 |
|
||
| 1 | 站点 |
|
||
|
||
### 阶梯类型-tiered_mode
|
||
|
||
> <a id="tiered_mode">阶梯类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| --- | ---- |
|
||
| 0 | 无阶梯 |
|
||
| 1 | 年度阶梯 |
|
||
| 2 | 月度阶梯 |
|
||
| 3 | 季度阶梯 |
|
||
|
||
### 计算类型-calculation_mode
|
||
|
||
> <a id="calculation_mode">计算类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| --- | ------ |
|
||
| 1 | 按水量计算 |
|
||
| 2 | 按人口数计算 |
|
||
| 3 | 固定金额 |
|
||
| 4 | 按户数计算 |
|
||
|
||
### 优惠方式-discount_type
|
||
|
||
> <a id="discount_type">优惠方式</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| --- | -------- |
|
||
| 1 | 按次优惠 |
|
||
| 2 | 按月优惠 |
|
||
| 3 | 按季优惠 |
|
||
| 4 | 按年优惠 |
|
||
| 5 | 无限期定量优惠 |
|
||
|
||
### 计划用水周期(scheme_cycle)
|
||
|
||
| 词语值 | 词语文本 |
|
||
| ------ | -------- |
|
||
| 1 | 月 |
|
||
| 2 | 季 |
|
||
| 3 | 年 |
|
||
|
||
---
|
||
|
||
### 计划模式(scheme_type)
|
||
|
||
| 词语值 | 词语文本 |
|
||
| ------ | ---------- |
|
||
| 1 | 超计划 |
|
||
| 2 | 非居民阶梯 |
|
||
|
||
### 客户类型(cust_type)
|
||
|
||
| 词语值 | 词语文本 |
|
||
| ------ | -------- |
|
||
| 1 | 居民 |
|
||
| 2 | 非居民 |
|
||
|
||
### 证件类型(certificate_type)
|
||
|
||
| 词语值 | 词语文本 |
|
||
| ------ | -------- |
|
||
| 1 | 身份证 |
|
||
| 2 | 军人证 |
|
||
| 3 | 户口本 |
|
||
| 4 | 护照 |
|
||
| 5 | 营业执照 |
|
||
|
||
### 自助机缴费方式(counter_am_type)
|
||
|
||
| 词语值 | 词语文本 |
|
||
| ------ | -------- |
|
||
| 1 | 微信 |
|
||
| 2 | 支付宝 |
|
||
| 3 | 银行卡 |
|
||
| 4 | 现金 |
|
||
| 5 | 其它 |
|
||
|
||
|
||
### 缴费方式(payment_method)
|
||
|
||
> <a id="payment_method">缴费方式</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 现金 |
|
||
| 2 | 代扣 |
|
||
| 3 | 托收 |
|
||
|
||
### 收费状态(charge_status)
|
||
|
||
> <a id="charge_status">收费状态</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 0 | 未收 |
|
||
| 1 | 已收 |
|
||
| 2 | 已结 |
|
||
| -1 | 呆账 |
|
||
|
||
### 优惠模式(preferential_mode)
|
||
|
||
> <a id="preferential_mode">优惠模式</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 按水量 |
|
||
| 2 | 按价格 |
|
||
|
||
### 优惠原因(preferential_reason)
|
||
|
||
> <a id="preferential_reason">优惠原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 用户申请 |
|
||
| 2 | 其它 |
|
||
|
||
### 价差调整原因(price_adjust_reason)
|
||
|
||
> <a id="price_adjust_reason">价差调整原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 用户协商 |
|
||
| 2 | 定价错误 |
|
||
| 3 | 其它 |
|
||
|
||
### 账务处理方式(account_process_type)
|
||
|
||
> <a id="account_process_type">账务处理方式</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 转预存 |
|
||
| 2 | 转退款 |
|
||
| 3 | 转销账 |
|
||
| 4 | 线下退款 |
|
||
|
||
### 问题上报类型(issue_report_type)
|
||
|
||
> <a id="issue_report_type">问题上报类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 换表申请 |
|
||
| 2 | 停水申请 |
|
||
| 3 | 复水申请 |
|
||
| 4 | 用户纠纷 |
|
||
|
||
### 抄表进度(meter_reading_progress)
|
||
|
||
> <a id="meter_reading_progress">抄表进度</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 0 | 未抄 |
|
||
| 1 | 已抄 |
|
||
| 3 | 外复 |
|
||
|
||
### 复水原因(water_restore_reason)
|
||
|
||
> <a id="water_restore_reason">复水原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 欠费缴清 |
|
||
| 2 | 恢复用水 |
|
||
| 3 | 其它 |
|
||
|
||
### 拆表原因(meter_remove_reason)
|
||
|
||
> <a id="meter_remove_reason">拆表原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 销户拆表 |
|
||
| 2 | 欠费拆表 |
|
||
| 3 | 临时停用 |
|
||
| 4 | 其它 |
|
||
|
||
### 换表原因(meter_change_reason)
|
||
|
||
> <a id="meter_change_reason">换表原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 用户申请 |
|
||
| 2 | 水司定检 |
|
||
| 3 | 其它 |
|
||
|
||
### 换表类型(meter_change_type)
|
||
|
||
> <a id="meter_change_type">换表类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 故障换表 |
|
||
| 2 | 批量换表 |
|
||
|
||
### 表卡恢复原因(card_restore_reason)
|
||
|
||
> <a id="card_restore_reason">表卡恢复原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 用户申请 |
|
||
| 2 | 欠费停水恢复 |
|
||
| 3 | 其他 |
|
||
|
||
### 表卡恢复类型(card_restore_type)
|
||
|
||
> <a id="card_restore_type">表卡恢复类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 内部停用恢复 |
|
||
| 2 | 用户保停恢复 |
|
||
|
||
### 分账调整原因(separate_adjust_reason)
|
||
|
||
> <a id="separate_adjust_reason">分账调整原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 一表多户 |
|
||
| 2 | 其它 |
|
||
|
||
### 分账调整类型(separate_adjust_type)
|
||
|
||
> <a id="separate_adjust_type">分账调整类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 按水量 |
|
||
| 2 | 按费用组成 |
|
||
|
||
### 分摊方式(allocation_method)
|
||
|
||
> <a id="allocation_method">分摊方式</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 按水量 |
|
||
| 2 | 按比例 |
|
||
| 3 | 其它 |
|
||
| 4 | 按累计水量 |
|
||
|
||
### 收费方式(charge_method)
|
||
|
||
> <a id="charge_method">收费方式</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 按实际水量 |
|
||
| 2 | 按固定水量 |
|
||
| 3 | 按人口数 |
|
||
| 4 | 按最低消费水量 |
|
||
|
||
### 表卡停用原因(card_stop_reason)
|
||
|
||
> <a id="card_stop_reason">表卡停用原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 用户申请 |
|
||
| 2 | 无人使用 |
|
||
|
||
### 停水原因(water_stop_reason)
|
||
|
||
> <a id="water_stop_reason">停水原因</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 长期未缴费 |
|
||
| 2 | 房屋动迁 |
|
||
| 3 | 其它 |
|
||
|
||
### 零税率标识(zero_tax_flag)
|
||
|
||
> <a id="zero_tax_flag">零税率标识</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 免税 |
|
||
| 2 | 不征税 |
|
||
| 3 | 普通零税率 |
|
||
| 4 | 非零税率 |
|
||
|
||
### 用户分组(user_group)
|
||
|
||
> <a id="user_group">用户分组</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 企业内 |
|
||
| 2 | 外聘人员 |
|
||
| 3 | 其它 |
|
||
|
||
### 工单类型(work_order_type)
|
||
|
||
> <a id="work_order_type">工单类型</a>
|
||
|
||
| 编码 | 中文含义 |
|
||
| ---- | -------- |
|
||
| 1 | 换表工单 |
|
||
| 2 | 维修工单 |
|
||
| 3 | 移表工单 |
|
||
| 4 | 拆表工单 |
|
||
|
||
### 客户组类型(cust_group_type)
|
||
|
||
| 词语值 | 词语文本 |
|
||
| ------ | -------- |
|
||
| 1 | 居民 |
|
||
| 2 | 单位 |
|
||
| 3 | 特业 |
|
||
|
||
|
||
|
||
## 数据库环境说明
|
||
|
||
*<span style="color: blue">(说明部署环境、工具、存放位置等)</span>*
|
||
|
||
### 命名规范
|
||
|
||
* 表名前面加上特定业务模块名称,例如:
|
||
* biz_(业务配置相关)
|
||
* mw_(表务相关)
|
||
|
||
## 逻辑设计
|
||
|
||
### 数据实体关系图
|
||
|
||
*<span style="color: blue">(说明本数据库反映的显示世界中的实体、属性和他们之间的关系等ER图)</span>*
|
||
|
||
#### 水表参数模块ER图
|
||
```mermaid
|
||
erDiagram
|
||
biz_meter_maker {
|
||
bigint id PK
|
||
varchar name
|
||
varchar code UK
|
||
varchar recharge_type
|
||
varchar address
|
||
varchar contact
|
||
varchar contact_number
|
||
varchar remark
|
||
}
|
||
|
||
biz_meter_model {
|
||
bigint id PK
|
||
varchar maker_code FK
|
||
varchar name
|
||
varchar code UK
|
||
varchar caliber_range
|
||
varchar remark
|
||
}
|
||
|
||
biz_meter_caliber {
|
||
bigint id PK
|
||
varchar name
|
||
decimal value
|
||
int check_period
|
||
int replace_period
|
||
decimal high_coefficient
|
||
decimal low_coefficient
|
||
}
|
||
|
||
biz_meter_range {
|
||
bigint id PK
|
||
varchar name
|
||
varchar code UK
|
||
decimal value
|
||
varchar remark
|
||
}
|
||
|
||
biz_meter_maker ||--o{ biz_meter_model : "厂家代码关联型号"
|
||
```
|
||
|
||
#### 地址参数模块ER图
|
||
```mermaid
|
||
erDiagram
|
||
system_dept {
|
||
bigint id PK
|
||
varchar name
|
||
bigint parent_id
|
||
varchar type
|
||
varchar code UK
|
||
varchar phone
|
||
varchar email
|
||
}
|
||
|
||
biz_company_account {
|
||
bigint id PK
|
||
varchar account_name
|
||
varchar account_address
|
||
varchar bank_name
|
||
varchar bank_code
|
||
varchar bank_account
|
||
}
|
||
|
||
biz_dept_account_rel {
|
||
bigint id PK
|
||
varchar dept_code FK
|
||
bigint account_id FK
|
||
varchar remark
|
||
}
|
||
|
||
biz_community {
|
||
bigint id PK
|
||
varchar name
|
||
varchar code UK
|
||
varchar address
|
||
varchar contact_number
|
||
varchar dept_code FK
|
||
bigint parent_id
|
||
varchar ancestor_list
|
||
}
|
||
|
||
biz_price_category {
|
||
bigint id PK
|
||
varchar name
|
||
varchar code UK
|
||
bigint parent_id
|
||
varchar ancestor_list
|
||
}
|
||
|
||
biz_price_dept_rel {
|
||
bigint id PK
|
||
varchar dept_code FK
|
||
varchar price_category_code FK
|
||
bit is_default
|
||
varchar remark
|
||
}
|
||
|
||
system_dept ||--o{ system_dept : "部门层级"
|
||
system_dept ||--o{ biz_dept_account_rel : "部门配置账户"
|
||
biz_company_account ||--o{ biz_dept_account_rel : "关联账户"
|
||
system_dept ||--o{ biz_community : "管辖小区"
|
||
biz_community ||--o{ biz_community : "小区层级"
|
||
system_dept ||--o{ biz_price_dept_rel : "部门配置价格归属"
|
||
biz_price_category ||--o{ biz_price_dept_rel : "价格归属关联部门"
|
||
biz_price_category ||--o{ biz_price_category : "价格归属层级"
|
||
```
|
||
|
||
#### 价格体系核心表ER图
|
||
```mermaid
|
||
erDiagram
|
||
biz_cost_component {
|
||
bigint id PK
|
||
varchar name
|
||
varchar code UK
|
||
decimal penalty_coefficient
|
||
bit zero_usage_calculation
|
||
}
|
||
|
||
biz_price_cost_adjustment {
|
||
bigint id PK
|
||
varchar price_category_code FK
|
||
varchar cost_component_code FK
|
||
int calculation_mode
|
||
bit is_tiered
|
||
int tiered_mode
|
||
int tier_level
|
||
decimal volume_coefficient
|
||
bit charge_penalty
|
||
}
|
||
|
||
biz_price_tier_adjustment {
|
||
bigint id PK
|
||
bigint cost_adjustment_id FK
|
||
varchar cost_component_code FK
|
||
int tier_level
|
||
decimal start_volume
|
||
decimal end_volume
|
||
decimal price
|
||
decimal volume_coefficient
|
||
}
|
||
|
||
biz_cost_component ||--o{ biz_price_cost_adjustment : "费用组成调整"
|
||
biz_price_cost_adjustment ||--o{ biz_price_tier_adjustment : "包含阶梯"
|
||
biz_cost_component ||--o{ biz_price_tier_adjustment : "费用组成阶梯"
|
||
```
|
||
|
||
#### 价格体系历史记录ER图
|
||
```mermaid
|
||
erDiagram
|
||
biz_price_adjustment_history {
|
||
bigint id PK
|
||
varchar price_category_code FK
|
||
varchar adjustment_name
|
||
date effective_date
|
||
date expiry_date
|
||
varchar adjustment_reason
|
||
varchar adjuster
|
||
datetime adjustment_time
|
||
}
|
||
|
||
biz_price_cost_adjustment_history {
|
||
bigint id PK
|
||
bigint history_id FK
|
||
varchar price_category_code FK
|
||
varchar cost_component_code FK
|
||
int calculation_mode
|
||
bit is_tiered
|
||
int tiered_mode
|
||
int tier_level
|
||
decimal volume_coefficient
|
||
bit charge_penalty
|
||
}
|
||
|
||
biz_price_tier_adjustment_history {
|
||
bigint id PK
|
||
bigint cost_adjustment_history_id FK
|
||
varchar cost_component_code FK
|
||
int tier_level
|
||
decimal start_volume
|
||
decimal end_volume
|
||
decimal price
|
||
decimal volume_coefficient
|
||
}
|
||
|
||
biz_price_adjustment_history ||--o{ biz_price_cost_adjustment_history : "调价记录包含费用历史"
|
||
biz_price_cost_adjustment_history ||--o{ biz_price_tier_adjustment_history : "费用历史包含阶梯历史"
|
||
```
|
||
|
||
#### 优惠方案ER图
|
||
```mermaid
|
||
erDiagram
|
||
biz_price_discount_scheme {
|
||
bigint id PK
|
||
varchar scheme_name
|
||
varchar scheme_code UK
|
||
varchar price_category_code FK
|
||
int discount_type
|
||
date effective_date
|
||
date expiry_date
|
||
varchar scheme_description
|
||
}
|
||
|
||
biz_price_discount_tier {
|
||
bigint id PK
|
||
varchar scheme_code FK
|
||
int tier_level
|
||
decimal start_volume
|
||
decimal end_volume
|
||
bit include_in_tier
|
||
}
|
||
|
||
biz_price_discount_scheme ||--o{ biz_price_discount_tier : "方案代码关联阶梯"
|
||
```
|
||
|
||
|
||
### 水价调整关系图
|
||
|
||
```mermaid
|
||
erDiagram
|
||
%% 顶层:水价归属和调价快照
|
||
biz_price_category["biz_price_category<br/>水价归属表"] {
|
||
bigint id PK
|
||
varchar name "归属名称"
|
||
varchar code UK "归属代码"
|
||
bigint parent_id "父级归属id"
|
||
varchar ancestor_list "祖级列表"
|
||
int sort "排序"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
biz_price_adjustment_snap["biz_price_adjustment_snap<br/>水价调整快照表"] {
|
||
bigint id PK
|
||
int code UK "快照编号/版本号"
|
||
datetime effective_date "生效日期"
|
||
datetime expiry_date "失效日期"
|
||
varchar adjuster "调价人"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间/调价时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 中层左:水价模版
|
||
biz_price_template["biz_price_template<br/>水价模版表"] {
|
||
bigint id PK
|
||
int sort "排序"
|
||
varchar name "用水性质"
|
||
varchar code UK "模版代码"
|
||
varchar price_category_code FK "水价归属代码"
|
||
bigint adjustment_snap_id FK "调价快照id"
|
||
int adjustment_snap_code FK "调价快照code"
|
||
int meter_start "起开量"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 中层右:费用组成
|
||
biz_cost_component["biz_cost_component<br/>费用组成表"] {
|
||
bigint id PK
|
||
varchar name "费用名称"
|
||
varchar code UK "费用代码"
|
||
decimal penalty_coefficient "违约金系数"
|
||
bit zero_usage_calculation "零用量是否计算"
|
||
int sort "排序"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 下层左:费用调整
|
||
biz_price_cost_adjustment["biz_price_cost_adjustment<br/>水价费用调整表"] {
|
||
bigint id PK
|
||
bigint template_id FK "水价模版id"
|
||
varchar cost_component_code FK "费用组成代码"
|
||
int calculation_mode "计算类型"
|
||
bit is_tiered "是否阶梯"
|
||
int tiered_mode "阶梯类型"
|
||
int tier_level "阶梯级别"
|
||
decimal volume_coefficient "水量系数"
|
||
bit charge_penalty "是否收取违约金"
|
||
int sort "排序"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 下层中:阶梯调整
|
||
biz_price_tier_adjustment["biz_price_tier_adjustment<br/>水价阶梯调整表"] {
|
||
bigint id PK
|
||
bigint cost_adjustment_id FK "水价费用调整id"
|
||
varchar cost_component_code FK "费用组成代码"
|
||
int tier_level "阶梯级别"
|
||
decimal start_volume "开始水量m3"
|
||
decimal end_volume "结束水量m3"
|
||
decimal price "价格元"
|
||
decimal volume_coefficient "水量系数"
|
||
int sort "排序"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 右侧:部门管理
|
||
system_dept["system_dept<br/>系统部门表"] {
|
||
bigint id PK
|
||
varchar name "部门名称"
|
||
bigint parent_id "父级部门id"
|
||
varchar code UK "部门代码"
|
||
varchar type "部门类型"
|
||
varchar phone "联系电话"
|
||
varchar email "邮箱"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人"
|
||
varchar updater "更新人"
|
||
int deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 右下:模版部门关系
|
||
biz_template_dept_rel["biz_template_dept_rel<br/>水价模版部门关系表"] {
|
||
bigint id PK
|
||
varchar dept_code FK "部门代码"
|
||
varchar template_code FK "水价调整模版代码"
|
||
bigint adjustment_snap_id FK "调价快照id"
|
||
int adjustment_snap_code FK "调价快照code"
|
||
bit is_default "是否默认"
|
||
varchar remark "备注"
|
||
int status "状态"
|
||
datetime create_time "创建时间"
|
||
datetime update_time "更新时间"
|
||
varchar creator "创建人id"
|
||
varchar updater "更新人id"
|
||
bit deleted "是否删除"
|
||
bigint tenant_id "租户id"
|
||
}
|
||
|
||
%% 核心业务关系链
|
||
biz_price_category ||--o{ biz_price_template : "code = price_category_code"
|
||
biz_price_adjustment_snap ||--o{ biz_price_template : "code = adjustment_snap_code"
|
||
biz_price_template ||--o{ biz_price_cost_adjustment : "id = template_id"
|
||
biz_cost_component ||--o{ biz_price_cost_adjustment : "code = cost_component_code"
|
||
biz_price_cost_adjustment ||--o{ biz_price_tier_adjustment : "id = cost_adjustment_id"
|
||
biz_cost_component ||--o{ biz_price_tier_adjustment : "code = cost_component_code"
|
||
|
||
%% 部门关系链
|
||
system_dept ||--o{ biz_template_dept_rel : "code = dept_code"
|
||
biz_price_template ||--o{ biz_template_dept_rel : "code = template_code"
|
||
biz_price_adjustment_snap ||--o{ biz_template_dept_rel : "code = adjustment_snap_code"
|
||
|
||
```
|
||
|
||
### 实体及关系描述
|
||
|
||
*<span style="color: blue">(按照ER图说明实体及实体间 一对一、一对多、多对多的关系)</span>*
|
||
|
||
|
||
|
||
## 物理设计
|
||
|
||
*<span style="color: blue">(说明是否采用分布式数据库、数据库表分部,存储空间等安排)</span>*
|
||
|
||
|
||
|
||
|
||
|
||
## 表结构设计
|
||
|
||
## 待补表清单(TODO)
|
||
|
||
> 说明:以下清单基于 `docs/design/04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md` 与当前 `backend` 真实表扫描结果整理,用于标识“数据字典或后端已出现,但当前文档尚未展开详细字段设计”的表或表组。
|
||
>
|
||
> 当前表结构设计已覆盖部分核心基础表、价格表、客户主表、抄表主表、营业账主表、托收/代扣主表、开票配置主表、统一工单主表;以下对象为后续优先补充范围。
|
||
|
||
### 已设计范围(当前文档)
|
||
|
||
当前已在本章展开设计的表包括:
|
||
|
||
- 水表基础:`biz_meter_maker`、`biz_meter_model`、`biz_meter_caliber`、`biz_meter_range`、`biz_meter`
|
||
- 组织账户:`system_dept`、`biz_company_account`、`biz_dept_account_rel`
|
||
- 基础主数据:`biz_community`、`biz_cust`、`biz_cust_group`
|
||
- 价格与方案:`biz_price_category`、`biz_cost_component`、`biz_price_adjustment_snap`、`biz_template_dept_rel`、`biz_price_template`、`biz_price_cost_adjustment`、`biz_price_tier_adjustment`、`biz_price_discount_scheme`、`biz_price_discount_tier`、`biz_price_discount_cost`、`biz_water_use_scheme`、`biz_water_use_scheme_tier`
|
||
- 页面配置:`infra_user_form_config`
|
||
- 抄表与账务:`biz_meter_book`、`biz_reading_data`、`biz_last_reading`、`biz_charge`、`biz_charge_detail`
|
||
- 银行与发票:`biz_collection`、`biz_withholding`、`biz_invoice`
|
||
- 业务办理:`biz_process`
|
||
|
||
### 待补设计范围(按领域归类)
|
||
|
||
#### 1. 客户信息扩展域
|
||
|
||
- `biz_account`(账户信息)
|
||
- `biz_cust_contact`(联系人)
|
||
- `biz_cust_app_binds`(客户应用绑定关联)
|
||
- `biz_cust_collection_rel`(客户托收中间关系)
|
||
- `biz_cust_withholding_rel`(客户代扣中间关系)
|
||
- `biz_cust_invoice`(客户开票信息)
|
||
- `biz_cust_meter`(客户与水表关系)
|
||
- `biz_cust_bill_type`(客户开账类型)
|
||
- `biz_cust_no_rule`、`biz_dept_cust_no_rule_rel`(客户编号规则)
|
||
- `biz_cust_hub_marks`(集收号/集收标记类)
|
||
- `biz_cust_water_use_scheme`、`biz_cust_water_scheme_rel`(客户计划用水关系)
|
||
|
||
#### 2. 抄表与表务扩展域
|
||
|
||
- `biz_meter_read`(抄表状态/抄表任务状态)
|
||
- `biz_reading_logs`(抄表日志)
|
||
- `biz_meter_log`(表务/抄表日志)
|
||
- `biz_meter_in_out`、`biz_meter_in_out_rel`(水表出入库及关联)
|
||
|
||
#### 3. 账务与收费处理扩展域
|
||
|
||
- 跨周期水量
|
||
- 特账 / 特账明细
|
||
- 退款账
|
||
- 阶梯累计量
|
||
- 收费汇总 / 收费小计 / 实时收费日志
|
||
- 红冲表
|
||
- 预存退款 / 预存退款详情
|
||
- 催缴登记 / 催缴停水 / 催缴明细
|
||
- 价差调整汇总 / 明细
|
||
- 分账调整汇总 / 明细
|
||
- 呆坏账汇总 / 明细
|
||
- 已销调整汇总 / 明细
|
||
- IC卡充退账 / 结余 / 操作日志
|
||
|
||
#### 4. 发票域扩展
|
||
|
||
- `biz_invoice_taxrate`(发票税率)
|
||
- 发票明细表
|
||
- 营业账开票关系表
|
||
- 发票信息关联表
|
||
- 发票修改记录
|
||
- `biz_process_invoice_modifys`(发票变更流程)
|
||
|
||
#### 5. 业务办理与工单子表域
|
||
|
||
- `biz_process_transfer`(流程流转)
|
||
- `biz_process_cust_contact`(流程联系人)
|
||
- `biz_process_meter_install`(装表流程信息)
|
||
- `biz_business_types`(业务类型)
|
||
- `biz_business_datas`(业务扩展数据)
|
||
- `biz_content`、`biz_content_attach`(资料与附件)
|
||
- 更名 / 过户 / 停复水 / 低保 / 换表 / 自助抄表等业务子表
|
||
- 稽查工单 / 移表工单 / PDA派单 / 上报清单 / 换表记录表
|
||
|
||
#### 6. 参数、页面与系统配置域
|
||
|
||
- `biz_parameter_settings`(系统参数/业务参数)
|
||
- `biz_page_settings`、`biz_page_settings_detail`(页面基础配置)
|
||
- `biz_extend_propertys`(扩展信息)
|
||
- `biz_bank`、`biz_bank_branch`(银行及分行)
|
||
- 账务年月表 / 抄表年月表
|
||
- 编号生成配置 / 编号生成记录
|
||
- 导出任务 / 站内消息 / 报表 / 日志管理
|
||
- 系统菜单表 / 权限表 / 词语字典表
|
||
|
||
#### 7. 银行代收与对账域
|
||
|
||
- `bk_payment_channel`
|
||
- `bk_channel_api_config`
|
||
- `bk_channel_route_rule`
|
||
- `bk_channel_statistics`
|
||
- `bk_transaction`
|
||
- `bk_transaction_callback`
|
||
- `bk_transaction_exception`
|
||
- `bk_withholding_agreement`
|
||
- `bk_withholding_batch`
|
||
- `bk_withholding_item`
|
||
- `bk_reconcile_batch`
|
||
- `bk_reconcile_diff`
|
||
- `bk_settlement_batch`
|
||
|
||
#### 8. 报装、微网厅与移动侧补充域
|
||
|
||
- 报装用户信息 / 报装工程项目 / 报装踏勘 / 工程验收信息
|
||
- 微网厅账户绑定、微信支付订单、网点门店、文章公告、页面配置等表
|
||
- 手机记录表 / PDA版本控制表
|
||
|
||
### 后续补充原则
|
||
|
||
1. 优先补充“后端已有真实表且业务价值高”的对象。
|
||
2. 对于数据字典中的旧系统表,若已被当前后端重构为统一模型,应在设计说明中注明“已合并映射”,而非机械按旧名重复建表。
|
||
3. 若某类对象仅在 `sw-module-system`、`sw-module-infra`、`sw-module-pay` 等模块中存在,后续应结合对应模块再次核对后补入。
|
||
|
||
## 表模块归属说明
|
||
|
||
> 说明:以下归属依据 `output/preview/福建水务营收系统整体架构图.html` 的业务子系统划分整理,用于明确“当前已设计表、真实后端表、待补表”在总体架构中的主归属模块。若某张表被多个子系统共同使用,以“主数据维护方、核心业务责任方”作为唯一主归属。
|
||
|
||
### 模块归属原则
|
||
|
||
1. 客户、账单、价格、收费等核心营收主数据,归属 `SYS-002 营收业务子系统`。
|
||
2. 水表设备主档、库存、出入库、设备日志等表务对象,归属 `SYS-006 表务管理子系统`。
|
||
3. 统一受理、流转、附件、业务办理过程数据,归属 `SYS-005 工单管理子系统`。
|
||
4. 发票主数据、税率、开票关系、回执与红冲作废,归属 `SYS-008 发票服务子系统`。
|
||
5. 支付渠道、交易、回调、代扣、对账、结算等资金链路数据,归属 `SYS-009 支付与银行结算子系统`。
|
||
6. `SYS-003 手机抄表APP` 与 `SYS-004 微网厅子系统` 原则上作为前端渠道,不单独持有核心业务主表,主要复用营收、工单、发票、支付等后端核心表;仅在出现终端同步、授权绑定、日志等专属数据时,才单独归入对应渠道子系统。
|
||
|
||
### 当前已设计表的模块归属
|
||
|
||
#### SYS-001 统一平台
|
||
|
||
- `system_dept`
|
||
|
||
#### SYS-002 营收业务子系统
|
||
|
||
- 客户与基础主数据:`biz_cust`、`biz_cust_group`、`biz_community`
|
||
- 价格与用水方案:`biz_price_category`、`biz_cost_component`、`biz_price_adjustment_snap`、`biz_template_dept_rel`、`biz_price_template`、`biz_price_cost_adjustment`、`biz_price_tier_adjustment`、`biz_price_discount_scheme`、`biz_price_discount_tier`、`biz_price_discount_cost`、`biz_water_use_scheme`、`biz_water_use_scheme_tier`
|
||
- 抄表开账:`biz_meter_book`、`biz_reading_data`、`biz_last_reading`
|
||
- 营业收费与账务:`biz_charge`、`biz_charge_detail`
|
||
|
||
#### SYS-005 工单管理子系统
|
||
|
||
- `biz_process`
|
||
|
||
#### SYS-006 表务管理子系统
|
||
|
||
- `biz_meter_maker`
|
||
- `biz_meter_model`
|
||
- `biz_meter_caliber`
|
||
- `biz_meter_range`
|
||
- `biz_meter`
|
||
|
||
#### SYS-008 发票服务子系统
|
||
|
||
- `biz_invoice`
|
||
|
||
#### SYS-009 支付与银行结算子系统
|
||
|
||
- `biz_collection`
|
||
- `biz_withholding`
|
||
|
||
#### 基础设施/页面配置能力
|
||
|
||
- `infra_user_form_config`
|
||
|
||
> 说明:`infra_user_form_config` 更偏表单与页面配置能力,建议作为基础设施支撑表看待,不直接归入单一营收业务子系统。
|
||
|
||
### 后续待补表的建议归属
|
||
|
||
#### SYS-002 营收业务子系统
|
||
|
||
- 客户扩展:`biz_account`、`biz_cust_contact`、`biz_cust_app_binds`、`biz_cust_meter`、`biz_cust_bill_type`、`biz_cust_no_rule`、`biz_dept_cust_no_rule_rel`、`biz_cust_hub_marks`、`biz_cust_water_use_scheme`、`biz_cust_water_scheme_rel`
|
||
- 抄表与开账扩展:`biz_meter_read`、`biz_reading_logs`
|
||
- 账务处理扩展:跨周期水量、特账/特账明细、退款账、阶梯累计量、收费汇总/收费小计/实时收费日志、红冲、预存退款、催缴登记、价差调整、分账调整、已销调整、呆坏账、IC卡账务等对象
|
||
- 参数配置扩展:`biz_parameter_settings`
|
||
|
||
#### SYS-005 工单管理子系统
|
||
|
||
- `biz_process_transfer`
|
||
- `biz_process_cust_contact`
|
||
- `biz_process_meter_install`
|
||
- `biz_business_types`
|
||
- `biz_business_datas`
|
||
- `biz_content`
|
||
- `biz_content_attach`
|
||
- 更名、过户、停复水、低保、换表、自助抄表、稽查工单、PDA派单等业务子表
|
||
|
||
#### SYS-006 表务管理子系统
|
||
|
||
- `biz_meter_log`
|
||
- `biz_meter_in_out`
|
||
- `biz_meter_in_out_rel`
|
||
|
||
#### SYS-008 发票服务子系统
|
||
|
||
- `biz_invoice_taxrate`
|
||
- `biz_cust_invoice`
|
||
- `biz_process_invoice_modifys`
|
||
- 发票明细表
|
||
- 营业账开票关系表
|
||
- 发票回执/作废/红冲/存证相关表
|
||
|
||
#### SYS-009 支付与银行结算子系统
|
||
|
||
- `biz_cust_collection_rel`
|
||
- `biz_cust_withholding_rel`
|
||
- `biz_bank`
|
||
- `biz_bank_branch`
|
||
- `bk_payment_channel`
|
||
- `bk_channel_api_config`
|
||
- `bk_channel_route_rule`
|
||
- `bk_channel_statistics`
|
||
- `bk_transaction`
|
||
- `bk_transaction_callback`
|
||
- `bk_transaction_exception`
|
||
- `bk_withholding_agreement`
|
||
- `bk_withholding_batch`
|
||
- `bk_withholding_item`
|
||
- `bk_reconcile_batch`
|
||
- `bk_reconcile_diff`
|
||
- `bk_settlement_batch`
|
||
|
||
#### SYS-003 / SYS-004 渠道子系统专属补充对象
|
||
|
||
- 微信绑定、默认账户、公众号配置、前台申请单、终端同步日志、PDA版本控制、移动端缓存同步等专属表
|
||
|
||
### 模块-表清单-状态总表
|
||
|
||
| 模块 | 表清单 | 状态 |
|
||
| --- | --- | --- |
|
||
| `SYS-001 统一平台` | `system_dept` | 已设计 |
|
||
| `SYS-002 营收业务子系统` | `biz_cust`、`biz_cust_group`、`biz_community` | 已设计 |
|
||
| `SYS-002 营收业务子系统` | `biz_price_category`、`biz_cost_component`、`biz_price_adjustment_snap`、`biz_template_dept_rel`、`biz_price_template`、`biz_price_cost_adjustment`、`biz_price_tier_adjustment`、`biz_price_discount_scheme`、`biz_price_discount_tier`、`biz_price_discount_cost`、`biz_water_use_scheme`、`biz_water_use_scheme_tier` | 已设计 |
|
||
| `SYS-002 营收业务子系统` | `biz_meter_book`、`biz_reading_data`、`biz_last_reading` | 已设计 |
|
||
| `SYS-002 营收业务子系统` | `biz_charge`、`biz_charge_detail` | 已设计 |
|
||
| `SYS-002 营收业务子系统` | `biz_account`、`biz_cust_contact`、`biz_cust_app_binds`、`biz_cust_meter`、`biz_cust_bill_type`、`biz_cust_no_rule`、`biz_dept_cust_no_rule_rel`、`biz_cust_hub_marks`、`biz_cust_water_use_scheme`、`biz_cust_water_scheme_rel` | 待补 |
|
||
| `SYS-002 营收业务子系统` | `biz_meter_read`、`biz_reading_logs` | 待补 |
|
||
| `SYS-002 营收业务子系统` | 跨周期水量、特账/特账明细、退款账、阶梯累计量、收费汇总/收费小计/实时收费日志、红冲、预存退款、催缴登记、价差调整、分账调整、已销调整、呆坏账、IC卡账务等对象 | 待补 |
|
||
| `SYS-002 营收业务子系统` | `biz_parameter_settings` | 待补 |
|
||
| `SYS-005 工单管理子系统` | `biz_process` | 已设计 |
|
||
| `SYS-005 工单管理子系统` | `biz_process_transfer`、`biz_process_cust_contact`、`biz_process_meter_install`、`biz_business_types`、`biz_business_datas`、`biz_content`、`biz_content_attach` | 待补 |
|
||
| `SYS-005 工单管理子系统` | 更名、过户、停复水、低保、换表、自助抄表、稽查工单、PDA派单等业务子表 | 待补 |
|
||
| `SYS-006 表务管理子系统` | `biz_meter_maker`、`biz_meter_model`、`biz_meter_caliber`、`biz_meter_range`、`biz_meter` | 已设计 |
|
||
| `SYS-006 表务管理子系统` | `biz_meter_log`、`biz_meter_in_out`、`biz_meter_in_out_rel` | 待补 |
|
||
| `SYS-008 发票服务子系统` | `biz_invoice` | 已设计 |
|
||
| `SYS-008 发票服务子系统` | `biz_invoice_taxrate`、`biz_cust_invoice`、`biz_process_invoice_modifys`、发票明细表、营业账开票关系表、发票回执/作废/红冲/存证相关表 | 待补 |
|
||
| `SYS-009 支付与银行结算子系统` | `biz_collection`、`biz_withholding` | 已设计 |
|
||
| `SYS-009 支付与银行结算子系统` | `biz_cust_collection_rel`、`biz_cust_withholding_rel`、`biz_bank`、`biz_bank_branch`、`bk_payment_channel`、`bk_channel_api_config`、`bk_channel_route_rule`、`bk_channel_statistics`、`bk_transaction`、`bk_transaction_callback`、`bk_transaction_exception`、`bk_withholding_agreement`、`bk_withholding_batch`、`bk_withholding_item`、`bk_reconcile_batch`、`bk_reconcile_diff`、`bk_settlement_batch` | 待补 |
|
||
| `基础设施/页面配置能力` | `infra_user_form_config` | 已设计 |
|
||
| `SYS-003 / SYS-004 渠道子系统` | 微信绑定、默认账户、公众号配置、前台申请单、终端同步日志、PDA版本控制、移动端缓存同步等专属表 | 待补 |
|
||
|
||
### 水表厂家表-biz_meter_maker
|
||
|
||
> 水表厂家基础信息管理,记录水表生产厂商的详细信息,支持水表型号的厂家归属管理
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| -------------- | ----- | --------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 厂家名称 | string / varchar(100) | 否 | 否 | |
|
||
| code | 厂家代码 | string / varchar(100) | 是 | 是 | |
|
||
| recharge_type | 充值类型 | string / varchar(10) | 否 | 否 | |
|
||
| address | 地址 | string / varchar(500) | 否 | 否 | |
|
||
| contact | 联系人 | string / varchar(100) | 否 | 否 | |
|
||
| contact_number | 联系号码 | string / varchar(100) | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水表型号表-biz_meter_model
|
||
|
||
> 水表型号管理,记录各厂家的水表型号信息
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------- | ----- | --------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| maker_code | 厂家代码 | string / varchar(100) | 否 | 是 | 关联[水表厂家表](###水表厂家表-biz_meter_maker) |
|
||
| name | 型号名称 | string / varchar(100) | 否 | 否 | |
|
||
| code | 型号代码 | string / varchar(100) | 是 | 是 | |
|
||
| caliber_range | 口径范围 | string / varchar(200) | 否 | 否 | 如:DN15-DN200 |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水表口径表-biz_meter_caliber
|
||
|
||
> 水表口径管理,涉及到抄表录入时的量高量低提醒
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ---------------- | ----- | ---------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 口径名称 | string / varchar(100) | 否 | 否 | |
|
||
| value | 口径值 | number / decimal(10,2) | 否 | 否 | 单位:毫米(mm) |
|
||
| check_period | 强检周期 | number / int | 否 | 否 | 单位:年 |
|
||
| replace_period | 定换周期 | number / int | 否 | 否 | 单位:年 |
|
||
| high_coefficient | 量高系数 | number / decimal(10,4) | 否 | 否 | 抄表量高提醒系数 |
|
||
| low_coefficient | 量低系数 | number / decimal(10,4) | 否 | 否 | 抄表量低提醒系数 |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水表量程表-biz_meter_range
|
||
|
||
> 水表量程管理
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ----------- | ----- | ---------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 量程名称 | string / varchar(100) | 否 | 否 | |
|
||
| code | 量程代码 | string / varchar(100) | 是 | 是 | |
|
||
| value | 量程值 | number / decimal(15,3) | 否 | 否 | 单位:立方米 |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 系统部门表-system_dept
|
||
|
||
> 系统部门管理表,原营业站点功能由此表承担,用于划分用户所属管辖区域,支持数据隔离
|
||
>
|
||
> **注意:在原表里添加了部门类型和部门代码字段**
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| -------------- | ------- | --------------------- | ---- | ---- | -------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 部门名称 | string / varchar(30) | 否 | 否 | |
|
||
| parent_id | 父级部门id | number / bigint(64) | 否 | 默认0 | 支持部门层级管理 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| leader_user_id | 负责人用户id | number / bigint(64) | 否 | 否 | |
|
||
| phone | 联系电话 | string / varchar(11) | 否 | 否 | |
|
||
| email | 邮箱 | string / varchar(50) | 否 | 否 | |
|
||
| longitude | 经度 | numeric(10, 6) | 否 | 否 | |
|
||
| latitude | 纬度 | numeric(10, 6) | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| type | 部门类型 | string / varchar(10) | 否 | 否 | |
|
||
| code | 部门代码 | string / varchar(50) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 是 | |
|
||
| creator | 创建人 | string / varchar(64) | 否 | 否 | |
|
||
| create_time | 创建时间 | timestamp | 否 | 否 | 默认当前时间 |
|
||
| updater | 更新人 | string / varchar(64) | 否 | 否 | |
|
||
| update_time | 更新时间 | timestamp | 否 | 否 | 默认当前时间 |
|
||
| deleted | 是否删除 | number / int | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水司账户表-biz_company_account
|
||
|
||
> 水司账户信息管理,记录水司的银行账户信息,用于收费缴费
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --------------- | ----- | --------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| account_name | 账户名称 | string / varchar(200) | 否 | 是 | |
|
||
| account_address | 账户地址 | string / varchar(500) | 否 | 否 | |
|
||
| bank_name | 开户行名称 | string / varchar(200) | 否 | 是 | |
|
||
| bank_code | 开户行代码 | string / varchar(100) | 否 | 是 | |
|
||
| bank_account | 开户行账户 | string / varchar(100) | 否 | 是 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 部门和水司账户关系表-biz_dept_account_rel
|
||
|
||
> 部门与水司账户的关联关系,一个部门可以关联多个水司账户
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ----------- | ------ | --------------------- | ---- | ---- | --------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| dept_code | 部门代码 | string / varchar(50) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) |
|
||
| account_id | 水司账户id | number / bigint(64) | 否 | 是 | 关联[水司账户表](###水司账户表-biz_company_account) |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 所属小区表-biz_community
|
||
|
||
> 所属小区信息管理,支持小区层级结构,用于客户地址归属管理
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| -------------- | ------ | ---------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 小区名称 | string / varchar(200) | 否 | 是 | |
|
||
| code | 小区代码 | string / varchar(100) | 是 | 是 | |
|
||
| address | 小区地址 | string / varchar(500) | 否 | 否 | |
|
||
| contact_number | 联系号码 | string / varchar(100) | 否 | 否 | |
|
||
| dept_code | 部门代码 | string / varchar(50) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) |
|
||
| parent_id | 父级小区id | number / bigint(64) | 否 | 否 | 支持小区层级管理 |
|
||
| ancestor_list | 祖级列表 | string / varchar(1000) | 否 | 否 | 格式:1,2,3 表示祖级小区id列表 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价归属表-biz_price_category
|
||
|
||
> 水价归属类别管理,支持层级结构,用于水价分类和用水性质管理
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------- | -------- | ---------------------- | ---- | ---- | ------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 归属名称 | string / varchar(100) | 否 | 否 | |
|
||
| code | 归属代码 | string / varchar(100) | 是 | 是 | |
|
||
| parent_id | 父级归属id | number / bigint(64) | 否 | 否 | 支持水价归属层级管理 |
|
||
| ancestor_list | 祖级列表 | string / varchar(1000) | 否 | 否 | 格式:1,2,3 表示祖级归属id列表 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 费用组成表-biz_cost_component
|
||
|
||
> 费用组成管理,定义水费的组成部分,如基本水费、污水处理费、垃圾处理费等
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ---------------------- | ---------- | ---------------------- | ---- | ---- | ------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 费用名称 | string / varchar(100) | 否 | 否 | |
|
||
| code | 费用代码 | string / varchar(100) | 是 | 是 | |
|
||
| penalty_coefficient | 违约金系数 | number / decimal(10,4) | 否 | 否 | 违约金计算系数,默认为0表示不收取违约金 |
|
||
| zero_usage_calculation | 零用量是否计算 | boolean / bit(1) | 否 | 默认0 | 0-不计算,1-计算 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价调整快照(历史)表-biz_price_adjustment_snap
|
||
|
||
> 水价调整历史记录表,记录每次调价的历史信息
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| -------------- | ----------------- | --------------------- | -------- | -------- | -------------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| code | 快照编号/版本号 | number / int | 是 | 是 | 1 -> 2 -> 3 首个版本为1 |
|
||
| effective_date | 生效日期 | datetime | 否 | 是 | |
|
||
| expiry_date | 失效日期 | datetime | 否 | 否 | 为空表示长期有效 |
|
||
| adjuster | 调价人 | string / varchar(100) | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间/调价时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价调整模版和部门关系表-biz_template_dept_rel
|
||
|
||
> 水价调整模版与部门的关联关系,不同部门可以配置不同的水价调整模版
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| -------------------- | ---------------- | --------------------- | -------- | -------- | ------------------------------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| dept_code | 部门代码 | string / varchar(50) | 否 | 是 | 关联[系统部门表](###系统部门表-system_dept) |
|
||
| template_code | 水价调整模版代码 | string / varchar(100) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) |
|
||
| adjustment_snap_code | 调价快照code | string / varchar(100) | 否 | 是 | 关联[水价调整快照(历史)表](###水价调整快照(历史)表-biz_price_adjustment_snap) |
|
||
| is_default | 是否默认 | boolean / bit(1) | 否 | 默认0 | 该部门是否默认使用此水价模版 |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价调整模版表-biz_price_template
|
||
|
||
> 水价调整模版表,记录每个水价归属下的模版配置
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| -------------------- | ------------- | --------------------- | -------- | -------- | ------------------------------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| name | 用水性质 | string / varchar(100) | 是 | 否 | |
|
||
| code | 模版代码/简号 | string / varchar(100) | 是 | 是 | |
|
||
| price_category_code | 水价归属代码 | string / varchar(100) | 是 | 是 | 关联[水价归属表](###水价归属表-biz_price_category) |
|
||
| adjustment_snap_code | 调价快照code | string / varchar(100) | 否 | 是 | 关联[水价调整快照(历史)表](###水价调整快照(历史)表-biz_price_adjustment_snap) |
|
||
| meter_start | 起开量 | number / int | 是 | 否 | |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
|
||
### 水价费用调整表-biz_price_cost_adjustment
|
||
|
||
> 水价费用调整表,记录每个水价归属下各费用组成的当前调价配置
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------------- | -------------- | ---------------------- | -------- | -------- | ---------------------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| template_id | 水价模版id | number / bigint(64) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) |
|
||
| cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 是 | 关联[费用组成表](###费用组成表-biz_cost_component) |
|
||
| calculation_mode | 计算类型 | number / int | 否 | 默认1 | 详见常量说明[计算类型](###计算类型-calculation_mode) |
|
||
| is_tiered | 是否阶梯 | boolean / bit(1) | 否 | 默认0 | 0-非阶梯,1-阶梯 |
|
||
| tiered_mode | 阶梯类型 | number / int | 否 | 默认0 | 详见常量说明[阶梯类型](###阶梯类型-tiered_mode) |
|
||
| tier_level | 阶梯级别 | number / int | 否 | 默认0 | 第几阶梯,如1、2、3等 限制子表条数 |
|
||
| volume_coefficient | 水量系数 | number / decimal(10,4) | 否 | 默认1 | 用于特殊计算场景 |
|
||
| charge_penalty | 是否收取违约金 | boolean / bit(1) | 否 | 默认1 | 0-不收取,1-收取 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价阶梯调整表-biz_price_tier_adjustment
|
||
|
||
> 水价阶梯调整表,记录每个费用组成在不同阶梯下的当前收费规则
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------------- | -------- | ---------------------- | ---- | ---- | ------------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| cost_adjustment_id | 水价费用调整id | number / bigint(64) | 否 | 是 | 关联[水价费用调整表](###水价费用调整表-biz_price_cost_adjustment) |
|
||
| cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 是 | 关联[费用组成表](###费用组成表-biz_cost_component) |
|
||
| tier_level | 阶梯级别 | number / int | 否 | 默认0 | 第几阶梯,如1、2、3等 |
|
||
| start_volume | 开始水量 | number / decimal(15,3) | 否 | 否 | 单位:立方米 |
|
||
| end_volume | 结束水量 | number / decimal(15,3) | 否 | 否 | 单位:立方米,为空表示无上限 |
|
||
| price | 价格 | number / decimal(10,4) | 否 | 是 | 单位:元/立方米或元(固定费用) |
|
||
| volume_coefficient | 水量系数 | number / decimal(10,4) | 否 | 默认1 | 用于特殊计算场景 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价优惠方案表-biz_price_discount_scheme
|
||
|
||
> 水价优惠方案表,针对某个水价归属制定优惠方案,管理不同费用组成的优惠配置
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------------ | ------------ | ---------------------- | -------- | -------- | ---------------------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| scheme_name | 方案名称 | string / varchar(200) | 否 | 是 | 如:居民用户优惠方案2024 |
|
||
| scheme_code | 方案代码 | string / varchar(100) | 是 | 是 | |
|
||
| template_code | 水价模版代码 | string / varchar(100) | 否 | 是 | 关联[水价调整模版表](###水价调整模版表-biz_price_template) |
|
||
| discount_type | 优惠方式 | number / int | 否 | 是 | 详见常量说明[优惠方式](###优惠方式-discount_type) |
|
||
| effective_date | 生效日期 | date | 否 | 是 | |
|
||
| expiry_date | 失效日期 | date | 否 | 否 | 为空表示长期有效 |
|
||
| scheme_description | 方案描述 | string / varchar(1000) | 否 | 否 | |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价优惠方案阶梯表-biz_price_discount_tier
|
||
|
||
> 水价优惠阶梯表,定义优惠方案的水量阶梯区间配置
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --------------- | ------------ | ---------------------- | -------- | -------- | ------------------------------------------------------------ |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| scheme_id | 优惠方案id | number / bigint(64) | 否 | 是 | 关联[水价优惠方案表](###水价优惠方案表-biz_price_discount_scheme) |
|
||
| tier_level | 阶梯级别 | number / int | 否 | 默认0 | 第几阶梯,如1、2、3等 |
|
||
| start_volume | 开始水量 | number / decimal(15,3) | 否 | 否 | 单位:立方米 |
|
||
| end_volume | 结束水量 | number / decimal(15,3) | 否 | 否 | 单位:立方米,为空表示无上限 |
|
||
| include_in_tier | 是否计入阶梯 | boolean / bit(1) | 否 | 默认1 | 0-不计入阶梯,1-计入阶梯 |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水价优惠方案阶梯费用表-biz_price_discount_cost
|
||
|
||
> 水价优惠费用表,记录每个阶梯下各费用组成的具体优惠价格配置
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------------- | ------ | ---------------------- | ---- | ---- | ----------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| tier_id | 优惠阶梯id | number / bigint(64) | 否 | 是 | 关联[水价优惠阶梯表](###水价优惠阶梯表-biz_price_discount_tier) |
|
||
| cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 是 | 关联[费用组成表](###费用组成表-biz_cost_component) |
|
||
| discount_price | 优惠价格 | number / decimal(10,4) | 否 | 是 | 单位:元/立方米或元(固定费用) |
|
||
| sort | 排序 | number / int | 否 | 默认0 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
|
||
### **用户表单字段配置-infra_user_form_config**
|
||
|
||
| **字段名** | **中文含义** | **字段类型** | **是否唯一** | **是否必填** | **字段说明** |
|
||
| ------------ | -------- | --------------------- | -------- | -------- | ------------- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| user_id | 用户ID | number / bigint(64) | 否 | 否 | 个人配置时使用 |
|
||
| role_id | 角色ID | number / bigint(64) | 否 | 否 | 角色配置时使用 |
|
||
| config_type | 配置类型 | number / tinyint | 否 | 是 | 1-个人配置,2-角色配置 |
|
||
| menu_id | 表格标识 | string / varchar(100) | 否 | 是 | 关联system_menu |
|
||
| column_key | 列字段标识 | string / varchar(100) | 否 | 是 | |
|
||
| column_title | 自定义列标题 | string / varchar(100) | 否 | 否 | |
|
||
| column_width | 列宽度 | number / int | 否 | 否 | |
|
||
| is_visible | 是否显示 | number / int | 否 | 默认1 | 0-隐藏,1-显示 |
|
||
| is_printable | 是否可打印 | number / int | 否 | 默认0 | 0-否,1-是 |
|
||
| sort_order | 排序序号 | number / int | 否 | 默认0 | |
|
||
| creator | 创建人 | string / varchar(64) | 否 | 否 | |
|
||
| create_time | 创建时间 | datetime | 否 | 默认当前时间 | |
|
||
| updater | 更新人 | string / varchar(64) | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 默认当前时间 | 自动更新 |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户编号 | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### **计划用水方案-biz_water_use_scheme**
|
||
|
||
| **字段名** | **中文含义** | **字段类型** | **是否唯一** | **是否必填** | **字段说明** |
|
||
| ------------------- | ------------- | --------------------- | ------------ | ------------ | ------------------------------------------------------------ |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| name | 方案名称 | string / varchar(64) | 否 | 否 | |
|
||
| price_category_code | 水价归属 | string / varchar(100) | 是 | 是 | 关联[水价归属表](app://obsidian.md/index.html###水价归属表-biz_price_category) |
|
||
| scheme_cycle | 开账/计划周期 | number / int | 否 | 否 | [计划用水周期(scheme_cycle)](计划用水周期(scheme_cycle)) |
|
||
| scheme_type | 计划模式 | number / int | 否 | 否 | [计划模式(scheme_type)](计划模式(scheme_type)) |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) |
|
||
| creator | 创建人 | string / varchar(64) | 否 | 否 | |
|
||
| create_time | 创建时间 | datetime | 否 | 默认当前时间 | |
|
||
| updater | 更新人 | string / varchar(64) | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 默认当前时间 | 自动更新 |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户编号 | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### **计划用水方案阶梯-biz_water_use_scheme_tier**
|
||
|
||
| **字段名** | **中文含义** | **字段类型** | **是否唯一** | **是否必填** | **字段说明** |
|
||
| ----------- | -------------- | ---------------------- | ------------ | ------------ | ------------------------------------------------------------ |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| scheme_id | 计划用水方案id | string / varchar(100) | 否 | 是 | 关联[计划用水方案](app://obsidian.md/index.html###计划用水方案-biz_water_use_scheme) |
|
||
| level | 级别 | string / varchar(64) | 否 | 否 | |
|
||
| start_water | 阶梯下限 | number / int | 否 | 否 | |
|
||
| end_water | 阶梯上限 | number / int | 否 | 否 | |
|
||
| price | 价格 | number / decimal(10,4) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) |
|
||
| creator | 创建人 | string / varchar(64) | 否 | 否 | |
|
||
| create_time | 创建时间 | datetime | 否 | 默认当前时间 | |
|
||
| updater | 更新人 | string / varchar(64) | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 默认当前时间 | 自动更新 |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户编号 | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
|
||
|
||
### **客户资料-biz_cust**
|
||
|
||
| **字段名** | **中文含义** | **字段类型** | **是否唯一** | **是否必填** | **字段说明** |
|
||
| ---------------------- | ---------------- | --------------------- | ------------ | ------------ | ------------------------------------------------------------ |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| cust_code | 客户编号 | string / varchar | 否 | 否 | |
|
||
| cust_name | 客户名称 | string / varchar | 否 | 否 | |
|
||
| cust_address | 客户地址 | string / varchar | 否 | 否 | |
|
||
| cust_type | 用户类型 | number / int | 否 | 否 | 详见[客户类型](#客户类型(cust_type))枚举值 |
|
||
| cust_group_code | 客户组编号 | string / varchar | 否 | 是 | 关联客户组 |
|
||
| cust_collect_code | 集收编号 | string / varchar | 否 | 是 | 关联集收 |
|
||
| certificate_type | 证件类型 | number / int | 否 | 是 | 详见[证件类型](#证件类型(certificate_type))枚举值 |
|
||
| certificate_account | 证件号码 | string / varchar | 否 | 是 | |
|
||
| org_id | 营业站点Id | number / int | 否 | 否 | |
|
||
| area_id | 所属小区Id | number / int | 否 | 是 | |
|
||
| price_category_code | 水价归属 | string / varchar(100) | 是 | 否 | 关联[水价归属表](app://obsidian.md/index.html###水价归属表-biz_price_category) |
|
||
| book_id | 册本Id | number / int | 否 | 否 | 关联册本 |
|
||
| book_sort_index | 册本序号 | number / int | 否 | 否 | |
|
||
| unit_no | 单元号 | string / varchar | 否 | 是 | |
|
||
| contract_no | 供水合同号 | string / varchar | 否 | 是 | |
|
||
| contract_date | 供水合同签订日期 | datetime | 否 | 否 | |
|
||
| meter_id | 启用水表ID | number / int | 否 | 是 | 关联水表 |
|
||
| pay_method | 缴费方式 | number / int | 否 | 否 | 详见[自助机缴费方式](#自助机缴费方式(counter_am_type))枚举值 |
|
||
| pay_cust_code | 付款户号 | string / varchar | 否 | 否 | |
|
||
| bill_type | 开账类型 | number / int | 否 | 否 | |
|
||
| invoice_id | 发票id | number / int | 否 | 是 | 关联发票 |
|
||
| statistical_type | 统计分类 | string / varchar | 否 | 是 | 统计分类枚举值 |
|
||
| population | 人口数 | number / int | 否 | 否 | |
|
||
| is_over | 是否超计划 | boolean / tinyint | 否 | 否 | 默认值: 0 |
|
||
| is_preferential_scheme | 是否低保优惠 | boolean / tinyint | 否 | 否 | 默认值: 0 |
|
||
| preferential_scheme_id | 优惠低保方案 | number / int | 否 | 是 | |
|
||
| is_we_chat | 是否绑定微信 | boolean / tinyint | 否 | 否 | 默认值: 0 |
|
||
| credit_rate | 信用等级 | number / int | 否 | 否 | 默认值: 0 |
|
||
| cust_state | 客户状态 | number / int | 否 | 否 | 客户状态枚举值 |
|
||
| build_date | 立户时间 | datetime | 否 | 否 | |
|
||
| book_date | 入册时间 | datetime | 否 | 是 | |
|
||
| transfer_date | 过户时间 | datetime | 否 | 是 | |
|
||
| deactivate_date | 停用时间 | datetime | 否 | 是 | |
|
||
| unregister_date | 注销时间 | datetime | 否 | 是 | |
|
||
| garbage_remark | 垃圾费备注 | string / varchar | 否 | 是 | |
|
||
| remark | 备注 | string / varchar | 否 | 是 | |
|
||
| extra_properties | 扩展字段内容 | string / longtext | 否 | 是 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](app://obsidian.md/index.html###默认状态-default_status) |
|
||
| creator | 创建人 | string / varchar(64) | 否 | 否 | |
|
||
| create_time | 创建时间 | datetime | 否 | 默认当前时间 | |
|
||
| updater | 更新人 | string / varchar(64) | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 默认当前时间 | 自动更新 |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户编号 | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 客户组表-biz_cust_group
|
||
|
||
> 客户组管理表,用于管理集团客户或批量客户的分组信息,支持统一管理和批量操作
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| ------------------- | ------------------ | --------------------- | -------- | -------- | ---------------------------------------------------------- |
|
||
| id | 主键 | number / bigint(64) | 是 | 是 | |
|
||
| code | 客户组编号 | string / varchar(100) | 是 | 是 | |
|
||
| name | 客户组名称 | string / varchar(200) | 否 | 是 | |
|
||
| address | 客户组地址 | string / varchar(500) | 否 | 否 | |
|
||
| type | 客户组类型 | number / int | 否 | 否 | 详见常量说明[客户组类型](###客户组类型(cust_group_type)) |
|
||
| legal_person | 法人 | string / varchar(100) | 否 | 否 | |
|
||
| credit_code | 统一社会信用代码 | string / varchar(100) | 否 | 否 | |
|
||
| certificate_type | 证件类型 | number / int | 否 | 否 | 详见常量说明[证件类型](###证件类型(certificate_type)) |
|
||
| certificate_account | 证件号码 | string / varchar(100) | 否 | 否 | |
|
||
| contact | 联系人 | string / varchar(100) | 否 | 否 | |
|
||
| mobile | 联系电话 | string / varchar(20) | 否 | 否 | |
|
||
| telephone | 座机 | string / varchar(20) | 否 | 否 | |
|
||
| email | 邮箱 | string / varchar(100) | 否 | 否 | |
|
||
| fax | 传真 | string / varchar(20) | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 水表信息表-biz_meter
|
||
|
||
> 水表主档信息表,用于管理实物水表、远传采集标识、库存归属及表务状态,是客户挂表、抄表、换表、远传接入的核心基础表。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| dept_id | 仓库/部门ID | number / bigint(64) | 否 | 否 | 关联组织或仓库 |
|
||
| maker_code | 水表厂家代码 | string / varchar(100) | 否 | 否 | 关联`biz_meter_maker` |
|
||
| model_code | 水表型号代码 | string / varchar(100) | 否 | 否 | 关联`biz_meter_model` |
|
||
| caliber_code | 水表口径代码 | string / varchar(100) | 否 | 否 | 关联`biz_meter_caliber` |
|
||
| range_code | 水表量程代码 | string / varchar(100) | 否 | 否 | 关联`biz_meter_range` |
|
||
| type | 水表分类 | number / tinyint | 否 | 否 | 普通表/远传表等 |
|
||
| cust_code | 客户编号 | string / varchar(100) | 否 | 否 | 当前绑定客户 |
|
||
| project_code | 工程编码 | string / varchar(100) | 否 | 否 | 报装/工程来源标识 |
|
||
| steel_mark | 钢印号 | string / varchar(100) | 否 | 否 | |
|
||
| seal_number | 水表编号 | string / varchar(100) | 否 | 否 | 表具编号 |
|
||
| bar_code | 条形码 | string / varchar(100) | 否 | 否 | |
|
||
| check_code | 强检编号 | string / varchar(100) | 否 | 否 | |
|
||
| make_date | 生产日期 | datetime | 否 | 否 | |
|
||
| check_date | 强检日期 | datetime | 否 | 否 | |
|
||
| collect_code | 采集号 | string / varchar(100) | 否 | 否 | 远传采集设备编号 |
|
||
| gpsx | GPSX坐标 | number / decimal(18,6) | 否 | 否 | |
|
||
| gpsy | GPSY坐标 | number / decimal(18,6) | 否 | 否 | |
|
||
| latitude | 纬度 | number / decimal(18,6) | 否 | 否 | |
|
||
| longitude | 经度 | number / decimal(18,6) | 否 | 否 | |
|
||
| imei | 设备识别码 | string / varchar(100) | 否 | 否 | 远传设备识别码 |
|
||
| imsi | IMSI | string / varchar(100) | 否 | 否 | |
|
||
| module_code | 模块号 | string / varchar(100) | 否 | 否 | |
|
||
| nfc_code | NFC编号 | string / varchar(100) | 否 | 否 | |
|
||
| qr_code | 二维码编号 | string / varchar(100) | 否 | 否 | |
|
||
| meter_status | 表务状态 | number / tinyint | 否 | 否 | 水表生命周期状态 |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / tinyint | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 抄表册本表-biz_meter_book
|
||
|
||
> 抄表册本主表,用于按站点、抄表员、周期组织客户抄表任务,是生成抄表数据与后续开账批次的基础对象。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| code | 册本编码 | string / varchar(100) | 是 | 是 | |
|
||
| name | 册本名称 | string / varchar(200) | 否 | 是 | |
|
||
| dept_id | 站点ID | number / bigint(64) | 否 | 是 | 关联部门/站点 |
|
||
| meter_read_id | 抄表员ID | number / bigint(64) | 否 | 否 | |
|
||
| urger_id | 催缴员ID | number / bigint(64) | 否 | 否 | |
|
||
| read_cycle | 抄表周期 | number / tinyint | 否 | 否 | 月/季/年等 |
|
||
| start_date | 起抄时间 | datetime | 否 | 否 | |
|
||
| next_read_date | 下次抄表时间 | datetime | 否 | 否 | |
|
||
| read_method | 抄表方式 | number / tinyint | 否 | 否 | 人工/远传等 |
|
||
| is_temp | 册本类型 | number / tinyint | 否 | 否 | 正式/临时 |
|
||
| book_mark | 册本标识 | number / tinyint | 否 | 否 | 特殊业务分类 |
|
||
| work_times | 工次 | number / int | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / tinyint | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 抄表数据表-biz_reading_data
|
||
|
||
> 抄表作业数据表,承载每次抄表过程中的读数、状态、审核、复核、退补等信息,是开账与异常处理的直接数据来源。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| cust_id | 客户ID | number / bigint(64) | 否 | 是 | 关联客户资料 |
|
||
| cust_meter_id | 客户水表ID | number / bigint(64) | 否 | 否 | 关联客户挂表关系 |
|
||
| cust_meter_status | 客户水表状态 | number / int | 否 | 否 | |
|
||
| dept_id | 站点ID | number / bigint(64) | 否 | 否 | |
|
||
| bill_month | 抄表期间 | number / int | 否 | 是 | 格式YYYYMM |
|
||
| meter_reader_id | 抄表员ID | string / varchar(100) | 否 | 否 | |
|
||
| book_id | 册本ID | number / bigint(64) | 否 | 否 | 关联`biz_meter_book` |
|
||
| book_code | 册本编号 | string / varchar(100) | 否 | 否 | |
|
||
| read_cycle | 抄表周期 | number / int | 否 | 否 | |
|
||
| read_method | 抄表方式 | number / int | 否 | 否 | |
|
||
| read_type | 抄表类型 | number / int | 否 | 否 | 正常抄表/补抄等 |
|
||
| read_times | 抄表次数 | number / int | 否 | 否 | |
|
||
| last_reading | 上次读数 | number / decimal(18,4) | 否 | 否 | |
|
||
| last_child_reading | 上次子读数 | number / decimal(18,4) | 否 | 否 | |
|
||
| last_read_date | 上次抄表日期 | datetime | 否 | 否 | |
|
||
| last_read_water | 上次抄表水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| last_read_state_id | 上次抄表状态ID | number / bigint(64) | 否 | 否 | |
|
||
| reading | 本次读数 | number / decimal(18,4) | 否 | 否 | |
|
||
| child_reading | 本次子读数 | number / decimal(18,4) | 否 | 否 | |
|
||
| read_date | 抄表日期 | datetime | 否 | 否 | |
|
||
| read_water | 抄表水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| read_state_id | 抄表状态ID | number / bigint(64) | 否 | 否 | |
|
||
| is_estimate | 是否估算 | boolean / bit(1) | 否 | 默认0 | |
|
||
| replace_water | 替代表量 | number / decimal(18,4) | 否 | 否 | 换表或估算修正 |
|
||
| avg_water | 平均水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| review_state | 审核状态 | number / int | 否 | 否 | |
|
||
| review_user | 审核人 | string / varchar(100) | 否 | 否 | |
|
||
| review_date | 审核日期 | datetime | 否 | 否 | |
|
||
| check_water | 复核水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| check_state | 复核状态 | number / int | 否 | 否 | |
|
||
| check_user | 复核人 | string / varchar(100) | 否 | 否 | |
|
||
| check_date | 复核日期 | datetime | 否 | 否 | |
|
||
| read_remark | 抄表备注 | string / varchar(500) | 否 | 否 | |
|
||
| refund_reason | 退费原因 | number / int | 否 | 否 | |
|
||
| refund_water | 退费水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 抄表记录状态 |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 上次抄表表-biz_last_reading
|
||
|
||
> 上次抄表快照表,用于为下一期抄表、开账、阶梯累计和异常核算提供基线数据。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| cust_id | 客户ID | number / bigint(64) | 否 | 是 | |
|
||
| cust_code | 客户编号 | string / varchar(100) | 否 | 是 | |
|
||
| bill_month | 抄表年月 | number / int | 否 | 是 | 格式YYYYMM |
|
||
| read_date | 抄表时间 | datetime | 否 | 否 | |
|
||
| reading | 抄码 | number / decimal(18,4) | 否 | 否 | |
|
||
| child_reading | 子表抄码 | number / decimal(18,4) | 否 | 否 | |
|
||
| read_water | 抄见水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| replace_water | 换表水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| read_state_id | 抄表状态 | number / bigint(64) | 否 | 否 | |
|
||
| state_times | 状态连续次数 | number / int | 否 | 否 | |
|
||
| check_water | 开账水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| change | 零头 | number / decimal(18,4) | 否 | 否 | |
|
||
| check_times | 开账次数 | number / int | 否 | 否 | |
|
||
| month_total_water | 月度累计量 | number / decimal(18,4) | 否 | 否 | |
|
||
| quarter_total_water | 季度累计量 | number / decimal(18,4) | 否 | 否 | |
|
||
| year_total_water | 年度累计量 | number / decimal(18,4) | 否 | 否 | |
|
||
| his_read_water | 历史抄见水量 | string / longtext | 否 | 否 | 历史轨迹记录 |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 营业账表-biz_charge
|
||
|
||
> 营业账主表,是营收系统最核心的账务表之一,汇总客户、册本、抄表、用水量、金额、收费、开票、优惠等信息。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| meter_id | 水表ID | number / bigint(64) | 否 | 是 | 关联水表 |
|
||
| record_id | 抄表ID | number / bigint(64) | 否 | 否 | 关联`biz_reading_data` |
|
||
| bill_month | 账务年月 | number / int | 否 | 是 | 格式YYYYMM |
|
||
| dept_id | 站点ID | number / bigint(64) | 否 | 否 | |
|
||
| book_id | 册本ID | number / bigint(64) | 否 | 否 | |
|
||
| book_sort_index | 册内顺序 | number / int | 否 | 否 | |
|
||
| cust_id | 客户ID | number / bigint(64) | 否 | 是 | |
|
||
| cust_code | 客户编号 | string / varchar(100) | 否 | 否 | |
|
||
| cust_name | 客户名称 | string / varchar(200) | 否 | 否 | |
|
||
| cust_address | 客户地址 | string / varchar(500) | 否 | 否 | |
|
||
| population | 人口数 | number / int | 否 | 否 | |
|
||
| pay_method | 缴费方式 | number / int | 否 | 否 | 详见常量说明[缴费方式](#payment_method) |
|
||
| last_reading | 上次抄码 | number / decimal(18,4) | 否 | 否 | |
|
||
| reading | 本次抄码 | number / decimal(18,4) | 否 | 否 | |
|
||
| read_water | 本次抄见水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| read_date | 本次抄表时间 | datetime | 否 | 否 | |
|
||
| adjustment_snap_code | 调价快照编码 | string / varchar(100) | 否 | 否 | 关联`biz_price_adjustment_snap` |
|
||
| price_template_code | 水价模板编码 | string / varchar(100) | 否 | 否 | 关联`biz_price_template` |
|
||
| bill_water | 开账水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| bill_amount | 开账金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| extended_amount | 应收金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| late_fee | 滞纳金 | number / decimal(18,4) | 否 | 否 | |
|
||
| pay_date | 收费时间 | datetime | 否 | 否 | |
|
||
| checkout_date | 结账时间 | datetime | 否 | 否 | |
|
||
| charge_method | 收费途径 | number / int | 否 | 否 | 柜台/线上/批量等 |
|
||
| charge_way | 收费渠道 | number / int | 否 | 否 | 渠道分类 |
|
||
| pay_state | 收费状态 | number / int | 否 | 否 | 详见常量说明[收费状态](#charge_status) |
|
||
| invoice_code | 发票代码 | string / varchar(100) | 否 | 否 | |
|
||
| invoice_date | 开票日期 | datetime | 否 | 否 | |
|
||
| invoice_number | 发票编号 | string / varchar(100) | 否 | 否 | |
|
||
| invoice_state | 开票状态 | number / int | 否 | 否 | |
|
||
| subtotal_id | 收费小计ID | number / bigint(64) | 否 | 否 | |
|
||
| task_id | 流程任务ID | string / varchar(100) | 否 | 否 | |
|
||
| water_fee | 用水费 | number / decimal(18,4) | 否 | 否 | |
|
||
| sewage_fee | 污水处理费 | number / decimal(18,4) | 否 | 否 | |
|
||
| garbage_fee | 垃圾费 | number / decimal(18,4) | 否 | 否 | |
|
||
| over_plan_fee | 超计划费 | number / decimal(18,4) | 否 | 否 | |
|
||
| discount_money | 优惠金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| original_money | 优惠前金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| refund_water | 退补水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| used_over_total | 超计划累计量 | number / decimal(18,4) | 否 | 否 | |
|
||
| community_id | 所属小区ID | number / bigint(64) | 否 | 否 | |
|
||
| cust_type | 用户类型 | number / int | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 营业账明细表-biz_charge_detail
|
||
|
||
> 营业账明细表,用于分解营业账中的费用组成、阶梯区间、分摊方式、金额构成,是计费规则落地的明细层对象。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| fee_id | 费用ID | number / bigint(64) | 否 | 是 | 关联`biz_charge` |
|
||
| adjustment_snap_code | 调价快照编码 | string / varchar(100) | 否 | 否 | |
|
||
| price_template_code | 水价模板编码 | string / varchar(100) | 否 | 否 | |
|
||
| cost_adjustment_id | 费用调整ID | number / bigint(64) | 否 | 否 | 关联`biz_price_cost_adjustment` |
|
||
| cost_component_code | 费用组成代码 | string / varchar(100) | 否 | 否 | 关联`biz_cost_component` |
|
||
| calc_mode | 计算方式 | number / int | 否 | 否 | 详见常量说明[计算类型](#calculation_mode) |
|
||
| level_type | 阶梯模式 | number / int | 否 | 否 | 详见常量说明[阶梯类型](#tiered_mode) |
|
||
| level_index | 阶梯级别 | number / int | 否 | 否 | |
|
||
| start_month | 开始月份 | number / int | 否 | 否 | |
|
||
| end_month | 结束月份 | number / int | 否 | 否 | |
|
||
| start_water | 开始水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| end_water | 结束水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| settle_method | 分摊方式 | number / int | 否 | 否 | 详见常量说明[分摊方式](#allocation_method) |
|
||
| settle_values | 分摊值 | number / decimal(18,4) | 否 | 否 | |
|
||
| price | 单价 | number / decimal(18,4) | 否 | 否 | |
|
||
| water | 应收水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| discount_water | 优惠水量 | number / decimal(18,4) | 否 | 否 | |
|
||
| water_num | 水量系数 | number / decimal(18,4) | 否 | 否 | |
|
||
| money | 金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| state | 状态 | number / int | 否 | 否 | 明细状态 |
|
||
| is_preferential | 是否优惠 | boolean / tinyint | 否 | 默认0 | |
|
||
| basic_number | 基数 | number / decimal(18,4) | 否 | 否 | |
|
||
| invoiced_state | 开票状态 | number / int | 否 | 否 | |
|
||
| discount_money | 优惠金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| original_money | 优惠前金额 | number / decimal(18,4) | 否 | 否 | |
|
||
| is_water_over | 是否超计划 | boolean / tinyint | 否 | 默认0 | |
|
||
| item_invoice_error | 明细开票错误 | string / varchar(500) | 否 | 否 | |
|
||
| item_invoice_state | 明细开票状态 | number / int | 否 | 否 | |
|
||
| item_invoice_type | 明细开票类型 | number / int | 否 | 否 | |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 托收资料表-biz_collection
|
||
|
||
> 托收资料主表,用于维护用户托收协议、银行账户、签约联系方式等信息,支撑批量托收与银行送盘业务。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| contract_no | 托收合同号 | string / varchar(100) | 否 | 否 | |
|
||
| agreement_no | 托收协议号 | string / varchar(100) | 否 | 否 | |
|
||
| bank_id | 总行ID | number / bigint(64) | 否 | 否 | 关联`biz_bank` |
|
||
| branchs_id | 分行ID | number / bigint(64) | 否 | 否 | 关联`biz_bank_branch` |
|
||
| account_no | 银行账号 | string / varchar(100) | 否 | 否 | |
|
||
| account_name | 开户户名 | string / varchar(200) | 否 | 否 | |
|
||
| account_address | 开户地址 | string / varchar(500) | 否 | 否 | |
|
||
| contact | 联系人 | string / varchar(100) | 否 | 否 | |
|
||
| mobile | 联系电话 | string / varchar(100) | 否 | 否 | 可脱敏/加密存储 |
|
||
| telephone | 座机 | string / varchar(100) | 否 | 否 | 可脱敏/加密存储 |
|
||
| contract_date | 签约日期 | datetime | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 代扣资料表-biz_withholding
|
||
|
||
> 银行代扣资料主表,用于维护代扣合同、账户、银行分支和签约信息,支撑批量代扣与银行代扣协议管理。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| bank_id | 总行ID | number / int | 否 | 否 | 关联`biz_bank` |
|
||
| branchs_id | 分行ID | number / int | 否 | 否 | 关联`biz_bank_branch` |
|
||
| account_no | 银行账号 | string / varchar(100) | 否 | 否 | |
|
||
| account_name | 开户户名 | string / varchar(200) | 否 | 否 | |
|
||
| account_address | 开户地址 | string / varchar(500) | 否 | 否 | |
|
||
| contract_date | 签约日期 | datetime | 否 | 否 | |
|
||
| contract_no | 代扣合同号 | string / varchar(100) | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | 详见常量说明[默认状态](###默认状态-default_status) |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 开票配置表-biz_invoice
|
||
|
||
> 开票配置主表,用于维护水司账户维度的发票供应商、开票限额、自动开票策略和扩展参数。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| account_id | 水司账户ID | number / bigint(64) | 否 | 是 | 关联`biz_company_account` |
|
||
| supplier | 供应商ID | number / int | 否 | 否 | |
|
||
| supplier_name | 供应商名称 | string / varchar(200) | 否 | 否 | |
|
||
| limit | 开票限额 | number / decimal(18,4) | 否 | 否 | 单次开票最大金额 |
|
||
| before_charge | 收费前开票 | boolean / tinyint | 否 | 默认0 | 0-否,1-是 |
|
||
| ex_cost_component_codes | 排除费用组成代码 | string / varchar(500) | 否 | 否 | 多个逗号分隔 |
|
||
| extra_properties | 扩展参数 | string / longtext | 否 | 否 | JSON扩展字段 |
|
||
| auto_invoice | 自动开票 | boolean / tinyint | 否 | 默认0 | 0-否,1-是 |
|
||
| invoice_type | 开票类型 | number / tinyint | 否 | 否 | 普票/专票 |
|
||
| include_invoice_special | 包含专票客户 | boolean / tinyint | 否 | 默认0 | |
|
||
| status | 状态 | number / tinyint | 否 | 默认0 | |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
### 基础工单信息表-biz_process
|
||
|
||
> 统一业务工单主表,用于承载更名、过户、停复水、换表、发票变更等业务办理流程,是当前后端流程化业务模型的核心表。
|
||
|
||
| 字段名 | 中文含义 | 字段类型 | 是否唯一 | 是否必填 | 字段说明 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| id | 主键ID | number / bigint(64) | 是 | 是 | |
|
||
| request_source_code | 来源编码 | string / varchar(100) | 否 | 否 | 申请来源 |
|
||
| applicant | 申请人 | string / varchar(100) | 否 | 否 | |
|
||
| mobile | 申请人手机号码 | string / varchar(100) | 否 | 否 | |
|
||
| telephone | 座机 | string / varchar(100) | 否 | 否 | |
|
||
| cust_id | 客户ID | number / int | 否 | 否 | |
|
||
| cust_code | 客户编号 | string / varchar(100) | 否 | 否 | |
|
||
| org_name | 营业站点名称 | string / varchar(200) | 否 | 否 | |
|
||
| cust_name | 客户名称 | string / varchar(200) | 否 | 否 | |
|
||
| cust_address | 客户地址 | string / varchar(500) | 否 | 否 | |
|
||
| contact | 联系人信息 | string / varchar(200) | 否 | 否 | |
|
||
| apply_type | 申请原因 | number / int | 否 | 否 | |
|
||
| apply_date | 申请时间 | datetime | 否 | 否 | |
|
||
| acceptance_name | 受理人姓名 | string / varchar(100) | 否 | 否 | |
|
||
| acceptance_id | 受理人ID | string / varchar(100) | 否 | 否 | |
|
||
| acceptance_time | 受理时间 | datetime | 否 | 否 | |
|
||
| state | 工单状态 | number / int | 否 | 否 | |
|
||
| review_reasons | 审批备注 | string / varchar(500) | 否 | 否 | |
|
||
| review_opinion | 审批意见 | string / varchar(500) | 否 | 否 | |
|
||
| business_type | 业务类型 | number / int | 否 | 否 | |
|
||
| business_id | 业务单ID | number / int | 否 | 否 | 关联具体业务单 |
|
||
| process_state | 流程状态 | string / varchar(100) | 否 | 否 | 工作流状态 |
|
||
| business_code | 业务类型编码 | string / varchar(100) | 否 | 否 | |
|
||
| process_instance_id | 流程实例ID | string / varchar(100) | 否 | 否 | 工作流实例 |
|
||
| contact_mobile | 主联系人手机 | string / varchar(100) | 否 | 否 | |
|
||
| affairs_project_code | 一网通办项目编码 | string / varchar(100) | 否 | 否 | |
|
||
| affairs_project_content | 一网通办内容 | string / longtext | 否 | 否 | JSON内容 |
|
||
| affairs_project_state | 一网通办状态 | string / varchar(100) | 否 | 否 | |
|
||
| affairs_project_type | 一网通办类型 | number / int | 否 | 否 | |
|
||
| cust_type | 客户类型 | number / int | 否 | 否 | |
|
||
| user_id | 小程序用户ID | string / varchar(100) | 否 | 否 | |
|
||
| remark | 备注 | string / varchar(500) | 否 | 否 | |
|
||
| status | 状态 | number / int | 否 | 默认0 | |
|
||
| create_time | 创建时间 | datetime | 否 | 否 | |
|
||
| update_time | 更新时间 | datetime | 否 | 否 | |
|
||
| creator | 创建人id | string / varchar(100) | 否 | 否 | |
|
||
| updater | 更新人id | string / varchar(100) | 否 | 否 | |
|
||
| deleted | 是否删除 | boolean / bit(1) | 否 | 默认0 | |
|
||
| tenant_id | 租户id | number / bigint(64) | 否 | 默认0 | |
|
||
|
||
## 数据库备份与安全
|
||
|
||
*<span style="color: blue">(说明数据备份方式备份周期以及数据安全控制等等)</span>*
|
||
|