docs: 归档任务 #148

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)