# cgm_code_unit_test_v2

**Repository Path**: qu-shuwei/cgm_code_unit_test_v2

## Basic Information

- **Project Name**: cgm_code_unit_test_v2
- **Description**: CGM代码单元测试
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CGM 单元测试工作区（第二轮：规范驱动 AI 辅助）

本工作区对 CGM 嵌入式 C 固件进行规范化单元测试，先按业务关键性筛出高价值函数，再由人工确认，最后生成可运行的测试资产。

## 目录结构

```text
cgm/                                被测固件 C 源码
tests/
├── specs/                          筛选规范、生成规范
├── reports/                        筛选报告、分层策略、FAQ
└── unit_test/
    ├── src/                        测试源码（test_*.c）
    ├── doubles/                    fake / stub / spy
    ├── unity/                      精简版 Unity 框架
    ├── plans/                      测试方案 + 质量门禁脚本
    ├── build.bat                   构建脚本
    └── run.bat                     运行脚本
```

## 快速开始

```bat
tests\unit_test\build.bat --no-pause
tests\unit_test\run.bat --no-pause
```

只构建/运行单个模块：

```bat
tests\unit_test\build.bat xxtea --no-pause
tests\unit_test\run.bat xxtea --no-pause
```

质量门禁检查：

```powershell
powershell -NoProfile -File tests/unit_test/plans/check_qg.ps1
```

## 当前状态

- 149 个候选函数已完成结构化筛选与分级
- 等效测试点收敛至约 39 个（约 7~8 人日）
- 已落地测试：`test_xxtea_F`、`test_bsl_raw_flash`、`fake_flash`、`fake_ble_transform`

## 主要文档

| 文档 | 说明 |
|------|------|
| `tests/specs/screening/ut_candidate_screening_spec.md` | 函数筛选规范 |
| `tests/specs/generation/ut_case_generation_spec.md` | 用例生成规范 |
| `tests/reports/screening/screening_report.md` | 筛选报告（149 候选） |
| `tests/reports/strategy/ut_scope_strategy.md` | 分层策略与工程量估算 |
| `tests/reports/faq/ut_workflow_faq.md` | 流程 FAQ 与判断案例 |
| `tests/specs/screening/code_refactoring_guide.md` | 代码改造建议 |
| `tests/unit_test/plans/test_generation_plan.md` | 用例生成计划 |

## 环境要求

- GCC：MinGW-w64 或 MSYS2，需加入 `PATH`
- PowerShell：用于运行 `check_qg.ps1`
- 测试框架：仓库内已包含精简版 Unity（`tests/unit_test/unity/`）

## 后续工作

- 继续补齐 `direct_test · high` 优先级函数
- 对 `heavy_global_deps` / `signature_deception` 函数完成人工复核
- 固化构建/运行/报告刷新脚本为可复用工具