# cgm_code_unit_test_v1

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

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CGM 单元测试工作区（第一轮：无规范 AI 辅助）

本工作区对 CGM 嵌入式 C 固件进行主机侧单元测试，验证 AI 辅助历史代码单测的可行性。

## 目录结构

```text
cgm/                        被测固件 C 源码
tests/unit_test/
├── code/                   测试源码（test_*.c）+ Unity 框架
├── build/                  构建产物
├── report/                 覆盖率报告（HTML + Markdown）
├── build_tests.bat         构建脚本（含覆盖率插桩）
└── run_tests.bat           运行脚本（执行测试 + 生成报告）
```

## 快速开始

```bat
cd tests\unit_test
build_tests.bat
run_tests.bat
```

## 当前状态

| 指标 | 结果 |
|------|------|
| 测试模块 | 11 个 |
| 测试用例 | 162 个 |
| 已覆盖函数 | 66 / 156（42.3%） |
| 语句覆盖率 | 97.5% |
| 判定覆盖率 | 88.5% |

## 主要文档

| 文档 | 说明 |
|------|------|
| `tests/unit_test/unit_test_run_guide.md` | 环境准备与运行说明 |
| `tests/unit_test/unit_test_summary.md` | 测试总报告与覆盖率 |
| `tests/unit_test/unit_test_conventions.md` | 文件组织与命名约定 |
| `tests/unit_test/unit_test_scheme_and_implementation.md` | 方案与实现细节 |
| `tests/unit_test/unit_test_subprogram_test_records.md` | 子程序级测试记录 |

## 环境要求

- GCC：MinGW-w64 或 MSYS2，需加入 `PATH`
- gcovr（可选，覆盖率报告）：`pip install gcovr`
- 测试框架：仓库内已包含精简版 Unity（`tests/unit_test/code/unity.*`）

## 后续工作

- 补齐高优先级模块的测试覆盖
- 完善替身（Stub/Mock/Fake）机制
- 本轮暴露的规范缺失问题已在第二轮（v2）中解决