diff --git a/docs/任务规划/UI补齐.md b/docs/任务规划/UI补齐.md index 0191453a..54418fba 100644 --- a/docs/任务规划/UI补齐.md +++ b/docs/任务规划/UI补齐.md @@ -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 统计 |