feat(testing): Flows/FromCase、增量 swagger 与 Doc-Driven 门禁

补齐多接口流程联调与控制台体验，并落地仓内 Doc-Driven+TDD 总规则与文档。

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/README.md

@@ -1,5 +1,7 @@
 # HoTime 文档索引
 
+本仓采用 **Doc-Driven + TDD**：行为一变必须回写 docs；改接口必须用 `-run` 精确测试验证（见 [Testing_API测试框架.md](Testing_API测试框架.md) 文首铁律与仓规则 `hotime-doc-tdd`）。
+
 推荐按路径阅读，避免同一概念在多份文档里来回找。
 
 ## 阅读路径
@@ -8,7 +10,7 @@
 2. **类型与工具** → [Common_工具类.md](Common_工具类.md)
 3. **数据库 ORM** → [HoTimeDB_使用说明.md](HoTimeDB_使用说明.md)（教程）→ [HoTimeDB_API参考.md](HoTimeDB_API参考.md)（速查）
 4. **开表 / 代码生成** → [DatabaseDesign_数据库设计规范.md](DatabaseDesign_数据库设计规范.md)（前置）→ [CodeGen_代码生成.md](CodeGen_代码生成.md)
-5. **接口测试** → [Testing_API测试框架.md](Testing_API测试框架.md)（日常用 `-run` 单测；全量见文末）
+5. **接口测试** → [Testing_API测试框架.md](Testing_API测试框架.md)（日常用 `-run` 单测；局限见文末；全量见文末）
 6. **运维** → [GracefulShutdown_优雅停机.md](GracefulShutdown_优雅停机.md)、[Seq_日志集成.md](Seq_日志集成.md)
 7. **规划** → [ROADMAP_改进规划.md](ROADMAP_改进规划.md)
 
@@ -22,7 +24,7 @@
 | HoTimeDB_API参考 | ORM 方法与条件语法速查 |
 | DatabaseDesign_数据库设计规范 | 表/字段/COMMENT 规范（CodeGen 输入契约） |
 | CodeGen_代码生成 | 生成器用法 + codeConfig / rule 配置 |
-| Testing_API测试框架 | API 测试；优先 `-run`，全量沉底 |
+| Testing_API测试框架 | API 测试、Flows、控制台；优先 `-run`；已知局限 |
 | GracefulShutdown_优雅停机 | 优雅停机与滚动重启 |
 | Seq_日志集成 | Seq 结构化日志 |
 | ROADMAP_改进规划 | 待改进项 |