docs(plans): 留痕 K74 开发本机地址

This commit is contained in:
Zhou Weidong committed 2026-10-21 09:17:48 +08:00
1 parent e1580c70ed
commit ad5b104e0d
2 files changed
+51 -18

No files matched your search

+21 -18
View File
@@ -1,30 +1,33 @@
# INBOX
## [已处理] K73-A 把 C3 埋点提交同步到 release/v1.0.0 与 main
## [已处理] K74-A 客户端开发默认地址改为本机地址 10.39.237.1
### 背景
`develop` 上新增了 C3 客户端埋点 SDK:
当前 Mac 的 Wi-Fi 地址为 `10.39.237.1`(路由器 10.39.237.58),本机后端已重启并监听 8081,
`http://10.39.237.1:8081/app/categories` 返回 200。需要把客户端开发默认地址从公网改回本机。
- `92bfc76 feat: C3 客户端埋点 SDK(EventTracker 批量上报 + 核心事件)`
- `827c972 merge: 补齐客户端埋点 SDK`
### 改动
`release/v1.0.0`(`182b7e3`)与 `main`(`6ae9e8e`)尚未包含,需要按既有流程同步。
1. `lib/core/config/app_config.dart`
- `devHostBaseUrl` 改为 `'http://10.39.237.1:8081'`(不带结尾斜杠)
- 注释保持「换网络时只改这一行」的说明
- 探测候选去重逻辑保持不变(当前 devHost 与 public 不同,`publicBaseUrl` 仍保留在候选里,
顺序仍为 `127.0.0.1 → 10.39.237.1 → 公网`)
2. `test/config/server_endpoint_test.dart`
- 字面量断言同步改为 `'http://10.39.237.1:8081'`
### 任务
### 验收
1. `git fetch origin`
2. `git checkout release/v1.0.0 && git merge --no-ff origin/develop`
- 预计无冲突;若有冲突一律采用 develop 版本并在 PROGRESS 记录。
3. 门禁:`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
4. push `release/v1.0.0`。
5. `git checkout main && git merge --no-ff origin/release/v1.0.0`,push `main`。
若 main 受保护导致 push 被拒,不要强推,停下记录原因。
6. 完成后切回 `develop`,`FruitServer/docs/plans/PROGRESS.md` 追加 K73-A 留痕
(两个合并 hash、门禁输出)。
- 门禁:`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
- 提供说明:该地址随网络变化,换网时只改 `devHostBaseUrl` 一行。
### Git
- 从 `develop` 拉 `chore/dev-host-local-ip`。
- 提交:`chore(config): 开发默认地址改回本机 10.39.237.1`,作者 `Zhou Weidong <502333560@qq.com>`。
- `--no-ff` 合回 `develop` 并 push;`FruitServer/docs/plans/PROGRESS.md` 追加 K74-A 留痕。
### 约束
- 全程中文;禁止 `git add -A`、禁止 `git push --force`;不改 `develop` 内容。
- 合并提交作者 `Zhou Weidong <502333560@qq.com>`。
- 完成后停住等待验收。
- 全程中文;禁止 `git add -A`;除上述两个文件外不改其它内容;完成后停住等待验收。
+30
View File
@@ -22593,3 +22593,33 @@ Running Gradle task 'assembleDebug'...
```
解读:release 合并结果静态检查零告警、482 条测试全部通过、debug APK 构建成功;release 与 main 均已推送,等待发布验收。
## 2026-10-21 ReelShort:K74-A 开发默认地址改回本机 IP
- 前置状态:K73-A 已完成并合并,develop 合并提交 `827c972`。
- 分支:`chore/dev-host-local-ip`
- 功能提交:`d13b601 chore(config): 开发默认地址改回本机 10.39.237.1`
- develop 合并提交:`3a636ca merge: 合并 K74-A 开发本机地址`,已推送。
- `devHostBaseUrl` 改为 `http://10.39.237.1:8081`,不带结尾斜杠;注释保留“换网络时只改这一行”的说明。
- 候选去重逻辑保持原实现;devHost 与 public 不同后自动恢复 `127.0.0.1 → 10.39.237.1 → 公网` 三候选顺序,并行探测与超时不变。
- 本任务只修改 `app_config.dart` 与对应配置测试,未改动其它业务文件。
测试:默认地址字面量断言改为 `10.39.237.1`;并行探测、顺序、全失败与运行时优先用例的候选数量同步恢复为三个唯一地址。
门禁原始输出:
```text
$ dart analyze lib test
Analyzing lib, test...
No issues found!
$ flutter test
01:07 +482: All tests passed!
$ flutter build apk --debug
Running Gradle task 'assembleDebug'...
14.2s
✓ Built build/app/outputs/flutter-apk/app-debug.apk
```
解读:静态检查零告警,482 条测试全部通过,debug APK 构建成功。该地址随网络变化,换网时只改 `devHostBaseUrl` 一行;真机验收由用户执行。