# 数字债权服务系统前端页面需求文档

## 简介

基于数字债权服务系统的后端API接口，为RuoYi-Vue3前端框架开发完整的业务页面。系统需要支持合同管理、债权管理、融资管理、支付结算、区块链集成、报表分析、安全管理和通知服务等核心功能模块。

## 术语表

- **数字债权服务系统**: 基于区块链技术的债权管理平台
- **RuoYi-Vue3**: 基于Vue3的前后端分离开发框架
- **合同管理模块**: 处理服务合同创建、确认、查询等功能的页面模块
- **债权管理模块**: 管理数字债权凭证生成、查询、验证等功能的页面模块
- **融资管理模块**: 处理融资申请、审批、风险评估等功能的页面模块
- **支付结算模块**: 管理支付处理、监管账户、资金分配等功能的页面模块
- **区块链集成模块**: 提供数据上链、验证、智能合约等功能的页面模块
- **报表分析模块**: 展示仪表板、生成报表、统计分析等功能的页面模块
- **安全管理模块**: 处理用户认证、MFA、审计日志等功能的页面模块
- **通知服务模块**: 管理消息发送、模板、投递状态等功能的页面模块

## 需求

### 需求 1

**用户故事:** 作为系统用户，我希望有完整的合同管理页面，以便创建、上传、确认和管理服务合同。

#### 验收标准

1. 当用户访问合同管理页面时，系统必须提供合同列表查询和分页显示功能
2. 当用户创建新合同时，系统必须提供表单页面调用POST /api/credit/contracts接口
3. 当用户上传已签署合同时，系统必须提供文件上传页面调用POST /api/credit/contracts/upload接口
4. 当用户确认合同时，系统必须提供确认操作调用PUT /api/credit/contracts/{id}/confirm接口
5. 当用户查看合同详情时，系统必须提供详情页面调用GET /api/credit/contracts/{id}接口

### 需求 2

**用户故事:** 作为系统用户，我希望有完整的债权管理页面，以便生成、查询和验证数字债权凭证。

#### 验收标准

1. 当用户访问债权管理页面时，系统必须提供债权列表查询和筛选功能
2. 当用户生成债权凭证时，系统必须提供生成页面调用POST /api/credit/credits接口
3. 当用户查看债权详情时，系统必须提供详情页面调用GET /api/credit/credits/{id}接口
4. 当用户验证债权时，系统必须提供验证功能调用POST /api/credit/credits/{id}/validate接口
5. 当用户查看数字签名时，系统必须提供签名展示调用GET /api/credit/credits/{id}/signature接口

### 需求 3

**用户故事:** 作为系统用户，我希望有完整的融资管理页面，以便提交申请、审批和管理融资业务。

#### 验收标准

1. 当用户访问融资管理页面时，系统必须提供融资申请列表和状态筛选功能
2. 当用户提交融资申请时，系统必须提供申请表单调用POST /api/credit/financing接口
3. 当用户审批融资申请时，系统必须提供审批页面调用PUT /api/credit/financing/{id}/approve接口
4. 当用户进行风险评估时，系统必须提供评估页面调用POST /api/credit/financing/{id}/risk-assess接口
5. 当用户查看利率信息时，系统必须提供利率展示调用GET /api/credit/financing/{id}/interest-rate接口

### 需求 4

**用户故事:** 作为系统用户，我希望有完整的支付结算页面，以便处理支付、管理监管账户和资金分配。

#### 验收标准

1. 当用户访问支付管理页面时，系统必须提供支付历史查询和状态展示功能
2. 当用户处理支付时，系统必须提供支付页面调用POST /api/payment/process接口
3. 当用户创建监管账户时，系统必须提供账户创建页面调用POST /api/payment/escrow接口
4. 当用户进行资金分配时，系统必须提供分配页面调用PUT /api/payment/escrow/{id}/distribute接口
5. 当用户查询账户余额时，系统必须提供余额展示调用GET /api/payment/escrow/{id}/balance接口

### 需求 5

**用户故事:** 作为系统用户，我希望有完整的区块链集成页面，以便进行数据上链、验证和智能合约操作。

#### 验收标准

1. 当用户访问区块链管理页面时，系统必须提供链上数据查询和事件展示功能
2. 当用户进行数据上链时，系统必须提供上链页面调用POST /api/blockchain/store接口
3. 当用户验证链上数据时，系统必须提供验证页面调用GET /api/blockchain/verify/{hash}接口
4. 当用户执行智能合约时，系统必须提供合约执行页面调用POST /api/blockchain/contract/execute接口
5. 当用户查询交易详情时，系统必须提供交易展示调用GET /api/blockchain/transaction/{txHash}接口

### 需求 6

**用户故事:** 作为系统用户，我希望有完整的报表分析页面，以便查看仪表板、生成报表和进行数据分析。

#### 验收标准

1. 当用户访问报表分析页面时，系统必须提供仪表板数据展示调用GET /api/reports/dashboard接口
2. 当用户生成报表时，系统必须提供报表生成页面调用POST /api/reports/generate接口
3. 当用户导出报表时，系统必须提供导出功能调用GET /api/reports/{id}/export接口
4. 当用户查看财务报表时，系统必须提供财务数据展示调用GET /api/reports/financial接口
5. 当用户进行风险分析时，系统必须提供分析页面调用POST /api/reports/risk-analysis接口

### 需求 7

**用户故事:** 作为系统用户，我希望有完整的安全管理页面，以便进行用户认证、MFA设置和审计日志查看。

#### 验收标准

1. 当用户访问安全管理页面时，系统必须提供审计日志查询和筛选功能
2. 当用户设置MFA时，系统必须提供MFA配置页面调用POST /api/security/mfa/generate接口
3. 当用户验证MFA时，系统必须提供验证页面调用POST /api/security/mfa/validate接口
4. 当用户查看审计日志时，系统必须提供日志展示调用GET /api/security/audit-logs接口
5. 当用户进行数据加密时，系统必须提供加密功能调用POST /api/security/encrypt接口

### 需求 8

**用户故事:** 作为系统用户，我希望有完整的通知服务页面，以便发送通知、管理模板和查看投递状态。

#### 验收标准

1. 当用户访问通知管理页面时，系统必须提供通知历史和模板管理功能
2. 当用户发送通知时，系统必须提供发送页面调用POST /api/notification/send接口
3. 当用户创建消息模板时，系统必须提供模板编辑页面调用POST /api/notification/templates接口
4. 当用户查看投递状态时，系统必须提供状态展示调用GET /api/notification/delivery-status/{id}接口
5. 当用户批量发送通知时，系统必须提供批量发送页面调用POST /api/notification/batch-send接口

### 需求 9

**用户故事:** 作为系统用户，我希望所有页面都具有良好的用户体验和响应式设计，以便在不同设备上正常使用。

#### 验收标准

1. 当用户在不同设备上访问时，系统必须提供响应式布局适配移动端、平板和桌面
2. 当用户进行操作时，系统必须提供加载状态、成功提示和错误处理
3. 当用户查看数据时，系统必须提供分页、排序、筛选等交互功能
4. 当用户导航页面时，系统必须保持与RuoYi框架的设计风格一致性
5. 当用户访问页面时，系统必须确保页面加载性能和交互响应速度

### 需求 10

**用户故事:** 作为系统用户，我希望页面能够根据我的角色和权限显示相应的功能，以便获得个性化的使用体验。

#### 验收标准

1. 当不同角色用户访问时，系统必须根据RuoYi权限体系显示对应的功能模块和操作按钮
2. 当用户权限不足时，系统必须隐藏相关功能并提供友好的权限提示
3. 当用户访问数据时，系统必须仅显示该用户有权查看的数据范围
4. 当用户进行操作时，系统必须验证操作权限并记录操作日志
5. 当用户权限变更时，系统必须实时更新页面显示的功能模块

### 需求 11

**用户故事:** 作为系统管理员，我希望能够在RuoYi权限管理系统中配置数字债权业务的菜单和角色权限，以便统一管理系统权限。

#### 验收标准

1. 当配置数字债权菜单时，系统必须在RuoYi菜单管理中创建完整的业务菜单结构
2. 当创建业务角色时，系统必须在RuoYi角色管理中配置安保公司、甲方单位、金融机构等角色
3. 当分配权限时，系统必须为各角色设置对应的菜单权限和数据范围权限
4. 当配置按钮权限时，系统必须设置各功能的操作权限标识
5. 当建立部门关联时，系统必须将业务角色与对应的部门进行关联

### 需求 12

**用户故事:** 作为系统管理员，我希望前端页面能够集成现有的RuoYi权限管理系统，以便统一管理用户权限和菜单访问。

#### 验收标准

1. 当系统启动时，前端必须调用GET /dev-api/system/role/list接口获取角色权限数据
2. 当用户登录时，系统必须调用GET /dev-api/system/menu/roleMenuTreeselect/{roleId}接口获取菜单权限
3. 当权限数据更新时，系统必须实时同步前端权限控制和菜单显示
4. 当数字债权业务角色与RuoYi系统角色映射时，系统必须保持权限控制的一致性
5. 当权限验证失败时，系统必须提供统一的错误处理和用户引导

### 需求 13

**用户故事:** 作为系统用户，我希望所有数字债权页面的路由路径保持一致性，以便获得统一的导航体验。

#### 验收标准

1. 当用户在合同列表页面点击新增按钮时，系统必须跳转到/digitalCredit/contract/create路径
2. 当用户在合同列表页面点击修改按钮时，系统必须跳转到/digitalCredit/contract/create路径并传递合同ID参数
3. 当用户在合同创建页面提交成功后，系统必须跳转到/digitalCredit/contract/detail路径
4. 当用户在合同创建页面点击返回时，系统必须跳转到/digitalCredit/contract路径
5. 当用户访问所有数字债权相关页面时，系统必须使用统一的/digitalCredit路径前缀