更新福建水务营收系统概要设计文档,新增报装业务系统电子签章集成方案,包括电子合同、签章记录、存证记录等数据库设计,补充相关模块功能描述和技术架构,优化文档结构与Mermaid图表,提升文档的完整性和可读性,符合甲方A级交付标准。
This commit is contained in:
parent
6c0cb35982
commit
851542aadd
Binary file not shown.
File diff suppressed because it is too large
Load Diff
@ -26,7 +26,7 @@
|
||||
| `water_biz_security_design.md` | ✅ 已完成 | 100% | A级 | 2024-12-19 | 已剔除等保三级内容,移除标题序号 |
|
||||
| `新-数据库设计说明书.md` | ✅ 已完成 | 100% | A++级 | 2024-12-19 | 完整的PostgreSQL表结构,包含30个系统表+113个业务表的完整字段定义,ER图,索引设计,性能优化,覆盖营收系统全业务场景(新增60个遗漏表) |
|
||||
| `新-详细设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2024-12-19 | 符合302国家标准格式的详细设计文档,包含5个子系统的完整模块设计、接口规范、业务流程,总计1215行,可直接指导开发实施 |
|
||||
| `新-概要设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2025-08-18 | 架构调整:将工单、表务、报装从营收业务系统中剥离为独立子系统(SYS-005/006/007);更新目录、功能范围、子系统列表、调用关系图、接口定义及相关章节,保留客户服务模块在营收业务系统内的作用。 |
|
||||
| `新-概要设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2025-08-22 | 架构调整:将工单、表务、报装从营收业务系统中剥离为独立子系统(SYS-005/006/007);更新目录、功能范围、子系统列表、调用关系图、接口定义及相关章节,保留客户服务模块在营收业务系统内的作用。新增报装系统CA电子签章依赖(外部接口、架构图、方案说明)。 |
|
||||
| 新增 | — | — | — | 2025-08-18 | 新增发票服务子系统(SYS-008):作为基础服务层统一开票能力中心,优先对接航天信息,预留博思等供应商。 |
|
||||
|
||||
### 补充文档 (可选交付)
|
||||
@ -129,6 +129,8 @@
|
||||
| 2024-12-19 | 统一导出工具 | 创建统一文档导出工具unified_export.sh | 解决多文件图表混乱和标题样式问题 | 正面影响,但图表处理可能卡住 |
|
||||
| 2024-12-19 | 快速导出工具 | 创建快速统一导出工具quick_unified_export.sh | 解决统一导出工具卡住问题,稳定高效 | 正面影响,完美解决所有问题 |
|
||||
| 2024-12-19 | 分离文档导出 | 修改unified_export.sh支持分离文档导出,创建manage_separated_docs.sh管理工具 | 用户需求:将每个文档分别导出为不同格式,而不是合并成一个大文档 | 正面影响,提供更灵活的文档导出选项 |
|
||||
| 2025-08-22 | 文档更新 | 新-概要设计说明书:在报装业务系统(SYS-007)新增CA电子签章依赖;补充INST-004签章回执接口;更新子系统架构图与方案说明;在主要接口定义中同步新增报装签章回执接口 | 对齐集成依赖,完善报装环节签署合规流程 | 正面影响,接口与架构更完整,便于实施 |
|
||||
| 2025-08-22 | 文档修复 | 修复微网厅子系统架构图Mermaid语法(中文节点引用导致Lexical error),将`Backend -.->|支付调用| 支付与结算(SYS-009)`改为`Backend -.->|支付调用| PAY_SYS[支付与结算(SYS-009)]` | 解决Mermaid解析错误,保证图表可渲染 | 正面影响,导出稳定性提升 |
|
||||
| 2024-12-19 | 数据库设计简化 | 剔除数据库设计文档中的SQL语句和DDL语句,保留核心设计概念和表结构说明 | 用户要求:剔除SQL语句简化内容 | 正面影响,符合概要设计标准,提升可读性 |
|
||||
| 2024-12-19 | 新增引言文档 | 创建water_biz_overview_design.md引言文档 | 用户需求:添加标准的第一章内容(编写目的、背景、定义、参考资料) | 正面影响,完善文档体系结构 |
|
||||
| 2024-12-19 | 代码简化优化 | 删除文档中过于详细的代码示例,保持概要设计抽象层次 | 用户反馈:删除过多详细的代码 | 正面影响,符合概要设计标准,提升文档可读性 |
|
||||
|
||||
@ -182,6 +182,7 @@
|
||||
- [x] 集成到Makefile构建流程 ✅
|
||||
- [x] 生成包含图表的Word文档 ✅
|
||||
- [x] 处理所有设计文档中的流程图 ✅
|
||||
- [x] 修复微网厅架构图中文节点引用导致的Mermaid语法错误 ✅ (2025-08-22)
|
||||
|
||||
## 📅 第二阶段任务 (内容完善)
|
||||
|
||||
|
||||
391
water_biz_ca_integration_summary.md
Normal file
391
water_biz_ca_integration_summary.md
Normal file
@ -0,0 +1,391 @@
|
||||
# 报装业务系统与泛微CA电子签章系统集成方案总结报告
|
||||
|
||||
## 文档信息
|
||||
| 项目信息 | 详情 |
|
||||
|---------|------|
|
||||
| **项目名称** | 福建水务营收系统 |
|
||||
| **文档类型** | 集成方案总结报告 |
|
||||
| **文档版本** | v1.0 |
|
||||
| **编写日期** | 2024-12-19 |
|
||||
| **文档状态** | ✅ 已完成 |
|
||||
|
||||
## 1. 项目背景
|
||||
|
||||
福建水务营收系统报装业务流程中涉及多种合同文件的签署,传统的纸质合同签署方式存在流程繁琐、效率低下、存储管理困难等问题。为提高业务办理效率,降低运营成本,同时确保合同的法律效力,本项目拟将泛微CA电子签章系统集成到报装业务系统中,实现合同的电子签署、身份认证和电子存证服务。
|
||||
|
||||
## 2. 需求概述
|
||||
|
||||
### 2.1 业务需求
|
||||
|
||||
1. **合同电子签署**:支持报装申请、用水协议等合同文档的电子签署
|
||||
2. **身份认证**:提供可靠的签署方身份认证机制
|
||||
3. **时间戳服务**:为签署过程提供可信时间戳
|
||||
4. **电子存证**:签署完成的文档需进行安全存储和防篡改保护
|
||||
5. **签署流程管理**:支持多方签署、签署状态跟踪
|
||||
6. **签署结果查询**:提供签署结果的查询和验证功能
|
||||
|
||||
### 2.2 技术需求
|
||||
|
||||
1. **系统集成**:与泛微CA电子签章系统进行无缝集成
|
||||
2. **安全性**:确保签署过程的安全性和数据传输的加密
|
||||
3. **可靠性**:保证签署服务的高可用性
|
||||
4. **合规性**:符合《中华人民共和国电子签名法》等相关法规
|
||||
5. **可扩展性**:支持未来更多类型的合同和文档签署
|
||||
|
||||
## 3. 集成方案设计
|
||||
|
||||
### 3.1 总体架构
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "福建水务营收系统"
|
||||
subgraph "报装业务系统"
|
||||
INST_APP[报装申请模块]
|
||||
INST_CONT[合同管理模块]
|
||||
INST_ARCH[档案管理模块]
|
||||
INST_SIGN[电子签章模块]
|
||||
end
|
||||
|
||||
SYS_PLAT[统一平台]
|
||||
end
|
||||
|
||||
subgraph "外部系统"
|
||||
CA_SYS[泛微CA电子签章系统]
|
||||
end
|
||||
|
||||
INST_APP --> INST_CONT
|
||||
INST_CONT --> INST_SIGN
|
||||
INST_SIGN --> INST_ARCH
|
||||
INST_SIGN <--> CA_SYS
|
||||
SYS_PLAT <--> INST_SIGN
|
||||
```
|
||||
|
||||
### 3.2 集成模式
|
||||
|
||||
本项目采用**API接口集成模式**,通过泛微CA电子签章系统提供的标准REST API接口,实现报装业务系统与CA系统的对接。该模式具有以下特点:
|
||||
|
||||
1. **松耦合**:系统间通过标准HTTP/HTTPS协议通信,降低系统间耦合度
|
||||
2. **灵活性**:可根据业务需求灵活调用不同的CA服务接口
|
||||
3. **易维护**:接口变更时只需调整适配层,不影响业务逻辑
|
||||
4. **安全性**:采用HTTPS加密传输和签名验证机制,确保数据安全
|
||||
|
||||
### 3.3 核心模块设计
|
||||
|
||||
#### 3.3.1 电子签章模块(INST-SIGN)
|
||||
|
||||
作为报装业务系统与泛微CA系统的桥梁,负责处理合同签署、验证和存证等核心功能。
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "电子签章模块(INST-SIGN)"
|
||||
ADAPTER[泛微CA适配器]
|
||||
CONTRACT[合同签署组件]
|
||||
VERIFY[签章验证组件]
|
||||
STORAGE[签章存储组件]
|
||||
MONITOR[签章监控组件]
|
||||
end
|
||||
|
||||
ADAPTER --> CONTRACT
|
||||
ADAPTER --> VERIFY
|
||||
CONTRACT --> STORAGE
|
||||
VERIFY --> STORAGE
|
||||
STORAGE --> MONITOR
|
||||
```
|
||||
|
||||
#### 3.3.2 泛微CA适配器
|
||||
|
||||
负责与泛微CA系统的直接交互,封装CA系统接口调用细节,提供统一的服务接口给上层组件。主要功能包括:
|
||||
|
||||
1. **接口调用**:封装CA系统API调用逻辑
|
||||
2. **参数转换**:处理业务参数与CA接口参数的转换
|
||||
3. **结果解析**:解析CA系统返回结果
|
||||
4. **异常处理**:处理接口调用异常情况
|
||||
5. **连接管理**:管理与CA系统的连接
|
||||
|
||||
## 4. 接口设计
|
||||
|
||||
### 4.1 内部接口
|
||||
|
||||
| 接口名称 | 接口描述 | 请求方式 | 输入参数 | 输出参数 |
|
||||
|---------|---------|---------|---------|---------|
|
||||
| createContract | 创建电子合同 | POST | 合同类型、合同内容、签署方信息 | 合同ID、状态 |
|
||||
| initiateSignature | 发起签署流程 | POST | 合同ID、签署方信息 | 签署任务ID、状态 |
|
||||
| querySignatureStatus | 查询签署状态 | GET | 签署任务ID | 签署状态、结果 |
|
||||
| verifySignature | 验证签章 | POST | 合同ID | 验证结果、详情 |
|
||||
| applyEvidence | 申请电子存证 | POST | 合同ID | 存证ID、状态 |
|
||||
| queryEvidence | 查询存证信息 | GET | 存证ID | 存证状态、详情 |
|
||||
|
||||
### 4.2 外部接口(泛微CA系统)
|
||||
|
||||
| 接口名称 | 接口描述 | 请求方式 | URL | 安全措施 |
|
||||
|---------|---------|---------|-----|---------|
|
||||
| 身份认证接口 | 验证签署方身份 | POST | /api/v1/auth | HTTPS、签名验证 |
|
||||
| 电子签章接口 | 执行电子签章操作 | POST | /api/v1/signature | HTTPS、签名验证 |
|
||||
| 时间戳接口 | 获取可信时间戳 | POST | /api/v1/timestamp | HTTPS、签名验证 |
|
||||
| 电子存证接口 | 存储签署后的合同 | POST | /api/v1/evidence | HTTPS、签名验证 |
|
||||
| 验证接口 | 验证签章和存证 | POST | /api/v1/verify | HTTPS、签名验证 |
|
||||
|
||||
### 4.3 接口调用示例
|
||||
|
||||
#### 身份认证接口
|
||||
|
||||
```json
|
||||
// 请求
|
||||
POST /api/v1/auth HTTP/1.1
|
||||
Host: ca.fanwei.com
|
||||
Content-Type: application/json
|
||||
Authorization: Bearer {token}
|
||||
|
||||
{
|
||||
"userId": "user123",
|
||||
"authType": "face",
|
||||
"authData": "base64_encoded_data"
|
||||
}
|
||||
|
||||
// 响应
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"code": 0,
|
||||
"message": "success",
|
||||
"data": {
|
||||
"authId": "auth_123456",
|
||||
"authResult": true,
|
||||
"authTime": "2024-12-19T10:30:00Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 电子签章接口
|
||||
|
||||
```json
|
||||
// 请求
|
||||
POST /api/v1/signature HTTP/1.1
|
||||
Host: ca.fanwei.com
|
||||
Content-Type: application/json
|
||||
Authorization: Bearer {token}
|
||||
|
||||
{
|
||||
"documentId": "doc123",
|
||||
"documentData": "base64_encoded_document",
|
||||
"signatureInfo": {
|
||||
"position": { "page": 1, "x": 100, "y": 200 },
|
||||
"signatureType": "personal"
|
||||
}
|
||||
}
|
||||
|
||||
// 响应
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"code": 0,
|
||||
"message": "success",
|
||||
"data": {
|
||||
"signatureId": "sign_123456",
|
||||
"signatureImage": "base64_encoded_image",
|
||||
"signatureTime": "2024-12-19T10:35:00Z",
|
||||
"documentHash": "sha256_hash_value"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 5. 数据库设计
|
||||
|
||||
### 5.1 数据表设计
|
||||
|
||||
集成方案涉及5个核心数据表:
|
||||
|
||||
1. **电子合同表(installation_contract)**:存储合同基本信息
|
||||
2. **电子签章记录表(installation_signature)**:记录签章信息
|
||||
3. **电子存证记录表(installation_evidence)**:存储存证信息
|
||||
4. **CA系统配置表(installation_ca_config)**:存储CA系统配置
|
||||
5. **签章模板表(installation_signature_template)**:存储签章模板
|
||||
|
||||
### 5.2 表关系设计
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
installation_contract ||--o{ installation_signature : "签署"
|
||||
installation_contract ||--o{ installation_evidence : "存证"
|
||||
installation_signature }|--|| installation_signature_template : "使用"
|
||||
installation_contract }|--|| installation_application : "关联"
|
||||
|
||||
installation_contract {
|
||||
bigint id PK
|
||||
varchar contract_code
|
||||
bigint installation_id FK
|
||||
varchar contract_type
|
||||
varchar contract_status
|
||||
}
|
||||
|
||||
installation_signature {
|
||||
bigint id PK
|
||||
varchar signature_code
|
||||
bigint contract_id FK
|
||||
varchar signer_type
|
||||
varchar signature_status
|
||||
}
|
||||
|
||||
installation_evidence {
|
||||
bigint id PK
|
||||
varchar evidence_code
|
||||
bigint contract_id FK
|
||||
varchar evidence_type
|
||||
varchar evidence_status
|
||||
}
|
||||
```
|
||||
|
||||
## 6. 业务流程设计
|
||||
|
||||
### 6.1 合同签署流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 客户
|
||||
participant 报装系统
|
||||
participant 电子签章模块
|
||||
participant 泛微CA系统
|
||||
|
||||
客户->>报装系统: 提交报装申请
|
||||
报装系统->>报装系统: 生成合同
|
||||
报装系统->>电子签章模块: 创建签署任务
|
||||
电子签章模块->>泛微CA系统: 身份认证请求
|
||||
泛微CA系统-->>电子签章模块: 返回认证结果
|
||||
电子签章模块->>泛微CA系统: 发送签章请求
|
||||
泛微CA系统-->>电子签章模块: 返回签章结果
|
||||
电子签章模块->>泛微CA系统: 申请时间戳
|
||||
泛微CA系统-->>电子签章模块: 返回时间戳凭证
|
||||
电子签章模块->>泛微CA系统: 申请电子存证
|
||||
泛微CA系统-->>电子签章模块: 返回存证凭证
|
||||
电子签章模块-->>报装系统: 返回签署结果
|
||||
报装系统-->>客户: 通知签署完成
|
||||
```
|
||||
|
||||
### 6.2 签署验证流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 用户
|
||||
participant 报装系统
|
||||
participant 电子签章模块
|
||||
participant 泛微CA系统
|
||||
|
||||
用户->>报装系统: 请求验证合同
|
||||
报装系统->>电子签章模块: 发送验证请求
|
||||
电子签章模块->>泛微CA系统: 签章验证请求
|
||||
泛微CA系统-->>电子签章模块: 返回验证结果
|
||||
电子签章模块->>泛微CA系统: 存证验证请求
|
||||
泛微CA系统-->>电子签章模块: 返回存证验证结果
|
||||
电子签章模块-->>报装系统: 返回综合验证结果
|
||||
报装系统-->>用户: 显示验证结果
|
||||
```
|
||||
|
||||
## 7. 安全设计
|
||||
|
||||
### 7.1 传输安全
|
||||
|
||||
- **HTTPS加密传输**:所有接口调用采用HTTPS协议,确保数据传输安全
|
||||
- **数据签名验证**:对请求和响应数据进行签名验证,防止数据篡改
|
||||
- **敏感信息加密**:对身份信息等敏感数据进行加密存储
|
||||
|
||||
### 7.2 身份认证安全
|
||||
|
||||
- **多因素身份认证**:支持人脸识别、手机验证码等多种身份认证方式
|
||||
- **签署权限控制**:基于角色的权限控制,确保只有授权用户才能进行签署
|
||||
- **操作日志记录**:记录所有签署操作,便于审计和追溯
|
||||
|
||||
### 7.3 数据安全
|
||||
|
||||
- **签章数据防篡改**:采用数字签名技术确保签章数据的完整性
|
||||
- **存证数据保护**:通过区块链技术或第三方存证服务确保存证数据不可篡改
|
||||
- **数据备份机制**:定期备份签章和存证数据,防止数据丢失
|
||||
|
||||
## 8. 实施计划
|
||||
|
||||
### 8.1 阶段划分
|
||||
|
||||
| 阶段 | 工作内容 | 时间周期 | 交付物 |
|
||||
|------|---------|---------|-------|
|
||||
| 需求分析 | 详细需求调研、业务流程分析 | 2周 | 需求规格说明书 |
|
||||
| 系统设计 | 架构设计、接口设计、数据库设计 | 3周 | 设计文档 |
|
||||
| 开发实施 | 模块开发、接口对接、单元测试 | 6周 | 系统代码 |
|
||||
| 系统测试 | 功能测试、集成测试、性能测试 | 3周 | 测试报告 |
|
||||
| 部署上线 | 环境准备、系统部署、验收测试 | 2周 | 部署文档 |
|
||||
| 运维支持 | 系统监控、问题处理、版本迭代 | 长期 | 运维手册 |
|
||||
|
||||
### 8.2 关键里程碑
|
||||
|
||||
| 里程碑 | 时间点 | 验收标准 |
|
||||
|-------|-------|---------|
|
||||
| 需求确认 | 第2周末 | 需求文档评审通过 |
|
||||
| 设计完成 | 第5周末 | 设计文档评审通过 |
|
||||
| 开发完成 | 第11周末 | 代码开发完成并通过代码审查 |
|
||||
| 测试通过 | 第14周末 | 测试用例通过率>95% |
|
||||
| 系统上线 | 第16周末 | 系统功能验收通过 |
|
||||
|
||||
## 9. 风险评估与应对策略
|
||||
|
||||
| 风险项 | 风险级别 | 影响范围 | 应对策略 |
|
||||
|-------|---------|---------|---------|
|
||||
| CA系统接口变更 | 中 | 签章功能 | 1. 建立接口版本管理机制<br>2. 设计适配层隔离变更影响<br>3. 与CA系统供应商建立变更通知机制 |
|
||||
| 签章过程中断 | 高 | 业务流程 | 1. 实现断点续签功能<br>2. 完善异常处理机制<br>3. 建立签章失败自动重试机制 |
|
||||
| 存证服务不可用 | 高 | 法律效力 | 1. 建立本地缓存机制<br>2. 实施异步存证策略<br>3. 设置服务可用性监控告警 |
|
||||
| 签章效率问题 | 中 | 用户体验 | 1. 优化签章流程<br>2. 实施批量签章功能<br>3. 签章预处理机制 |
|
||||
| 法规政策变化 | 低 | 合规性 | 1. 定期跟踪法规更新<br>2. 系统设计预留政策调整空间<br>3. 建立合规评估机制 |
|
||||
|
||||
## 10. 预期效益
|
||||
|
||||
### 10.1 业务效益
|
||||
|
||||
1. **提高业务效率**:电子签章将报装合同签署时间从平均3天缩短至30分钟内完成
|
||||
2. **降低运营成本**:减少纸质合同打印、邮寄、存储成本,预计年节省成本30万元
|
||||
3. **优化客户体验**:客户无需到营业厅即可完成合同签署,提升服务满意度
|
||||
4. **提升合规性**:电子签章符合法律法规要求,具有与纸质合同同等的法律效力
|
||||
|
||||
### 10.2 技术效益
|
||||
|
||||
1. **系统现代化**:引入电子签章技术,提升系统现代化水平
|
||||
2. **数据标准化**:合同数据电子化,便于统一管理和分析
|
||||
3. **流程标准化**:签署流程标准化,减少人为干预和错误
|
||||
4. **安全性提升**:采用先进的加密和存证技术,提高数据安全性
|
||||
|
||||
## 11. 结论与建议
|
||||
|
||||
### 11.1 结论
|
||||
|
||||
本集成方案通过将泛微CA电子签章系统与福建水务营收系统的报装业务系统进行对接,实现了合同电子签署、身份认证和电子存证等核心功能,有效解决了传统纸质合同签署方式存在的效率低下、成本高昂、管理困难等问题。方案设计充分考虑了系统安全性、可靠性、合规性和可扩展性,能够满足业务需求并适应未来发展。
|
||||
|
||||
### 11.2 建议
|
||||
|
||||
1. **分阶段实施**:建议按照合同类型分阶段实施电子签章功能,先从用水协议等高频简单合同开始,逐步扩展到复杂合同
|
||||
2. **加强用户培训**:对系统操作人员和客户进行必要的培训,提高电子签章功能的接受度和使用率
|
||||
3. **持续优化体验**:基于用户反馈持续优化签章流程和界面,提升用户体验
|
||||
4. **定期合规检查**:定期对电子签章系统进行合规性检查,确保符合最新的法律法规要求
|
||||
5. **扩展应用范围**:在报装业务成功实施后,可考虑将电子签章功能扩展到其他业务领域,如客户服务、表务管理等
|
||||
|
||||
## 12. 附录
|
||||
|
||||
### 12.1 术语表
|
||||
|
||||
| 术语 | 英文 | 说明 |
|
||||
|------|------|------|
|
||||
| 电子签章 | Electronic Seal | 使用电子技术手段产生的、与实体印章具有同等法律效力的数字印记 |
|
||||
| 电子存证 | Electronic Evidence | 对电子数据进行保全和存储,确保其法律效力的技术手段 |
|
||||
| 时间戳 | Timestamp | 证明电子数据在某一时刻已经存在且未被篡改的数字证明 |
|
||||
| CA系统 | Certificate Authority System | 数字证书认证系统,提供电子认证服务 |
|
||||
|
||||
### 12.2 参考文档
|
||||
|
||||
1. 《泛微CA电子签章系统接口规范》v2.0
|
||||
2. 《福建水务营收系统报装业务需求规格说明书》
|
||||
3. 《中华人民共和国电子签名法》
|
||||
4. GB/T 35275-2017 《电子签名 可信电子签名生成技术规范》
|
||||
5. GB/T 38540-2020 《信息安全技术 电子签名数据电子存证规范》
|
||||
|
||||
### 12.3 相关设计文档
|
||||
|
||||
1. [报装业务系统电子签章功能设计](water_biz_module_design_installation_ca.md)
|
||||
2. [报装业务系统电子签章数据库设计](water_biz_database_design_ca.md)
|
||||
3. [报装业务系统电子签章集成概要设计](water_biz_overview_design_ca.md)
|
||||
442
water_biz_database_design_ca.md
Normal file
442
water_biz_database_design_ca.md
Normal file
@ -0,0 +1,442 @@
|
||||
# 报装业务系统电子签章数据库设计
|
||||
|
||||
## 文档信息
|
||||
| 项目信息 | 详情 |
|
||||
|---------|------|
|
||||
| **项目名称** | 福建水务营收系统 |
|
||||
| **文档类型** | 数据库设计文档 |
|
||||
| **文档版本** | v1.0 |
|
||||
| **编写日期** | 2024-12-19 |
|
||||
| **文档状态** | 🟡 进行中 |
|
||||
|
||||
## 表结构设计
|
||||
|
||||
### 1. 电子合同表(installation_contract)
|
||||
|
||||
#### 表描述
|
||||
存储报装业务系统中的电子合同信息,包括合同基本信息、状态和文件链接等。
|
||||
|
||||
#### 表结构
|
||||
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 主键 | 说明 |
|
||||
|-------|------|------|-------|-------|------|------|
|
||||
| id | bigint | - | 否 | - | 是 | 主键ID |
|
||||
| contract_code | varchar | 32 | 否 | - | - | 合同编号 |
|
||||
| installation_id | bigint | - | 否 | - | - | 报装申请ID |
|
||||
| contract_type | varchar | 20 | 否 | - | - | 合同类型 |
|
||||
| contract_title | varchar | 100 | 否 | - | - | 合同标题 |
|
||||
| contract_content | text | - | 是 | NULL | - | 合同内容 |
|
||||
| contract_file_url | varchar | 255 | 是 | NULL | - | 合同文件URL |
|
||||
| contract_status | varchar | 20 | 否 | - | - | 合同状态 |
|
||||
| valid_from | datetime | - | 是 | NULL | - | 生效时间 |
|
||||
| valid_to | datetime | - | 是 | NULL | - | 到期时间 |
|
||||
| create_by | varchar | 64 | 是 | NULL | - | 创建人 |
|
||||
| create_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 创建时间 |
|
||||
| update_by | varchar | 64 | 是 | NULL | - | 更新人 |
|
||||
| update_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 更新时间 |
|
||||
|
||||
#### 索引设计
|
||||
| 索引名 | 索引类型 | 字段 | 说明 |
|
||||
|-------|---------|------|------|
|
||||
| PRIMARY | 主键 | id | 主键索引 |
|
||||
| uk_contract_code | 唯一索引 | contract_code | 合同编号唯一索引 |
|
||||
| idx_installation_id | 普通索引 | installation_id | 报装申请ID索引 |
|
||||
|
||||
#### 字段说明
|
||||
- **contract_type**: 合同类型,如"用水协议"、"施工合同"等
|
||||
- **contract_status**: 合同状态,包括"待签署"、"签署中"、"已签署"、"已作废"等
|
||||
|
||||
### 2. 电子签章记录表(installation_signature)
|
||||
|
||||
#### 表描述
|
||||
记录电子合同的签章信息,包括签署方信息、签署时间、签章数据等。
|
||||
|
||||
#### 表结构
|
||||
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 主键 | 说明 |
|
||||
|-------|------|------|-------|-------|------|------|
|
||||
| id | bigint | - | 否 | - | 是 | 主键ID |
|
||||
| signature_code | varchar | 32 | 否 | - | - | 签章编号 |
|
||||
| contract_id | bigint | - | 否 | - | - | 合同ID |
|
||||
| signer_type | varchar | 20 | 否 | - | - | 签署方类型 |
|
||||
| signer_id | varchar | 64 | 否 | - | - | 签署方ID |
|
||||
| signer_name | varchar | 100 | 否 | - | - | 签署方名称 |
|
||||
| signature_time | datetime | - | 是 | NULL | - | 签署时间 |
|
||||
| signature_ip | varchar | 50 | 是 | NULL | - | 签署IP |
|
||||
| signature_location | varchar | 255 | 是 | NULL | - | 签署位置 |
|
||||
| signature_image | varchar | 255 | 是 | NULL | - | 签章图像URL |
|
||||
| signature_data | text | - | 是 | NULL | - | 签章数据 |
|
||||
| timestamp_cert | text | - | 是 | NULL | - | 时间戳凭证 |
|
||||
| signature_status | varchar | 20 | 否 | - | - | 签章状态 |
|
||||
| create_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 创建时间 |
|
||||
| update_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 更新时间 |
|
||||
|
||||
#### 索引设计
|
||||
| 索引名 | 索引类型 | 字段 | 说明 |
|
||||
|-------|---------|------|------|
|
||||
| PRIMARY | 主键 | id | 主键索引 |
|
||||
| uk_signature_code | 唯一索引 | signature_code | 签章编号唯一索引 |
|
||||
| idx_contract_id | 普通索引 | contract_id | 合同ID索引 |
|
||||
| idx_signer_id | 普通索引 | signer_id | 签署方ID索引 |
|
||||
|
||||
#### 字段说明
|
||||
- **signer_type**: 签署方类型,如"客户"、"水务公司"等
|
||||
- **signature_status**: 签章状态,包括"待签署"、"已签署"、"签署失败"、"已撤销"等
|
||||
- **signature_data**: 签章的原始数据,通常为加密后的数据
|
||||
- **timestamp_cert**: 时间戳凭证,用于证明签署时间的真实性
|
||||
|
||||
### 3. 电子存证记录表(installation_evidence)
|
||||
|
||||
#### 表描述
|
||||
存储电子合同的存证信息,包括存证哈希、存证时间、存证凭证等。
|
||||
|
||||
#### 表结构
|
||||
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 主键 | 说明 |
|
||||
|-------|------|------|-------|-------|------|------|
|
||||
| id | bigint | - | 否 | - | 是 | 主键ID |
|
||||
| evidence_code | varchar | 32 | 否 | - | - | 存证编号 |
|
||||
| contract_id | bigint | - | 否 | - | - | 合同ID |
|
||||
| evidence_type | varchar | 20 | 否 | - | - | 存证类型 |
|
||||
| evidence_hash | varchar | 128 | 否 | - | - | 存证哈希值 |
|
||||
| evidence_time | datetime | - | 否 | - | - | 存证时间 |
|
||||
| evidence_cert | text | - | 是 | NULL | - | 存证凭证 |
|
||||
| evidence_status | varchar | 20 | 否 | - | - | 存证状态 |
|
||||
| storage_location | varchar | 255 | 是 | NULL | - | 存储位置 |
|
||||
| verify_url | varchar | 255 | 是 | NULL | - | 验证URL |
|
||||
| create_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 创建时间 |
|
||||
| update_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 更新时间 |
|
||||
|
||||
#### 索引设计
|
||||
| 索引名 | 索引类型 | 字段 | 说明 |
|
||||
|-------|---------|------|------|
|
||||
| PRIMARY | 主键 | id | 主键索引 |
|
||||
| uk_evidence_code | 唯一索引 | evidence_code | 存证编号唯一索引 |
|
||||
| idx_contract_id | 普通索引 | contract_id | 合同ID索引 |
|
||||
|
||||
#### 字段说明
|
||||
- **evidence_type**: 存证类型,如"区块链存证"、"第三方存证"等
|
||||
- **evidence_hash**: 存证文件的哈希值,通常使用SHA-256算法生成
|
||||
- **evidence_status**: 存证状态,包括"存证中"、"存证成功"、"存证失败"等
|
||||
- **verify_url**: 存证验证URL,可用于在线验证存证的真实性
|
||||
|
||||
### 4. CA系统配置表(installation_ca_config)
|
||||
|
||||
#### 表描述
|
||||
存储泛微CA电子签章系统的配置信息,包括接口地址、认证信息等。
|
||||
|
||||
#### 表结构
|
||||
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 主键 | 说明 |
|
||||
|-------|------|------|-------|-------|------|------|
|
||||
| id | bigint | - | 否 | - | 是 | 主键ID |
|
||||
| config_name | varchar | 50 | 否 | - | - | 配置名称 |
|
||||
| config_key | varchar | 50 | 否 | - | - | 配置键 |
|
||||
| config_value | varchar | 500 | 否 | - | - | 配置值 |
|
||||
| config_desc | varchar | 255 | 是 | NULL | - | 配置描述 |
|
||||
| is_enabled | tinyint | - | 否 | 1 | - | 是否启用 |
|
||||
| create_by | varchar | 64 | 是 | NULL | - | 创建人 |
|
||||
| create_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 创建时间 |
|
||||
| update_by | varchar | 64 | 是 | NULL | - | 更新人 |
|
||||
| update_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 更新时间 |
|
||||
|
||||
#### 索引设计
|
||||
| 索引名 | 索引类型 | 字段 | 说明 |
|
||||
|-------|---------|------|------|
|
||||
| PRIMARY | 主键 | id | 主键索引 |
|
||||
| uk_config_key | 唯一索引 | config_key | 配置键唯一索引 |
|
||||
|
||||
#### 字段说明
|
||||
- **config_key**: 配置键,如"ca.api.url"、"ca.api.key"等
|
||||
- **config_value**: 配置值,存储实际的配置内容
|
||||
- **is_enabled**: 是否启用,1表示启用,0表示禁用
|
||||
|
||||
### 5. 签章模板表(installation_signature_template)
|
||||
|
||||
#### 表描述
|
||||
存储电子签章模板信息,用于快速生成签章。
|
||||
|
||||
#### 表结构
|
||||
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 主键 | 说明 |
|
||||
|-------|------|------|-------|-------|------|------|
|
||||
| id | bigint | - | 否 | - | 是 | 主键ID |
|
||||
| template_code | varchar | 32 | 否 | - | - | 模板编号 |
|
||||
| template_name | varchar | 100 | 否 | - | - | 模板名称 |
|
||||
| template_type | varchar | 20 | 否 | - | - | 模板类型 |
|
||||
| template_image | varchar | 255 | 是 | NULL | - | 模板图像URL |
|
||||
| template_data | text | - | 是 | NULL | - | 模板数据 |
|
||||
| is_default | tinyint | - | 否 | 0 | - | 是否默认 |
|
||||
| is_enabled | tinyint | - | 否 | 1 | - | 是否启用 |
|
||||
| create_by | varchar | 64 | 是 | NULL | - | 创建人 |
|
||||
| create_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 创建时间 |
|
||||
| update_by | varchar | 64 | 是 | NULL | - | 更新人 |
|
||||
| update_time | datetime | - | 否 | CURRENT_TIMESTAMP | - | 更新时间 |
|
||||
|
||||
#### 索引设计
|
||||
| 索引名 | 索引类型 | 字段 | 说明 |
|
||||
|-------|---------|------|------|
|
||||
| PRIMARY | 主键 | id | 主键索引 |
|
||||
| uk_template_code | 唯一索引 | template_code | 模板编号唯一索引 |
|
||||
|
||||
#### 字段说明
|
||||
- **template_type**: 模板类型,如"个人签章"、"企业签章"等
|
||||
- **template_data**: 模板数据,包含签章的样式、大小等信息
|
||||
- **is_default**: 是否默认模板,1表示是,0表示否
|
||||
- **is_enabled**: 是否启用,1表示启用,0表示禁用
|
||||
|
||||
## 表关系设计
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
installation_contract ||--o{ installation_signature : "签署"
|
||||
installation_contract ||--o{ installation_evidence : "存证"
|
||||
installation_signature }|--|| installation_signature_template : "使用"
|
||||
installation_contract }|--|| installation_application : "关联"
|
||||
|
||||
installation_contract {
|
||||
bigint id PK
|
||||
varchar contract_code
|
||||
bigint installation_id FK
|
||||
varchar contract_type
|
||||
varchar contract_title
|
||||
text contract_content
|
||||
varchar contract_file_url
|
||||
varchar contract_status
|
||||
datetime valid_from
|
||||
datetime valid_to
|
||||
}
|
||||
|
||||
installation_signature {
|
||||
bigint id PK
|
||||
varchar signature_code
|
||||
bigint contract_id FK
|
||||
varchar signer_type
|
||||
varchar signer_id
|
||||
varchar signer_name
|
||||
datetime signature_time
|
||||
varchar signature_ip
|
||||
varchar signature_location
|
||||
varchar signature_image
|
||||
text signature_data
|
||||
text timestamp_cert
|
||||
varchar signature_status
|
||||
}
|
||||
|
||||
installation_evidence {
|
||||
bigint id PK
|
||||
varchar evidence_code
|
||||
bigint contract_id FK
|
||||
varchar evidence_type
|
||||
varchar evidence_hash
|
||||
datetime evidence_time
|
||||
text evidence_cert
|
||||
varchar evidence_status
|
||||
varchar storage_location
|
||||
varchar verify_url
|
||||
}
|
||||
|
||||
installation_ca_config {
|
||||
bigint id PK
|
||||
varchar config_name
|
||||
varchar config_key
|
||||
varchar config_value
|
||||
varchar config_desc
|
||||
tinyint is_enabled
|
||||
}
|
||||
|
||||
installation_signature_template {
|
||||
bigint id PK
|
||||
varchar template_code
|
||||
varchar template_name
|
||||
varchar template_type
|
||||
varchar template_image
|
||||
text template_data
|
||||
tinyint is_default
|
||||
tinyint is_enabled
|
||||
}
|
||||
|
||||
installation_application {
|
||||
bigint id PK
|
||||
varchar application_code
|
||||
varchar customer_name
|
||||
varchar application_status
|
||||
}
|
||||
```
|
||||
|
||||
## 数据字典
|
||||
|
||||
### 合同类型(contract_type)
|
||||
| 代码 | 名称 | 说明 |
|
||||
|------|------|------|
|
||||
| WATER_AGREEMENT | 用水协议 | 客户与水务公司签订的用水服务协议 |
|
||||
| CONSTRUCTION_CONTRACT | 施工合同 | 水务工程施工合同 |
|
||||
| INSTALLATION_AGREEMENT | 报装协议 | 新用户报装服务协议 |
|
||||
|
||||
### 合同状态(contract_status)
|
||||
| 代码 | 名称 | 说明 |
|
||||
|------|------|------|
|
||||
| DRAFT | 草稿 | 合同草稿状态,尚未发起签署 |
|
||||
| PENDING | 待签署 | 合同已创建,等待签署 |
|
||||
| SIGNING | 签署中 | 合同正在签署过程中 |
|
||||
| COMPLETED | 已签署 | 合同已完成所有签署 |
|
||||
| EXPIRED | 已过期 | 合同已过期 |
|
||||
| CANCELLED | 已作废 | 合同已被作废 |
|
||||
|
||||
### 签署方类型(signer_type)
|
||||
| 代码 | 名称 | 说明 |
|
||||
|------|------|------|
|
||||
| CUSTOMER | 客户 | 用水客户 |
|
||||
| COMPANY | 水务公司 | 水务服务提供方 |
|
||||
| CONTRACTOR | 施工方 | 工程施工单位 |
|
||||
| SUPERVISOR | 监理方 | 工程监理单位 |
|
||||
|
||||
### 签章状态(signature_status)
|
||||
| 代码 | 名称 | 说明 |
|
||||
|------|------|------|
|
||||
| PENDING | 待签署 | 等待签署 |
|
||||
| COMPLETED | 已签署 | 签署完成 |
|
||||
| FAILED | 签署失败 | 签署过程中出现错误 |
|
||||
| REVOKED | 已撤销 | 签章已被撤销 |
|
||||
|
||||
### 存证类型(evidence_type)
|
||||
| 代码 | 名称 | 说明 |
|
||||
|------|------|------|
|
||||
| BLOCKCHAIN | 区块链存证 | 使用区块链技术进行电子存证 |
|
||||
| THIRD_PARTY | 第三方存证 | 通过第三方机构进行电子存证 |
|
||||
| LOCAL | 本地存证 | 在本地系统进行电子存证 |
|
||||
|
||||
### 存证状态(evidence_status)
|
||||
| 代码 | 名称 | 说明 |
|
||||
|------|------|------|
|
||||
| PROCESSING | 存证中 | 正在进行存证 |
|
||||
| COMPLETED | 存证成功 | 存证已完成 |
|
||||
| FAILED | 存证失败 | 存证过程中出现错误 |
|
||||
| EXPIRED | 已过期 | 存证已过期 |
|
||||
|
||||
## 数据库优化建议
|
||||
|
||||
### 索引优化
|
||||
1. **合理使用索引**:已为高频查询字段创建索引,如合同ID、签署方ID等
|
||||
2. **避免过度索引**:仅为必要的查询条件创建索引,避免影响写入性能
|
||||
3. **考虑复合索引**:对于经常一起查询的字段,考虑创建复合索引
|
||||
|
||||
### 性能优化
|
||||
1. **大字段处理**:对于签章数据、存证凭证等大字段,考虑使用文件存储,数据库中只存储文件路径
|
||||
2. **分表策略**:当数据量增长到一定程度时,考虑按年份或业务单元进行分表
|
||||
3. **缓存机制**:对于频繁访问的合同和签章信息,实施适当的缓存策略
|
||||
|
||||
### 安全建议
|
||||
1. **敏感数据加密**:对于签章数据、存证哈希等敏感信息,采用加密存储
|
||||
2. **访问控制**:实施严格的数据库访问控制,限制对签章表的直接访问
|
||||
3. **审计日志**:记录所有对签章和存证数据的操作,便于追踪和审计
|
||||
|
||||
## 数据迁移与升级计划
|
||||
|
||||
### 初始数据迁移
|
||||
1. **现有合同数据导入**:将现有纸质合同信息导入电子合同表
|
||||
2. **签章模板初始化**:预设常用的签章模板
|
||||
3. **CA系统配置初始化**:配置泛微CA系统的连接参数
|
||||
|
||||
### 版本升级计划
|
||||
1. **v1.1版本**:增加签章权限控制表,细化签章权限管理
|
||||
2. **v1.2版本**:增加签章日志表,记录详细的签章操作日志
|
||||
3. **v2.0版本**:支持多CA系统集成,增加CA系统路由表
|
||||
|
||||
## 附录
|
||||
|
||||
### SQL创建脚本
|
||||
|
||||
```sql
|
||||
-- 电子合同表
|
||||
CREATE TABLE `installation_contract` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`contract_code` varchar(32) NOT NULL COMMENT '合同编号',
|
||||
`installation_id` bigint NOT NULL COMMENT '报装申请ID',
|
||||
`contract_type` varchar(20) NOT NULL COMMENT '合同类型',
|
||||
`contract_title` varchar(100) NOT NULL COMMENT '合同标题',
|
||||
`contract_content` text COMMENT '合同内容',
|
||||
`contract_file_url` varchar(255) DEFAULT NULL COMMENT '合同文件URL',
|
||||
`contract_status` varchar(20) NOT NULL COMMENT '合同状态',
|
||||
`valid_from` datetime DEFAULT NULL COMMENT '生效时间',
|
||||
`valid_to` datetime DEFAULT NULL COMMENT '到期时间',
|
||||
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_contract_code` (`contract_code`),
|
||||
KEY `idx_installation_id` (`installation_id`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报装合同表';
|
||||
|
||||
-- 电子签章记录表
|
||||
CREATE TABLE `installation_signature` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`signature_code` varchar(32) NOT NULL COMMENT '签章编号',
|
||||
`contract_id` bigint NOT NULL COMMENT '合同ID',
|
||||
`signer_type` varchar(20) NOT NULL COMMENT '签署方类型',
|
||||
`signer_id` varchar(64) NOT NULL COMMENT '签署方ID',
|
||||
`signer_name` varchar(100) NOT NULL COMMENT '签署方名称',
|
||||
`signature_time` datetime DEFAULT NULL COMMENT '签署时间',
|
||||
`signature_ip` varchar(50) DEFAULT NULL COMMENT '签署IP',
|
||||
`signature_location` varchar(255) DEFAULT NULL COMMENT '签署位置',
|
||||
`signature_image` varchar(255) DEFAULT NULL COMMENT '签章图像URL',
|
||||
`signature_data` text COMMENT '签章数据',
|
||||
`timestamp_cert` text COMMENT '时间戳凭证',
|
||||
`signature_status` varchar(20) NOT NULL COMMENT '签章状态',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_signature_code` (`signature_code`),
|
||||
KEY `idx_contract_id` (`contract_id`),
|
||||
KEY `idx_signer_id` (`signer_id`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报装签章记录表';
|
||||
|
||||
-- 电子存证记录表
|
||||
CREATE TABLE `installation_evidence` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`evidence_code` varchar(32) NOT NULL COMMENT '存证编号',
|
||||
`contract_id` bigint NOT NULL COMMENT '合同ID',
|
||||
`evidence_type` varchar(20) NOT NULL COMMENT '存证类型',
|
||||
`evidence_hash` varchar(128) NOT NULL COMMENT '存证哈希值',
|
||||
`evidence_time` datetime NOT NULL COMMENT '存证时间',
|
||||
`evidence_cert` text COMMENT '存证凭证',
|
||||
`evidence_status` varchar(20) NOT NULL COMMENT '存证状态',
|
||||
`storage_location` varchar(255) DEFAULT NULL COMMENT '存储位置',
|
||||
`verify_url` varchar(255) DEFAULT NULL COMMENT '验证URL',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_evidence_code` (`evidence_code`),
|
||||
KEY `idx_contract_id` (`contract_id`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报装存证记录表';
|
||||
|
||||
-- CA系统配置表
|
||||
CREATE TABLE `installation_ca_config` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`config_name` varchar(50) NOT NULL COMMENT '配置名称',
|
||||
`config_key` varchar(50) NOT NULL COMMENT '配置键',
|
||||
`config_value` varchar(500) NOT NULL COMMENT '配置值',
|
||||
`config_desc` varchar(255) DEFAULT NULL COMMENT '配置描述',
|
||||
`is_enabled` tinyint NOT NULL DEFAULT '1' COMMENT '是否启用',
|
||||
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_config_key` (`config_key`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CA系统配置表';
|
||||
|
||||
-- 签章模板表
|
||||
CREATE TABLE `installation_signature_template` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`template_code` varchar(32) NOT NULL COMMENT '模板编号',
|
||||
`template_name` varchar(100) NOT NULL COMMENT '模板名称',
|
||||
`template_type` varchar(20) NOT NULL COMMENT '模板类型',
|
||||
`template_image` varchar(255) DEFAULT NULL COMMENT '模板图像URL',
|
||||
`template_data` text COMMENT '模板数据',
|
||||
`is_default` tinyint NOT NULL DEFAULT '0' COMMENT '是否默认',
|
||||
`is_enabled` tinyint NOT NULL DEFAULT '1' COMMENT '是否启用',
|
||||
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_template_code` (`template_code`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='签章模板表';
|
||||
```
|
||||
500
water_biz_module_design_installation_ca.md
Normal file
500
water_biz_module_design_installation_ca.md
Normal file
@ -0,0 +1,500 @@
|
||||
# 报装业务系统电子签章功能设计
|
||||
|
||||
## 文档信息
|
||||
| 项目信息 | 详情 |
|
||||
|---------|------|
|
||||
| **项目名称** | 福建水务营收系统 |
|
||||
| **文档类型** | 模块设计文档 |
|
||||
| **文档版本** | v1.0 |
|
||||
| **编写日期** | 2024-12-19 |
|
||||
| **文档状态** | 🟡 进行中 |
|
||||
|
||||
## 功能概述
|
||||
|
||||
报装业务系统电子签章功能是通过集成泛微CA电子签章系统,实现合同电子签署、身份认证和电子存证服务,确保电子合同的法律效力,提高报装业务办理效率,降低纸质文档处理成本。
|
||||
|
||||
## 需求分析
|
||||
|
||||
### 业务需求
|
||||
|
||||
1. **合同电子签署**:支持报装申请、用水协议等合同文档的电子签署
|
||||
2. **身份认证**:提供可靠的签署方身份认证机制
|
||||
3. **时间戳服务**:为签署过程提供可信时间戳
|
||||
4. **电子存证**:签署完成的文档需进行安全存储和防篡改保护
|
||||
5. **签署流程管理**:支持多方签署、签署状态跟踪
|
||||
6. **签署结果查询**:提供签署结果的查询和验证功能
|
||||
|
||||
### 技术需求
|
||||
|
||||
1. **系统集成**:与泛微CA电子签章系统进行无缝集成
|
||||
2. **安全性**:确保签署过程的安全性和数据传输的加密
|
||||
3. **可靠性**:保证签署服务的高可用性
|
||||
4. **合规性**:符合《中华人民共和国电子签名法》等相关法规
|
||||
5. **可扩展性**:支持未来更多类型的合同和文档签署
|
||||
|
||||
## 技术架构
|
||||
|
||||
### 集成架构
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "报装业务系统"
|
||||
INST_APP[报装申请模块]
|
||||
INST_CONT[合同管理模块]
|
||||
INST_ARCH[档案管理模块]
|
||||
INST_SIGN[电子签章模块]
|
||||
end
|
||||
|
||||
subgraph "泛微CA电子签章系统"
|
||||
CA_AUTH[身份认证服务]
|
||||
CA_SIGN[电子签章服务]
|
||||
CA_TIME[时间戳服务]
|
||||
CA_STORE[电子存证服务]
|
||||
end
|
||||
|
||||
INST_APP --> INST_CONT
|
||||
INST_CONT --> INST_SIGN
|
||||
INST_SIGN --> CA_AUTH
|
||||
INST_SIGN --> CA_SIGN
|
||||
INST_SIGN --> CA_TIME
|
||||
INST_SIGN --> CA_STORE
|
||||
INST_SIGN --> INST_ARCH
|
||||
```
|
||||
|
||||
### 模块组件
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "电子签章模块(INST-SIGN)"
|
||||
ADAPTER[泛微CA适配器]
|
||||
CONTRACT[合同签署组件]
|
||||
VERIFY[签章验证组件]
|
||||
STORAGE[签章存储组件]
|
||||
MONITOR[签章监控组件]
|
||||
end
|
||||
|
||||
ADAPTER --> CONTRACT
|
||||
ADAPTER --> VERIFY
|
||||
CONTRACT --> STORAGE
|
||||
VERIFY --> STORAGE
|
||||
STORAGE --> MONITOR
|
||||
```
|
||||
|
||||
## 功能模块设计
|
||||
|
||||
### 电子签章模块(INST-SIGN)
|
||||
|
||||
#### 核心功能
|
||||
|
||||
1. **合同签署管理**
|
||||
- 合同模板管理
|
||||
- 签署流程定义
|
||||
- 签署任务创建
|
||||
- 签署状态跟踪
|
||||
|
||||
2. **电子签章服务**
|
||||
- 签章申请
|
||||
- 签章执行
|
||||
- 签章验证
|
||||
- 签章结果通知
|
||||
|
||||
3. **电子存证管理**
|
||||
- 存证申请
|
||||
- 存证查询
|
||||
- 存证验证
|
||||
- 存证下载
|
||||
|
||||
4. **系统集成服务**
|
||||
- CA系统连接管理
|
||||
- 接口调用监控
|
||||
- 异常处理机制
|
||||
- 日志记录与审计
|
||||
|
||||
#### 数据模型
|
||||
|
||||
1. **电子合同表(installation_contract)**
|
||||
- 合同ID
|
||||
- 合同类型
|
||||
- 合同标题
|
||||
- 合同内容
|
||||
- 创建时间
|
||||
- 有效期
|
||||
- 状态
|
||||
|
||||
2. **电子签章记录表(installation_signature)**
|
||||
- 签章ID
|
||||
- 合同ID
|
||||
- 签署人ID
|
||||
- 签署时间
|
||||
- 签署IP
|
||||
- 签章图像
|
||||
- 签章状态
|
||||
|
||||
3. **电子存证记录表(installation_evidence)**
|
||||
- 存证ID
|
||||
- 合同ID
|
||||
- 存证时间
|
||||
- 存证哈希
|
||||
- 存证状态
|
||||
- 存证凭证
|
||||
|
||||
## 接口设计
|
||||
|
||||
### 内部接口
|
||||
|
||||
1. **合同签署接口**
|
||||
- 功能:创建合同签署任务
|
||||
- 输入:合同信息、签署方信息
|
||||
- 输出:签署任务ID、状态
|
||||
|
||||
2. **签署状态查询接口**
|
||||
- 功能:查询合同签署状态
|
||||
- 输入:签署任务ID
|
||||
- 输出:签署状态、签署结果
|
||||
|
||||
3. **存证申请接口**
|
||||
- 功能:为已签署合同申请电子存证
|
||||
- 输入:合同ID
|
||||
- 输出:存证ID、存证状态
|
||||
|
||||
### 外部接口(泛微CA系统)
|
||||
|
||||
1. **身份认证接口**
|
||||
- 功能:验证签署方身份
|
||||
- 方式:HTTPS REST API
|
||||
- 输入:用户信息、认证方式
|
||||
- 输出:认证结果、认证凭证
|
||||
|
||||
2. **电子签章接口**
|
||||
- 功能:执行电子签章操作
|
||||
- 方式:HTTPS REST API
|
||||
- 输入:文档内容、签章位置、签章类型
|
||||
- 输出:签章结果、签章图像
|
||||
|
||||
3. **时间戳接口**
|
||||
- 功能:为签署过程提供可信时间戳
|
||||
- 方式:HTTPS REST API
|
||||
- 输入:签署数据哈希
|
||||
- 输出:时间戳凭证
|
||||
|
||||
4. **电子存证接口**
|
||||
- 功能:存储签署后的合同文档
|
||||
- 方式:HTTPS REST API
|
||||
- 输入:签署完成的文档、元数据
|
||||
- 输出:存证凭证、存证ID
|
||||
|
||||
## 业务流程
|
||||
|
||||
### 合同签署流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 客户
|
||||
participant 报装系统
|
||||
participant 电子签章模块
|
||||
participant 泛微CA系统
|
||||
|
||||
客户->>报装系统: 提交报装申请
|
||||
报装系统->>报装系统: 生成合同
|
||||
报装系统->>电子签章模块: 创建签署任务
|
||||
电子签章模块->>泛微CA系统: 身份认证请求
|
||||
泛微CA系统-->>电子签章模块: 返回认证结果
|
||||
电子签章模块->>泛微CA系统: 发送签章请求
|
||||
泛微CA系统-->>电子签章模块: 返回签章结果
|
||||
电子签章模块->>泛微CA系统: 申请时间戳
|
||||
泛微CA系统-->>电子签章模块: 返回时间戳凭证
|
||||
电子签章模块->>泛微CA系统: 申请电子存证
|
||||
泛微CA系统-->>电子签章模块: 返回存证凭证
|
||||
电子签章模块-->>报装系统: 返回签署结果
|
||||
报装系统-->>客户: 通知签署完成
|
||||
```
|
||||
|
||||
### 签署验证流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 用户
|
||||
participant 报装系统
|
||||
participant 电子签章模块
|
||||
participant 泛微CA系统
|
||||
|
||||
用户->>报装系统: 请求验证合同
|
||||
报装系统->>电子签章模块: 发送验证请求
|
||||
电子签章模块->>泛微CA系统: 签章验证请求
|
||||
泛微CA系统-->>电子签章模块: 返回验证结果
|
||||
电子签章模块->>泛微CA系统: 存证验证请求
|
||||
泛微CA系统-->>电子签章模块: 返回存证验证结果
|
||||
电子签章模块-->>报装系统: 返回综合验证结果
|
||||
报装系统-->>用户: 显示验证结果
|
||||
```
|
||||
|
||||
## 安全设计
|
||||
|
||||
1. **数据传输安全**
|
||||
- 采用HTTPS加密传输
|
||||
- 实施数据签名验证
|
||||
- 敏感信息加密存储
|
||||
|
||||
2. **身份认证安全**
|
||||
- 多因素身份认证
|
||||
- 签署权限控制
|
||||
- 身份信息保护
|
||||
|
||||
3. **签章防伪措施**
|
||||
- 签章图像防篡改
|
||||
- 签章过程全程记录
|
||||
- 签章结果防抵赖
|
||||
|
||||
4. **存证安全保障**
|
||||
- 区块链存证技术
|
||||
- 多副本存储策略
|
||||
- 存证数据定期校验
|
||||
|
||||
## 部署方案
|
||||
|
||||
### 系统部署
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "应用服务器"
|
||||
APP[报装业务系统]
|
||||
SIGN_MOD[电子签章模块]
|
||||
end
|
||||
|
||||
subgraph "数据服务器"
|
||||
DB[(业务数据库)]
|
||||
SIGN_DB[(签章数据库)]
|
||||
end
|
||||
|
||||
subgraph "泛微CA服务"
|
||||
CA_API[CA API服务]
|
||||
CA_STORAGE[CA存证服务]
|
||||
end
|
||||
|
||||
APP --> SIGN_MOD
|
||||
SIGN_MOD --> DB
|
||||
SIGN_MOD --> SIGN_DB
|
||||
SIGN_MOD --> CA_API
|
||||
CA_API --> CA_STORAGE
|
||||
```
|
||||
|
||||
### 配置要求
|
||||
|
||||
1. **服务器配置**
|
||||
- 应用服务器:8核16G,100G存储
|
||||
- 数据服务器:16核32G,500G存储
|
||||
|
||||
2. **网络配置**
|
||||
- 内网带宽:≥1Gbps
|
||||
- 外网带宽:≥100Mbps
|
||||
- 专线连接:建议与CA系统建立专线
|
||||
|
||||
3. **安全配置**
|
||||
- 防火墙策略:仅开放必要端口
|
||||
- 访问控制:IP白名单限制
|
||||
- 日志审计:全程记录系统操作
|
||||
|
||||
## 测试方案
|
||||
|
||||
1. **功能测试**
|
||||
- 合同生成测试
|
||||
- 签章流程测试
|
||||
- 存证流程测试
|
||||
- 验证流程测试
|
||||
|
||||
2. **性能测试**
|
||||
- 并发签署测试
|
||||
- 响应时间测试
|
||||
- 系统负载测试
|
||||
|
||||
3. **安全测试**
|
||||
- 数据传输安全测试
|
||||
- 身份认证安全测试
|
||||
- 防篡改能力测试
|
||||
|
||||
4. **集成测试**
|
||||
- 与CA系统集成测试
|
||||
- 与报装流程集成测试
|
||||
- 与档案管理集成测试
|
||||
|
||||
## 运维监控
|
||||
|
||||
1. **系统监控**
|
||||
- 接口调用监控
|
||||
- 系统资源监控
|
||||
- 签章服务可用性监控
|
||||
|
||||
2. **告警机制**
|
||||
- 服务不可用告警
|
||||
- 签章失败告警
|
||||
- 存证异常告警
|
||||
|
||||
3. **日志管理**
|
||||
- 操作日志记录
|
||||
- 签章日志记录
|
||||
- 安全审计日志
|
||||
|
||||
## 实施计划
|
||||
|
||||
1. **开发阶段**
|
||||
- 泛微CA接口对接:2周
|
||||
- 电子签章模块开发:3周
|
||||
- 业务流程集成:2周
|
||||
|
||||
2. **测试阶段**
|
||||
- 功能测试:1周
|
||||
- 集成测试:1周
|
||||
- 安全测试:1周
|
||||
|
||||
3. **部署阶段**
|
||||
- 环境准备:3天
|
||||
- 系统部署:2天
|
||||
- 上线验证:2天
|
||||
|
||||
4. **运维阶段**
|
||||
- 系统监控配置:2天
|
||||
- 运维文档编写:3天
|
||||
- 运维人员培训:1天
|
||||
|
||||
## 风险评估
|
||||
|
||||
| 风险项 | 风险级别 | 应对措施 |
|
||||
|-------|---------|---------|
|
||||
| CA系统接口变更 | 中 | 建立接口版本管理机制,做好兼容性处理 |
|
||||
| 签章过程中断 | 高 | 实现断点续签功能,完善异常处理机制 |
|
||||
| 存证服务不可用 | 高 | 建立本地缓存机制,实施异步存证策略 |
|
||||
| 签章效率问题 | 中 | 优化签章流程,实施批量签章功能 |
|
||||
| 法规政策变化 | 低 | 定期跟踪法规更新,及时调整系统功能 |
|
||||
|
||||
## 附录
|
||||
|
||||
### 泛微CA系统接口规范
|
||||
|
||||
泛微CA电子签章系统提供以下核心API接口:
|
||||
|
||||
1. **身份认证API**
|
||||
- 接口地址:`/api/v1/auth`
|
||||
- 请求方式:POST
|
||||
- 参数示例:
|
||||
```json
|
||||
{
|
||||
"userId": "user123",
|
||||
"authType": "face",
|
||||
"authData": "base64_encoded_data"
|
||||
}
|
||||
```
|
||||
|
||||
2. **电子签章API**
|
||||
- 接口地址:`/api/v1/signature`
|
||||
- 请求方式:POST
|
||||
- 参数示例:
|
||||
```json
|
||||
{
|
||||
"documentId": "doc123",
|
||||
"documentData": "base64_encoded_document",
|
||||
"signatureInfo": {
|
||||
"position": { "page": 1, "x": 100, "y": 200 },
|
||||
"signatureType": "personal"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
3. **时间戳API**
|
||||
- 接口地址:`/api/v1/timestamp`
|
||||
- 请求方式:POST
|
||||
- 参数示例:
|
||||
```json
|
||||
{
|
||||
"documentHash": "sha256_hash_value"
|
||||
}
|
||||
```
|
||||
|
||||
4. **电子存证API**
|
||||
- 接口地址:`/api/v1/evidence`
|
||||
- 请求方式:POST
|
||||
- 参数示例:
|
||||
```json
|
||||
{
|
||||
"documentId": "doc123",
|
||||
"documentData": "base64_encoded_document",
|
||||
"metadata": {
|
||||
"title": "用水协议",
|
||||
"signers": ["user1", "user2"],
|
||||
"signTime": "2024-12-19T10:30:00Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 数据库表设计
|
||||
|
||||
#### 电子合同表(installation_contract)
|
||||
|
||||
```sql
|
||||
CREATE TABLE `installation_contract` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`contract_code` varchar(32) NOT NULL COMMENT '合同编号',
|
||||
`installation_id` bigint NOT NULL COMMENT '报装申请ID',
|
||||
`contract_type` varchar(20) NOT NULL COMMENT '合同类型',
|
||||
`contract_title` varchar(100) NOT NULL COMMENT '合同标题',
|
||||
`contract_content` text COMMENT '合同内容',
|
||||
`contract_file_url` varchar(255) DEFAULT NULL COMMENT '合同文件URL',
|
||||
`contract_status` varchar(20) NOT NULL COMMENT '合同状态',
|
||||
`valid_from` datetime DEFAULT NULL COMMENT '生效时间',
|
||||
`valid_to` datetime DEFAULT NULL COMMENT '到期时间',
|
||||
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_contract_code` (`contract_code`),
|
||||
KEY `idx_installation_id` (`installation_id`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报装合同表';
|
||||
```
|
||||
|
||||
#### 电子签章记录表(installation_signature)
|
||||
|
||||
```sql
|
||||
CREATE TABLE `installation_signature` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`signature_code` varchar(32) NOT NULL COMMENT '签章编号',
|
||||
`contract_id` bigint NOT NULL COMMENT '合同ID',
|
||||
`signer_type` varchar(20) NOT NULL COMMENT '签署方类型',
|
||||
`signer_id` varchar(64) NOT NULL COMMENT '签署方ID',
|
||||
`signer_name` varchar(100) NOT NULL COMMENT '签署方名称',
|
||||
`signature_time` datetime DEFAULT NULL COMMENT '签署时间',
|
||||
`signature_ip` varchar(50) DEFAULT NULL COMMENT '签署IP',
|
||||
`signature_location` varchar(255) DEFAULT NULL COMMENT '签署位置',
|
||||
`signature_image` varchar(255) DEFAULT NULL COMMENT '签章图像URL',
|
||||
`signature_data` text COMMENT '签章数据',
|
||||
`timestamp_cert` text COMMENT '时间戳凭证',
|
||||
`signature_status` varchar(20) NOT NULL COMMENT '签章状态',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_signature_code` (`signature_code`),
|
||||
KEY `idx_contract_id` (`contract_id`),
|
||||
KEY `idx_signer_id` (`signer_id`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报装签章记录表';
|
||||
```
|
||||
|
||||
#### 电子存证记录表(installation_evidence)
|
||||
|
||||
```sql
|
||||
CREATE TABLE `installation_evidence` (
|
||||
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||||
`evidence_code` varchar(32) NOT NULL COMMENT '存证编号',
|
||||
`contract_id` bigint NOT NULL COMMENT '合同ID',
|
||||
`evidence_type` varchar(20) NOT NULL COMMENT '存证类型',
|
||||
`evidence_hash` varchar(128) NOT NULL COMMENT '存证哈希值',
|
||||
`evidence_time` datetime NOT NULL COMMENT '存证时间',
|
||||
`evidence_cert` text COMMENT '存证凭证',
|
||||
`evidence_status` varchar(20) NOT NULL COMMENT '存证状态',
|
||||
`storage_location` varchar(255) DEFAULT NULL COMMENT '存储位置',
|
||||
`verify_url` varchar(255) DEFAULT NULL COMMENT '验证URL',
|
||||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_evidence_code` (`evidence_code`),
|
||||
KEY `idx_contract_id` (`contract_id`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报装存证记录表';
|
||||
```
|
||||
383
water_biz_overview_design_ca.md
Normal file
383
water_biz_overview_design_ca.md
Normal file
@ -0,0 +1,383 @@
|
||||
# 报装业务系统电子签章集成概要设计
|
||||
|
||||
## 文档信息
|
||||
| 项目信息 | 详情 |
|
||||
|---------|------|
|
||||
| **项目名称** | 福建水务营收系统 |
|
||||
| **文档类型** | 概要设计文档 |
|
||||
| **文档版本** | v1.0 |
|
||||
| **编写日期** | 2024-12-19 |
|
||||
| **文档状态** | 🟡 进行中 |
|
||||
|
||||
## 1. 设计目标
|
||||
|
||||
本设计旨在为福建水务营收系统的报装业务系统集成泛微CA电子签章系统,实现合同电子签署、身份认证和电子存证服务,确保电子合同的法律效力,提高业务办理效率,降低纸质文档处理成本。
|
||||
|
||||
## 2. 系统架构
|
||||
|
||||
### 2.1 总体架构
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "福建水务营收系统"
|
||||
subgraph "报装业务系统"
|
||||
INST_APP[报装申请模块]
|
||||
INST_CONT[合同管理模块]
|
||||
INST_ARCH[档案管理模块]
|
||||
INST_SIGN[电子签章模块]
|
||||
end
|
||||
|
||||
SYS_PLAT[统一平台]
|
||||
end
|
||||
|
||||
subgraph "外部系统"
|
||||
CA_SYS[泛微CA电子签章系统]
|
||||
end
|
||||
|
||||
INST_APP --> INST_CONT
|
||||
INST_CONT --> INST_SIGN
|
||||
INST_SIGN --> INST_ARCH
|
||||
INST_SIGN <--> CA_SYS
|
||||
SYS_PLAT <--> INST_SIGN
|
||||
```
|
||||
|
||||
### 2.2 模块架构
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "电子签章模块(INST-SIGN)"
|
||||
ADAPTER[泛微CA适配器]
|
||||
CONTRACT[合同签署组件]
|
||||
VERIFY[签章验证组件]
|
||||
STORAGE[签章存储组件]
|
||||
MONITOR[签章监控组件]
|
||||
end
|
||||
|
||||
subgraph "泛微CA电子签章系统"
|
||||
CA_AUTH[身份认证服务]
|
||||
CA_SIGN[电子签章服务]
|
||||
CA_TIME[时间戳服务]
|
||||
CA_STORE[电子存证服务]
|
||||
end
|
||||
|
||||
ADAPTER --> CA_AUTH
|
||||
ADAPTER --> CA_SIGN
|
||||
ADAPTER --> CA_TIME
|
||||
ADAPTER --> CA_STORE
|
||||
|
||||
CONTRACT --> ADAPTER
|
||||
VERIFY --> ADAPTER
|
||||
STORAGE --> ADAPTER
|
||||
MONITOR --> ADAPTER
|
||||
```
|
||||
|
||||
## 3. 功能需求
|
||||
|
||||
### 3.1 核心功能
|
||||
|
||||
| 功能模块 | 功能点 | 优先级 | 描述 |
|
||||
|---------|-------|-------|------|
|
||||
| 合同管理 | 合同模板管理 | 高 | 管理各类电子合同模板,支持模板参数化 |
|
||||
| 合同管理 | 合同生成 | 高 | 基于模板和业务数据生成电子合同 |
|
||||
| 电子签章 | 签章申请 | 高 | 向CA系统申请电子签章 |
|
||||
| 电子签章 | 签章执行 | 高 | 执行电子签章操作 |
|
||||
| 电子签章 | 签章验证 | 中 | 验证电子签章的有效性 |
|
||||
| 电子存证 | 存证申请 | 高 | 向CA系统申请电子存证 |
|
||||
| 电子存证 | 存证查询 | 中 | 查询电子存证状态和信息 |
|
||||
| 电子存证 | 存证验证 | 中 | 验证电子存证的有效性 |
|
||||
| 系统集成 | CA系统连接管理 | 高 | 管理与CA系统的连接配置 |
|
||||
| 系统集成 | 接口调用监控 | 中 | 监控与CA系统的接口调用情况 |
|
||||
|
||||
### 3.2 业务流程
|
||||
|
||||
#### 3.2.1 合同签署流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 客户
|
||||
participant 报装系统
|
||||
participant 电子签章模块
|
||||
participant 泛微CA系统
|
||||
|
||||
客户->>报装系统: 提交报装申请
|
||||
报装系统->>报装系统: 生成合同
|
||||
报装系统->>电子签章模块: 创建签署任务
|
||||
电子签章模块->>泛微CA系统: 身份认证请求
|
||||
泛微CA系统-->>电子签章模块: 返回认证结果
|
||||
电子签章模块->>泛微CA系统: 发送签章请求
|
||||
泛微CA系统-->>电子签章模块: 返回签章结果
|
||||
电子签章模块->>泛微CA系统: 申请时间戳
|
||||
泛微CA系统-->>电子签章模块: 返回时间戳凭证
|
||||
电子签章模块->>泛微CA系统: 申请电子存证
|
||||
泛微CA系统-->>电子签章模块: 返回存证凭证
|
||||
电子签章模块-->>报装系统: 返回签署结果
|
||||
报装系统-->>客户: 通知签署完成
|
||||
```
|
||||
|
||||
#### 3.2.2 签署验证流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 用户
|
||||
participant 报装系统
|
||||
participant 电子签章模块
|
||||
participant 泛微CA系统
|
||||
|
||||
用户->>报装系统: 请求验证合同
|
||||
报装系统->>电子签章模块: 发送验证请求
|
||||
电子签章模块->>泛微CA系统: 签章验证请求
|
||||
泛微CA系统-->>电子签章模块: 返回验证结果
|
||||
电子签章模块->>泛微CA系统: 存证验证请求
|
||||
泛微CA系统-->>电子签章模块: 返回存证验证结果
|
||||
电子签章模块-->>报装系统: 返回综合验证结果
|
||||
报装系统-->>用户: 显示验证结果
|
||||
```
|
||||
|
||||
## 4. 接口设计
|
||||
|
||||
### 4.1 内部接口
|
||||
|
||||
| 接口名称 | 接口描述 | 请求方式 | 输入参数 | 输出参数 |
|
||||
|---------|---------|---------|---------|---------|
|
||||
| createContract | 创建电子合同 | POST | 合同类型、合同内容、签署方信息 | 合同ID、状态 |
|
||||
| initiateSignature | 发起签署流程 | POST | 合同ID、签署方信息 | 签署任务ID、状态 |
|
||||
| querySignatureStatus | 查询签署状态 | GET | 签署任务ID | 签署状态、结果 |
|
||||
| verifySignature | 验证签章 | POST | 合同ID | 验证结果、详情 |
|
||||
| applyEvidence | 申请电子存证 | POST | 合同ID | 存证ID、状态 |
|
||||
| queryEvidence | 查询存证信息 | GET | 存证ID | 存证状态、详情 |
|
||||
|
||||
### 4.2 外部接口
|
||||
|
||||
| 接口名称 | 接口描述 | 请求方式 | URL | 安全措施 |
|
||||
|---------|---------|---------|-----|---------|
|
||||
| 身份认证接口 | 验证签署方身份 | POST | /api/v1/auth | HTTPS、签名验证 |
|
||||
| 电子签章接口 | 执行电子签章操作 | POST | /api/v1/signature | HTTPS、签名验证 |
|
||||
| 时间戳接口 | 获取可信时间戳 | POST | /api/v1/timestamp | HTTPS、签名验证 |
|
||||
| 电子存证接口 | 存储签署后的合同 | POST | /api/v1/evidence | HTTPS、签名验证 |
|
||||
| 验证接口 | 验证签章和存证 | POST | /api/v1/verify | HTTPS、签名验证 |
|
||||
|
||||
## 5. 数据设计
|
||||
|
||||
### 5.1 数据模型
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
installation_contract ||--o{ installation_signature : "签署"
|
||||
installation_contract ||--o{ installation_evidence : "存证"
|
||||
installation_signature }|--|| installation_signature_template : "使用"
|
||||
installation_contract }|--|| installation_application : "关联"
|
||||
|
||||
installation_contract {
|
||||
bigint id PK
|
||||
varchar contract_code
|
||||
bigint installation_id FK
|
||||
varchar contract_type
|
||||
varchar contract_title
|
||||
text contract_content
|
||||
varchar contract_file_url
|
||||
varchar contract_status
|
||||
}
|
||||
|
||||
installation_signature {
|
||||
bigint id PK
|
||||
varchar signature_code
|
||||
bigint contract_id FK
|
||||
varchar signer_type
|
||||
varchar signer_id
|
||||
varchar signature_time
|
||||
varchar signature_status
|
||||
}
|
||||
|
||||
installation_evidence {
|
||||
bigint id PK
|
||||
varchar evidence_code
|
||||
bigint contract_id FK
|
||||
varchar evidence_type
|
||||
varchar evidence_hash
|
||||
varchar evidence_status
|
||||
}
|
||||
|
||||
installation_ca_config {
|
||||
bigint id PK
|
||||
varchar config_key
|
||||
varchar config_value
|
||||
tinyint is_enabled
|
||||
}
|
||||
|
||||
installation_signature_template {
|
||||
bigint id PK
|
||||
varchar template_code
|
||||
varchar template_name
|
||||
varchar template_type
|
||||
tinyint is_default
|
||||
}
|
||||
```
|
||||
|
||||
### 5.2 关键表设计
|
||||
|
||||
#### 5.2.1 电子合同表(installation_contract)
|
||||
|
||||
存储报装业务系统中的电子合同信息,包括合同基本信息、状态和文件链接等。
|
||||
|
||||
#### 5.2.2 电子签章记录表(installation_signature)
|
||||
|
||||
记录电子合同的签章信息,包括签署方信息、签署时间、签章数据等。
|
||||
|
||||
#### 5.2.3 电子存证记录表(installation_evidence)
|
||||
|
||||
存储电子合同的存证信息,包括存证哈希、存证时间、存证凭证等。
|
||||
|
||||
#### 5.2.4 CA系统配置表(installation_ca_config)
|
||||
|
||||
存储泛微CA电子签章系统的配置信息,包括接口地址、认证信息等。
|
||||
|
||||
#### 5.2.5 签章模板表(installation_signature_template)
|
||||
|
||||
存储电子签章模板信息,用于快速生成签章。
|
||||
|
||||
## 6. 安全设计
|
||||
|
||||
### 6.1 传输安全
|
||||
|
||||
- 采用HTTPS加密传输
|
||||
- 实施数据签名验证
|
||||
- 敏感信息加密存储
|
||||
|
||||
### 6.2 身份认证安全
|
||||
|
||||
- 多因素身份认证
|
||||
- 签署权限控制
|
||||
- 身份信息保护
|
||||
|
||||
### 6.3 签章防伪措施
|
||||
|
||||
- 签章图像防篡改
|
||||
- 签章过程全程记录
|
||||
- 签章结果防抵赖
|
||||
|
||||
### 6.4 存证安全保障
|
||||
|
||||
- 区块链存证技术
|
||||
- 多副本存储策略
|
||||
- 存证数据定期校验
|
||||
|
||||
## 7. 部署架构
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "应用服务器"
|
||||
APP[报装业务系统]
|
||||
SIGN_MOD[电子签章模块]
|
||||
end
|
||||
|
||||
subgraph "数据服务器"
|
||||
DB[(业务数据库)]
|
||||
SIGN_DB[(签章数据库)]
|
||||
end
|
||||
|
||||
subgraph "泛微CA服务"
|
||||
CA_API[CA API服务]
|
||||
CA_STORAGE[CA存证服务]
|
||||
end
|
||||
|
||||
APP --> SIGN_MOD
|
||||
SIGN_MOD --> DB
|
||||
SIGN_MOD --> SIGN_DB
|
||||
SIGN_MOD --> CA_API
|
||||
CA_API --> CA_STORAGE
|
||||
```
|
||||
|
||||
## 8. 性能考虑
|
||||
|
||||
### 8.1 性能指标
|
||||
|
||||
| 指标 | 目标值 | 说明 |
|
||||
|------|-------|------|
|
||||
| 签章响应时间 | <3秒 | 单个文档签章操作的响应时间 |
|
||||
| 存证响应时间 | <5秒 | 单个文档存证操作的响应时间 |
|
||||
| 验证响应时间 | <2秒 | 签章验证操作的响应时间 |
|
||||
| 并发签章能力 | >50/分钟 | 系统每分钟可处理的签章请求数 |
|
||||
| 系统可用性 | >99.9% | 系统服务可用时间比例 |
|
||||
|
||||
### 8.2 优化措施
|
||||
|
||||
- **异步处理**:对于耗时操作采用异步处理机制
|
||||
- **缓存策略**:对频繁访问的数据实施缓存
|
||||
- **批量处理**:支持批量签章和存证操作
|
||||
- **资源池化**:采用连接池管理CA系统连接
|
||||
- **负载均衡**:在高并发场景下实施负载均衡
|
||||
|
||||
## 9. 风险评估
|
||||
|
||||
| 风险项 | 风险级别 | 影响范围 | 应对措施 |
|
||||
|-------|---------|---------|---------|
|
||||
| CA系统接口变更 | 中 | 签章功能 | 建立接口版本管理机制,做好兼容性处理 |
|
||||
| 签章过程中断 | 高 | 业务流程 | 实现断点续签功能,完善异常处理机制 |
|
||||
| 存证服务不可用 | 高 | 法律效力 | 建立本地缓存机制,实施异步存证策略 |
|
||||
| 签章效率问题 | 中 | 用户体验 | 优化签章流程,实施批量签章功能 |
|
||||
| 法规政策变化 | 低 | 合规性 | 定期跟踪法规更新,及时调整系统功能 |
|
||||
|
||||
## 10. 实施计划
|
||||
|
||||
### 10.1 阶段划分
|
||||
|
||||
| 阶段 | 工作内容 | 时间周期 | 交付物 |
|
||||
|------|---------|---------|-------|
|
||||
| 需求分析 | 详细需求调研、业务流程分析 | 2周 | 需求规格说明书 |
|
||||
| 系统设计 | 架构设计、接口设计、数据库设计 | 3周 | 设计文档 |
|
||||
| 开发实施 | 模块开发、接口对接、单元测试 | 6周 | 系统代码 |
|
||||
| 系统测试 | 功能测试、集成测试、性能测试 | 3周 | 测试报告 |
|
||||
| 部署上线 | 环境准备、系统部署、验收测试 | 2周 | 部署文档 |
|
||||
| 运维支持 | 系统监控、问题处理、版本迭代 | 长期 | 运维手册 |
|
||||
|
||||
### 10.2 里程碑计划
|
||||
|
||||
| 里程碑 | 时间点 | 验收标准 |
|
||||
|-------|-------|---------|
|
||||
| 需求确认 | 第2周末 | 需求文档评审通过 |
|
||||
| 设计完成 | 第5周末 | 设计文档评审通过 |
|
||||
| 开发完成 | 第11周末 | 代码开发完成并通过代码审查 |
|
||||
| 测试通过 | 第14周末 | 测试用例通过率>95% |
|
||||
| 系统上线 | 第16周末 | 系统功能验收通过 |
|
||||
|
||||
## 11. 附录
|
||||
|
||||
### 11.1 术语表
|
||||
|
||||
| 术语 | 英文 | 说明 |
|
||||
|------|------|------|
|
||||
| 电子签章 | Electronic Seal | 使用电子技术手段产生的、与实体印章具有同等法律效力的数字印记 |
|
||||
| 电子存证 | Electronic Evidence | 对电子数据进行保全和存储,确保其法律效力的技术手段 |
|
||||
| 时间戳 | Timestamp | 证明电子数据在某一时刻已经存在且未被篡改的数字证明 |
|
||||
| CA系统 | Certificate Authority System | 数字证书认证系统,提供电子认证服务 |
|
||||
|
||||
### 11.2 参考标准
|
||||
|
||||
1. 《中华人民共和国电子签名法》
|
||||
2. GB/T 35275-2017 《电子签名 可信电子签名生成技术规范》
|
||||
3. GB/T 38540-2020 《信息安全技术 电子签名数据电子存证规范》
|
||||
4. 泛微CA电子签章系统接口规范 v2.0
|
||||
|
||||
### 11.3 泛微CA系统接口规范
|
||||
|
||||
泛微CA电子签章系统提供以下核心API接口:
|
||||
|
||||
1. **身份认证API**
|
||||
- 接口地址:`/api/v1/auth`
|
||||
- 请求方式:POST
|
||||
- 功能:验证签署方身份
|
||||
|
||||
2. **电子签章API**
|
||||
- 接口地址:`/api/v1/signature`
|
||||
- 请求方式:POST
|
||||
- 功能:执行电子签章操作
|
||||
|
||||
3. **时间戳API**
|
||||
- 接口地址:`/api/v1/timestamp`
|
||||
- 请求方式:POST
|
||||
- 功能:获取可信时间戳
|
||||
|
||||
4. **电子存证API**
|
||||
- 接口地址:`/api/v1/evidence`
|
||||
- 请求方式:POST
|
||||
- 功能:存储签署后的合同文档
|
||||
809
新-概要设计说明书.md
809
新-概要设计说明书.md
File diff suppressed because it is too large
Load Diff
@ -364,7 +364,7 @@
|
||||
|
||||
<div class="component">
|
||||
<div class="component-title">客户服务模块群</div>
|
||||
<div class="component-desc">账户绑定、信息查询、在线缴费<br/>电子发票、营业网点、业务办理</div>
|
||||
<div class="component-desc">账户绑定、信息查询、在线缴费、柜面扫码支付<br/>电子发票、营业网点、业务办理</div>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
@ -461,7 +461,7 @@
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">仓库与库存</div>
|
||||
<div class="component-desc">入出库/盘点/调拨<br/>库存预警</div>
|
||||
<div class="component-desc">入出库/盘点/调拨<br/>库存预警<br/>全生命周期管理</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">设备档案</div>
|
||||
@ -486,11 +486,11 @@
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">施工管理</div>
|
||||
<div class="component-desc">进度/资源/质量/安全<br/>过程留痕</div>
|
||||
<div class="component-desc">进度/资源/质量/安全<br/>过程留痕<br/>节点灵活配置</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">验收通水/资料归档</div>
|
||||
<div class="component-desc">竣工验收、通水<br/>档案归档</div>
|
||||
<div class="component-desc">竣工验收、通水<br/>档案归档(CA签章/存证)</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@ -515,9 +515,17 @@
|
||||
<div class="component-desc">Flowable<br/>业务流程管理</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">消息服务</div>
|
||||
<div class="component-title">消息队列</div>
|
||||
<div class="component-desc">RabbitMQ<br/>异步消息处理</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">注册/配置中心</div>
|
||||
<div class="component-desc">统一配置/注册<br/>服务发现</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">任务调度</div>
|
||||
<div class="component-desc">定时任务<br/>批处理调度</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">文件服务</div>
|
||||
<div class="component-desc">MinIO<br/>分布式文件存储</div>
|
||||
@ -527,16 +535,12 @@
|
||||
<div class="component-desc">统一开票/作废/红冲<br/>供应商适配/回执存证</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">银行对接子系统(SYS-009)</div>
|
||||
<div class="component-desc">代扣送盘/回盘<br/>对账处理/加解密</div>
|
||||
<div class="component-title">支付与银行结算子系统(SYS-009)</div>
|
||||
<div class="component-desc">聚合支付/回调/退款<br/>代扣送回盘/对账/加解密</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">第三方支付子系统(SYS-010)</div>
|
||||
<div class="component-desc">聚合支付/退款<br/>渠道适配/回调</div>
|
||||
</div>
|
||||
<div class="component">
|
||||
<div class="component-title">通信服务</div>
|
||||
<div class="component-desc">短信平台<br/>消息推送</div>
|
||||
<div class="component-title">消息服务子系统(SYS-010)</div>
|
||||
<div class="component-desc">统一短信/邮件/推送<br/>模板与回执</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@ -589,6 +593,36 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="connections">
|
||||
<h3>🔗 关键系统集成关系</h3>
|
||||
<div class="flow-diagram">
|
||||
<div class="flow-item">营收(SYS-002)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">发票服务(SYS-008)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">发票供应商</div>
|
||||
</div>
|
||||
<div class="flow-diagram" style="margin-top:6px;">
|
||||
<div class="flow-item">营收(SYS-002)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">支付与银行结算(SYS-009)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">银行/支付渠道</div>
|
||||
</div>
|
||||
<div class="flow-diagram" style="margin-top:6px;">
|
||||
<div class="flow-item">营收(SYS-002)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">消息服务(SYS-010)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">短信/邮件/推送</div>
|
||||
</div>
|
||||
<div class="flow-diagram" style="margin-top:6px;">
|
||||
<div class="flow-item">报装(SYS-007)</div>
|
||||
<div class="arrow">→</div>
|
||||
<div class="flow-item">CA电子签章</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 技术栈 -->
|
||||
<div class="tech-stack">
|
||||
<h3>🛠️ 核心技术栈</h3>
|
||||
@ -596,8 +630,8 @@
|
||||
<div class="tech-category">
|
||||
<h4>后端技术</h4>
|
||||
<ul class="tech-list">
|
||||
<li>Java 11+</li>
|
||||
<li>Spring Boot 2.7+</li>
|
||||
<li>Java 17+</li>
|
||||
<li>Spring Boot 3.1+</li>
|
||||
<li>Spring Cloud Gateway</li>
|
||||
<li>MyBatis-Plus</li>
|
||||
<li>Spring Security</li>
|
||||
@ -647,11 +681,12 @@
|
||||
<h4>外部集成</h4>
|
||||
<ul class="tech-list">
|
||||
<li>微信公众号平台</li>
|
||||
<li>微信支付 JSAPI</li>
|
||||
<li>支付宝支付</li>
|
||||
<li>微信支付 JSAPI(经SYS-009)</li>
|
||||
<li>支付宝支付(经SYS-009)</li>
|
||||
<li>银行代扣</li>
|
||||
<li>短信平台</li>
|
||||
<li>电子发票</li>
|
||||
<li>集抄系统</li>
|
||||
<li>短信平台/邮件服务/移动推送(经SYS-010)</li>
|
||||
<li>电子发票/CA电子签章</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user