Files
clean-architecture-frontend…/tests/component/starter-platform-overview-route.test.tsx
T
DongHyeonka d549ceb330 perf(examples): 플랫폼 구성 화면이 제목을 먼저 그리고 실행부 표만 기다린다
문제
lab 게이트 FE-GATE-026은 내비게이션 클릭부터 플랫폼 구성 화면 제목이
보일 때까지를 잰다. 298201f 뒤로 이 route module은 그리기 전에
loadInstalledFeatureRuntimeRegistries()를 기다린다. 그 함수는 설치된
모든 기능의 실행부를 dynamic import한다. 그래서 클릭 뒤 요청 묶음이
두 번이 되고 상호작용 중앙값이 117 -> 227 ms가 됐다(예산 200 ms).

고른 방법 (영역 문서 최소 개선 방향 (c))
- route module은 페이지 컴포넌트를 바로 돌려준다(default export).
  제목·릴리스·라우트 표·서버 상태·능력·기능 상태처럼 선언과 런타임
  snapshot으로 아는 것은 바로 그린다.
- 실행부가 있어야 아는 것(HTTP 오퍼레이션 수, 픽스처 수, 오퍼레이션
  표, 검증 생략 표)만 Suspense 경계 두 곳 뒤에서 use()로 채운다.
- 실행부 조립 모듈도 dynamic import로 바꿔 제목이 기다리는 페이지
  청크에서 뺐다(첫 요청 묶음 8,095 -> 6,919 B).
- 기능 사이 중복은 여전히 이 화면에서 throw하고 route 경계로 간다.
  실패한 load는 캐시에서 지워 다음 방문 때 다시 시도한다.
- 버린 대안: 예산 300 ms(회귀를 숨김), lab 대상 라우트 변경(같은
  이유), hover 프리페치(키보드·직접 진입에 효과 작음).

위험·한계
- 화면 안에 "기능 실행부를 불러오고 있습니다." 로딩 상태가 생긴다.
- PlatformOverviewPage의 contracts prop이 Promise가 됐다. 이 컴포넌트를
  직접 쓰는 다운스트림 테스트는 Promise를 넘기고 act로 기다려야 한다.
- 첫 요청 묶음은 d99301b보다 여전히 크다(6,919 vs 5,019 B). 그 사이
  페이지가 커졌고 badge·card가 공유 청크로 갈라졌다. 그래서 d99301b보다
  약 30 ms 느리다.
- 실제 CI 러너에서는 재지 않았다.

검증
- 새 component 테스트(실행부 load가 끝나지 않아도 제목·라우트 표가
  보이고 오퍼레이션 표만 로딩): 수정 전 실패, 수정 뒤 통과.
- test:component 통과. check:types, check:architecture, 바뀐 파일
  eslint 통과.
- lab A/B(heavy lock, 같은 호스트, d99301b worktree와 번갈아,
  test:performance --runs=5, CHOKIDAR_USEPOLLING=1, 이 브랜치 끝 기준):
  부하 19 -> 11에서 d99301b 107·106 ms PASS, 이 변경 136·134 ms PASS.
  LCP 1,968·1,984 ms, CLS 0. (같은 날 다른 묶음 한 번은 두 쪽 모두
  홈 링크를 30초 안에 찾지 못해 측정 전에 끝났다. 포트를 바꿔 다시
  잰 것이 위 결과다.)
- 요청 추적: 클릭 뒤 제목은 첫 묶음(페이지 청크 4개) 뒤에 나오고,
  feature-runtime·reference-schemas는 제목 뒤에 받는다.

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-01
2026-11-04 22:59:03 +09:00

55 lines
2.2 KiB
TypeScript

// @vitest-environment jsdom
import { render, screen, within } from "@testing-library/react";
import { Suspense } from "react";
import { describe, expect, it, vi } from "vitest";
import { ROUTE_REGISTRY } from "../../src/features/installed-feature-contracts.ts";
import { LocaleProvider } from "../../src/presentation/i18n/index.ts";
import { ApplicationProvider } from "../../src/presentation/providers/application-provider.tsx";
import { PLATFORM_ROUTE_RUNTIME } from "../../src/presentation/routes/route-runtime.tsx";
import { createTestApplication } from "../helpers/create-test-application.ts";
// The feature runtimes never arrive: the route must not wait for them.
vi.mock("../../src/features/installed-feature-runtime-registries.ts", () => ({
loadInstalledFeatureRuntimeRegistries: () => new Promise(() => {}),
}));
/**
* 1103/15-01. The lab gate (FE-GATE-026) times this route from the click to
* its heading. Its route module used to await every installed feature's
* runtime half first, which added a second request round to the click.
*/
describe("platform overview route module", () => {
it("draws the title and the declared routes before the feature runtimes load", async () => {
const Page = PLATFORM_ROUTE_RUNTIME.EXAMPLES_PLATFORM.Component;
render(
<ApplicationProvider application={createTestApplication()}>
<LocaleProvider>
<Suspense fallback={<p>route chunk</p>}>
<Page />
</Suspense>
</LocaleProvider>
</ApplicationProvider>,
);
expect(
await screen.findByRole("heading", { level: 1, name: "플랫폼 구성" }),
).toBeVisible();
const routes = screen.getByRole("table", { name: "설치된 라우트 목록" });
expect(within(routes).getAllByRole("row").slice(1)).toHaveLength(
Object.keys(ROUTE_REGISTRY).length,
);
// Only the part read from the runtime halves waits.
const contracts = screen.getByRole("region", {
name: "계약과 HTTP 오퍼레이션",
});
expect(
within(contracts).getByLabelText("기능 실행부를 불러오고 있습니다."),
).toBeVisible();
expect(
screen.queryByRole("table", { name: "설치된 HTTP 오퍼레이션" }),
).toBeNull();
});
});