# 数字债权服务系统实施计划 ## 实施概述 将需求和设计转换为一系列代码生成任务，每个任务都基于前一个任务构建，最终完成完整的数字债权服务系统集成。重点关注编写、修改或测试代码的任务。 ## 任务列表 - [ ] 1. 项目结构搭建和基础配置 - 在RuoYi框架基础上创建9个新模块：ruoyi-credit、ruoyi-blockchain、ruoyi-payment、ruoyi-security、ruoyi-notification、ruoyi-analytics、ruoyi-workflow、ruoyi-integration、ruoyi-monitor - 配置Maven依赖，包括区块链集成、加密库、jqwik测试框架、缓存组件、文件上传处理组件 - 设置数据库连接和基础配置文件，配置Redis缓存 - 创建41个数据库表的DDL脚本，包括员工管理、风险监控相关表 - _需求: 1.1, 2.1, 3.1, 8.1, 9.1_ - [x] 2. 数据模型和实体类实现 - [x] 2.1 创建核心实体类和数据库表结构 - 实现所有41个数据库表对应的实体类，包括ServiceContract、DigitalCredit、FinancingApplication、EmployeeLibrary、RiskEvent等 - 在ServiceContract中添加合同类型、合同来源、附件ID、签署日期、提取信息等新字段 - 新增员工管理相关实体类：EmployeeLibrary、EmployeeGroup、EmployeeGroupMember、ContractEmployeeLink - 新增风险监控相关实体类：RiskEvent、RiskEventTracking、DataConsistencyCheck - 添加@EncryptedField注解到敏感字段，实现AES-256-GCM加密 - 创建对应的数据库表、索引和外键约束 - 实现数据验证注解和业务规则检查 - _需求: 1.1, 1.4, 2.1, 8.1, 8.2, 9.1, 9.6_ - [x] 2.2 编写实体类属性测试 - **属性 5: 债权凭证完整性** - **验证需求: 1.4** - [x] 2.3 实现数据访问层(Mapper) - 创建41个实体类对应的MyBatis Mapper接口和XML文件 - 实现基础CRUD操作、复杂查询、分页查询、统计查询 - 添加员工管理、风险监控相关的数据访问方法 - 添加数据加密解密的自动处理逻辑 - 实现跨模块的关联查询和数据同步 - _需求: 1.1, 1.2, 1.3, 8.1, 9.1_ - [x] 2.4 编写数据访问层属性测试 - **属性 1: 线上合同创建完整性** - **验证需求: 1.1** - [x] 3. 安全管理组件实现 - [x] 3.1 实现数据加密解密服务 - 创建SecurityManager组件的EncryptionService - 实现AES-256-GCM加密算法和密钥管理 - 添加密钥轮换机制和HSM硬件安全模块集成 - 实现字段级加密的自动处理和透明解密 - 添加加密性能监控和密钥安全审计 - _需求: 1.5, 2.1, 5.5_ - [x] 3.2 编写加密服务属性测试 - **属性 6: 区块链不可篡改性** - **验证需求: 1.5** - [x] 3.3 实现身份认证和权限管理 - 扩展RuoYi的认证机制，实现MFA多因素认证（短信、邮箱、TOTP、生物识别） - 实现细粒度权限控制，支持字段级权限和数据脱敏 - 添加登录失败处理、账户锁定、数据清理机制 - 实现异常登录检测、IP白名单、设备指纹识别 - 添加会话管理、强制登出、并发登录控制 - _需求: 4.1, 5.2, 6.1_ - [x] 3.4 编写认证授权属性测试 - **属性 8: 操作权限验证** - **验证需求: 1.7, 2.4, 4.3** - [x] 3.5 实现数据访问权限控制 - 实现基于角色的数据访问控制，确保安保公司仅看本公司业务 - 实现甲方单位仅能查看签署合同及关联债权的权限控制 - 实现金融机构仅能访问受理申请及对应债权的权限控制 - 添加未授权访问检测和日志记录机制 - _需求: 1.6, 2.1, 2.5, 2.6, 3.1, 3.6, 3.7, 4.4_ - [x] 3.6 编写数据访问权限属性测试 - **属性 7: 数据访问权限控制** - **验证需求: 1.6, 2.1, 2.5, 3.1, 3.6, 4.4** - [ ] 3.8 实现风险监控服务 - 创建RiskMonitor组件处理数据一致性检查 - 实现合同金额与服务确认单金额一致性检查 - 实现服务确认单与发票金额一致性检查 - 添加开票方与收票方主体信息验证 - 实现服务期限与实际服务周期一致性检查 - _需求: 9.1, 9.2, 9.3, 9.4_ - [ ]* 3.9 编写合同金额一致性检查属性测试 - **属性 44: 合同金额一致性检查** - **验证需求: 9.1** - [ ]* 3.10 编写发票金额风险标记属性测试 - **属性 45: 发票金额风险标记** - **验证需求: 9.2** - [ ]* 3.11 编写主体信息验证阻断属性测试 - **属性 46: 主体信息验证阻断** - **验证需求: 9.3** - [ ]* 3.12 编写服务期限一致性提醒属性测试 - **属性 47: 服务期限一致性提醒** - **验证需求: 9.4** - [ ] 3.13 实现风险事件管理服务 - 实现融资申请数据一致性验证和风险评估报告生成 - 添加数据异常记录和风险事件跟踪机制 - 实现按用户角色的风险提示推送功能 - 添加风险状态动态更新机制 - _需求: 9.5, 9.6, 9.7, 9.8_ - [ ]* 3.14 编写融资数据一致性验证属性测试 - **属性 48: 融资数据一致性验证** - **验证需求: 9.5** - [ ]* 3.15 编写数据异常记录与跟踪属性测试 - **属性 49: 数据异常记录与跟踪** - **验证需求: 9.6** - [ ]* 3.16 编写角色化风险提示推送属性测试 - **属性 50: 角色化风险提示推送** - **验证需求: 9.7** - [ ]* 3.17 编写风险状态动态更新属性测试 - **属性 51: 风险状态动态更新** - **验证需求: 9.8** - [x] 4. 合同管理服务实现 - [x] 4.1 实现合同创建和上传服务 - 创建ContractService处理合同生命周期，支持线上创建和线下上传两种模式 - 实现线上合同创建、线下合同上传、合同确认、状态更新功能 - 前端页面创建合同时，合同编号和合同状态由后端自动生成和添加 - 合同类型根据调用的API接口进行区分(线上创建API vs 线下上传API) - 服务开始日期和服务结束日期格式修改为年月日(YYYY-MM-DD) - 添加合同文件验证、信息提取、数据完整性检查功能 - 实现合同文件存储和关联管理 - 强化后端状态控制：拒绝前端提供的合同状态，所有状态变更由后端业务逻辑控制 - _需求: 1.1, 1.2, 1.8_ - [x] 4.2 编写线上合同创建属性测试 - **属性 1: 线上合同创建完整性** - **验证需求: 1.1** - [x] 4.3 编写线下合同上传属性测试 - **属性 2: 线下合同上传完整性** - **验证需求: 1.1** - [x] 4.4 编写合同状态一致性属性测试 - **属性 3: 合同状态一致性** - **验证需求: 1.2** - [ ] 4.5 实现合同来源自动识别机制 - 修改合同创建API（createContract），自动设置contractSource为"PLATFORM_CREATED" - 修改合同上传API（uploadSignedContract），自动设置contractSource为"UPLOADED" - 移除前端对contractSource参数的接受和处理 - 在ContractServiceImpl中实现基于接口的来源自动识别逻辑 - 更新前端表单，移除合同来源输入字段，改为只读显示 - 添加合同来源设置的审计日志 - _需求: 1.1, 1.8_ - [ ] 4.6 实现合同状态后端控制安全机制 - 修改合同创建和更新API，移除前端状态参数的接受和处理 - 在后端服务层实现状态自动设置逻辑：新建合同状态为"待确认"，确认后为"已确认" - 添加状态变更业务规则验证，确保状态转换的合法性 - 更新前端表单，移除合同状态输入字段，改为只读显示 - 实现状态变更审计日志，记录所有状态变更操作 - _需求: 1.8_ - [ ]* 4.7 编写合同状态后端控制属性测试 - **属性 25: 合同状态后端控制** - **验证需求: 1.8** - [ ]* 4.8 编写合同来源自动识别属性测试 - **属性 26: 合同来源自动识别** - **验证需求: 1.1, 1.8** - [x] 4.9 实现员工管理服务 - 创建EmployeeManager组件处理员工库和员工组管理 - 实现员工库创建、ERP文件批量导入功能 - 支持多种薪资单位（小时制、班次制、月薪制）的员工信息创建 - 实现员工组创建和员工分配功能 - 添加临时员工管理和同步到员工库的选项 - _需求: 8.1, 8.2, 8.3, 8.6_ - [ ]* 4.10 编写员工库管理属性测试 - **属性 35: 员工库创建完整性** - **验证需求: 8.1** - [ ]* 4.11 编写员工信息多样性属性测试 - **属性 36: 员工信息多样性支持** - **验证需求: 8.2** - [ ]* 4.12 编写员工组管理属性测试 - **属性 37: 员工组管理功能** - **验证需求: 8.3** - [x] 4.13 实现合同员工关联服务 - 实现合同创建时员工组或单个员工的关联功能 - 添加服务周期出勤员工选择功能 - 实现OCR自动提取员工信息和手动调整薪资标准 - 添加人工成本计算功能 - _需求: 8.4, 8.5, 8.7, 8.8_ - [ ]* 4.14 编写合同员工关联属性测试 - **属性 38: 合同员工关联功能** - **验证需求: 8.4** - [ ]* 4.15 编写出勤员工选择属性测试 - **属性 39: 出勤员工选择功能** - **验证需求: 8.5** - [ ]* 4.16 编写OCR信息提取属性测试 - **属性 41: OCR信息提取与调整** - **验证需求: 8.7** - [ ]* 4.17 编写成本计算准确性属性测试 - **属性 42: 成本计算准确性** - **验证需求: 8.8** - [ ] 4.18 实现服务周期贷款管理 - 根据服务周期出勤记录中的总贷款金额进行贷款申请 - 根据合同中的期限条件选择银行融资金额、利率、期限等参数 - 实现基于出勤数据的贷款金额计算和验证功能 - 添加合同期限与银行融资条件的匹配逻辑 - 实现服务周期报表导出功能，包含贷款与出勤关联信息 - 添加服务周期数据变更审计和通知机制 - _需求: 8.9, 8.10, 8.11, 8.12_ - [ ]* 4.19 编写贷款信息记录属性测试 - **属性 43: 贷款信息完整记录** - **验证需求: 8.9** - [ ]* 4.20 编写服务周期权限控制属性测试 - **属性 32: 服务周期数据访问权限** - **验证需求: 8.10** - [ ]* 4.21 编写服务周期报表完整性属性测试 - **属性 33: 服务周期报表完整性** - **验证需求: 8.11** - [ ]* 4.22 编写服务周期变更审计属性测试 - **属性 34: 服务周期变更审计** - **验证需求: 8.12** - [x] 5. 区块链集成实现 - [x] 5.1 实现区块链连接和数据上链 - 创建BlockchainIntegrator组件处理链上操作 - 实现联盟链连接、数据哈希计算和上链存储 - 添加链上数据验证、查询功能和事件监控 - 实现零知识证明和同态加密的隐私保护 - 添加区块链网络监控和异常恢复机制 - _需求: 1.5, 2.2_ - [x] 5.2 编写区块链集成属性测试 - **属性 7: 债权验证准确性** - **验证需求: 2.1** - [x] 5.3 实现智能合约集成 - 实现智能合约部署、执行和升级机制 - 实现资金分配和支付优先级的智能合约逻辑 - 添加合约安全审计、权限控制和Gas优化 - 实现Oracle数据源集成和外部数据验证 - 添加合约执行监控、异常处理和回滚机制 - _需求: 2.5, 3.2, 3.3_ - [x] 5.4 编写智能合约属性测试 - **属性 11: 智能合约执行优先级** - **验证需求: 2.5** - [x] 6. 融资管理服务实现 - [x] 6.1 实现融资申请和审批服务 - 创建FinancingService处理融资流程 - 实现申请提交、审批处理、结果记录 - 添加风险评估和信用检查 - _需求: 2.1, 2.3, 2.4_ - [x] 6.2 编写融资管理属性测试 - **属性 9: 审批结果记录** - **验证需求: 2.3** - [x] 6.3 实现资金监管账户管理 - 创建EscrowAccountService处理资金托管 - 实现资金存入、分配、转账功能 - 添加账户状态监控和资金流向跟踪 - _需求: 2.4, 2.5, 3.4_ - [x] 6.4 编写资金管理属性测试 - **属性 10: 资金监管存储** - **验证需求: 2.4** - [x] 7. 支付结算服务实现 - [x] 7.1 实现支付处理和确认服务 - 创建PaymentService处理支付流程 - 实现收款确认、智能合约触发 - 添加支付状态跟踪和异常处理 - _需求: 3.1, 3.2_ - [x] 7.2 编写支付处理属性测试 - **属性 13: 收款确认触发** - **验证需求: 3.2** - [x] 7.3 实现资金分配和结算服务 - 实现贷款偿还优先级逻辑 - 添加剩余资金分配和债权状态更新 - 实现完整的结算流程自动化 - _需求: 3.3, 3.4, 3.5_ - [x] 7.4 编写资金分配属性测试 - **属性 14: 资金分配优先级** - **验证需求: 3.3** - [x] 7.5 编写资金分配优先级属性测试 - **属性 17: 资金分配优先级** - **验证需求: 4.5, 6.2, 6.3** - [x] 7.6 编写债权状态更新属性测试 - **属性 18: 债权状态更新** - **验证需求: 6.4** - [x] 8. 通知和提醒服务实现 - [x] 8.1 实现通知服务和消息推送 - 创建NotificationService组件处理各类通知 - 实现多渠道消息推送（邮件、短信、微信、系统消息、APP推送） - 添加消息模板管理、个性化配置和批量发送 - 实现消息投递状态跟踪和失败重试机制 - 添加消息优先级管理和流量控制 - _需求: 1.1, 3.1, 4.2_ - [x] 8.2 编写付款提醒属性测试 - **属性 15: 付款提醒及时性** - **验证需求: 2.3** - [x] 8.3 实现定时任务和提醒机制 - 集成RuoYi的定时任务框架 - 实现合同到期提醒、状态检查等定时任务 - 添加任务调度和执行监控 - _需求: 3.1, 4.3_ - [x] 8.4 编写异常告警属性测试 - **属性 20: 异常告警及时性** - **验证需求: 5.2** - [x] 9. API接口层实现 - [x] 9.1 实现RESTful API控制器 - 创建各业务模块的Controller类 - 实现标准化的API接口和响应格式，包括合同上传、文件下载、信息提取等新接口 - 添加员工管理API：员工库创建、员工组管理、ERP导入、OCR提取等 - 添加风险监控API：数据一致性检查、风险事件管理、风险提示推送等 - 添加文件上传处理、多媒体类型支持、文件大小限制等功能 - 添加API文档和Swagger集成 - _需求: 5.1, 5.3, 6.2, 8.1, 8.7, 9.1, 9.5_ - [x] 9.2 编写债权验证属性测试 - **属性 6: 债权验证准确性** - **验证需求: 4.1** - [x] 9.3 实现API安全和限流机制 - 添加API认证、签名验证、IP白名单 - 实现API限流和防护机制 - 添加API调用监控和日志记录 - _需求: 5.2, 5.4, 5.5_ - [x] 9.4 编写API权限验证属性测试 - **属性 12: API权限验证与数据提供** - **验证需求: 3.2, 7.2, 7.5** - [x] 9.5 编写API数据完整性属性测试 - **属性 13: API数据完整性** - **验证需求: 3.3, 7.3** - [x] 9.6 编写API标准化响应属性测试 - **属性 14: API标准化响应** - **验证需求: 7.1** - [x] 9.7 编写数据传输安全属性测试 - **属性 23: 数据传输安全性** - **验证需求: 6.5** - [x] 10. 报表和数据分析实现 - [x] 10.1 实现财务报表生成服务 - 创建ReportAnalyzer组件处理报表生成和数据分析 - 实现债权统计、收益分析、风险评估等多维度财务报表 - 添加报表定时生成、多格式导出（Excel、PDF、Word）功能 - 实现数据可视化图表和交互式仪表板 - 添加趋势预测和智能分析功能 - _需求: 6.4, 6.5_ - [x] 10.2 编写财务数据导出属性测试 - **属性 24: 财务数据导出权限** - **验证需求: 4.6** - [x] 10.3 实现数据查询和展示服务 - 实现债权状态查询、历史记录查看 - 添加实时数据更新和通知机制 - 实现用户个性化仪表板 - _需求: 4.3, 6.1, 6.2, 6.3_ - [x] 10.4 编写查询数据实时性属性测试 - **属性 21: 查询数据实时性** - **验证需求: 5.3** - [x] 11. 系统监控和日志实现 - [x] 11.1 实现审计日志和操作记录 - 扩展RuoYi的日志框架 - 实现详细的操作审计和数据变更记录 - 添加日志查询和分析功能 - _需求: 4.1, 4.4_ - [x] 11.2 编写审计日志属性测试 - **属性 19: 操作日志完整性** - **验证需求: 5.1** - [x] 11.3 实现系统监控和告警机制 - 添加系统性能监控和健康检查 - 实现异常检测和自动告警 - 集成监控仪表板和报警通知 - _需求: 4.2, 4.5_ - [x] 11.4 编写数据备份一致性属性测试 - **属性 22: 数据备份一致性** - **验证需求: 5.4** - [x] 11.5 实现工作流引擎服务 - 创建WorkflowEngine组件处理业务流程自动化 - 实现工作流定义、实例管理、任务分配和审批 - 添加流程监控、异常处理和回滚机制 - 集成业务规则引擎和决策表 - _需求: 2.3, 3.1, 4.1_ - [x] 11.6 实现集成适配服务 - 创建IntegrationAdapter组件处理外部系统集成 - 实现金融机构API、支付网关、第三方服务的适配 - 添加数据转换、格式映射和协议适配 - 实现Webhook管理和回调处理 - 添加集成监控和健康检查 - _需求: 2.2, 5.1, 5.4_ - [x] 11.7 实现缓存管理服务 - 创建CacheManager组件处理系统缓存 - 实现Redis分布式缓存和本地缓存策略 - 添加缓存预加载、失效管理和性能监控 - 实现缓存一致性保证和数据同步 - _需求: 4.3, 6.2, 6.3_ - [x] 11.8 实现数据管理服务 - 创建DataManager组件处理数据生命周期 - 实现数据备份、恢复、归档和清理 - 添加数据质量监控和完整性验证 - 实现跨节点数据同步和一致性保证 - _需求: 4.4, 4.5_ - [-] 12. 前端界面集成 - [x] 12.1 实现债权管理前端页面 - 基于RuoYi-Vue3创建债权管理界面 - 实现线上合同创建、线下合同上传、合同确认、债权查看等页面 - 添加文件上传组件、文件预览、信息提取展示功能 - 添加数据脱敏和权限控制 - _需求: 1.1, 1.2, 6.1, 6.2_ - [ ] 12.1.1 实现员工管理前端页面 - 创建员工库管理界面，支持ERP文件批量导入 - 实现员工信息创建和编辑，支持多种薪资单位选择 - 创建员工组管理界面，支持员工分配和组管理 - 实现合同员工关联界面，支持员工组和单个员工选择 - 添加服务周期出勤员工选择功能 - 实现临时员工添加和同步到员工库的选项 - _需求: 8.1, 8.2, 8.3, 8.4, 8.5, 8.6_ - [ ] 12.1.2 实现风险监控前端页面 - 创建风险事件监控界面，展示数据一致性检查结果 - 实现风险事件列表和详情查看 - 添加风险提示和处理建议展示 - 实现风险事件跟踪和状态更新界面 - 添加数据修正和重新验证功能 - _需求: 9.1, 9.2, 9.6, 9.7, 9.8_ - [x] 12.2 实现融资管理前端页面 - 创建融资申请、审批、资金管理界面 - 实现实时状态更新和进度跟踪 - 添加风险评估和数据可视化 - _需求: 2.1, 2.3, 6.3_ - [x] 12.3 实现财务报表和仪表板 - 创建财务数据展示和报表界面 - 实现数据导出和打印功能 - 添加交互式图表和数据钻取 - _需求: 6.4, 6.5_ - [x] 12.4 实现系统管理和监控界面 - 创建系统监控、日志查看、用户管理界面 - 实现安全事件监控和告警管理界面 - 添加工作流管理和任务审批界面 - 实现系统配置和参数管理界面 - _需求: 4.1, 4.2, 4.3_ - [ ] 13. 集成测试和系统测试 - [ ] 13.1 实现端到端集成测试 - 编写完整业务流程的集成测试 - 测试三个核心阶段的完整流转 - 验证数据一致性和业务规则 - _需求: 1.1-1.5, 2.1-2.5, 3.1-3.5_ - [ ] 13.2 编写收款确认触发属性测试 - **属性 16: 收款确认触发** - **验证需求: 6.1** - [ ] 13.4 实现性能测试和压力测试 - 测试系统在高并发下的性能表现 - 验证数据库查询和API响应性能 - 测试区块链集成的稳定性 - _需求: 4.5, 5.1_ - [ ] 14. 部署配置和上线准备 - [ ] 14.1 配置生产环境部署 - 配置生产数据库和区块链网络连接 - 设置安全证书和加密密钥 - 配置负载均衡和高可用架构 - _需求: 4.4, 4.5, 5.5_ - [ ] 14.2 实现数据迁移和初始化 - 编写41个数据库表的初始化脚本和索引 - 实现现有数据的迁移和转换，包括数据加密处理 - 添加员工管理、风险监控相关表的数据迁移脚本 - 添加系统配置、基础数据、权限数据的导入 - 实现数据迁移的回滚和验证机制 - _需求: 4.4, 8.1, 9.1_ - [ ] 14.3 实现安全加固和合规配置 - 配置WAF防火墙、DDoS防护、IDS/IPS系统 - 实施SSL/TLS加密、API安全、网络隔离 - 配置安全监控、威胁检测、事件响应 - 实现等保合规、ISO27001认证要求 - 添加安全审计和渗透测试 - _需求: 4.2, 5.5_ - [ ] 15. 最终检查点 - 确保所有测试通过 - 确保所有测试通过，如有问题请咨询用户