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:
1 parent
81dc70b86c
commit
a5ce27c6ec
3 files changed
+57
-2
No files matched your search
@@ -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 后的一条窄带,
|
||||
不抢「新闻」这一拍。段序变化只动装配顺序,各段的真源与空态判据不变。 */}
|
||||
|
||||
@@ -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();
|
||||
});
|
||||
});
|
||||
@@ -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}
|
||||
/>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user