fix(registry): 9월 경로 변경을 registry에 등록하고 근거를 남긴다

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건 실패).
This commit is contained in:
DongHyeonka
2026-11-12 12:50:28 +09:00
parent ed47b562bc
commit 588ebca54f
3 changed files with 57 additions and 1 deletions
@@ -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"
}
]
}
+4 -1
View File
@@ -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",
@@ -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",