diff --git a/docs/task/148-切换正式管理端默认地址.md b/docs/task/148-切换正式管理端默认地址.md new file mode 100644 index 0000000..d3fc7b2 --- /dev/null +++ b/docs/task/148-切换正式管理端默认地址.md @@ -0,0 +1,53 @@ +# 148 Client:将管理端默认地址切换为正式 HTTPS 地址 + +- 类型:需求 +- 父级大工单:#1 +- 所属 MVP / 版本:#2 / Client 可运行任务闭环 +- 状态:已完成,待用户验收 +- 日期:2026-08-11 +- Gitea 工单:http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/148 + +## 背景与目标 + +Client 原来默认连接本机 Admin。新安装客户端应默认连接 `https://buy.833729.com`,升级时还要迁移旧默认值,同时保留用户手动保存的其他地址。 + +## 最终方案 + +- 将唯一默认地址常量改为 `https://buy.833729.com`。 +- 增加统一的管理端地址读取函数:没有值、空值或旧默认地址时写入新默认值;其他地址只在使用时去除首尾空白和末尾斜杠,不覆盖数据库原值。 +- 设置页和 PDD 任务页都使用统一读取函数,避免登记、领取和提交访问不同地址。 +- 更新设置页占位文字和长期界面基线。 + +## 改了哪些 + +- `client/src/http_admin_gateway.py`:修改默认地址。 +- `client/src/current_client_service.py`:增加旧默认值兼容迁移。 +- `client/src/settings_ui_event.py`、`client/src/pdd_ui_event.py`:统一读取管理端地址。 +- `client/src/settings_ui.py`:更新地址占位文字。 +- `client/test/`:覆盖默认值、迁移、自定义地址和界面保存行为。 +- `docs/client/05-ui-specification.md`:记录稳定默认值与迁移规则。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 全新 Client 使用正式 HTTPS 默认地址 | 通过 | +| 缺少配置时保存新默认值 | 通过 | +| 旧本机默认值自动迁移 | 通过 | +| 用户自定义地址保持不变 | 通过 | +| 设置页与任务页使用同一地址来源 | 通过 | +| 测试不访问真实管理端、不记录凭据 | 通过 | + +## 测试 + +- 执行的命令: + - `C:/Python310/python.exe -m unittest discover -s test -p "test_current_client_service.py"` + - `C:/Python310/python.exe -m unittest discover -s test -p "test_http_admin_gateway.py"` + - `$env:QT_QPA_PLATFORM='offscreen'; C:/Python310/python.exe -m unittest discover -s test -p "test_settings_ui_event.py"` + - `C:/Python310/python.exe -m py_compile src/http_admin_gateway.py src/current_client_service.py src/settings_ui_event.py src/pdd_ui_event.py src/settings_ui.py` +- 结果:6、13、43 项测试全部通过,语法检查通过;Qt 输出已有字体目录警告,不影响测试结果。 +- **没验证到的部分**:未向正式 Admin 发起真实登记、领取或提交请求,避免测试影响线上任务。 + +## 相关提交 + +- `5c2f4f6` feat: 切换正式管理端默认地址 (#148)