feat: 根目录文档、脚本、gitignore

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,90 @@
+# 开发日志 (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% 须填写原因，并获得人类确认后方可推进：
+> - 原因：
+> - 确认人：
+> - 确认时间：
+
+#### 失败/跳过明细（若有）
+
+| 测试方法 | 失败原因 | 修复状态 | 修复时间 |
+|----------|----------|----------|----------|
+| — | — | — | — |
+
+---
+
+## 变更记录
+
+> 暂无变更
+
+---
+
+## 阻塞记录
+
+> 暂无阻塞