fix: 恢复 Cloud Web SPA 运行配置

2026-07-11 12:06:57 +02:00
parent 9c91ea0c5c
commit 7939c4ca92
9 changed files with 74 additions and 3 deletions
@@ -0,0 +1,18 @@
+# Cloud Web SPA 运行面恢复
+
+来源：https://github.com/pikasTech/HWLAB/issues/2494
+
+目标是在 NC01/v03 的单一 `hwlab-cloud-web` 构建与路由合同内恢复 `/` 和 `/workbench`，不引入运行面补丁或第二路由。
+
+## R1 [in_progress]
+
+恢复 NC01/v03 Cloud Web SPA，依据 https://github.com/pikasTech/HWLAB/issues/2494 完成根因、修复和 PR 交付，完成任务后将详细报告写入[任务报告](./details/cloud-web-spa-runtime-recovery/R1_Task_Report.md)。
+### R1.1 [completed]
+
+只读核对运行面 provenance、容器静态目录与应用路由，锁定 https://github.com/pikasTech/HWLAB/issues/2494 根因，完成任务后将详细报告写入[任务报告](./details/cloud-web-spa-runtime-recovery/R1.1_Task_Report.md)。
+### R1.2 [completed]
+
+在单一镜像与 SPA fallback 合同内实施最小修复，并完成定向源码测试，完成任务后将详细报告写入[任务报告](./details/cloud-web-spa-runtime-recovery/R1.2_Task_Report.md)。
+### R1.3 [in_progress]
+
+提交受控非 draft PR，记录自动链验收边界与 https://github.com/pikasTech/HWLAB/issues/2494 证据，完成任务后将详细报告写入[任务报告](./details/cloud-web-spa-runtime-recovery/R1.3_Task_Report.md)。
@@ -0,0 +1,6 @@
+# R1.1 调查报告
+
+- issue：https://github.com/pikasTech/HWLAB/issues/2494
+- NC01/v03 唯一 Web Pod 的 localhost 结果：`/` 与 `/workbench` 为 404，`/health/live` 为 200。
+- `dist/index.html` 实际存在；缺少 `HWLAB_WORKBENCH_KAFKA_REFRESH_REPLAY_ENABLED` 导致 HTML 运行配置注入抛错。
+- 静态文件循环宽泛捕获该配置错误并伪装为文件缺失，最终返回 404；健康路径未校验运行配置。
@@ -0,0 +1,6 @@
+# R1.2 修复报告
+
+- 在 v03 `hwlab-cloud-web` owning YAML 中显式开启独立 refresh replay 功能开关。
+- Web 启动监听前校验完整运行配置，缺配置时 fail-fast，不再产生假健康实例。
+- 静态文件候选只忽略 `ENOENT`/`ENOTDIR`，运行配置错误不再伪装为 404。
+- 定向测试：20/20 通过，覆盖缺少 refresh flag 的启动拒绝、SPA 根路径与深链渲染。
@@ -0,0 +1,6 @@
+# R1.3 交付报告
+
+- issue：https://github.com/pikasTech/HWLAB/issues/2494
+- 分支：`fix/2494-cloud-web-404`
+- PR 合并后只允许 GitHub webhook -> Gitea -> PaC -> Tekton -> GitOps/Argo 自动交付。
+- internal/public 原入口验收由主代理在自动滚动完成后执行；本任务不人工触发或修改运行面。
@@ -0,0 +1,5 @@
+# R1 总报告
+
+已修复 Cloud Web 将缺失 Kafka refresh 功能开关伪装成静态文件 404、同时健康探针误报正常的问题。修复保持单一 Cloud Web 路由，并把功能开关保留为可组合的 YAML 字段。
+
+定向 Node 测试 20/20 通过；线上恢复等待正常 PR 合并后的自动 CI/CD 滚动与 semantic internal/public 验收。