문제: 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
73 lines
2.7 KiB
TypeScript
73 lines
2.7 KiB
TypeScript
import { matchRoutes } from "react-router-dom";
|
|
|
|
import {
|
|
contractRoutePaths,
|
|
type BoundedContextModule,
|
|
} from "../contexts/bounded-context-module.ts";
|
|
import { assertWithinCardinalityBudget } from "../platform/cardinality/cardinality-budget.ts";
|
|
|
|
export type DeployableAppModule<Context extends BoundedContextModule = BoundedContextModule> = Readonly<{
|
|
id: string;
|
|
contexts: readonly Context[];
|
|
budget: Readonly<{ maxContexts: number }>;
|
|
}>;
|
|
|
|
export function defineDeployableAppModule<const Context extends BoundedContextModule>(
|
|
definition: Readonly<{
|
|
id: string;
|
|
contexts: readonly Context[];
|
|
budget: Readonly<{ maxContexts: number }>;
|
|
}>,
|
|
): DeployableAppModule<Context> {
|
|
assertWithinCardinalityBudget(
|
|
`${definition.id}.contexts`,
|
|
definition.contexts.length,
|
|
definition.budget.maxContexts,
|
|
);
|
|
const seen = new Set<string>();
|
|
for (const context of definition.contexts) {
|
|
if (seen.has(context.id)) {
|
|
throw new TypeError(`Duplicate ${definition.id}.contexts child id: ${context.id}`);
|
|
}
|
|
seen.add(context.id);
|
|
}
|
|
assertFeatureRoutesReachOwningContext(definition.contexts);
|
|
return Object.freeze({
|
|
...definition,
|
|
contexts: Object.freeze([...definition.contexts]),
|
|
budget: Object.freeze({ ...definition.budget }),
|
|
});
|
|
}
|
|
|
|
/**
|
|
* 09-06. The router mounts one gateway per context at its route root and
|
|
* renders a feature route only inside that gateway, while the route registry
|
|
* and navigation list every feature route wherever it points. A route its
|
|
* owning root does not reach (outside the root, at the platform home, or
|
|
* under another context's identical or more specific root) would be a menu
|
|
* link to NOT_FOUND. Matching uses the router's own ranking, so nested roots
|
|
* stay allowed as long as each route lands in its owner. Platform routes are
|
|
* not checked here.
|
|
*/
|
|
function assertFeatureRoutesReachOwningContext(
|
|
contexts: readonly BoundedContextModule[],
|
|
): void {
|
|
const roots = contexts.flatMap((context) =>
|
|
context.route ? [{ id: context.id, path: context.route.path }] : [],
|
|
);
|
|
for (const context of contexts) {
|
|
for (const feature of context.features) {
|
|
for (const [routeId, path] of contractRoutePaths(feature.contracts)) {
|
|
const reached = matchRoutes(roots, path)?.[0]?.route;
|
|
if (reached?.id === context.id) continue;
|
|
throw new TypeError(
|
|
`Route ${routeId} (${path}) of feature ${feature.id} is not under the route root of its context ${context.id} (${context.route?.path ?? "no route root"}): ` +
|
|
(reached
|
|
? `context ${reached.id} (${reached.path}) takes that URL.`
|
|
: "the router would answer NOT_FOUND."),
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|