docs: 删任务规划两份已完成文档，数据可信内容迁入算法层/硬件平台/登记簿

任务规划目录从 5 个文件收敛到 3 个：只留导航（README）、待办（登记簿）、暂缓专项（暂缓-RS485）。删除的两个文件都不再有现行读者： - UI补齐.md 执行清单 2026-10-28 清空、上板判据 2026-11-06 台架轮已复核；叶数口径迁 docs/UI设计/菜单页面设计.md §3.9，三条内容页硬规矩迁 docs/UI设计/内容页架构.md §7.1，两条未闭环待办迁登记簿 §7/§8。 - 数据可信.md 不是完成记录，而是被约 130 处代码头注释引用的设计约束，因此按内容分三处落位后删除，不整篇丢弃。数据可信内容的新归属（旧节号 → 新家）： - §2/§4 设计口径 → docs/算法/采集与算法层设计说明.md 新增 §13（13 小节）， §7 前置决策表 → §13.12 已定案的前置决策。 - §3 台阶与波次退出判据 → docs/硬件平台/ADC通道映射说明.md 新增 §9。 - §5 任务卡 → docs/任务规划/登记簿.md §7（拆成变比确认 / 两点标定两行）。引用改写 34 文件 77 处路径引用 + 14 文件 24 处昵称引用 + 双重节号 35 处，覆盖代码头注释、测试、生成器与文档；归档区历史路径改纯文本提及。四个 SVG 生成器文案同步并重跑，产物随脚本同批提交。同批处理两件事： - 9 个 UTF-16 LE 证据文件转 UTF-8。end-of-file-fixer 按字节判末尾换行， UTF-16 的换行是 0A 00、末字节 00，钩子会追加裸 0x0a 使文件变奇数长度， 8 个已实际损坏。转码后逐文件比对 HEAD 原文验证正文零丢失。 - 修回 App/cfg/cfg_file.c 被剥掉的 UTF-8 BOM（补 3 字节，未整文件重写）。验证：/keil-build 0 错误 0 警告（Code=255160）；check_doc_links --all --sections-strict 221 篇全通过、无法判定 0；pre-commit 全量全 Passed。
2026-11-09 16:10:55 +08:00
parent 7027718dcd
commit ae09c5737a
87 changed files with 613 additions and 746 deletions
@@ -27,14 +27,14 @@
 *     v1.0  2026-10-25  王建锋  创建（道E task-14：契约 §4 快照层落地；相对契约
 *                                两通道新增第三条 info，划分理由见本头"通道划分"注
 *                                与契约 §4.4）
- *     v1.1  2026-10-26  DTU 项目组  道F task-1（docs/任务规划/UI补齐.md §2 第 1 行）：
+ *     v1.1  2026-10-26  DTU 项目组  道F task-1（docs/UI设计/内容页架构.md §7）：
 *                                新增定值写路径（param_request/param_state/
 *                                param_drain，契约 §6.2 深度 4 环形队列）+ 参数帧尾
 *                                追加 cal_block（UI_DATA_VER 1→2，整定页"未标定"徽标
 *                                的数据源）；写路径仍不引入任何 App 依赖（执行事实
 *                                经 ui_data_param_ops_t 由 App 侧注入，同契约 §7.2
 *                                记录页注入式 reader 的路子）
- *     v1.2  2026-10-26  DTU 项目组  道F task-3（docs/任务规划/UI补齐.md §2 第 3 行
+ *     v1.2  2026-10-26  DTU 项目组  道F task-3（docs/UI设计/内容页架构.md §7.1 第 2 条
 *                                「装置维护 3 页」的前置）：新增通道四——维护写请求
 *                                （ui_data_maint_*：墙钟设置 / 强制复归 / 清除记录，
 *                                常驻注入 ui_data_maint_ops_t）与时钟字段换算
@@ -85,7 +85,7 @@ extern "C" {
 /* ── 量纲口径 eng（诚实性字段：数值 val 的单位由它决定）───────────────────── */

 /*
- * 真值语义（现场口径 = docs/任务规划/数据可信.md §2.6 的承诺边界 + §4.2 三态
+ * 真值语义（现场口径 = docs/算法/采集与算法层设计说明.md §13.5 的承诺边界 + §4.2 三态
 * 可用性；契约文档原先写的"0 = 原始码值（未标定）"是标定落地前的旧口径，
 * 已按本表更正，勿再照抄旧表述）：
 *   ENG_PIN 引脚电压 V —— 现状：adc_cal 的 ROM 默认系数是「数据可信」量程口径冻结定死
@@ -107,7 +107,7 @@ extern "C" {
 #define UI_DATA_Q_SB     0x08u  /* 取代值（虚拟注入/替身值，页面应带角标） */
 #define UI_DATA_Q_BL     0x10u  /* 闭锁：该量被业务闭锁（未标定闭锁/采样闭锁） */
 /* 原始码值域：val 不是工程量而是转换器码值——TEMP 不参与线性标定
- * （docs/任务规划/数据可信.md §4.2 的"TEMP 透传码值"决策），有此位即页面
+ * （docs/算法/采集与算法层设计说明.md §13.3 的"TEMP 透传码值"决策），有此位即页面
 * 不得给 val 挂 V/A 单位，也不得与工程量互比 */
 #define UI_DATA_Q_RAW    0x20u

@@ -186,7 +186,7 @@ typedef struct {
     *   "标定做完屏上仍永不解锁"。三路口径的权威实现 = App/task/protect_task.c
     *   的 s_cal_locked()（写侧 App/app/ui_data_feed.c 按同一条判据现算，本层只存
     *   真值、不判断）。与上面 locked（定值校验和自检闭锁 = 禁编辑）是两件事，
-     *   屏上不得互认（三词三源见 docs/任务规划/数据可信.md §4.3） */
+     *   屏上不得互认（三词三源见 docs/算法/采集与算法层设计说明.md §13.4） */
    uint8_t  cal_block;
 } ui_data_par_t;

@@ -348,7 +348,7 @@ uint32_t ui_data_info_seq(void);
 *   任何判定；先 memset 再填也完全可以，两种写法都安全）。
 *   绝不允许"从显示值回提全表"——Q10 存不下 0.95 这类返回系数（真存 972/1024），
 *   按显示域往返会把用户没动的项顺手改掉
- *   （docs/任务规划/UI补齐.md §2 第 2 行判据"值不落盘"的前提）。
+ *   （"编辑提交前的值只在 RAM、不落盘"这条交接语义的前提）。
 */
 typedef struct {
    uint64_t mask;                  /* bit i = 1 → 第 i 项随本请求提交 */
@@ -15,9 +15,9 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-27
 * 修改记录：
- *     v1.0  2026-10-27  DTU 项目组  创建（道F task-7；判据 docs/任务规划/UI补齐.md
- *                               §2 第 4 行「改死区能改变 104 上送门限 / 改 k 后
- *                               页面值按比例变化 / 只走既有落盘链不加第二真源」）
+ *     v1.0  2026-10-27  DTU 项目组  创建（道F task-7；通用判据 = docs/UI设计/
+ *                               内容页架构.md §7.1；本页另须「改死区能改变 104 上送门限 /
+ *                               改 k 后页面值按比例变化 / 只走既有落盘链不加第二真源」）
 */
 /* 头文件包含区 */
 #include "ui_page_calib.h"
@@ -20,8 +20,8 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-26
 * 修改记录：
- *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3；判据 docs/任务规划/UI补齐.md
- *                               §2 第 3 行「清除记录…不允许只做没有实际效果的按钮」；
+ *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3；判据 docs/UI设计/
+ *                               内容页架构.md §7.1 第 2 条「清除记录…不允许只做没有实际效果的按钮」；
 *                               删除 API 与请求/落地分离 = task-4，口径真源
 *                               App/log/README.md 与 App/log/sys_log.h）
 */
@@ -7,7 +7,7 @@
 * 创建日期：2026-10-26
 * 修改记录：
 *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3「装置维护 3 页」，判据 =
- *                               docs/任务规划/UI补齐.md §2 第 3 行；形态 =
+ *                               docs/UI设计/内容页架构.md §7.1 第 2 条；形态 =
 *                               docs/UI设计/页面扩充详细方案.md §3.4）
 */
 #ifndef UI_PAGE_CLEAR_H
@@ -17,8 +17,8 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-26
 * 修改记录：
- *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3；判据 docs/任务规划/UI补齐.md
- *                               §2 第 3 行「时钟设置写入 sys_clock_set_unix()
+ *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3；判据 docs/UI设计/内容页架构.md
+ *                               §7.1 第 2 条「时钟设置写入 sys_clock_set_unix()
 *                               并回读」；形态 = 页面扩充详细方案.md §3.4 表单 6 字段）
 */

@@ -7,7 +7,7 @@
 * 创建日期：2026-10-26
 * 修改记录：
 *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3「装置维护 3 页」，判据 =
- *                               docs/任务规划/UI补齐.md §2 第 3 行；形态 =
+ *                               docs/UI设计/内容页架构.md §7.1 第 2 条；形态 =
 *                               docs/UI设计/页面扩充详细方案.md §3.4）
 */
 #ifndef UI_PAGE_CLOCK_H
@@ -21,9 +21,9 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-27
 * 修改记录：
- *     v1.0  2026-10-27  DTU 项目组  创建（道G task-9；判据 = docs/任务规划/
- *                               UI补齐.md §2 第 1 行「重启即生效 + 104 侧读回
- *                               真值 + 段数键数上限核对」，台架判据见该卡与
+ *     v1.0  2026-10-27  DTU 项目组  创建（道G task-9；验收口径 = 本页须
+ *                               「重启即生效 + 104 侧读回真值 + 段数键数上限核对」，
+ *                               台架判据见 docs/任务规划/登记簿.md §7「通讯设置页真机判据」与
 *                               IEC104上行设计说明.md §8）
 */
 /* 头文件包含区 */
@@ -14,9 +14,9 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-27
 * 修改记录：
- *     v1.0  2026-10-27  DTU 项目组  创建（道F task-7；判据 docs/任务规划/UI补齐.md
- *                               §2 第 4 行「改死区能改变 104 上送门限 / 改 k 后
- *                               页面值按比例变化 / 只走既有落盘链不加第二真源」）
+ *     v1.0  2026-10-27  DTU 项目组  创建（道F task-7；通用判据 = docs/UI设计/
+ *                               内容页架构.md §7.1；本页另须「改死区能改变 104 上送门限 /
+ *                               改 k 后页面值按比例变化 / 只走既有落盘链不加第二真源」）
 */
 /* 头文件包含区 */
 #include "ui_page_deadband.h"
@@ -16,8 +16,8 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-26
 * 修改记录：
- *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3；判据 docs/任务规划/UI补齐.md
- *                               §2 第 3 行「强制复归确认后动作位复归且有 SOE」）
+ *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3；判据 docs/UI设计/内容页架构.md
+ *                               §7.1 第 2 条「强制复归确认后动作位复归且有 SOE」）
 */

 /* 头文件包含区 */
@@ -7,7 +7,7 @@
 * 创建日期：2026-10-26
 * 修改记录：
 *     v1.0  2026-10-26  DTU 项目组  创建（道F task-3「装置维护 3 页」，判据 =
- *                               docs/任务规划/UI补齐.md §2 第 3 行；形态 =
+ *                               docs/UI设计/内容页架构.md §7.1 第 2 条；形态 =
 *                               docs/UI设计/页面扩充详细方案.md §3.4）
 */
 #ifndef UI_PAGE_RESET_H
@@ -4,7 +4,7 @@
 *           分 2 页（UI_LIST_ROWS=8 行/页 → 8 + 5）；数据全部经 ui_data 装置信息帧下发
 *           （写侧 App/app/ui_data_feed.c 搬 boot_stats_get() 与 iec104_serv_get_stats()，
 *           本文件零 App include，分层方向由 layer-deps 门禁守护）
- * 口径纪律（判据 docs/任务规划/UI补齐.md §2「运行报告」行 + App/util/boot_stats.h 四数台账）：
+ * 口径纪律（判据 = 本页四个数逐个挂范围标签 + App/util/boot_stats.h 四数台账）：
 *           ① **四个数逐个挂范围标签**，不许含糊——上电次数=自 RTC 电池周期（换电池即清零，
 *              **禁写终身次数**，固件里压根没有跨开机计数器）、复位原因/运行时长/104 统计
 *              =本次开机以来（104 四枚跨重连不清零，但**断电即归零**）；
@@ -7,8 +7,7 @@
 *           等待也不查询结果（录波从触发到成段最快也要一秒后，页面上做同步
 *           等待等于把 uiTask 绘制定律「零 I/O」当场破掉）；
 *           只读进入（查看密码）整页拒执行并显式 LOCK——与强制复归同一条
- *           「触发是操作不是查看」的权限判据（docs/任务规划/UI补齐.md §2
- *           维护组的既有口径，本页不自造第二种）；
+ *           「触发是操作不是查看」的权限判据（装置维护组的既有口径，本页不自造第二种）；
 *           本文件零 App include、零存储触点（分层方向由注入表守住）。
 * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
 * 作者：DTU 项目组
@@ -54,7 +54,7 @@ typedef enum {
                                 * ⚠ 与「未标定」是两件事、屏上两条通道：未标定
                                 *   （= par.cal_block）仍可改定值、只是判据停走，
                                 *   用标题右侧徽标表达；LOCK 才是"写不进去"。
-                                 *   三词三源 → docs/任务规划/数据可信.md §4.3 */
+                                 *   三词三源 → docs/算法/采集与算法层设计说明.md §13.4 */
 } ui_w_setlist_st_t;

 /* 行种类 */
@@ -104,8 +104,8 @@ uint8_t ui_w_setview_key(ui_w_setlist_t *a_inst, lv_key_t a_key);
 *          当前是整定视图（attach_edit）+ 参数帧已就位 + par.cal_block 非 0
 * 函数说明：为什么值得占标题带一个角：整定页的存在就是"让用户改保护定值"，
 *          而产品构建下 UA/UN/IA 未标定 → 判据恒停走 → **改完也不会动作**。
- *          不写这件事，页面就是在暗示"改了就算数"（UI补齐.md §4 末段"保护闭锁
- *          必须可见"；口径 docs/任务规划/数据可信.md §4.3）。
+ *          不写这件事，页面就是在暗示"改了就算数"（判据 docs/UI设计/内容页架构.md
+ *          §7.1 第 3 条"保护闭锁必须可见"；口径 docs/算法/采集与算法层设计说明.md §13.4）。
 *          ⚠ 与保存行的 LOCK 是两件事：LOCK = 定值闭锁（写不进去、禁编辑），
 *            徽标 = 未标定（仍可改，只是判据停走）——合成一个词就等于互相冒充。
 *          ⚠ 查看页不画（s_edit=0）：那四页是既有黄金参考，像素零变化是硬约束
@@ -27,8 +27,8 @@
 * 作者：DTU 项目组
 * 创建日期：2026-10-27
 * 修改记录：
- *     v1.0  2026-10-27  DTU 项目组  创建（道F task-7；判据 docs/任务规划/UI补齐.md
- *                               §2 第 4 行；Lead 裁定：注入表八口形状、结果锁存、
+ *     v1.0  2026-10-27  DTU 项目组  创建（道F task-7；通用判据 = docs/UI设计/
+ *                               内容页架构.md §7.1；Lead 裁定：注入表八口形状、结果锁存、
 *                               粗守 + 注释两层守卫、真带访问器归 task-43）
 */
 #ifndef UI_W_YTVIEW_H