From 588ebca54f64472b85e9cdb1d2efae6b2e5ec9e0 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 12:50:28 +0900 Subject: [PATCH] =?UTF-8?q?fix(registry):=209=EC=9B=94=20=EA=B2=BD?= =?UTF-8?q?=EB=A1=9C=20=EB=B3=80=EA=B2=BD=EC=9D=84=20registry=EC=97=90=20?= =?UTF-8?q?=EB=93=B1=EB=A1=9D=ED=95=98=EA=B3=A0=20=EA=B7=BC=EA=B1=B0?= =?UTF-8?q?=EB=A5=BC=20=EB=82=A8=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit check-registries가 이 repo에서 실패한다. 9월 커밋(67a54917 주제 변형 화면, b9e29369 UX 리뷰 H1)이 경로 계약을 바꿨지만 governance와 schema registry는 그대로였다. 2026-09-29 템플릿 동기화의 baseline 승인도 「TechLog 경로 변경은 승인하지 않은 채 남긴다」고 적었다. 단위 시험 second-api-feature-registries가 이 실패를 그대로 드러냈다. - schema registry에 TechLogTopicVariantParams(route-params, REJECT_UNKNOWN)를 더한다. 코덱(tech-log-route-codecs.ts)은 이미 있다. - governance의 FE-REG-ROUTE 허용 값에 TechLogTopicVariantParams, TechLogStudioDocumentsSearch, TechLogStudioPublicationsSearch를 더한다. - breaking 변경 여섯에 근거를 남긴다: 출시 화면이 주 내비에서 빠짐 (navigationLabel·navigationOrder), Studio 문서·게시 목록이 검색·필터· 쪽수를 주소에서 읽음(searchSchema·searchCodec). baseline은 다시 만들지 않는다. 이 repo는 지금까지 breaking 변경마다 근거를 더하고 baseline은 템플릿 동기화 때만 승인했다(c5c8b942 등). 위험·한계: 근거의 내용은 이미 운영에 나간 변경을 사후에 적은 것이다. 검증: node scripts/check-registries.ts가 "11 registries PASS; compatibility=breaking"을 낸다(고치기 전 11건 실패). --- .../contracts/registry-change-evidence.json | 48 +++++++++++++++++++ config/contracts/registry-governance.json | 5 +- .../contracts/tech-log-route-contract.ts | 5 ++ 3 files changed, 57 insertions(+), 1 deletion(-) diff --git a/config/contracts/registry-change-evidence.json b/config/contracts/registry-change-evidence.json index a63998d..73564a6 100644 --- a/config/contracts/registry-change-evidence.json +++ b/config/contracts/registry-change-evidence.json @@ -488,6 +488,54 @@ "compatibilityWindow": "The deployed release consumes only its same-release registry snapshot; the rows leave the registries, the bundle and the contract set in one release.", "rollback": "Revert the template sync commit (rollback ref backup/main-before-template-af3d8e6), or reinstall the sample with its presentation, feature-module.ts and context-routes.ts.", "owner": "tech-log-frontend" + }, + { + "changeId": "FE-REG-ROUTE:TECH_LOG_RELEASES:navigationLabel:field-type-changed", + "versionBump": "The releases page leaves the primary navigation (navigationLabel \"변경 기록\" and navigationOrder 30 become null, 2026-09). The route, path /releases, title and chunk are unchanged.", + "migration": "Nothing to migrate: /releases still resolves and the public shell keeps its link to it (public-shell.tsx, publicSiteConfig.releasesPath); only the primary navigation entry is gone.", + "compatibilityWindow": "None needed. Bookmarks and links to /releases keep working; no route id or path changed.", + "rollback": "Restore navigationLabel \"변경 기록\" and navigationOrder 30 on TECH_LOG_RELEASES in src/features/tech-log/contracts/tech-log-route-contract.ts.", + "owner": "tech-log-frontend" + }, + { + "changeId": "FE-REG-ROUTE:TECH_LOG_RELEASES:navigationOrder:field-type-changed", + "versionBump": "The releases page leaves the primary navigation (navigationLabel \"변경 기록\" and navigationOrder 30 become null, 2026-09). The route, path /releases, title and chunk are unchanged.", + "migration": "Nothing to migrate: /releases still resolves and the public shell keeps its link to it (public-shell.tsx, publicSiteConfig.releasesPath); only the primary navigation entry is gone.", + "compatibilityWindow": "None needed. Bookmarks and links to /releases keep working; no route id or path changed.", + "rollback": "Restore navigationLabel \"변경 기록\" and navigationOrder 30 on TECH_LOG_RELEASES in src/features/tech-log/contracts/tech-log-route-contract.ts.", + "owner": "tech-log-frontend" + }, + { + "changeId": "FE-REG-ROUTE:TECH_LOG_STUDIO_DOCUMENTS:searchSchema:field-type-changed", + "versionBump": "TECH_LOG_STUDIO_DOCUMENTS reads its search, filter and page state from the URL through TechLogStudioDocumentsSearch (STRIP_UNKNOWN), 2026-09 UX review H1. Before, the list kept that state in memory and lost it on back navigation.", + "migration": "Old links without a query string open the list unfiltered on page 1, as before. Unknown keys are stripped, not rejected.", + "compatibilityWindow": "None needed: STRIP_UNKNOWN accepts every URL the previous contract accepted.", + "rollback": "Set searchSchema back to null on TECH_LOG_STUDIO_DOCUMENTS in tech-log-route-contract.ts, drop TechLogStudioDocumentsSearch from TECH_LOG_ROUTE_CODECS and the route runtime searchCodec back to none; the list then keeps its state in memory again.", + "owner": "tech-log-frontend" + }, + { + "changeId": "FE-REG-ROUTE:TECH_LOG_STUDIO_PUBLICATIONS:searchSchema:field-type-changed", + "versionBump": "TECH_LOG_STUDIO_PUBLICATIONS reads its search, filter and page state from the URL through TechLogStudioPublicationsSearch (STRIP_UNKNOWN), 2026-09 UX review H1. Before, the list kept that state in memory and lost it on back navigation.", + "migration": "Old links without a query string open the list unfiltered on page 1, as before. Unknown keys are stripped, not rejected.", + "compatibilityWindow": "None needed: STRIP_UNKNOWN accepts every URL the previous contract accepted.", + "rollback": "Set searchSchema back to null on TECH_LOG_STUDIO_PUBLICATIONS in tech-log-route-contract.ts, drop TechLogStudioPublicationsSearch from TECH_LOG_ROUTE_CODECS and the route runtime searchCodec back to none; the list then keeps its state in memory again.", + "owner": "tech-log-frontend" + }, + { + "changeId": "FE-REG-ROUTE-RUNTIME:TECH_LOG_STUDIO_DOCUMENTS:searchCodec:field-changed", + "versionBump": "TECH_LOG_STUDIO_DOCUMENTS reads its search, filter and page state from the URL through TechLogStudioDocumentsSearch (STRIP_UNKNOWN), 2026-09 UX review H1. Before, the list kept that state in memory and lost it on back navigation.", + "migration": "Old links without a query string open the list unfiltered on page 1, as before. Unknown keys are stripped, not rejected.", + "compatibilityWindow": "None needed: STRIP_UNKNOWN accepts every URL the previous contract accepted.", + "rollback": "Set searchSchema back to null on TECH_LOG_STUDIO_DOCUMENTS in tech-log-route-contract.ts, drop TechLogStudioDocumentsSearch from TECH_LOG_ROUTE_CODECS and the route runtime searchCodec back to none; the list then keeps its state in memory again.", + "owner": "tech-log-frontend" + }, + { + "changeId": "FE-REG-ROUTE-RUNTIME:TECH_LOG_STUDIO_PUBLICATIONS:searchCodec:field-changed", + "versionBump": "TECH_LOG_STUDIO_PUBLICATIONS reads its search, filter and page state from the URL through TechLogStudioPublicationsSearch (STRIP_UNKNOWN), 2026-09 UX review H1. Before, the list kept that state in memory and lost it on back navigation.", + "migration": "Old links without a query string open the list unfiltered on page 1, as before. Unknown keys are stripped, not rejected.", + "compatibilityWindow": "None needed: STRIP_UNKNOWN accepts every URL the previous contract accepted.", + "rollback": "Set searchSchema back to null on TECH_LOG_STUDIO_PUBLICATIONS in tech-log-route-contract.ts, drop TechLogStudioPublicationsSearch from TECH_LOG_ROUTE_CODECS and the route runtime searchCodec back to none; the list then keeps its state in memory again.", + "owner": "tech-log-frontend" } ] } diff --git a/config/contracts/registry-governance.json b/config/contracts/registry-governance.json index af0c136..3173e39 100644 --- a/config/contracts/registry-governance.json +++ b/config/contracts/registry-governance.json @@ -60,6 +60,7 @@ "ReferenceResourceParams", "TechLogExploreKindParams", "TechLogSlugParams", + "TechLogTopicVariantParams", "TechLogVersionParams", "TechLogDocumentIdParams", "TechLogPublicationEventIdParams", @@ -72,7 +73,9 @@ "TechLogExploreSearch", "TechLogExploreKindSearch", "TechLogSearchQuery", - "TechLogCaseStateSearch" + "TechLogCaseStateSearch", + "TechLogStudioDocumentsSearch", + "TechLogStudioPublicationsSearch" ], "loadingSurface": [ "app-shell", diff --git a/src/features/tech-log/contracts/tech-log-route-contract.ts b/src/features/tech-log/contracts/tech-log-route-contract.ts index 5388f28..6ca7e2f 100644 --- a/src/features/tech-log/contracts/tech-log-route-contract.ts +++ b/src/features/tech-log/contracts/tech-log-route-contract.ts @@ -94,6 +94,11 @@ export const TECH_LOG_ROUTE_SCHEMA_REGISTRY = Object.freeze({ "route-params", "REJECT_UNKNOWN", ), + TechLogTopicVariantParams: routeSchema( + "TechLogTopicVariantParams", + "route-params", + "REJECT_UNKNOWN", + ), TechLogVersionParams: routeSchema( "TechLogVersionParams", "route-params",