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。
This commit is contained in:
@@ -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 项随本请求提交 */
|
||||
|
||||
Reference in New Issue
Block a user