From a5ce27c6ece97194a7fbbcdb0a31cfb791eeff93 Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Wed, 21 Oct 2026 16:36:34 +0800 Subject: [PATCH] =?UTF-8?q?feat(cms):=20=E9=A6=96=E9=A1=B5=E8=BE=93?= =?UTF-8?q?=E5=87=BA=20data-cms-state=EF=BC=8C=E9=80=80=E5=8C=96=E6=97=B6?= =?UTF-8?q?=E6=8C=89=E5=90=8D=E5=AD=97=E5=A4=B1=E8=B4=A5=E8=80=8C=E4=B8=8D?= =?UTF-8?q?=E6=98=AF=E7=8C=9C=E5=83=8F=E7=B4=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CMS 读数全空时首页会整套落到常量版式,页面照常 200,外观与「后台就是没内容」 不可区分。视觉基线对此只能给出一团无从归因的像素差——2026-10-20 那次间歇红 就是被这样当成了竞态。 - `page.tsx` 统计六路内容来源,全空判 `cmsState='empty'`,非空为 `ok`; 同时把 `getHomePageCopy` 原本 `catch(() => null)` 的静默吞掉改成带 tag 的 `console.warn`(行为不变,只是不再无声)。 - `home-content-v16.tsx` 在根节点渲染 `data-cms-state`;默认 `ok`,不影响其它调用方。 - 单测新增三例:全空 ⇒ empty;任一来源有内容 ⇒ ok;copy 抛错 ⇒ 页面不炸、 状态仍 ok、且 warn 被调用(钉住「不静默」这条)。 视觉层据此在截图前断言该标记(下一笔)。 --- src/app/(marketing)/home-content-v16.tsx | 5 ++- src/app/(marketing)/page.test.tsx | 40 ++++++++++++++++++++++++ src/app/(marketing)/page.tsx | 14 ++++++++- 3 files changed, 57 insertions(+), 2 deletions(-) diff --git a/src/app/(marketing)/home-content-v16.tsx b/src/app/(marketing)/home-content-v16.tsx index 10b4877..e9a6d8e 100644 --- a/src/app/(marketing)/home-content-v16.tsx +++ b/src/app/(marketing)/home-content-v16.tsx @@ -635,6 +635,7 @@ export default function HomeContentV16({ news, pageCopy, trustSignals, + cmsState = 'ok', }: { services?: CapabilityRow[]; solutions?: Row[]; @@ -644,6 +645,8 @@ export default function HomeContentV16({ news?: NewsItem[]; pageCopy?: Record | null; trustSignals?: Row[]; + /** 由 page.tsx 判定的 CMS 读数状态;视觉用例据此按名字判红,而不是猜像素差 */ + cmsState?: 'ok' | 'empty'; }) { const caseRows = cases ?? []; // 判别式联合要靠显式类型标注收窄 —— 三元直接推会退化成 { kind: string }, @@ -654,7 +657,7 @@ export default function HomeContentV16({ : { kind: 'co-creation', steps: CO_CREATION_STEPS }; return ( -
+
{/* 咨询机构的首页节拍:影像开场 → 编辑内容 → 行业网格 → 能力 → 客户成果 → 信任 → 收尾 CTA。数字账本压成 hero 后的一条窄带, 不抢「新闻」这一拍。段序变化只动装配顺序,各段的真源与空态判据不变。 */} diff --git a/src/app/(marketing)/page.test.tsx b/src/app/(marketing)/page.test.tsx index 0921680..6648c9a 100644 --- a/src/app/(marketing)/page.test.tsx +++ b/src/app/(marketing)/page.test.tsx @@ -24,6 +24,7 @@ jest.mock('./home-content-v16', () => ({
{(props.news as unknown[])?.length ?? 0}
{props.heroData ? JSON.stringify(props.heroData) : 'null'}
{props.pageCopy ? JSON.stringify(props.pageCopy) : 'null'}
+
{String(props.cmsState ?? '')}
); }, @@ -176,4 +177,43 @@ describe('HomePage', () => { expect(screen.getByTestId('services-count')).toHaveTextContent('0'); expect(screen.getByTestId('hero-data')).toHaveTextContent('null'); }); + + /** + * CMS 读数退化与「后台就是没内容」在页面上长得一样:两者都落到常量版式, + * 页面照常 200。视觉基线只能看到像素差,读不出是哪一种 —— 2026-10-20 的间歇红 + * 就是这么被当成竞态的。这里把状态显式透出,视觉层才能按名字失败。 + */ + it('一条内容都没读到 ⇒ cmsState=empty(供视觉层按名字判红)', async () => { + const page = await HomePage(); + render(page); + expect(screen.getByTestId('cms-state')).toHaveTextContent('empty'); + }); + + it('任一来源读到内容 ⇒ cmsState=ok', async () => { + mockedGetResolvedHomeZones.mockResolvedValue({ + hero: [createMockItem('hero-banner', { heading: 'H' })], + }); + const page = await HomePage(); + render(page); + expect(screen.getByTestId('cms-state')).toHaveTextContent('ok'); + }); + + it('page-copy 读取抛错时页面不炸,且错误不被静默吞掉', async () => { + mockedGetResolvedHomeZones.mockResolvedValue({ + hero: [createMockItem('hero-banner', { heading: 'H' })], + }); + mockedGetHomePageCopy.mockRejectedValue(new Error('SQLITE_BUSY')); + const warn = jest.spyOn(console, 'warn').mockImplementation(() => {}); + + const page = await HomePage(); + render(page); + + expect(screen.getByTestId('page-copy-data')).toHaveTextContent('null'); + expect(screen.getByTestId('cms-state')).toHaveTextContent('ok'); + expect(warn).toHaveBeenCalledWith( + expect.stringContaining('getHomePageCopy'), + expect.any(Error), + ); + warn.mockRestore(); + }); }); diff --git a/src/app/(marketing)/page.tsx b/src/app/(marketing)/page.tsx index 01541e1..a756639 100644 --- a/src/app/(marketing)/page.tsx +++ b/src/app/(marketing)/page.tsx @@ -57,7 +57,12 @@ export default async function HomePage() { * ⇒ 兜底数据在这里起的是**遮蔽**作用,不是降级作用。 */ - const homePageCopy = await getHomePageCopy().catch(() => null); + const homePageCopy = await getHomePageCopy().catch((error: unknown) => { + // 静默 catch 成 null 会让「CMS 读挂了」和「后台没配」在页面上长得一模一样: + // 两者都回落到内置文案,页面照常 200。至少要留下可检索的一行。 + console.warn('[home] getHomePageCopy 读取失败,回落到内置文案:', error); + return null; + }); const copyData = (homePageCopy?.data ?? null) as Record | null; // 信任信号:后台可覆盖,未配置则回到 constants 里那份带 source 的真实信号 @@ -65,6 +70,12 @@ export default async function HomePage() { ? (copyData!.trustSignals as Record[]) : [...TRUST_SIGNALS]; // 常量是 as const 只读元组,转成可变数组喂给 Row[] + // 一条内容都没读到 ⇒ 整套落到常量版式(页面仍 200,外观与「后台没内容」不可区分)。 + // 把这个状态显式透给视觉层:否则它只能看到一团像素差,无从判断是竞态还是数据退化。 + const cmsItemCount = + services.length + solutions.length + cases.length + stats.length + news.length + (heroData ? 1 : 0); + const cmsState: 'ok' | 'empty' = cmsItemCount > 0 ? 'ok' : 'empty'; + return ( ); }