adspecs 0.1.12

package/.adspecs/templates/07-/345/215/225/345/205/203/346/265/213/350/257/225/346/212/245/345/221/212/346/250/241/346/235/277.md

@@ -0,0 +1,694 @@
+# 单元测试报告模板
+
+> **版本**: v1.1
+> **创建日期**: 2026-03-16
+> **适用人员**: 测试工程师、开发工程师、AI助手
+> **目的**: 记录单元测试执行情况,包括测试用例、测试覆盖率、测试结果、缺陷报告,确保代码质量和功能正确性
+
+---
+
+## 📝 使用说明
+
+本模板用于记录单元测试的执行情况,包括:
+
+1. **测试概览** - 测试基本信息、测试范围、测试环境
+2. **测试用例清单** - 正常场景、异常场景、边界场景的测试用例
+3. **测试覆盖率** - 代码覆盖率、分支覆盖率
+4. **测试结果** - 测试通过率、测试执行时间
+5. **缺陷报告** - 发现的缺陷、缺陷状态
+6. **测试总结** - 测试总结、改进建议
+
+**注意**: 测试代码保留在项目源码中,测试报告只记录测试用例的设计思路和结果。
+
+---
+
+## 🎯 模板结构
+
+### 第1部分：测试概览
+
+```markdown
+## 1. 测试概览
+
+### 1.1 基本信息
+- **测试报告编号**: [如:UTR-20260316-001]
+- **需求名称**: [对应的需求名称]
+- **需求编号**: [对应的需求编号]
+- **所属模块**: [对应的模块名称]
+- **测试人员**: [测试人员姓名]
+- **测试日期**: [YYYY-MM-DD]
+- **测试版本**: [v1.0]
+
+### 1.2 测试目标
+**本次单元测试要达到什么目标？**
+[用1-2句话描述测试目标,如:验证Service层的业务逻辑正确性,确保代码覆盖率达到100%]
+
+### 1.3 测试范围
+**包含哪些测试内容？**
+[列出本次测试包含的内容,如:Service层测试、Mapper层测试、工具类测试]
+
+**不包含哪些测试内容？**
+[明确说明本次测试不包含的内容,如:Controller层测试、集成测试]
+
+### 1.4 测试环境
+**测试环境配置**:
+- **操作系统**: [如:Windows 10 / Linux]
+- **JDK版本**: [如:JDK 1.8]
+- **测试框架**: [如:JUnit 5 + Mockito]
+- **覆盖率工具**: [如:JaCoCo]
+- **数据库**: [如:MySQL 5.7]
+- **其他依赖**: [其他依赖]
+
+### 1.5 测试标准
+**通过标准**:
+- 所有测试用例必须通过
+- 代码覆盖率必须达到100%
+- 每个方法至少3个测试用例(正常+异常+边界)
+- 测试方法命名规范:testMethodName_Success/Fail/Boundary
+
+**失败标准**:
+- 测试用例失败
+- 代码覆盖率低于100%
+- 测试用例不足
+- 测试方法命名不规范
+```
+
+---
+
+### 第2部分：测试用例清单
+
+```markdown
+## 2. 测试用例清单
+
+### 2.1 [类名]测试
+
+#### 2.1.1 正常场景测试
+
+**测试用例1**: test[MethodName]_Success
+- **测试描述**: [描述测试目的]
+- **测试方法**: [被测试的方法名]
+- **前置条件**: [测试前置条件]
+- **输入数据**:
+  - [参数1]: [值] - [说明]
+  - [参数2]: [值] - [说明]
+- **预期结果**: [预期结果]
+- **实际结果**: [实际结果]
+- **测试状态**: [PASS/FAIL]
+- **备注**: [备注信息]
+
+**测试用例2**: test[MethodName]_Success
+- **测试描述**: [描述测试目的]
+- **测试方法**: [被测试的方法名]
+- **前置条件**: [测试前置条件]
+- **输入数据**:
+  - [参数1]: [值] - [说明]
+  - [参数2]: [值] - [说明]
+- **预期结果**: [预期结果]
+- **实际结果**: [实际结果]
+- **测试状态**: [PASS/FAIL]
+- **备注**: [备注信息]
+
+---
+
+#### 2.1.2 异常场景测试
+
+**测试用例1**: test[MethodName]_Fail_[Reason]
+- **测试描述**: [描述测试目的]
+- **测试方法**: [被测试的方法名]
+- **前置条件**: [测试前置条件]
+- **输入数据**:
+  - [参数1]: [值] - [说明]
+  - [参数2]: [值] - [说明]
+- **预期结果**: [预期抛出的异常]
+- **实际结果**: [实际抛出的异常]
+- **测试状态**: [PASS/FAIL]
+- **备注**: [备注信息]
+
+**测试用例2**: test[MethodName]_Fail_[Reason]
+- **测试描述**: [描述测试目的]
+- **测试方法**: [被测试的方法名]
+- **前置条件**: [测试前置条件]
+- **输入数据**:
+  - [参数1]: [值] - [说明]
+  - [参数2]: [值] - [说明]
+- **预期结果**: [预期抛出的异常]
+- **实际结果**: [实际抛出的异常]
+- **测试状态**: [PASS/FAIL]
+- **备注**: [备注信息]
+
+---
+
+#### 2.1.3 边界场景测试
+
+**测试用例1**: test[MethodName]_Boundary_[Condition]
+- **测试描述**: [描述测试目的]
+- **测试方法**: [被测试的方法名]
+- **前置条件**: [测试前置条件]
+- **输入数据**:
+  - [参数1]: [值] - [说明]
+  - [参数2]: [值] - [说明]
+- **预期结果**: [预期结果]
+- **实际结果**: [实际结果]
+- **测试状态**: [PASS/FAIL]
+- **备注**: [备注信息]
+
+**测试用例2**: test[MethodName]_Boundary_[Condition]
+- **测试描述**: [描述测试目的]
+- **测试方法**: [被测试的方法名]
+- **前置条件**: [测试前置条件]
+- **输入数据**:
+  - [参数1]: [值] - [说明]
+  - [参数2]: [值] - [说明]
+- **预期结果**: [预期结果]
+- **实际结果**: [实际结果]
+- **测试状态**: [PASS/FAIL]
+- **备注**: [备注信息]
+
+---
+
+### 2.2 [类名]测试
+
+[按照上述格式继续描述其他类的测试用例]
+```
+
+---
+
+### 第3部分：测试覆盖率
+
+```markdown
+## 3. 测试覆盖率
+
+### 3.1 代码覆盖率
+
+| 类名 | 行覆盖率(%) | 分支覆盖率(%) | 方法覆盖率(%) | 类覆盖率(%) |
+|------|-----------|-------------|-------------|-----------|
+| [类1] | [覆盖率] | [覆盖率] | [覆盖率] | [覆盖率] |
+| [类2] | [覆盖率] | [覆盖率] | [覆盖率] | [覆盖率] |
+| [类3] | [覆盖率] | [覆盖率] | [覆盖率] | [覆盖率] |
+| **总计** | **[总覆盖率]** | **[总覆盖率]** | **[总覆盖率]** | **[总覆盖率]** |
+
+### 3.2 覆盖率分析
+
+**未覆盖的代码**:
+- [代码1]: [说明为什么未覆盖]
+- [代码2]: [说明为什么未覆盖]
+
+**覆盖率不足的代码**:
+- [代码1]: [说明覆盖率不足的原因]
+- [代码2]: [说明覆盖率不足的原因]
+
+### 3.3 覆盖率报告
+
+**JaCoCo覆盖率报告**:
+- **报告路径**: [报告文件路径]
+- **生成时间**: [生成时间]
+- **覆盖率**: [总体覆盖率]
+```
+
+---
+
+### 第4部分：测试结果
+
+```markdown
+## 4. 测试结果
+
+### 4.1 测试统计
+
+| 测试项 | 数量 |
+|-------|------|
+| 总测试用例数 | [数量] |
+| 通过的测试用例数 | [数量] |
+| 失败的测试用例数 | [数量] |
+| 跳过的测试用例数 | [数量] |
+| 测试通过率 | [百分比] |
+| 测试执行时间 | [时间] |
+
+### 4.2 测试执行日志
+
+**测试执行日志**:
+```bash
+[测试执行日志]
+```
+
+### 4.3 失败的测试用例
+
+**失败的测试用例列表**:
+
+| 测试用例 | 失败原因 | 失败位置 | 状态 |
+|---------|---------|---------|------|
+| [用例1] | [原因] | [位置] | [OPEN/FIXED] |
+| [用例2] | [原因] | [位置] | [OPEN/FIXED] |
+
+**失败详情**:
+
+**失败用例1**: [测试用例名称]
+- **失败原因**: [详细描述失败原因]
+- **失败位置**: [失败的代码位置]
+- **错误信息**: [错误信息]
+- **修复方案**: [如何修复]
+- **修复状态**: [OPEN/FIXED]
+```
+
+---
+
+### 第5部分：缺陷报告
+
+```markdown
+## 5. 缺陷报告
+
+### 5.1 缺陷统计
+
+| 缺陷等级 | 数量 |
+|---------|------|
+| 严重 | [数量] |
+| 主要 | [数量] |
+| 次要 | [数量] |
+| 一般 | [数量] |
+| 总计 | [数量] |
+
+### 5.2 缺陷列表
+
+**缺陷1**: [缺陷名称]
+- **缺陷编号**: [如:BUG-20260316-001]
+- **缺陷等级**: [严重/主要/次要/一般]
+- **缺陷描述**: [详细描述缺陷]
+- **发现时间**: [YYYY-MM-DD HH:mm:ss]
+- **发现人**: [发现人姓名]
+- **相关测试用例**: [相关测试用例]
+- **复现步骤**:
+  1. [步骤1]
+  2. [步骤2]
+  3. [步骤3]
+- **预期结果**: [预期结果]
+- **实际结果**: [实际结果]
+- **修复状态**: [OPEN/FIXED/CLOSED]
+- **修复人**: [修复人姓名]
+- **修复时间**: [YYYY-MM-DD HH:mm:ss]
+- **备注**: [备注信息]
+
+**缺陷2**: [缺陷名称]
+- **缺陷编号**: [如:BUG-20260316-002]
+- **缺陷等级**: [严重/主要/次要/一般]
+- **缺陷描述**: [详细描述缺陷]
+- **发现时间**: [YYYY-MM-DD HH:mm:ss]
+- **发现人**: [发现人姓名]
+- **相关测试用例**: [相关测试用例]
+- **复现步骤**:
+  1. [步骤1]
+  2. [步骤2]
+  3. [步骤3]
+- **预期结果**: [预期结果]
+- **实际结果**: [实际结果]
+- **修复状态**: [OPEN/FIXED/CLOSED]
+- **修复人**: [修复人姓名]
+- **修复时间**: [YYYY-MM-DD HH:mm:ss]
+- **备注**: [备注信息]
+```
+
+---
+
+### 第6部分：测试总结
+
+```markdown
+## 6. 测试总结
+
+### 6.1 测试总结
+
+**本次测试的成果**:
+- [成果1]: [如:完成了XX个类的单元测试]
+- [成果2]: [如:代码覆盖率达到100%]
+- [成果3]: [如:发现了XX个缺陷]
+- [成果4]: [如:测试通过率达到100%]
+
+**关键发现**:
+- [发现1]: [如:发现业务逻辑存在并发问题]
+- [发现2]: [如:发现参数校验不完善]
+
+### 6.2 改进建议
+
+**建议1**: [建议内容]
+- **建议理由**: [为什么提出这个建议]
+- **影响范围**: [这个建议会影响什么]
+
+**建议2**: [建议内容]
+- **建议理由**: [为什么提出这个建议]
+- **影响范围**: [这个建议会影响什么]
+
+### 6.3 后续工作
+
+**下一步需要做什么**:
+- [任务1]: [如:修复发现的缺陷]
+- [任务2]: [如:进行集成测试]
+- [任务3]: [如:进行系统测试]
+
+**需要确认的问题**:
+- [问题1]: [如:是否需要补充测试用例?]
+- [问题2]: [如:是否需要优化测试代码?]
+
+### 6.4 注意事项
+**注意事项1**: [如:注意测试用例的独立性]
+**注意事项2**: [如:注意测试数据的准备]
+**注意事项3**: [如:注意测试环境的稳定性]
+```
+
+---
+
+## 📋 填写示例：财务结算功能单元测试报告
+
+为了帮助您更好地理解如何填写这个模板,我以"财务结算-应收佣金"功能为例:
+
+```markdown
+## 1. 测试概览
+
+### 1.1 基本信息
+- **测试报告编号**: UTR-20260316-001
+- **需求名称**: 财务结算-应收佣金管理
+- **需求编号**: REQ-20260310-001
+- **所属模块**: 财务中心-结算管理
+- **测试人员**: AI助手
+- **测试日期**: 2026-03-16
+- **测试版本**: v1.0
+
+### 1.2 测试目标
+验证Service层的业务逻辑正确性,确保代码覆盖率达到100%。
+
+### 1.3 测试范围
+包含Service层测试、Mapper层测试、工具类测试。
+
+不包含Controller层测试、集成测试。
+
+### 1.4 测试环境
+**测试环境配置**:
+- **操作系统**: Windows 10
+- **JDK版本**: JDK 1.8
+- **测试框架**: JUnit 5 + Mockito
+- **覆盖率工具**: JaCoCo
+- **数据库**: MySQL 5.7
+- **其他依赖**: Spring Boot 2.5.8, MyBatis 2.2.0
+
+### 1.5 测试标准
+**通过标准**:
+- 所有测试用例必须通过
+- 代码覆盖率必须达到100%
+- 每个方法至少3个测试用例(正常+异常+边界)
+- 测试方法命名规范:testMethodName_Success/Fail/Boundary
+
+**失败标准**:
+- 测试用例失败
+- 代码覆盖率低于100%
+- 测试用例不足
+- 测试方法命名不规范
+
+---
+
+## 2. 测试用例清单
+
+### 2.1 CommissionService测试
+
+#### 2.1.1 正常场景测试
+
+**测试用例1**: testCalculateCommission_Success
+- **测试描述**: 测试正常计算佣金的功能
+- **测试方法**: calculateCommission
+- **前置条件**: 佣金规则已配置
+- **输入数据**:
+  - projectId: 1001 - 项目ID
+  - orgId: 2001 - 机构ID
+  - repaymentAmount: 10000.00 - 回款金额
+- **预期结果**: 1000.00 (佣金比例为10%)
+- **实际结果**: 1000.00
+- **测试状态**: PASS
+- **备注**: 佣金比例为10%,回款金额为10000元,预期佣金为1000元
+
+**测试用例2**: testGetCommissionList_Success
+- **测试描述**: 测试正常查询应收佣金列表的功能
+- **测试方法**: getCommissionList
+- **前置条件**: 已有应收佣金数据
+- **输入数据**:
+  - projectId: 1001 - 项目ID
+  - orgId: 2001 - 机构ID
+  - settlementStatus: PENDING - 结算状态
+  - pageNum: 1 - 页码
+  - pageSize: 20 - 每页大小
+- **预期结果**: 返回5条待结算的应收佣金记录
+- **实际结果**: 返回5条待结算的应收佣金记录
+- **测试状态**: PASS
+- **备注**: 查询到5条待结算的应收佣金记录
+
+---
+
+#### 2.1.2 异常场景测试
+
+**测试用例1**: testCalculateCommission_Fail_RuleNotFound
+- **测试描述**: 测试佣金规则不存在时抛出异常
+- **测试方法**: calculateCommission
+- **前置条件**: 佣金规则未配置
+- **输入数据**:
+  - projectId: 9999 - 不存在的项目ID
+  - orgId: 9999 - 不存在的机构ID
+  - repaymentAmount: 10000.00 - 回款金额
+- **预期结果**: 抛出RuleNotFoundException异常
+- **实际结果**: 抛出RuleNotFoundException异常
+- **测试状态**: PASS
+- **备注**: 项目ID和机构ID不存在时,抛出RuleNotFoundException
+
+**测试用例2**: testCalculateCommission_Fail_InvalidAmount
+- **测试描述**: 测试回款金额为负数时抛出异常
+- **测试方法**: calculateCommission
+- **前置条件**: 回款金额为负数
+- **输入数据**:
+  - projectId: 1001 - 项目ID
+  - orgId: 2001 - 机构ID
+  - repaymentAmount: -100.00 - 负数的回款金额
+- **预期结果**: 抛出InvalidAmountException异常
+- **实际结果**: 抛出InvalidAmountException异常
+- **测试状态**: PASS
+- **备注**: 回款金额为负数时,抛出InvalidAmountException
+
+---
+
+#### 2.1.3 边界场景测试
+
+**测试用例1**: testCalculateCommission_Boundary_ZeroAmount
+- **测试描述**: 测试回款金额为0时计算佣金
+- **测试方法**: calculateCommission
+- **前置条件**: 回款金额为0
+- **输入数据**:
+  - projectId: 1001 - 项目ID
+  - orgId: 2001 - 机构ID
+  - repaymentAmount: 0.00 - 回款金额为0
+- **预期结果**: 佣金为0.00
+- **实际结果**: 佣金为0.00
+- **测试状态**: PASS
+- **备注**: 回款金额为0时,佣金为0
+
+**测试用例2**: testCalculateCommission_Boundary_MaxAmount
+- **测试描述**: 测试回款金额为最大值时计算佣金
+- **测试方法**: calculateCommission
+- **前置条件**: 回款金额为最大值
+- **输入数据**:
+  - projectId: 1001 - 项目ID
+  - orgId: 2001 - 机构ID
+  - repaymentAmount: 99999999.99 - 回款金额最大值
+- **预期结果**: 佣金为9999999.999
+- **实际结果**: 佣金为9999999.999
+- **测试状态**: PASS
+- **备注**: 回款金额为最大值时,佣金计算正确
+
+---
+
+### 2.2 CommissionMapper测试
+
+[按照上述格式继续描述其他类的测试用例]
+
+---
+
+## 3. 测试覆盖率
+
+### 3.1 代码覆盖率
+
+| 类名 | 行覆盖率(%) | 分支覆盖率(%) | 方法覆盖率(%) | 类覆盖率(%) |
+|------|-----------|-------------|-------------|-----------|
+| CommissionServiceImpl | 100 | 100 | 100 | 100 |
+| SettlementServiceImpl | 100 | 100 | 100 | 100 |
+| CommissionMapper | 100 | 100 | 100 | 100 |
+| SettlementMapper | 100 | 100 | 100 | 100 |
+| **总计** | **100** | **100** | **100** | **100** |
+
+### 3.2 覆盖率分析
+
+**未覆盖的代码**: 无
+
+**覆盖率不足的代码**: 无
+
+### 3.3 覆盖率报告
+
+**JaCoCo覆盖率报告**:
+- **报告路径**: target/site/jacoco/index.html
+- **生成时间**: 2026-03-16 10:00:00
+- **覆盖率**: 100%
+
+---
+
+## 4. 测试结果
+
+### 4.1 测试统计
+
+| 测试项 | 数量 |
+|-------|------|
+| 总测试用例数 | 12 |
+| 通过的测试用例数 | 12 |
+| 失败的测试用例数 | 0 |
+| 跳过的测试用例数 | 0 |
+| 测试通过率 | 100% |
+| 测试执行时间 | 2.5s |
+
+### 4.2 测试执行日志
+
+**测试执行日志**:
+```bash
+[INFO] -------------------------------------------------------
+[INFO]  T E S T S
+[INFO] -------------------------------------------------------
+[INFO] Running com.xh.finance.service.impl.CommissionServiceImplTest
+[INFO] Tests run: 12, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.5 s
+[INFO] 
+[INFO] Results:
+[INFO] 
+[INFO] Tests run: 12, Failures: 0, Errors: 0, Skipped: 0
+[INFO] 
+[INFO] BUILD SUCCESS
+```
+
+### 4.3 失败的测试用例
+
+**失败的测试用例列表**:
+
+| 测试用例 | 失败原因 | 失败位置 | 状态 |
+|---------|---------|---------|------|
+| 无 | 无 | 无 | 无 |
+
+---
+
+## 5. 缺陷报告
+
+### 5.1 缺陷统计
+
+| 缺陷等级 | 数量 |
+|---------|------|
+| 严重 | 0 |
+| 主要 | 0 |
+| 次要 | 0 |
+| 一般 | 0 |
+| 总计 | 0 |
+
+### 5.2 缺陷列表
+
+无缺陷
+
+---
+
+## 6. 测试总结
+
+### 6.1 测试总结
+
+**本次测试的成果**:
+- 完成了2个Service类的单元测试
+- 完成了2个Mapper类的单元测试
+- 代码覆盖率达到100%
+- 发现了0个缺陷
+- 测试通过率达到100%
+
+**关键发现**:
+- 业务逻辑实现正确
+- 异常处理完善
+- 边界条件处理正确
+
+### 6.2 改进建议
+
+**建议1**: 增加性能测试
+- **建议理由**: 验证大数据量下的性能表现
+- **影响范围**: CommissionService
+
+**建议2**: 增加并发测试
+- **建议理由**: 验证多线程下的安全性
+- **影响范围**: SettlementService
+
+### 6.3 后续工作
+
+**下一步需要做什么**:
+- 修复发现的缺陷(无)
+- 进行集成测试
+- 进行系统测试
+
+**需要确认的问题**:
+- 是否需要补充测试用例?
+- 是否需要优化测试代码?
+
+### 6.4 注意事项
+**注意事项1**: 注意测试用例的独立性
+**注意事项2**: 注意测试数据的准备
+**注意事项3**: 注意测试环境的稳定性
+```
+
+---
+
+## ✅ 填写建议
+
+### 1. 严格遵循测试规范
+- 每个方法至少3个测试用例(正常+异常+边界)
+- 测试方法命名规范:testMethodName_Success/Fail/Boundary
+- 代码覆盖率必须达到100%
+- 测试用例必须独立运行、可重复运行
+
+### 2. 简洁描述测试用例
+- 测试代码保留在项目源码中,报告只记录测试用例的设计思路
+- 重点描述测试目的、测试数据、预期结果、实际结果
+- 输入数据用列表形式,简洁明了
+
+### 3. 分析测试覆盖率
+- 代码覆盖率必须达到100%
+- 分析未覆盖的代码,说明原因
+- 分析覆盖率不足的代码,说明原因
+
+### 4. 记录测试结果
+- 统计测试通过率、测试执行时间
+- 记录失败的测试用例
+- 分析失败原因,提供修复方案
+
+### 5. 记录发现的缺陷
+- 详细描述缺陷信息
+- 提供复现步骤
+- 跟踪缺陷修复状态
+
+### 6. 总结测试工作
+- 总结测试成果和关键发现
+- 提供改进建议
+- 规划后续工作
+
+---
+
+## 🎯 模板优势
+
+1. **严格遵循测试规范**: 强制要求每个方法至少3个测试用例
+2. **结构化输出**: 模板结构清晰,便于AI理解和处理
+3. **覆盖全面**: 覆盖了单元测试的所有核心要素
+4. **重点突出**: 重点突出测试用例、测试覆盖率、测试结果
+5. **简洁高效**: 去掉测试代码,重点关注测试思路和结果
+6. **可追溯性**: 测试用例与缺陷关联,便于追溯
+7. **AI友好**: 结构化的格式便于AI理解和生成测试报告
+
+---
+
+## 📞 使用流程
+
+完成单元测试报告后,将进入下一步:
+
+1. **修复缺陷** - 根据测试报告修复发现的缺陷
+2. **集成测试** - 进行集成测试,测试各模块之间的交互
+3. **系统测试** - 进行系统测试,测试整个系统的功能
+
+---
+
+**文档结束**
+
+*本模板由AI辅助生成,作为单元测试报告的标准参考。*