문제: context gateway는 적재한 라우트의 handle `routeId`가 가리키는
등록 라우트를 그린다. `context-routes.ts`가 기능 계약에 없는 route id를
handle에 실으면(오타, 계약에서 지운 라우트) 적재는 성공하고, 그 URL을
그릴 때 context 경계 실패 화면이 된다. 7139c7c가 리뷰의 (1)(2)를 했고
(3) "핸들의 route id가 레지스트리에 있는가"는 설계 선택으로 남겼다.
고른 방법: 적재 때 검사한다. `defineBoundedContextModule`이
`route.loadRoutes`를 감싸, 적재한 각 라우트의 handle `routeId`가 그
context 기능들의 계약 라우트 id에 없으면 TypeError로 실패한다. 메시지에
route id, context id, 기능 id를 담는다. handle에 `routeId`가 없어도
실패한다(gateway는 그 라우트를 NOT_FOUND로 그린다).
- 모든 context가 이 함수를 거치므로(생성된 product-context-index) 모든
context에 걸린다. 모든 context의 라우트를 적재하는 기존 단위 테스트
(tests/unit/route-runtime.test.ts)가 개발 단계에서 잡는다.
- 적재 실패는 09-09(de48db2)의 "청크 누락이 아닌 적재 실패" 경로로
context 경계에 가서 `ui.render.failed` 진단을 남긴다. 테스트로 확인했다.
- 라우트는 계속 늦게 읽는다. context를 정의할 때는 loadRoutes를 부르지
않는다.
- 7139c7c의 `contractRoutePaths`를 bounded-context-module.ts로 옮겨
앱 모듈과 같이 쓴다. "계약 라우트"의 정의가 한 곳에 남는다.
- starter-experience.md 기능 추가 3단계에 규칙을 적었다.
버린 대안:
- 헬퍼로 제공: 그 헬퍼를 쓰는 context만 지킨다. 안 쓰면 그만이다.
- 생성기에서 검사: 생성기는 정규식으로 리터럴만 읽어 handle을 모른다.
위험·한계:
- 생성된 index는 기능별 라우트를 합쳐서 돌려주므로, 어느 기능의
`context-routes.ts`가 잘못된 handle을 냈는지는 알 수 없다. 메시지는
그 context의 기능 id 전부를 적는다. 기능이 하나인 context(지금
reference)는 정확하다.
- 최상위 라우트만 본다. 지금 context 라우트는 평평하다. children을 쓰는
context가 생기면 재귀가 필요하다.
- `defineBoundedContextModule`을 거치지 않고 손으로 만든 context 객체는
검사되지 않는다. 그 경우는 기존처럼 렌더 때 context 경계가 잡는다.
- 등록 라우트가 없는 URL에서 난 적재 실패는 진단 route_id가 NOT_FOUND다.
레지스트리의 NOT_FOUND splat이 모든 URL에 맞아 gateway의
`?? routeModule.id` 대체가 쓰이지 않는다. 09-09의 동작이고 고치지 않았다.
- 초기 JS gzip +141 B(203,818 -> 203,959 B, 여유 982 -> 841 B).
같은 worktree에서 `vite build` 두 번으로 쟀다.
검증:
- RED: tests/architecture/context-route-roots.test.ts 새 3건 중 거절
2건이 "promise resolved ... instead of rejecting"으로 실패(10건 중 2
실패). tests/component/context-boundary-diagnostics.test.tsx 새 1건이
route_id "FIXTURE_ITEMSS"(렌더 때 경계)로 실패.
- GREEN: 두 파일 10건, 4건 통과.
- 회귀: tests/{architecture,unit,features,platform,component,contract,
runtime-schema,integration,scripts,scale}(pnpm을 띄우는 4개 제외)
296 files 중 3,383 통과, 1건 실패. 실패는 telemetry-storm.test.ts의
10초 timeout(부하 34)이고 단독 재실행에서 4건 통과했다.
check-registries, check-adapter-inventory 통과.
- tsc app·test·node 통과. 바꾼 파일 eslint 통과.
verify-documentation-readiness PASS_SCOPED.
- check:architecture는 pnpm이 필요해 돌리지 않았다.
Refs: docs/reviews/2026-11-01-maturity-review/09-app-core.md 09-06
165 lines
5.4 KiB
TypeScript
165 lines
5.4 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { render, screen } from "@testing-library/react";
|
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
|
|
import { ApplicationProvider } from "../../src/presentation/providers/application-provider.tsx";
|
|
import { PreferenceProviders } from "../../src/presentation/providers/preference-providers.tsx";
|
|
import { AppRouter } from "../../src/presentation/routes/app-router.tsx";
|
|
import { createTestApplication } from "../helpers/create-test-application.ts";
|
|
|
|
/**
|
|
* 09-09 (0929/08-05). Failures the context gateway catches outside a route's
|
|
* own boundary: the context boundary (a route handle naming an unregistered
|
|
* route), the feature boundary (a handle without the codecs its route needs)
|
|
* and a routes module that fails for a reason other than a missing chunk.
|
|
* Each has to leave a `ui.render.failed` record whose incident id the screen
|
|
* shows as `<buildId>:<incidentId>`.
|
|
*/
|
|
vi.mock("../../src/.generated/product-feature-index.ts", async () => ({
|
|
DECLARED_PRODUCT_FEATURE_IDS: ["fixture-feature"],
|
|
PRODUCT_FEATURE_MODULES: [(await import("../helpers/fixture-feature.tsx")).FIXTURE_FEATURE_MODULE],
|
|
}));
|
|
vi.mock("../../src/apps/template-app.ts", async () => {
|
|
const { FIXTURE_CONTEXT_ROUTES, FIXTURE_FEATURE_MODULE } = await import(
|
|
"../helpers/fixture-feature.tsx"
|
|
);
|
|
const { defineBoundedContextModule } = await import(
|
|
"../../src/contexts/bounded-context-module.ts"
|
|
);
|
|
const items = FIXTURE_CONTEXT_ROUTES.find((route) => route.id === "FIXTURE_ITEMS");
|
|
const runtime = (items?.handle as { runtime: unknown }).runtime;
|
|
return {
|
|
TEMPLATE_APP_MODULE: {
|
|
id: "boundary-app",
|
|
budget: { maxContexts: 4 },
|
|
contexts: [
|
|
// 09-06 (3). A context defined the regular way refuses the same typo
|
|
// when its routes load, before anything renders.
|
|
defineBoundedContextModule({
|
|
id: "context-checked-typo",
|
|
features: [FIXTURE_FEATURE_MODULE],
|
|
budget: { maxFeatures: 1 },
|
|
route: {
|
|
path: "fixture/checked/*",
|
|
loadRoutes: async () => [
|
|
{
|
|
id: "FIXTURE_ITEMSS",
|
|
path: "/fixture/checked",
|
|
handle: { routeId: "FIXTURE_ITEMSS", runtime },
|
|
},
|
|
],
|
|
},
|
|
}),
|
|
{
|
|
id: "context-without-codecs",
|
|
route: {
|
|
path: "fixture/items/*",
|
|
loadRoutes: async () => [
|
|
{
|
|
id: "FIXTURE_ITEMS",
|
|
path: "/fixture/items",
|
|
handle: { routeId: "FIXTURE_ITEMS", runtime },
|
|
},
|
|
],
|
|
},
|
|
},
|
|
{
|
|
id: "context-with-typo",
|
|
route: {
|
|
path: "fixture/items/status/*",
|
|
loadRoutes: async () => [
|
|
{
|
|
id: "FIXTURE_ITEM_STATUSS",
|
|
path: "/fixture/items/status",
|
|
handle: { routeId: "FIXTURE_ITEM_STATUSS", runtime },
|
|
},
|
|
],
|
|
},
|
|
},
|
|
{
|
|
id: "context-broken",
|
|
route: {
|
|
path: "fixture/items/new/*",
|
|
loadRoutes: async () => {
|
|
throw new ReferenceError("pageComponent is not defined");
|
|
},
|
|
},
|
|
},
|
|
],
|
|
},
|
|
};
|
|
});
|
|
|
|
afterEach(() => {
|
|
vi.restoreAllMocks();
|
|
});
|
|
|
|
async function expectReportedFailure(
|
|
url: string,
|
|
expected: Readonly<{ routeId: string; boundary: "route" | "feature" }>,
|
|
) {
|
|
// React logs every caught render error; the assertions below are the point.
|
|
vi.spyOn(console, "error").mockImplementation(() => {});
|
|
const record = vi.fn();
|
|
window.history.pushState({}, "", url);
|
|
render(
|
|
<ApplicationProvider
|
|
application={createTestApplication({ diagnostics: { record } })}
|
|
>
|
|
<PreferenceProviders>
|
|
<AppRouter buildId="build-a" />
|
|
</PreferenceProviders>
|
|
</ApplicationProvider>,
|
|
);
|
|
|
|
const reference = await screen.findByText(/^지원 참조: build-a:[0-9a-f]{8}$/);
|
|
const incidentId = reference.textContent?.split(":").at(-1);
|
|
const failures = record.mock.calls
|
|
.map(([event]) => event as { eventId: string; context: Record<string, unknown> })
|
|
.filter((event) => event.eventId === "ui.render.failed");
|
|
expect(failures).toEqual([
|
|
{
|
|
level: "error",
|
|
eventId: "ui.render.failed",
|
|
context: {
|
|
route_id: expected.routeId,
|
|
build_id: "build-a",
|
|
component_boundary: expected.boundary,
|
|
correlation_id: incidentId,
|
|
},
|
|
},
|
|
]);
|
|
}
|
|
|
|
describe("context gateway failure diagnostics", () => {
|
|
it("reports what the context boundary catches", async () => {
|
|
await expectReportedFailure("/fixture/items/status", {
|
|
routeId: "FIXTURE_ITEM_STATUSS",
|
|
boundary: "route",
|
|
});
|
|
});
|
|
|
|
it("reports what the feature boundary catches", async () => {
|
|
await expectReportedFailure("/fixture/items", {
|
|
routeId: "FIXTURE_ITEMS",
|
|
boundary: "feature",
|
|
});
|
|
});
|
|
|
|
it("reports a routes module that fails without a missing chunk", async () => {
|
|
await expectReportedFailure("/fixture/items/new", {
|
|
routeId: "FIXTURE_ITEM_FORM",
|
|
boundary: "route",
|
|
});
|
|
});
|
|
|
|
it("reports an unregistered handle refused while the routes load", async () => {
|
|
// No feature route owns this URL; the registry's NOT_FOUND splat does.
|
|
await expectReportedFailure("/fixture/checked", {
|
|
routeId: "NOT_FOUND",
|
|
boundary: "route",
|
|
});
|
|
});
|
|
});
|