docs(#72): document API readiness and SYB retry

2026-08-24 10:57:53 +08:00
parent 936fad46a1
commit 2075bb8a28
1 changed files with 2 additions and 2 deletions
@@ -135,7 +135,7 @@ Remove-Item Env:GOAUTO_IMPORT_MYSQL_TEST_DSN
 本机安装的 Go Supervisor 位于 `D:\supervisor`。GoAuto 的版本化配置源为 `scripts/supervisor/goauto.conf`，运行副本为 `D:\supervisor\programs\goauto.conf`。两个实例都读取仓库根目录已忽略的 `config.yaml`，Supervisor 配置不得保存数据库密码：

 - `goauto-admin-api`：调用 `scripts/start-server.ps1`，执行迁移后启动 Admin API。
- `goauto-admin-ui`：调用 `scripts/start-web.ps1`，启动 Admin UI；脚本会解析 Node.js 并直接运行项目的 Vite CLI，避免 Supervisor 子进程缺少 Node PATH。
+- `goauto-admin-ui`：调用 `scripts/start-web.ps1`，先等待 `ports.server` 对应的 `/api/v1/health` 返回 200，再启动 Admin UI；脚本会解析 Node.js 并直接运行项目的 Vite CLI，避免 Supervisor 子进程缺少 Node PATH。API 在 60 秒内未就绪时，脚本明确失败并由 Supervisor 按重启策略处理。
 - 日志：`D:\supervisor\logs\goauto-admin-api.log`、`D:\supervisor\logs\goauto-admin-ui.log`。
 - Supervisor 管理界面：`http://127.0.0.1:9009`。

@@ -154,4 +154,4 @@ D:\supervisor\supervisord.exe /c D:\supervisor\supervisord.conf ctl restart goau
 D:\supervisor\supervisord.exe /c D:\supervisor\supervisord.conf ctl restart goauto-admin-ui
 ```

-Supervisor 托管期间不要再运行 `start-all.bat` 或重复启动对应单端脚本，否则会因 8010/9527 被占用而失败。
+Supervisor 托管期间不要再运行 `start-all.bat` 或重复启动对应单端脚本，否则会因 8010/9527 被占用而失败。两个 GoAuto 实例同时重启时，Admin UI 会等待 API HTTP 就绪后再监听 Web 端口；SYB 商品页对一次短暂网络断开做单次有界重试，不对认证、权限或业务错误重试。