docs(任务规划): UI补齐 销项两项并同步全部计数——登记簿不再与仓库真值矛盾

这一笔是补一次**该问而没问的疏漏**:AGENTS 把登记簿删行销项列在 Ask first,用户此前只授权过上一批的具体
范围,所以之后两项落地时我只关了看板卡、没动这份执行清单——结果文档与仓库开始互相矛盾。本次按用户指示做
全量销项 + 同步计数。

删掉的已完成行:装置维护 3 页(48a8ef05 之前的 52e28885,真机验过:时钟页按回读 RTC 出真判据、清除与强制
复归默认拒绝)、遥测死区与系数 2 页(48a8ef05,三态用脏位、WAIT 与 OK 各一张黄金)。§2 剩余三项顺次重编为
1 通讯设置 / 2 记录 5 页 / 3 运行报告,开篇指针同步改成「从第 1 项通讯设置开始」。

同步的真值(不再抄旧数):菜单树按行内 #page= 实测**已绑 21 叶 / 未绑 21 叶**(清单行合计 42),页面映射
UI_PAGE_MAP_COUNT = 21,内容页黄金 47 页;旧写的 33/16/17 是两项落地前的数,已注明覆盖来源与重测时刻。
§1 分类表删掉「数据源已就绪 5」这一类(已做完),§3 数据源表删掉那 5 页已完成行;§1「这些基础当前没有完整
页面消费者」一句也已改成真话——ui_data 现在有四通道,装置维护与遥测两批已经把这套基础接上了真实消费者。

依赖关系一节没有直接删掉旧判据,而是把它们**留成后续项沿用的口径**:执行类页面不得做成「点了个按钮但没效
果」;清除记录必须按 syslog_clear_state() 出真反馈;三态区分「已受理」与「已落盘」,黄金必须出 WAIT 与 OK
两张(假件保留脏位、只由 headless pump 清),否则真机的 WAIT 态永远不会被像素回归覆盖。

自查:check_doc_links.py --all exit 0(195 文档、2,673 处章节引用、无法判定 0);本篇 --section
s-strict 通过;
check_ids --strict exit 0 且不可判定绝对数 **1,156 未变**(本笔没吃余量、没新增编号引用);无 BOM / LF /
U+FFFD=0 / 结尾换行齐。⚠ 全仓其他文档里「内容页 40 页」那类计数仍是旧值,属 task-39 同族的独立改写,不在本笔。
This commit is contained in:
2026-10-27 07:02:06 +08:00
parent d286b69a2d
commit 475885d621
+17 -20
View File
@@ -1,22 +1,24 @@
# 当前任务:UI 补齐
> **从第 1 项「装置维护 3 页」开始,按表序单道串行推进。**
> **从第 1 项「通讯设置」开始,按表序单道串行推进。**
> 本文件是当前唯一执行清单;全项目顺序见 `docs/任务规划/README.md` §2。
## 1. 目标与范围
菜单树 33 叶,已绑 16 叶,未绑 17 叶:
菜单树按行内 `#page=` 标记实测:**已绑 21 叶、未绑 21 叶**(清单行合计 42);
页面映射表 `UI_PAGE_MAP_COUNT` = 21。上一版写的 33/16/17 是`装置维护 3 页`与`遥测死区/系数 2 页`
落地前的数,已按 05:1x 工作区重测覆盖。
| 分类 | 数量 | 当前怎么处理 |
|---|---:|---|
| 数据源已就绪 | 5 | 当前执行:装置维护 3 + 遥测死区/系数 2 |
| 需补配置或写入方 | 7 | 当前执行:通讯设置 1 + 记录 5 + 运行报告 1 |
| 需补配置或写入方 | 7 | 当前执行:通讯设置 1 + 记录 5 + 运行报告 1(即下方第 1~3 项) |
| 无开入硬件 | 3 | 不做:遥信类型、遥信防抖、双点遥信 |
| 缺独立模块或产品定义 | 2 | 不做:手动录波、SNTP 设置 |
现有基础:`ui_w_editor` / `ui_w_setlist` / `ui_page_action` 已就绪;
`ui_data` 的 rt / par / info 三通道已接线;像素黄金用例与字符集门禁已存在。
**这些基础当前没有完整页面消费者,本任务就是把它们真正用起来。**
现有基础:`ui_w_editor` / `ui_w_setlist` / `ui_page_action` 已就绪;`ui_data` 已扩到**四通道**
(rt / par / info + 遥测死区与系数用的第四张注入表);像素黄金用例与字符集门禁已存在,内容页黄金
现有 **47 页**(菜单 8 状态另计)。**装置维护 3 页与遥测死区/系数 2 页已把这套基础接上了真实消费者,
剩余三项继续用它,不另发明一套机制。**
逐页形态见 `docs/UI设计/页面补齐规划.md`;数据契约见
`docs/UI设计/UI_数据供给设计说明.md`。本文件只维护执行顺序和完成判据。
@@ -29,19 +31,18 @@
| 顺序 | 任务 | 完成判据 | 主要写范围 | 状态 |
|---|---|---|---|---|
| **1** | **装置维护 3 页** | 时钟设置写入 `sys_clock_set_unix()` 并回读;强制复归确认后动作位复归且留操作记录;清除记录经 `syslog_request_clear()` 发起、按 `syslog_clear_state()` 出真反馈,覆盖删后重建、计数归零、不存在时幂等 | `Drivers/BSP/UI/`、`App/log/sys_log.*` | 未开始 |
| **2** | **遥测死区与系数 2 页** | 修改死区能改变 104 上送门限;修改 `k` 后页面值按比例变化;两页只走既有 `[run_par]` / `[adc_cal]` 落盘链,不新增真源 | `Drivers/BSP/UI/`、`ui_menu_tree.txt` | 未开始 |
| **3** | **通讯设置** | 新建 `[comm]` 段承载公共地址与端口;修改并重启后连接与公共地址生效;核对配置段数和键数上限(主站地址白名单本卡不做,见 §5) | `App/cfg/`、`App/protocol/iec104/`、`Drivers/BSP/UI/` | 未开始 |
| **4** | **记录 5 页** | 事故、操作、保护告警、保护启动、遥控各有一个写入点和记录类型;可翻最近 20 条;空记录明确显示“无记录”;共用 reader | `App/log/`、`Drivers/BSP/UI/` | 未开始 |
| **5** | **运行报告** | 展示上电次数、运行时长、复位原因、104 统计;复用 info 通道的已有数据;新计数器明确“掉电保持”或“本次运行”,不得含糊 | `App/log/` 或 `App/app/`、`Drivers/BSP/UI/` | 未开始 |
| **1** | **通讯设置** | 新建 `[comm]` 段承载公共地址与端口;修改并重启后连接与公共地址生效;核对配置段数和键数上限(主站地址白名单本卡不做,见 §5) | `App/cfg/`、`App/protocol/iec104/`、`Drivers/BSP/UI/` | 未开始 |
| **2** | **记录 5 页** | 事故、操作、保护告警、保护启动、遥控各有一个写入点和记录类型;可翻最近 20 条;空记录明确显示“无记录”;共用 reader | `App/log/`、`Drivers/BSP/UI/` | 未开始 |
| **3** | **运行报告** | 展示上电次数、运行时长、复位原因、104 统计;复用 info 通道的已有数据;新计数器明确“掉电保持”或“本次运行”,不得含糊 | `App/log/` 或 `App/app/`、`Drivers/BSP/UI/` | 未开始 |
### 依赖关系
- 各项虽可独立开发,但当前仍按表序单道执行(菜单树、页面注册表与字库都是生成物)。
- 1 的“清除记录”只能发 `syslog_request_clear()` 请求并按 `syslog_clear_state()` 出反馈,
不允许只做一个没有实际效果的按钮,也不得在页面里直接删文件。
- 3 可先完成配置层再接页面,但最终必须作为一整项验收。
- 4、5 先补真实写入方或计数器,再做页面;不允许用静态演示数据充数。
- 通讯设置可先完成配置层再接页面,但最终必须作为一整项验收。
- 记录 5 页与运行报告先补真实写入方或计数器,再做页面;不允许用静态演示数据充数。
- 历史教训(已完成的装置维护 3 页留下的口径,后续项沿用):**执行类页面不得做成「点了个按钮但没效果」**——清除记录必须按 `syslog_clear_state()` 出真反馈;遥测死区/系数两页的三态用
`run_par_dirty_peek()` 区分「已受理」与「已落盘」,且黄金必须出 WAIT 与 OK 两张(假件保留脏位、只由
headless pump 清),否则真机的 WAIT 态永远不会被像素回归覆盖。
---
@@ -49,10 +50,6 @@
| 页面 | 现有数据源 | 还缺什么 |
|---|---|---|
| 时钟设置 | `sys_clock_set_unix()` | 页面与回读校验 |
| 强制复归 | `prot_elm_request_reset()`、`ui_page_action` | 页面与 SOE 留痕 |
| 清除记录 | `sys_log` | 页面与确认交互(删除 API 已落) |
| 遥测死区 / 系数 | `run_par`、`adc_cal` | 可编辑页面 |
| 通讯设置 | 网口配置保存范式可复用 | `[comm]` 段及 104 消费 |
| 记录 5 页 | SOE、自检、运行记录已有 reader 先例 | 五类写入方与记录类型 |
| 运行报告 | `uptime_s`、复位原因已有 | 上电次数与 104 统计 |