feat(cms): 首页输出 data-cms-state,退化时按名字失败而不是猜像素

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 被调用(钉住「不静默」这条)。

视觉层据此在截图前断言该标记(下一笔)。
This commit is contained in:
zhangxiang committed 2026-10-21 16:36:34 +08:00
1 parent 81dc70b86c
commit a5ce27c6ec
3 files changed
+57 -2

No files matched your search

+4 -1
View File
@@ -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<string, unknown> | 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 (
<div>
<div data-cms-state={cmsState}>
{/* 咨询机构的首页节拍:影像开场 → 编辑内容 → 行业网格 → 能力
→ 客户成果 → 信任 → 收尾 CTA。数字账本压成 hero 后的一条窄带,
不抢「新闻」这一拍。段序变化只动装配顺序,各段的真源与空态判据不变。 */}
+40
View File
@@ -24,6 +24,7 @@ jest.mock('./home-content-v16', () => ({
<div data-testid="news-count">{(props.news as unknown[])?.length ?? 0}</div>
<div data-testid="hero-data">{props.heroData ? JSON.stringify(props.heroData) : 'null'}</div>
<div data-testid="page-copy-data">{props.pageCopy ? JSON.stringify(props.pageCopy) : 'null'}</div>
<div data-testid="cms-state">{String(props.cmsState ?? '')}</div>
</div>
);
},
@@ -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();
});
});
+13 -1
View File
@@ -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<string, unknown> | null;
// 信任信号:后台可覆盖,未配置则回到 constants 里那份带 source 的真实信号
@@ -65,6 +70,12 @@ export default async function HomePage() {
? (copyData!.trustSignals as Record<string, unknown>[])
: [...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 (
<HomeContentV16
services={services}
@@ -75,6 +86,7 @@ export default async function HomePage() {
news={news}
pageCopy={copyData}
trustSignals={trustSignals}
cmsState={cmsState}
/>
);
}