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:
+17
-20
@@ -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 统计 |
|
||||
|
||||
Reference in New Issue
Block a user