From ec84988e57f572f5769a9ab7c7a5448d7ceb89d2 Mon Sep 17 00:00:00 2001 From: que01 Date: Wed, 21 Oct 2026 11:00:37 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E7=94=9F=E4=BA=A7?= =?UTF-8?q?=E5=8F=91=E5=B8=83=E7=8A=B6=E6=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PROJECT_STATUS.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/PROJECT_STATUS.md b/PROJECT_STATUS.md index 4e2a656..be61217 100644 --- a/PROJECT_STATUS.md +++ b/PROJECT_STATUS.md @@ -36,10 +36,10 @@ ADR 0033 已落地: 当前生产 release: ```text -20261021024748-e752a3b7edb6 +20261021025713-f266bda3a9c1 ``` -该 release 由提交 `e752a3b` 构建,包含创建品牌与页面方案的交互修复、发布流程浏览器回归、小程序配置表单实例修复、前置的 Node 24 版本门禁,以及 Ant Design 6 弃用项收口。部署后已完成公开路由健康检查、三个品牌公开接口和发布快照核对。 +该 release 由提交 `f266bda` 构建,包含创建品牌与页面方案的交互修复、发布流程浏览器回归、小程序配置表单实例修复、前置的 Node 24 版本门禁、Ant Design 6 弃用项收口,以及 Admin 渲染错误边界。部署后已完成公开路由健康检查、三个品牌公开接口和发布快照核对。 生产健康检查: @@ -101,6 +101,20 @@ Admin 浏览器回归新增 `apps/taro/test/browser/brand-creation-and-page-sche 该回归同时发现并修复了 `MiniAppSettingsTab` 的 `Form` 实例归属问题:表单实例原本在父组件创建、子组件懒挂载,触发 antd `useForm` 未连接警告;现已下沉到配置页自身。 +## Admin 渲染错误边界 + +后台此前没有任何 React error boundary:任一页面在渲染阶段抛错(例如接口返回了形状不符的数据)都会导致整页白屏,用户只能从控制台看到堆栈。现在按两级兜底: + +- `Root` 上的整页边界:后台外壳自身渲染失败时显示错误页,提供「重新加载页面」和「返回概览」。 +- `Dashboard` 内容区的页面边界:单个业务页面失败时保留侧边栏与顶部导航,提供「重试」和「重新加载页面」,切换路由后自动复位。 +- 错误页展示可复制的错误编号,日志侧输出同一编号、堆栈与组件栈,便于把用户反馈和服务器日志对应起来。 +- 开发环境额外显示原始错误信息;生产环境不暴露堆栈。 + +`apps/taro/test/browser/admin-error-boundary.spec.ts` 覆盖: + +- 品牌成员接口返回异常结构时显示整页错误,页面不再空白。 +- 业务页面数据异常时保留导航,重试仍失败保持错误页,重新加载后恢复。 + ## Ant Design 6 弃用项 - `Alert` 统一使用 `title`,`Space` 统一使用 `orientation`。 @@ -125,6 +139,8 @@ Admin 浏览器回归新增 `apps/taro/test/browser/brand-creation-and-page-sche - `pnpm template:doctor` - Playwright: - `brand-creation-and-page-scheme.spec.ts` + - `publication-release.spec.ts` + - `admin-error-boundary.spec.ts` - `template-preview-media.spec.ts` - `admin-editor.spec.ts` @@ -139,7 +155,6 @@ Admin 浏览器回归新增 `apps/taro/test/browser/brand-creation-and-page-sche ## 未决事项 -- 本次源码新增的 Admin 浏览器回归、页面方案查询缓存修复和 Node 门禁修复尚未部署到生产;部署后需更新本节的生产 release 和验证结果。 - `miniprogram-ci` 上游发布修复版本后,需要移除对应的 audit ignore、风险登记和本地 patch。 - Gitea SSH 直连仍受 OCI 安全列表限制;当前本机通过 `oracle_arm` ProxyCommand 转发访问,不阻塞业务。 - CI 已加入 audit 和三套模板矩阵构建;后续可继续拆分更细粒度的 smoke/visual matrix。