Skip to content

Commit 7eedff0

Browse files
author
zhangtao
committed
merge: 同步覆盖率计划
2 parents 8da2727 + b659245 commit 7eedff0

1 file changed

Lines changed: 43 additions & 0 deletions

File tree

‎docs/COVERAGE-PLAN.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# 覆盖率目标与基线(D:全部口径)
2+
3+
## 当前基线
4+
5+
| 口径 | 当前值 | 说明 |
6+
|---|---:|---|
7+
| 后端 pytest | 351 passed | 全量 pytest,覆盖 16,661 statements |
8+
| 后端行覆盖 | **50%**(8,327 missed) | `pytest --cov=app` |
9+
| 前端 vitest | 41 passed | 现有 3 个测试文件 |
10+
| 前端行覆盖 | **61.73%**(仅被 import 的文件) | 尚未启用 all-source 统计,不能当全站覆盖率 |
11+
| 接口 | 250 个 | 还没有做到每个接口成功/校验/权限三路径 |
12+
| Web 路由 | 31 个 | 已有只读巡检,写路径未全覆盖 |
13+
14+
## 100% 的定义
15+
16+
D 包含四个独立目标:
17+
18+
1. **功能测试点 100%**:每条需求/字段/状态/权限组合都有用例并通过;
19+
2. **接口/页面 100%**:250 个接口 × 成功/参数校验/未登录/无权限;31 个页面 × 关键交互;
20+
3. **代码行/分支 100%**:后端 `pytest-cov`、前端 `vitest --coverage` 全源码;
21+
4. **外部集成 100%**:FTP/SFTP/OBS/OSS/COS、AI、SSH 使用真实测试环境。
22+
23+
## 现实约束
24+
25+
- 后端当前还有约 8,300 行未被测试覆盖,包含存储 FTP/SFTP、传输引擎、工作流、监控、初始化、工具函数等;
26+
- 前端若开启 `coverage.all`,大量 views/components/hooks 会进入统计;
27+
- 外部协议和第三方服务没有测试环境时,mock 只能算逻辑覆盖,不能算集成 100%;
28+
- 100% 代码覆盖不能替代功能验收,反之亦然。
29+
30+
## 执行顺序
31+
32+
1. 固定功能清单与接口/页面 traceability matrix;
33+
2. 后端按模块补测试:权限/认证 → 存储/传输 → 调度 → SQL/SSH → 生成器/AI → 监控/工具;
34+
3. 前端按页面补交互与异常分支;
35+
4. 接入覆盖率门禁:先记录基线,逐模块提高,达到目标后再设为 100%;
36+
5. 外部集成接入真实测试环境;无环境的项必须在矩阵中标记为 mock,不算 100%。
37+
38+
## 命令
39+
40+
```bash
41+
cd backend && uv run pytest -q --cov=app --cov-report=term-missing
42+
cd frontend/web && pnpm exec vitest run --coverage
43+
```

0 commit comments

Comments
 (0)