anxin-ruoyi/.kiro/specs/digital-credit-service/requirements.md
2025-12-23 18:33:17 +08:00

148 lines
9.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 数字债权服务系统需求文档
## 简介
数字债权服务系统是一个基于区块链技术的安保服务债权管理平台,旨在为安保公司提供服务确权、融资申请和到期结算的完整解决方案。系统通过三个核心阶段实现服务合同的数字化管理和债权流转。
## 术语表
- **安信平台**: 数字债权服务管理平台
- **甲方单位**: 购买安保服务的客户方
- **安保公司**: 提供安保服务的服务方
- **数字债权凭证**: 基于区块链技术生成的不可篡改债权证明
- **金融机构**: 提供融资服务的银行或其他金融服务机构
- **资金监管账户**: 专门用于资金托管和分配的银行账户
- **智能合约**: 自动执行合约条款的区块链程序
- **员工库**: 安保公司维护的员工信息数据库,包含员工基本信息、薪资标准等
- **员工组**: 按项目或业务需求组织的员工集合,便于批量管理和分配
- **服务周期**: 合同执行过程中的具体服务时间段,包含实际出勤员工和工作量
- **薪资单位**: 员工薪资计算方式,包括小时制、班次制、月薪制等
- **风险事件**: 系统检测到的数据不一致或异常情况,需要人工干预处理
- **OCR识别**: 光学字符识别技术,用于自动提取合同文档中的关键信息
## 需求
### 需求 1
**用户故事:** 作为安保公司,我希望能够在平台上创建服务合同并管理债权,以便生成可信的数字债权凭证并申请融资。
#### 验收标准
1. 当安保公司提交服务合同和服务内容时,安信平台必须创建合同记录、自动生成合同状态并通知对应的甲方单位进行确认
2. 当甲方单位确认交易意向时,安信平台必须更新合同状态为"已确认"并记录确认时间
3. 当服务完成且甲方确认服务履行情况时,安信平台必须自动生成应收账款债权记录
4. 当债权记录生成时,安信平台必须创建包含合同详情、金额、到期日的数字债权凭证
5. 当数字债权凭证创建时,安信平台必须利用区块链技术确保凭证数据不可篡改
6. 当安保公司查看债权信息时,安信平台必须仅显示本公司发起或参与的业务相关债权
7. 当安保公司申请融资时,安信平台必须验证其对相关债权凭证的合法权限
8. 当创建或更新合同时,安信平台必须在后端自动设置合同状态,前端不得提供或修改合同状态信息
### 需求 2
**用户故事:** 作为甲方单位,我希望能够确认合同、管理付款并查看相关债权,以便履行合同义务并监控债务状态。
#### 验收标准
1. 当甲方单位登录系统时,安信平台必须仅显示其签署的合同及关联债权信息
2. 当甲方单位确认服务履行情况时,安信平台必须记录确认结果并触发债权生成流程
3. 当合同付款日临近时,安信平台必须向甲方单位发送付款提醒通知
4. 当甲方单位触发付款操作时,安信平台必须验证其对该合同的付款权限
5. 当甲方单位查看债权状态时,安信平台必须仅允许查看与其签署合同相关的债权信息
6. 当甲方单位尝试访问其他合同信息时,安信平台必须拒绝访问并记录未授权尝试
### 需求 3
**用户故事:** 作为金融机构,我希望能够审批融资申请、评估风险并管理资金,以便为合格的债权提供融资服务。
#### 验收标准
1. 当金融机构接收融资申请时,安信平台必须仅显示本机构受理的融资申请及对应债权信息
2. 当金融机构调用API获取债权数据时安信平台必须验证机构权限并提供链上相关数据用于风险评估
3. 当金融机构进行风险评估时,安信平台必须提供包含合同金额、信用历史、还款能力等评估要素
4. 当金融机构审批融资申请时,安信平台必须记录审批结果并创建融资合约
5. 当融资资金到账时,安信平台必须将资金存入指定的资金监管账户
6. 当金融机构查看数据分析报告时,安信平台必须仅提供与本机构业务相关的统计数据
7. 当金融机构尝试访问其他机构的业务数据时,安信平台必须拒绝访问并记录未授权尝试
### 需求 4
**用户故事:** 作为安保公司,我希望能够使用数字债权凭证向金融机构申请融资并生成财务报表,以便获得资金支持并进行财务管理。
#### 验收标准
1. 当安保公司提交融资申请时,安信平台必须验证数字债权凭证的有效性和完整性
2. 当安保公司生成债权凭证时,安信平台必须确保仅针对本公司发起或参与的业务
3. 当安保公司申请融资时,安信平台必须验证其对相关债权的合法所有权
4. 当安保公司查看财务报表时,安信平台必须仅显示本公司相关的债权统计和收益分析
5. 当融资资金到账时,安信平台必须通过智能合约实现定向支付并优先保障安保人员薪资
6. 当安保公司导出财务数据时安信平台必须支持Excel、PDF等格式并确保数据仅包含本公司业务
### 需求 5
**用户故事:** 作为系统管理员,我希望能够监控和管理整个债权流转过程,以便确保系统安全稳定运行。
#### 验收标准
1. 当安信平台处理任何债权相关操作时,必须记录详细的操作日志和审计轨迹
2. 当发生异常情况时,安信平台必须立即发送告警通知给相关管理人员
3. 当管理员查询债权状态时,安信平台必须提供实时的债权流转状态和历史记录
4. 当安信平台进行数据备份时,必须确保区块链数据和业务数据的一致性
5. 当执行系统维护时,安信平台必须在不影响核心业务的情况下进行升级和维护
### 需求 6
**用户故事:** 作为系统用户,我希望系统能够在合同到期时自动处理资金分配,以便确保债务按时清偿。
#### 验收标准
1. 当甲方单位支付款项到资金监管专户时,安信平台必须确认收款并触发智能合约
2. 当智能合约启动资金分配程序时,安信平台必须首先偿还金融机构贷款本金和利息
3. 当贷款偿还完成且有剩余资金时,安信平台必须将剩余资金转至安保公司账户
4. 当所有债务结清时,安信平台必须更新数字债权凭证状态为"已结清"
5. 当资金分配过程中,安信平台必须使用加密协议确保所有数据传输安全
### 需求 7
**用户故事:** 作为金融机构我希望能够通过标准化API接口获取链上数据并审批放款以便做出准确的融资决策。
#### 验收标准
1. 当金融机构通过API请求债权信息时安信平台必须通过RESTful API提供标准化的数据接口
2. 当API调用包含有效的认证信息时安信平台必须验证调用方身份并仅授权访问本机构受理的融资申请数据
3. 当返回债权数据时,安信平台必须包含合同金额、信用历史、还款能力等风险评估要素
4. 当金融机构提交审批结果时,安信平台必须接收并记录审批决定和相关放款条件
5. 当金融机构调用链上数据时,安信平台必须确保仅提供与该机构业务相关的区块链数据
### 需求 8
**用户故事:** 作为安保公司,我希望能够维护员工库并通过员工组管理不同项目的人员配置,以便高效地管理服务周期的员工安排和成本计算。
#### 验收标准
1. 当安保公司注册账号后安信平台必须提供员工库管理功能支持批量导入常用ERP格式文件
2. 当创建员工信息时,安信平台必须支持多种薪资单位(小时制、班次制、月薪制)和岗位信息
3. 当管理员工库时安信平台必须允许创建不同的员工组如项目1员工组、项目2员工组
4. 当创建合同时,安信平台必须支持直接勾选对应的员工组或单个员工进行关联
5. 当确认服务周期出勤时,安信平台必须支持从员工组或员工库中选择实际出勤员工
6. 当添加临时员工时,安信平台必须提供"将该员工同步添加到员工库"的选项
7. 当通过OCR读取合同时安信平台必须自动提取服务周期信息并允许手动调整薪资标准
8. 当计算服务周期成本时,安信平台必须根据实际出勤员工的薪资标准和工作量计算人工成本
9. 当安保公司添加贷款信息时,安信平台必须记录贷款金额、利率、还款期限和还款计划
10. 当查看服务周期信息时,安信平台必须仅显示用户有权访问的员工和财务数据
11. 当导出服务周期报表时,安信平台必须包含完整的员工配置、成本分析和贷款明细
12. 当服务周期数据发生变更时,安信平台必须记录变更日志并通知相关责任人
### 需求 9
**用户故事:** 作为平台管理员和银行用户,我希望系统能够自动检测和预警数据不一致的情况,以便及时识别和控制业务风险。
#### 验收标准
1. 当合同金额与服务确认单金额不符时,安信平台必须生成重要事件警示并通知安保公司用户
2. 当服务确认单金额与发票金额不符时,安信平台必须标记为风险事件并推送给银行和平台管理员
3. 当开票方与收票方主体信息不匹配时,安信平台必须阻止融资申请并要求用户核实
4. 当服务期限与实际确认的服务周期不符时,安信平台必须提醒用户检查合同条款
5. 当发起融资申请时,安信平台必须验证所有关联数据的一致性并生成风险评估报告
6. 当检测到数据异常时,安信平台必须记录异常详情并建立风险事件跟踪机制
7. 当风险事件发生时,安信平台必须按照用户角色推送相应的风险提示和处理建议
8. 当用户修正数据不一致问题后,安信平台必须重新验证并更新风险状态