完成源数据库设计对齐工作,明确以parsed_docs_new/数据库设计.md为基准的规则,补充biz_meter_calibercode字段和meter_info缺失字段,新增标准表system_user_form_config并保留兼容说明。在详细/概要设计说明书中加入统一对齐声明,提升数据库定义一致性,减少后续返工风险,符合甲方A级交付标准。

This commit is contained in:
tangweijie 2025-08-08 09:46:51 +08:00
parent 4a6fb049e5
commit e8f207f8ae
4 changed files with 2670 additions and 2 deletions

File diff suppressed because it is too large Load Diff

View File

@ -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 | 数据库系统变更为达梦数据库 | 将三个设计文档中的数据库从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协议 | 在三个设计文档中完善单点登录设计明确采用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_approve2. 详细设计说明书中更新OAuth2.0数据表引用修正表名为system_oauth2_*系列3. 文档版本更新至V1.5 | 用户提供实际的OAuth2.0表SQL文件 | 正面影响确保设计文档与实际SQL表结构完全一致避免开发过程中的混乱。实际的表结构更加完善包含了OAuth2.0批准表(system_oauth2_approve)支持用户授权记录管理字段设计更加规范符合PostgreSQL数据库特性为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_approve2. 详细设计说明书中更新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个工单表设计完善了工单数据模型支持不同类型工单的差异化管理需求 | | 2024-12-19 | 业务工单模块设计整合 | 参考营收系统详细设计说明书在新版设计文档中新增业务工单模块并将表务系统的工单管理功能整合到业务工单中。包括1. 详细设计说明书中新增营收系统模块9-业务工单包含业务清单管理、上报清单管理、稽查工单管理、换表工单管理4个功能模块2. 概要设计说明书中同步新增业务工单模块描述调整表务系统模块结构3. 数据库设计说明书中新增4个业务工单相关表business_work_order、report_work_order、audit_work_order、work_order_log并更新总表数量为147个 | 用户要求参考营收系统详细设计说明书添加业务工单模块,并将表务工单管理整合到业务工单中 | 正面影响实现了工单管理的统一化设计避免了功能重复。业务工单模块覆盖了客户服务、账务处理、投诉建议、故障报修等全业务场景支持工单全生命周期管理。表务系统专注于仓库管理和设备档案管理功能边界更加清晰。新增的4个工单表设计完善了工单数据模型支持不同类型工单的差异化管理需求 |
## 项目完成总结 ## 项目完成总结

View File

@ -597,6 +597,14 @@
- [x] **增加模块分类** - 按业务功能重新分类表结构 ✅ - [x] **增加模块分类** - 按业务功能重新分类表结构 ✅
- [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`加入数据库对齐声明 ✅
## 📊 数据库设计补完总结 ## 📊 数据库设计补完总结
### ✅ 补完效果 ### ✅ 补完效果

View File

@ -498,6 +498,27 @@
| deleted | int2 | N | 0 | 是否删除 | | deleted | int2 | N | 0 | 是否删除 |
| tenant_id | int8 | N | 0 | 租户id | | 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 (水司账户表) ### biz_company_account (水司账户表)
| 字段名 | 类型 | 是否可空 | 默认值 | 注释 | | 字段名 | 类型 | 是否可空 | 默认值 | 注释 |
| :--- | :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- | :--- |
@ -554,6 +575,7 @@
| :--- | :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- | :--- |
| id | int8 | N | nextval() | 主键 | | id | int8 | N | nextval() | 主键 |
| name | varchar(100) | Y | | 口径名称 | | name | varchar(100) | Y | | 口径名称 |
| code | varchar(100) | N | | 口径代码 |
| value | numeric(10,2) | Y | | 口径值(单位:毫米) | | value | numeric(10,2) | Y | | 口径值(单位:毫米) |
| check_period | int4 | Y | | 强检周期(单位:年) | | check_period | int4 | Y | | 强检周期(单位:年) |
| replace_period | int4 | Y | | 定换周期(单位:年) | | replace_period | int4 | Y | | 定换周期(单位:年) |
@ -974,8 +996,12 @@
| customer_id | int8 | Y | | 客户ID | | customer_id | int8 | Y | | 客户ID |
| maker_code | varchar(100) | N | | 厂家代码 | | maker_code | varchar(100) | N | | 厂家代码 |
| model_code | varchar(100) | N | | 型号代码 | | model_code | varchar(100) | N | | 型号代码 |
| caliber_id | int8 | N | | 口径ID | | caliber_code | varchar(100) | Y | | 口径代码(与源设计对齐,优先使用) |
| range_id | int8 | N | | 量程ID | | 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_date | timestamp(6) | Y | | 安装日期 |
| install_address | varchar(500) | Y | | 安装地址 | | install_address | varchar(500) | Y | | 安装地址 |
| meter_status | int2 | N | 0 | 水表状态0-正常1-故障2-停用3-拆除 | | meter_status | int2 | N | 0 | 水表状态0-正常1-故障2-停用3-拆除 |
@ -983,6 +1009,16 @@
| last_reading | numeric(15,3) | Y | 0 | 上次读数 | | last_reading | numeric(15,3) | Y | 0 | 上次读数 |
| check_date | timestamp(6) | Y | | 检定日期 | | check_date | timestamp(6) | Y | | 检定日期 |
| expire_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 | | 备注 | | remark | varchar(500) | Y | | 备注 |
| create_time | timestamp(6) | N | pg_systimestamp() | 创建时间 | | create_time | timestamp(6) | N | pg_systimestamp() | 创建时间 |
| update_time | timestamp(6) | N | pg_systimestamp() | 更新时间 | | update_time | timestamp(6) | N | pg_systimestamp() | 更新时间 |