docs+scripts: 删除测试与架构专项文档并把引用改成就地口径
这是并行的另一路在飞的改动（本会话按用户「全部提交」指示代为落盘）： 移除 docs/任务规划/测试与架构专项.md，并把指向它的引用改成就地口径 （app_assert.h / net_socket.c / ch395f_test.h 头注释改指本文件注释或 对应文档，check_size_gate.py 与 ram_baseline.py 的出处改指 CI 文档， RAM预算台账、暂缓-RS485、采集与算法层设计说明、cubemx-survival、 id-check、两份 README 同步改引）。 如要拆回：git reset --soft HEAD~1 即可把这一笔退回工作区。 合树后 @build 0 错 0 警（Code=236456 RO=28124 RW=1876 ZI=137084）。
This commit is contained in:
@@ -1,58 +0,0 @@
|
||||
# 测试与架构改进专项（P1 收尾 / S1x / A-x）
|
||||
|
||||
> 编号空间见 `docs/任务规划/README.md` §0；排期位置见 `docs/任务规划/README.md` §2 顺序表。
|
||||
> **`S` 裸形 / `T-x` / `A-x` 三族**是 2026-10-02 版复审的**条目编号**——编号**不随条目删除而回收**（现存有效条目 = 「采集链路测试可验证性约束」「体积门禁 CI 强制路径」与「CI 远端闭环未验证」）；
|
||||
> 其他文档若引用这些编号，其证据见对应模块文档与 `git log`。已完成事项的证据沉淀：
|
||||
> `../测试说明/系统时钟单元测试说明.md`（S1-a）、`../测试说明/配置文件单元测试说明.md`（S1-b）、
|
||||
> `../测试说明/测试开发标准流程.md` §4.2.1（主机侧纯逻辑单测适格台账）、`../测试说明/模拟器差距清单.md`（S13）、
|
||||
> `../测试说明/实机测试实施指南.md`（S4/S5/S7/S9/S11）、`../问题记录/GD5F2GQ5UE_Trap_Records.md`（S9）、
|
||||
> `../测试说明/主机单测覆盖率口径.md` §9「P1 落地」与「P2 落地」（S1-c：`sys_log_mcu` 106 例、
|
||||
> `time_sync` 既有 4 例，两套均已被 `test-coverage` 总闸覆盖）。
|
||||
>
|
||||
> **本文件只剩 1 项未闭环**（「采集链路测试可验证性约束」，且 RS485 侧随 B2 暂缓）。2026-10-25 复核时把已销项条目
|
||||
> 压缩成证据指针——原来的详述与「完成即销项」规则冲突，留着会让读者以为还有活。
|
||||
|
||||
## 1. P1 收尾（0 项）
|
||||
|
||||
**测试固件静态 RAM 预算** 已于 2026-10-25 销项（`task/P1-10-test-fw`→73f9e10）：
|
||||
CH395F 套件 5 档构建全部链接通过，最坏态 `RW_IRAM1` 91,088 B / 69.5%（距 92% 线余 29,498 B）；
|
||||
`@test` f3 轮 VERDICT PASS（Phase 1/12/15 = 9/9、1/1、21/21）。**数字与规范正文的唯一出处**是
|
||||
`test/board/ch395f_test.h` 的开关区注释，本文件不再重复。
|
||||
|
||||
**约束（仍然有效）**：**不建议**扩 scatter 到 192 KB——破坏既有克隆芯片兼容决策。
|
||||
|
||||
## 2. 测试与架构改进专项（S1x / A-x）
|
||||
|
||||
**未闭环一览**
|
||||
|
||||
| 编号 | 事项 | 状态 | 详述 |
|
||||
|---|---|---|---|
|
||||
| **采集链路测试可验证性约束** | ADC / RS485 采集链路的**测试可验证性约束** | ⏸ ADC 侧随 B1 闭环；**RS485 侧随 B2 暂缓（`暂缓-RS485.md`）** | §2.2 |
|
||||
|
||||
### 2.1 S12：模块级轻量断言宏（✅ 2026-10-25 销项）
|
||||
|
||||
实现 `Drivers/BSP/app_assert.h`（→658fbe7）。**落位从示意稿的 `App/util/` 改到 `Drivers/BSP/`
|
||||
的理由 = layer-deps 方向约束**，载于该头注释与提交正文。生产构建 `APP_ASSERT_ENABLE` 关闭时
|
||||
宏展开为 `((void)0)`，零符号零开销——口径唯一正文 = 该头文件注释。
|
||||
|
||||
### 2.2 采集链路测试可验证性约束：ADC / RS485 ⏸
|
||||
|
||||
**背景**：`adc_task.c` 已实现（B1，2026-10-10），`rs485_task.c` 仍是空桩，`App/protocol/` 只有 README 与 `.gitkeep`。
|
||||
本项不是"缺陷"，而是**对上游 B2 的设计约束**（B1 已完成；**B2 暂缓中，见 `暂缓-RS485.md`——重启 B2 动手前必须先落实本约束**，否则后续无法补测）。
|
||||
|
||||
**约束**（建议纳入 B2 设计）：
|
||||
|
||||
1. **协议解析必须与硬件 I/O 分离**——`App/protocol/` 的解析函数应接受
|
||||
`(const uint8_t *buf, size_t len)` 并返回解析结果，使其成为 主机侧纯逻辑单测的**天然适格对象**
|
||||
（参考 `cfg_file` 的"核心 + 后端"模式）；
|
||||
2. **采集缓冲必须双缓冲 + 序号**——否则消费者读到撕裂数据，
|
||||
且**撕裂在单测里测不出来**（时序相关），必须在设计上消除；
|
||||
3. **DE 收尾必须有超时路径覆盖**（RS485 半双工特有陷阱）。
|
||||
|
||||
**完成判据**：B2 设计文档体现上述三条；协议解析函数有对应主机侧纯逻辑单测。（B1 侧：ADC 无协议解析面，其"同一时刻性"由原子快照保证、已闭环。）
|
||||
|
||||
### 2.3 「体积门禁 CI 强制路径」残余：CI 体积门禁盲区（✅ 2026-10-25 销项）
|
||||
|
||||
同码凭证 + CI 复核→564715c、跨树稳定修复→7c4628b。**口径唯一正文** = `scripts/check_size_gate.py`
|
||||
的 docstring（含"CI 侧跳过 `mem-numbers` 的边界"与本地强制路径）。`docs/内存管理/RAM预算台账.md`
|
||||
§1 仍指向本条目名，读那里的数字即可，不必回本文件。
|
||||
@@ -32,7 +32,7 @@
|
||||
|
||||
- **门禁**：pre-commit `mem-budget` 钩子（`scripts/ram_baseline.py --gate`）——
|
||||
RW_IRAM1 / RW_CCM 任一 >92% 即拦提交，并打印 Top-10 RW+ZI 对象定位增量；
|
||||
无 `.map` 时自适应跳过（CI 盲区登记在 `docs/任务规划/测试与架构专项.md`「体积门禁 CI 强制路径」残余）。
|
||||
无 `.map` 时自适应跳过（CI 侧跳过 `mem-numbers` 的边界 = `scripts/check_size_gate.py` 的 docstring，唯一正文）。
|
||||
- **阈值依据**：92% 由 2026-09 体系评审提出、2026-10-12 落地为门禁（提出时的报告条目已随销项删除，闭环说明见 `RAM使用分析与优化方案.md` §4 阶段 3「长效机制」与本文）——留 ~8% 给突发缓冲与栈抬升，
|
||||
触线即触发排期，而不是静默逼近溢出。
|
||||
- **软提醒**（不拦提交）：tsv 末行落后于 `.map`（忘跑 `--update`）、`.map` 早于最新源码（忘 `@build`）。
|
||||
|
||||
Reference in New Issue
Block a user