refactor(server-state): 아무도 읽지 않는 쿼리·뮤테이션 정의 칸을 선택 칸으로 둔다
문제 QueryDefinition의 owner·operationId와 BoundMutation의 owner는 필수 칸이다. bindQuery가 돌려주는 객체에는 둘 다 없고, src 어디서도 읽지 않는다. 기능 작성자는 효과 없는 값을 매번 채우고, 매뉴얼은 그 오타를 "못 잡는 위험"으로 적어 오히려 신경 쓰게 한다(리뷰 16-06 ①②). 고른 방법 세 칸을 @deprecated 선택 칸으로 바꾼다. 참조 기능과 생성 뼈대는 더는 채우지 않는다. 요청 기록의 operation ID는 지금처럼 descriptor에서 온다. 매뉴얼 6·7단계와 patterns.md에 "적지 않는다"와, 라우트 계약 title· navigationLabel을 무엇이 읽는지(FE-REG-ROUTE, lab 측정)를 적었다. 버린 대안 - 칸을 바로 지우기: 객체 리터럴의 초과 속성 검사로 테스트 3파일과 다운스트림 정의가 컴파일 오류가 난다. 선택 칸으로 한 릴리스 두고 지운다. - 쿼리 operationId를 진단 이름표로 잇기: HTTP 실행 기록이 이미 descriptor의 operation ID를 싣는다. 같은 값을 두 번 싣는다. 위험·한계 - 라우트 계약의 title·navigationLabel(16-06 ③)은 그대로 둔다. 지우려면 FE-REG-ROUTE 기준선 행을 catalog에서 만들고, 플랫폼 라우트와 test-performance.ts를 함께 바꿔야 한다. 다른 작업(예제 화면 이동)과 같은 파일이라 이번에는 문서로만 적었다. 검증 - RED: application-query-scope-fence 새 테스트가 tsconfig.test에서 owner· operationId 누락으로 타입 오류. 선택 칸으로 바꾼 뒤 통과. - tests/features/reference-feature, tests/unit/create-feature.test.ts, scope-fence 129건 통과. check:types(app·node·test), lint 통과. Refs: docs/reviews/2026-11-03-maturity-review/16-structure-patterns.md 16-06
This commit is contained in:
@@ -880,7 +880,7 @@ export function ${camel}RouteUrl(
|
||||
`;
|
||||
}
|
||||
|
||||
function renderUseItems({ names, operationId }: Shape): string {
|
||||
function renderUseItems({ names }: Shape): string {
|
||||
const { base, pascal, upper } = names;
|
||||
return `import { bindQuery, type QueryResultMeasure } from "../../../contracts/server-state.ts";
|
||||
import { useApplicationQuery } from "../../../presentation/adapters/query/application-query.ts";
|
||||
@@ -916,9 +916,7 @@ export function use${pascal}Items() {
|
||||
{
|
||||
definitionId: "${base}-item-list-v1",
|
||||
definitionVersion: 1,
|
||||
owner: ${upper}_FEATURE_ID,
|
||||
namespace: ${upper}_ITEM_QUERY_NAMESPACE,
|
||||
operationId: "${operationId}",
|
||||
profileId: "LIST_STANDARD",
|
||||
measureResult: measureItems,
|
||||
execute: (_input: typeof NO_INPUT, { signal }) => input.listItems({ signal }),
|
||||
|
||||
Reference in New Issue
Block a user