# Reference feature ownership and removal 이 모듈은 제품 도메인이 아니라 새 기능의 수직 경계를 검증하는 제거 가능한 reference implementation이다. ## 소유 경계 - `domain`: 외부 DTO와 React를 모르는 불변 model - `application`: UI가 호출하는 list/get/create input과 gateway 계약 - `adapters`: HTTP executor를 gateway로 투영하는 outbound adapter - `contracts`: route/API/query contribution, Zod DTO와 request schema, mapper - `presentation`: route input을 query/form controller로 연결하는 inbound adapter, 독립 form schema/command mapper와 list/detail/form/status page generic application은 비어 있는 `ApplicationFeatureInputs`와 typed `features.has/get/load` registry만 소유한다. input은 reference route에 처음 들어갈 때 router가 `features.load`로 실행부를 적재한 뒤에 생긴다. 이 feature의 application API가 module augmentation으로 `"reference-feature": ReferenceFeatureInput`을 기여하므로 등록되지 않은 ID와 잘못된 input shape는 typecheck에서 거절된다. feature hook은 별도 cast나 runtime shape 확인 없이 정확한 input type을 받는다. 다만 동적 호출로 설치되지 않은 ID가 들어오는 경우를 위해 `get`의 runtime guard도 유지한다. 예측 가능한 실패는 canonical shared contract인 `src/contracts/result.ts`의 `Result`로 반환한다. `src/application/result.ts`는 기존 호출자를 위한 deprecated migration shim일 뿐 새 코드의 import 경로가 아니다. `AppFailure.kind`는 `ERROR_REGISTRY` key에서 파생된 닫힌 vocabulary다. 폐기된 별칭 `ApiFailure` 대신 `AppFailure`를 import한다(lint가 막는다). mapper는 `boundary-mapper.ts`의 `BoundaryMappingResult`를 반환한다. HTTP adapter는 `src/adapters/http/feature-http-binding.ts`의 capability-specific typed binding을 사용한다. feature는 operation ID, route ID, request type, 성공 value type, mapper만 소유한다. timeout/cancellation/auth/transport/contract violation을 `AppFailure`로 정규화하는 책임은 reusable HTTP capability가 소유한다. 따라서 gateway 메서드는 transport outcome이나 runtime result guard를 반복 구현하지 않고도 정확한 결과 타입을 반환한다. route codec과 URL builder는 `src/presentation/routes/route-codecs.ts`, route type은 `route-contract.ts`, React context/provider/hook은 `route-input.tsx`가 각각 소유한다. reference page는 `app-router.tsx`를 역참조하지 않고 좁은 `useRouteInput` 경계만 사용하므로 lazy route와 router 사이의 순환 의존을 만들지 않는다. page는 HTTP client, storage, auth owner, output port나 TanStack API를 직접 import하지 않는다. page는 경로 문자열을 적지 않는다. 경로는 계약의 `path` 한 곳에만 있다. `presentation/reference-routes.ts`가 다음 helper를 둔다. 이 기능의 route codec은 `presentation/reference-route-codecs.ts`에 있다. - 링크: `referenceRouteUrl(routeId, { params, search })`. 위 `buildRouteUrl`에 이 기능의 codec을 넘긴다. - route 입력: `useReferenceListFilters()`, `useReferenceResourceId()`. 이미 통과한 codec으로 다시 읽어 cast 없이 타입을 얻는다. ## 설치 지점 feature가 실제 contribution을 소유한다. - 선언(초기 청크, `feature-module.ts`): route 표와 invalidation은 `reference-feature-contract.ts`, 문구는 `reference-message-catalog.ts` - 실행부(`feature-runtime.ts`, reference route에 들어갈 때 적재): 스키마 메타데이터 `reference-schema-metadata.ts`, bootstrap input `REFERENCE_FEATURE_ADAPTER_CONTRIBUTION`, HTTP contract contribution - route codec과 page component: `REFERENCE_FEATURE_ROUTE_CODECS`, `REFERENCE_FEATURE_ROUTE_RUNTIME` (`context-routes.ts`가 route handle에 실어 lazy로 적재) `feature-module.ts`는 `feature-runtime.ts`를 동적 import로만 가리킨다. 정적 import로 바꾸면 실행부 전체가 다시 초기 청크에 들어간다(15-01). 중앙 파일인 `installed-feature-contracts.ts`, `installed-feature-adapters.ts`, `installed-contract-contributions.ts`는 선택된 contribution을 합치는 역할만 한다. 새 기능의 내부 조립 규칙을 중앙 catalog에 추가하지 않는다. ## 검증과 제거 ```sh corepack pnpm test:reference-feature corepack pnpm test:sample-removal ``` 첫 명령은 URL filter와 query key/HTTP request의 동일성, schema/mapper, 모든 query/mutation/form 상태와 production composition을 검증한다. 두 번째 명령은 임시 복제본에서 이 source/test 디렉터리를 제거하고 installed catalog를 빈 목록으로 재생성한다. feature 소유 coverage include, risk-policy 행과 test-evidence contribution도 제거한 뒤 typecheck, architecture, registry, unit/integration, coverage, source evidence, home smoke, production build와 source/built fixture ID 잔여 0개를 검사한다. generic feature registry의 성공 경로는 reference와 무관한 unit test가 소유하므로 feature 삭제 후에도 공통 boundary coverage가 유지된다. CI의 negative type fixture는 잘못된 feature ID/input shape, registry에 없는 failure kind, operation과 route ID의 불일치가 실제로 컴파일 실패하는지도 검증한다. Architecture fixture는 허용 edge뿐 아니라 unresolved import, 금지 계층 edge와 TypeScript 순환 의존을 각각 거절해야 통과한다.