docs: 任务规划目录收缩——只留推进顺序与硬件缺陷,其余待办归模块文档

按用户裁定(2026-11-10)把 docs/任务规划/ 从"全量待办表"收成两个文件:

1. 登记簿.md 只记 V0.1 硬件缺陷 → V0.2 改版要求(双转换器无共同采样触发、
   IA 前端差分滤波限制谐波带宽)。原 §1/§2/§4/§5/§6/§7/§8/§9 的待办按
   "待办跟着所属模块走"清空,四类事实在删除前先落到新归属:
   - 两点标定开工前要先拍板的三件事 → 算法层设计说明 §13.13(新节)
   - 通讯设置页真机判据 → 网络配置说明 §3.6 内联
   - 缩堆迁 CCM 后半、开入开出重开条件 → 原本各模块文档即唯一权威
2. 暂缓-RS485.md 删除,其唯一不可丢的"采集链路测试可验证性约束"三条与
   完成判据并入 产品需求设计文档 §5.10。
3. 任务规划/README.md 去掉全部历史叙述(UI 补齐销项流水、net 收口过程、
   故障录波近千字台账),只留:怎么用、条目规则、生成物单写者纪律、
   推进顺序表(每行只写当前状态与卡点)、维护约定。

同步改写全库引用(约 60 处):AGENTS.md、docs/README.md、产品需求、UI、
子系统设计、内存管理、环境与部署、算法、测试说明、门禁说明、问题记录,
以及 App/ 与 Drivers/BSP/ 的头注释、脚本与 .pre-commit-config.yaml 注释。
顺带修掉三处已失效的引用目标:链路延迟测试的队列往返重验项改指实机测试
实施指南 §7.3;并行工作树的 <ID> 行去掉已退役的 N-x/S-x/T-x 编号族;
任务规划 README 的 §1 旧编号在技能示例里的引用。

门禁:check_doc_links --all --sections-strict 214 篇通过、无法判定 0;
pre-commit 全 Passed(doc-links / mermaid / 任务表 / 内存数字 / BOM /
UI 像素回归 / generated-fresh / layer-deps / bsp-err / skill-size);
keil-build 0 错误 0 警告(Code=255160 RO=31204 RW=2080 ZI=152152),
RAM 预算门禁 PASS(RW_IRAM1 73.9%、RW_CCM 87.9%)。
This commit is contained in:
2026-11-10 20:33:30 +08:00
parent ae09c5737a
commit 7b05d7bfd4
66 changed files with 208 additions and 339 deletions
+1 -1
View File
@@ -194,7 +194,7 @@ ADC 引脚电压 V)+ `adc_health_rail_watch()` ×9(「采样通道自检」
- 模拟器侧分两类(Lead 裁定 2026-10-29):`wave_ring.c` 与 `wave_store.c` **真实参与**
`simulator/CMakeLists.txt`——回放页要在模拟器里出真波形,两份又零平台依赖,与「双端共享核心、不造
第二真相」同一条口径,故**不进** `SIM_EXEMPT`;其余九个采集链文件(UI 模拟器不跑采集链路)仍登记在
`scripts/check_registration.py` 的 `SIM_EXEMPT`(附理由),`registration-check` 钩子反向校验(登记簿条目「rs485_task 白名单缺口」)。
`scripts/check_registration.py` 的 `SIM_EXEMPT`(附理由),`registration-check` 钩子反向校验(`rs485_task` 白名单缺口)。
### 4.2 主机侧纯逻辑单测——生产源文件以 `#include` 原样纳入
+1 -1
View File
@@ -7,7 +7,7 @@
* 修改记录:
* v1.0 2026-07-19 王建锋 创建初始版本
* v1.1 2026-10-04 王建锋 如实标注三个 APP_*_ENABLE 为"未接线占位"(全库零消费点)
* v1.2 2026-10-22 王建锋 收口(登记簿 C5):删除 4 个零消费点的宏
* v1.2 2026-10-22 王建锋 收口:删除 4 个零消费点的宏
* (APP_NET_ENABLE / APP_ADC_ENABLE / APP_RS485_ENABLE /
* APP_SYS_TIME_SRC)。留"看起来能裁剪、其实不生效"的宏比不留更糟:
* 评审者会误信模块可裁剪,而关掉它们不会产生任何编译期效果。
+1 -1
View File
@@ -10,7 +10,7 @@
* 帧结构(本层只管 ASDU,APCI 6 字节头归 iec104_link):
* [type 1B][vsq 1B][cot 2B][ca 2B]( [ioa 3B][元素...] )*n
* 多信息体地址对象(SQ=0)每对象带独立 IOA;顺序对象(SQ=1)单 IOA + n 元素。
* 创建日期:2026-10-12(B4,W1 功能主线,登记簿见 docs/任务规划/)
* 创建日期:2026-10-12(B4,W1 功能主线)
*/
#ifndef IEC104_ASDU_H
#define IEC104_ASDU_H
+1 -1
View File
@@ -15,7 +15,7 @@
* netTask/uiTask 不得直接触碰引擎);getter = 任意消费上下文(u16
* 半字对齐读天然原子,重载瞬间最坏 = 单字段新旧值之一);setter =
* UI 保存交接路(task-9,net_cfg_set_* 先例)。
* 生效语义:**改后重启生效**(通讯设置页验收口径,见 `docs/任务规划/登记簿.md` §7)——
* 生效语义:**改后重启生效**(口径见 `docs/子系统设计/网络配置说明.md` §3.6)——
* iec104Task 启动时取一次 getter 填 link cfg;端口另在下次重 bind
* (拆链/网络代次重建)自然生效,不必整机重启。不挂段回调、不新增
* 事件位、不走 SYS_EVT_NET_RECONFIG(网络代次链语义不同;且 CH395F
+1 -1
View File
@@ -2,7 +2,7 @@
* 模块名称:RS485 Communication Task
* 模块功能:RS-485 轮询收发、协议帧解析与响应
* 状态说明:**预留桩(未启用)**——采集/协议链路尚未实现,产品定义未定
* (见 docs/任务规划/暂缓-RS485.md,B2 暂缓)。当前 init/func 为空实现,
* (整簇冻结与重启门禁见 docs/产品需求/产品需求设计文档.md §5.10)。当前 init/func 为空实现,
* 不收发、不解析。
* 适用平台:STM32F407ZGTx
* 作者:王建锋
+6 -5
View File
@@ -25,15 +25,16 @@
* (2026-10-25 实测 bit4 8 连击、uisn=154ms 仍在段内;
* 按位连击判据 = docs/子系统设计/看门狗设计说明.md §5.3)。
* 单个往返自身仍无上界——该上界与彻底解耦(事件驱动
* accept)归登记簿「net 层跨上下文收口」(批 3),本票只做心跳续命。
* accept)随「net 层跨上下文收口」后续评估(该波已于 2026-11-06 闭环),
* 本票只做心跳续命。
* v1.5 2026-10-26 DTU 项目组 道F task-3 装置维护三页的执行侧:新增
* ui_data_maint_ops_t 六件适配(时钟=写+回读 RTC、
* 复归=prot_elm_request_reset、清除=syslog_request_clear
* /clear_state 直通)并在 ui_menu_init 之前注入;记录
* reader 的 2 条 if 链改成 7 条映射表 s_log_map,并加
* 编译期守卫把 UI_W_REC_LOG_* == syslog_id_t 枚举序钉死
* v1.6 2026-11-02 DTU 项目组 修复「回放页段表枚举恒空」第一幕(登记簿同名
* 条目 + docs/测试说明/专项验证/故障录波板级到场轮执行手册.md §3):
* v1.6 2026-11-02 DTU 项目组 修复「回放页段表枚举恒空」第一幕(docs/子系统设计/故障录波设计说明.md §10 +
* docs/测试说明/专项验证/故障录波板级到场轮执行手册.md §3):
* ui_task_wave_scan 失败不再无条件钉 s_wave_scanned——
* opendir/readdir 失败本轮返 -1(卷忙语义),下一次进页/
* 按键自然重试;失败分支与「FR_OK 零条目」补带 FR 码留痕
@@ -457,8 +458,8 @@ static uint8_t s_wave_buf[256u]; /* 读窗:数据区流式 256B/次
* 函数说明:目录不存在(FR_NO_PATH,从未录过波)与目录空都归「0 段」并钉表,
* 不是错误(设计原口径);其余 f_opendir/f_readdir 失败一律不钉表
* (v1.6:原实现失败也无条件置 s_wave_scanned=1,卷忙 / FR_DENIED
* 一类失败被钉成「0 段」假空态直到下一次 manual_req,登记簿
* 「回放页段表枚举恒空」处置方向 = 失败不钉表、下键重试,与
* 一类失败被钉成「0 段」假空态直到下一次 manual_req,故障录波设计说明 §10
* 的处置方向 = 失败不钉表、下键重试,与
* soe_store 读者同纪律)。失败留痕带 FR 码,板级判读表(FR_DENIED
* → 锁纪律;FR_NOT_READY → 挂载;FR_OK 但零条目 → readdir 与卷状态
* 交互)见 docs/测试说明/专项验证/故障录波板级到场轮执行手册.md §3。