91 lines
2.4 KiB
Markdown
91 lines
2.4 KiB
Markdown
# 开发日志 (05_delivery/dev_log.md)
|
||
|
||
> **项目**: {project_name}
|
||
> **更新规则**: 每个任务完成或有重要产出时更新；单元测试执行后**必须**填写"单元测试记录"区块
|
||
|
||
---
|
||
|
||
## 任务状态总览
|
||
|
||
| 任务 | 负责人 | Day | 状态 | 完成时间 | 备注 |
|
||
|------|--------|-----|------|----------|------|
|
||
| T-xxx | — | — | ⬜ 待开始 | — | — |
|
||
|
||
> 状态说明：✅ 完成 / 🔄 进行中 / ⬜ 待开始 / ❌ 阻塞
|
||
|
||
---
|
||
|
||
## 开发日志详情
|
||
|
||
### {YYYY-MM-DD} | Round N | Dev Assist — {任务编号} {任务名称}
|
||
|
||
**PDCA 阶段**: Do — 代码产出
|
||
|
||
**本轮产出**:
|
||
|
||
| 文件 | 模块 | 说明 |
|
||
|------|------|------|
|
||
| — | — | — |
|
||
|
||
**关键设计决策**:
|
||
- （记录影响后续维护的设计选择）
|
||
|
||
**DoD 验证清单**:
|
||
- [ ] ...
|
||
|
||
**遗留问题**:
|
||
- （无则写"无"）
|
||
|
||
---
|
||
|
||
## 单元测试记录
|
||
|
||
> ⚠️ **强制要求**：每个任务的单测必须在进入 Check 阶段前完成并记录。
|
||
> 单测未通过或未记录 = DoD 未达成 = 禁止推进下一阶段。
|
||
|
||
### {任务编号} {任务名称} — 单测计划与结果
|
||
|
||
**执行时间**: {YYYY-MM-DD HH:MM}
|
||
**执行人**: {name}
|
||
**测试框架**: JUnit 5 / Mockito（或实际使用框架）
|
||
|
||
#### 单测结果明细
|
||
|
||
| 测试类 | 测试方法 | 场景描述 | 结果 | 备注 |
|
||
|--------|----------|----------|------|------|
|
||
| `XxxServiceTest` | `testSave_success` | 正常创建，返回主键 | ✅ PASS | — |
|
||
| `XxxServiceTest` | `testSave_missingOrderNo` | 订单号为空，抛 BusinessException | ✅ PASS | — |
|
||
| `XxxServiceTest` | `testSave_invalidProvider` | 服务商不存在，抛 BusinessException | ✅ PASS | — |
|
||
| `XxxServiceTest` | `testList_emptyResult` | 无数据时返回空 Page | ✅ PASS | — |
|
||
|
||
> 结果说明：✅ PASS / ❌ FAIL / ⚠️ SKIP（须注明原因）
|
||
|
||
#### 覆盖率摘要
|
||
|
||
| 类 | 方法数 | 已覆盖 | 覆盖率 | 是否达标（≥80%） |
|
||
|----|--------|--------|--------|-----------------|
|
||
| `XxxService` | — | — | —% | — |
|
||
|
||
> 覆盖率低于 80% 须填写原因，并获得人类确认后方可推进：
|
||
> - 原因：
|
||
> - 确认人：
|
||
> - 确认时间：
|
||
|
||
#### 失败/跳过明细（若有）
|
||
|
||
| 测试方法 | 失败原因 | 修复状态 | 修复时间 |
|
||
|----------|----------|----------|----------|
|
||
| — | — | — | — |
|
||
|
||
---
|
||
|
||
## 变更记录
|
||
|
||
> 暂无变更
|
||
|
||
---
|
||
|
||
## 阻塞记录
|
||
|
||
> 暂无阻塞
|