docs: 归档任务 #103

2026-08-11 11:13:43 +08:00
parent 69e52928aa
commit 6d30115c7e
1 changed files with 45 additions and 0 deletions
@@ -0,0 +1,45 @@
+# #103 Client：启动检查到新版本时提醒参数设置导航
+
+- 工单号：#103
+- 类型：功能
+- 父级：#1
+- 版本：MVP #2
+- 状态：待验收
+- 日期：2026-08-11
+- Gitea：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/103>
+
+## 背景与目标
+
+启动时异步检查到线上版本较新后，在主导航明确提醒采购人员，并在设置页同时展示本地和线上版本。
+
+## 最终方案
+
+更新检查成功后由事件层发出版本状态信号。主窗口收到信号后使用提醒色和“有更新”文字共同标记参数设置导航；确认已是最新版本时恢复普通导航。检查失败不改变导航状态，进入设置页也不会清除提醒。
+
+## 改了哪些
+
+- `client/src/update_ui_event.py`：发布更新可用状态和本地、线上版本。
+- `client/src/ui_main.py`：更新参数设置导航的文字、颜色和提示。
+- `client/src/settings_ui.py`：同时展示本地版本和线上版本。
+- `client/test/`：补充更新状态和导航提醒测试。
+- `docs/client/05-ui-specification.md`：补充稳定交互规则。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 启动检查保持后台执行，不阻塞主界面 | 通过 |
+| 发现新版本时导航同时使用颜色和文字提醒 | 通过 |
+| 设置页显示本地版本和线上版本 | 通过 |
+| 已是最新版本时清除提醒 | 通过 |
+| 检查失败不误报，提示可重试 | 通过 |
+
+## 测试
+
+- 执行的命令：`cd client; python -m unittest discover -s test -p "test_update_ui_event.py"`；`cd client; python -m unittest discover -s test -p "test_pdd_ui_event.py"`
+- 结果：通过，共 48 项 PDD UI 事件测试及在线更新事件测试。
+- **没验证到的部分**：未连接真实发布服务器下载更新；未在 Windows 有界面环境人工检查深浅色主题效果。
+
+## 相关提交
+
+- `69e5292` 新版本时提醒参数设置导航