Files
tech-log-frontend/src/features/tech-log/presentation/tech-log-route-runtime.tsx
T
DongHyeonka 02cf5ed3f9 perf(studio): Studio 셸을 /studio에 들어갈 때 받는다
문제
라우트 레이아웃 표(tech-log-route-runtime.tsx)가 StudioShell을 정적으로
가져와, 공개 화면의 초기 JS에 StudioProvider·Studio 머리말·문서 server
state가 들어갔다.

고른 방법
- STUDIO 레이아웃은 lazy StudioShell을 Suspense와 ChunkRecoveryBoundary로
  감싼다. 청크를 못 받으면 라우트 청크와 같은 recoverChunk가 한 번 새로
  읽기를 정한다(chunkId `tech-log-studio-shell`).
- tests/features/tech-log/boot-graph.test.ts가 부팅 그래프(main.tsx, 그
  정적 import, 진입점이 바로 동적으로 읽는 boot·render-boot-failure)를
  빌드 없이 따라가, MOCK 소스·정적 콘텐츠·Studio 화면·HTTP Studio
  gateway가 다시 들어오지 않는지 본다. 공개 셸과 기능 입력 조립이
  그래프에 있는지도 봐서 빈 결과로 통과하지 않는다.

버린 대안
- 템플릿 소유 app-router.tsx에서 레이아웃 route에 lazy를 거는 것: 템플릿
  파일을 고치게 되고, 자식 화면 청크는 여전히 셸 뒤에 받는다.

위험·한계
- /studio 첫 진입은 셸 청크를 받은 뒤 화면 청크를 받는다(직렬 왕복 하나).
  Studio는 작성자 한 사람이 쓰는 화면이다.
- 셸을 받는 동안 LoadingSurface가 보인다.

검증
- desktop CI env 빌드: 앞 커밋과 함께 초기 JS 300,869 → 232,337 B.
- boot-graph.test.ts 통과.
2026-11-12 22:33:48 +09:00

333 lines
8.8 KiB
TypeScript

import {
lazy,
Suspense,
type ComponentType,
type LazyExoticComponent,
type ReactNode,
} from "react";
import { Outlet } from "react-router-dom";
import { ChunkRecoveryBoundary } from "../../../presentation/boundaries/chunk-recovery-boundary.tsx";
import { LoadingSurface } from "../../../presentation/design-system/index.ts";
import { useApplicationRecovery } from "../../../presentation/providers/application-provider.tsx";
import {
TECH_LOG_ROUTE_RUNTIME_CONTRACT,
type TechLogRouteId,
} from "../contracts/tech-log-route-contract.ts";
import { PublicShell } from "./public/public-shell.tsx";
/*
Studio 셸은 공개 화면을 읽는 사람에게 필요 없다. 정적으로 가져오면 셸이 끌고 오는
StudioProvider·Studio 머리말·문서 server state 가 모든 첫 화면의 초기 JS 에 들어갔다
(FE-GATE-012). /studio 에 들어갈 때 받는다. 라우트 청크와 같이 청크를 못 받으면
ChunkRecoveryBoundary 가 한 번 새로 읽기를 정한다.
*/
const StudioShell = lazy(async () => {
const module = await import("./studio/studio-shell.tsx");
return { default: module.StudioShell };
});
function DeferredStudioShell({ children }: Readonly<{ children: ReactNode }>) {
const recovery = useApplicationRecovery();
return (
<ChunkRecoveryBoundary
chunkId="tech-log-studio-shell"
recover={recovery.recoverChunk}
>
<Suspense fallback={<LoadingSurface />}>
<StudioShell>{children}</StudioShell>
</Suspense>
</ChunkRecoveryBoundary>
);
}
type RouteRuntime = Readonly<{
moduleId: string;
Component: LazyExoticComponent<ComponentType>;
}>;
function runtime(
routeId: TechLogRouteId,
load: () => Promise<{ default: ComponentType }>,
): RouteRuntime {
return Object.freeze({
moduleId: TECH_LOG_ROUTE_RUNTIME_CONTRACT[routeId].moduleId,
Component: lazy(load),
});
}
function routeModule<Module, Key extends keyof Module>(
load: () => Promise<Module>,
key: Key,
): () => Promise<{ default: Extract<Module[Key], ComponentType> }> {
return async () => {
const module = await load();
return { default: module[key] as Extract<Module[Key], ComponentType> };
};
}
export const TECH_LOG_ROUTE_RUNTIME = Object.freeze({
TECH_LOG_HOME: runtime(
"TECH_LOG_HOME",
routeModule(() => import("./public/pages/home-page.tsx"), "HomePage"),
),
TECH_LOG_EXPLORE: runtime(
"TECH_LOG_EXPLORE",
routeModule(
() => import("./public/pages/explore-page.tsx"),
"ExplorePage",
),
),
TECH_LOG_EXPLORE_KIND: runtime(
"TECH_LOG_EXPLORE_KIND",
routeModule(
() => import("./public/pages/explore-kind-page.tsx"),
"ExploreKindPage",
),
),
TECH_LOG_CASE: runtime(
"TECH_LOG_CASE",
routeModule(() => import("./public/pages/case-page.tsx"), "CasePage"),
),
TECH_LOG_REFERENCE: runtime(
"TECH_LOG_REFERENCE",
routeModule(
() => import("./public/pages/reference-page.tsx"),
"ReferencePage",
),
),
TECH_LOG_CONCEPT: runtime(
"TECH_LOG_CONCEPT",
routeModule(
() => import("./public/pages/concept-page.tsx"),
"ConceptPage",
),
),
TECH_LOG_SETUP: runtime(
"TECH_LOG_SETUP",
routeModule(
() => import("./public/pages/setup-page.tsx"),
"SetupPage",
),
),
TECH_LOG_QUESTION: runtime(
"TECH_LOG_QUESTION",
routeModule(
() => import("./public/pages/question-page.tsx"),
"QuestionPage",
),
),
TECH_LOG_TOPICS: runtime(
"TECH_LOG_TOPICS",
routeModule(
() => import("./public/pages/topics-page.tsx"),
"TopicsPage",
),
),
TECH_LOG_TOPIC: runtime(
"TECH_LOG_TOPIC",
routeModule(() => import("./public/pages/topic-page.tsx"), "TopicPage"),
),
TECH_LOG_TOPIC_VARIANT: runtime(
"TECH_LOG_TOPIC_VARIANT",
routeModule(
() => import("./public/pages/topic-variant-page.tsx"),
"TopicVariantPage",
),
),
TECH_LOG_PROJECTS: runtime(
"TECH_LOG_PROJECTS",
routeModule(
() => import("./public/pages/projects-page.tsx"),
"ProjectsPage",
),
),
TECH_LOG_PROJECT: runtime(
"TECH_LOG_PROJECT",
routeModule(
() => import("./public/pages/project-overview-page.tsx"),
"ProjectOverviewPage",
),
),
TECH_LOG_PROJECT_RECORDS: runtime(
"TECH_LOG_PROJECT_RECORDS",
routeModule(
() => import("./public/pages/project-records-page.tsx"),
"ProjectRecordsPage",
),
),
TECH_LOG_PROJECT_DECISIONS: runtime(
"TECH_LOG_PROJECT_DECISIONS",
routeModule(
() => import("./public/pages/project-decisions-page.tsx"),
"ProjectDecisionsPage",
),
),
TECH_LOG_PROJECT_ACTIVITY: runtime(
"TECH_LOG_PROJECT_ACTIVITY",
routeModule(
() => import("./public/pages/project-activity-page.tsx"),
"ProjectActivityPage",
),
),
TECH_LOG_RELEASES: runtime(
"TECH_LOG_RELEASES",
routeModule(
() => import("./public/pages/releases-page.tsx"),
"ReleasesPage",
),
),
TECH_LOG_RELEASE: runtime(
"TECH_LOG_RELEASE",
routeModule(
() => import("./public/pages/release-page.tsx"),
"ReleasePage",
),
),
TECH_LOG_PROFILE: runtime(
"TECH_LOG_PROFILE",
routeModule(
() => import("./public/pages/profile-page.tsx"),
"ProfilePage",
),
),
TECH_LOG_SEARCH: runtime(
"TECH_LOG_SEARCH",
routeModule(() => import("./public/pages/search-page.tsx"), "SearchPage"),
),
TECH_LOG_STUDIO_HOME: runtime(
"TECH_LOG_STUDIO_HOME",
routeModule(
() => import("./studio/pages/studio-home-page.tsx"),
"StudioHomePage",
),
),
TECH_LOG_STUDIO_DOCUMENTS: runtime(
"TECH_LOG_STUDIO_DOCUMENTS",
routeModule(
() => import("./studio/pages/documents-page.tsx"),
"DocumentsPage",
),
),
TECH_LOG_STUDIO_DOCUMENT_NEW: runtime(
"TECH_LOG_STUDIO_DOCUMENT_NEW",
routeModule(
() => import("./studio/pages/new-document-page.tsx"),
"NewDocumentPage",
),
),
TECH_LOG_STUDIO_DOCUMENT_EDIT: runtime(
"TECH_LOG_STUDIO_DOCUMENT_EDIT",
routeModule(
() => import("./studio/pages/document-edit-page.tsx"),
"DocumentEditPage",
),
),
TECH_LOG_STUDIO_DOCUMENT_VALIDATION: runtime(
"TECH_LOG_STUDIO_DOCUMENT_VALIDATION",
routeModule(
() => import("./studio/pages/document-validation-page.tsx"),
"DocumentValidationPage",
),
),
TECH_LOG_STUDIO_DOCUMENT_PREVIEW: runtime(
"TECH_LOG_STUDIO_DOCUMENT_PREVIEW",
routeModule(
() => import("./studio/pages/document-preview-page.tsx"),
"DocumentPreviewPage",
),
),
TECH_LOG_STUDIO_DOCUMENT_PUBLISH: runtime(
"TECH_LOG_STUDIO_DOCUMENT_PUBLISH",
routeModule(
() => import("./studio/pages/document-publish-page.tsx"),
"DocumentPublishPage",
),
),
TECH_LOG_STUDIO_PUBLICATIONS: runtime(
"TECH_LOG_STUDIO_PUBLICATIONS",
routeModule(
() => import("./studio/pages/publications-page.tsx"),
"PublicationsPage",
),
),
TECH_LOG_STUDIO_PUBLICATION_PREVIEW: runtime(
"TECH_LOG_STUDIO_PUBLICATION_PREVIEW",
routeModule(
() => import("./studio/pages/publication-preview-page.tsx"),
"PublicationPreviewPage",
),
),
TECH_LOG_STUDIO_ASSETS: runtime(
"TECH_LOG_STUDIO_ASSETS",
routeModule(
() => import("./studio/pages/assets-page.tsx"),
"AssetsPage",
),
),
TECH_LOG_STUDIO_TAXONOMY: runtime(
"TECH_LOG_STUDIO_TAXONOMY",
routeModule(
() => import("./studio/pages/taxonomy-page.tsx"),
"TaxonomyPage",
),
),
TECH_LOG_STUDIO_PROJECT_EDIT: runtime(
"TECH_LOG_STUDIO_PROJECT_EDIT",
routeModule(
() => import("./studio/pages/project-edit-page.tsx"),
"ProjectEditPage",
),
),
TECH_LOG_STUDIO_TOPIC_EDIT: runtime(
"TECH_LOG_STUDIO_TOPIC_EDIT",
routeModule(
() => import("./studio/pages/topic-edit-page.tsx"),
"TopicEditPage",
),
),
TECH_LOG_STUDIO_RELEASES: runtime(
"TECH_LOG_STUDIO_RELEASES",
routeModule(
() => import("./studio/pages/releases-page.tsx"),
"StudioReleasesPage",
),
),
TECH_LOG_STUDIO_RELEASE_EDIT: runtime(
"TECH_LOG_STUDIO_RELEASE_EDIT",
routeModule(
() => import("./studio/pages/release-edit-page.tsx"),
"ReleaseEditPage",
),
),
TECH_LOG_STUDIO_NOT_FOUND: runtime(
"TECH_LOG_STUDIO_NOT_FOUND",
routeModule(
() => import("./studio/pages/studio-not-found-page.tsx"),
"StudioNotFoundPage",
),
),
NOT_FOUND: runtime(
"NOT_FOUND",
routeModule(
() => import("./public/pages/public-not-found-page.tsx"),
"PublicNotFoundPage",
),
),
}) satisfies Readonly<Record<TechLogRouteId, RouteRuntime>>;
export const TECH_LOG_ROUTE_LAYOUTS: Readonly<
Record<"PUBLIC" | "STUDIO", ReactNode>
> = Object.freeze({
PUBLIC: (
<PublicShell>
<Outlet />
</PublicShell>
),
STUDIO: (
<DeferredStudioShell>
<Outlet />
</DeferredStudioShell>
),
});