문제: OIDC PKCE session owner 레시피가 sign-in transaction의 sessionStorage 키를 글자 그대로 적는다 (`"ca-frontend:auth:v1:oidc-pkce-transaction"`). 주석은 `buildPhysicalKey(...)`라고 하지만 함수를 부르지 않는다. 템플릿의 다른 Web Storage 키는 모두 `src/contracts/storage-keys.ts` registry가 `APP_NAMESPACE`로 만들고, 어댑터가 직접 쓰는 키도 `backend: "external"` 행으로 둔다. 그래서 제품이 `APP_NAMESPACE`를 바꾸면(memento 설계가 예정한 일) 이 키만 `ca-frontend:`로 남고, registry는 앱이 쓰는 Web Storage 키 목록이 아니게 된다. registry로 로그아웃 때 지울 키를 정하는 제품은 버려진 sign-in의 verifier·state·nonce·돌아갈 경로를 지우지 못한다. 고른 방법: - registry에 `AUTH_REDIRECT_TRANSACTION` 행을 둔다. `scope: "auth"`, `name: "oidc-pkce-transaction"`, `backend: "external"`(pulse 키와 같은 모양, StoragePort는 거절), `ttl: "session"`. 물리 키는 지금 글자와 같다 (`ca-frontend:auth:v1:oidc-pkce-transaction`)라서 진행 중인 sign-in을 잃지 않는다. - 레시피의 `OIDC_PKCE_TRANSACTION_KEY`는 그 행의 `physicalKey`다. 매뉴얼의 복사 규칙(`../../src/` → `../`)이 새 import에도 그대로 맞는다. - 분류는 `opaque-cache`다. `sensitive-forbidden`은 "저장하지 않는다"는 뜻이고 backend가 disabled·forbidden이어야 해서 맞지 않는다. 이 값은 리다이렉트 한 번 동안 저장하는 것이 설계다. - FE-REG-STORAGE의 `orphanExemptRows`에 이 행을 더한다 (`config/contracts/registry-governance.json`). 이 행을 쓰는 곳은 레시피 하나뿐이고, 레시피는 제품이 지울 수 있다(test:optional-recipe-removal). 행은 registry로 지울 키를 정하는 제품을 위해 남는다. `AUTH_TOKEN`처럼 사용처 없이 선언만 하는 행이다. 빼지 않으면 `src`만 복사해 check:registries를 돌리는 `tests/unit/second-api-feature-registries.test.ts`가 "has no executable consumer"로 실패한다. 버린 대안: consumer 폴더에 `recipes`를 더하기. 레시피를 지운 사본(FE-GATE-020) 에서 다시 사용처가 사라진다. 버린 대안: registry에 새 분류(예: `session-transaction`)를 더하기. 계약 타입의 union과 registry 기준선의 허용 값이 함께 바뀌는데, 분류가 코드 동작을 바꾸는 곳은 `sensitive-forbidden` 검사뿐이라 얻는 것이 없다. 위험·한계: - `src/contracts/storage-keys.ts`에 행 하나가 더해진다(FE-REG-STORAGE additive). CHANGELOG [계약] 행이 필요하다. - 이미 레시피를 복사한 제품은 자기 복사본을 같은 diff로 고쳐야 키가 namespace를 따른다. - orphan 검사가 이 행을 보지 않는다. 레시피가 키를 registry에서 가져오는지는 `tests/recipes/oidc-pkce-session-owner.test.ts`가 본다. 검증: desktop batch에서 확인 - node scripts/run-vitest.ts run tests/unit/storage-registry.test.ts tests/recipes/oidc-pkce-session-owner.test.ts - corepack pnpm check:registries (additive 행) - node scripts/run-vitest.ts run tests/unit/second-api-feature-registries.test.ts - corepack pnpm test:optional-recipe-removal Refs: 1105/05-01
556 lines
15 KiB
JSON
556 lines
15 KiB
JSON
{
|
|
"schemaVersion": 2,
|
|
"sourceDirectories": [
|
|
"src/application",
|
|
"src/presentation",
|
|
"src/domain"
|
|
],
|
|
"registries": [
|
|
{
|
|
"registryId": "FE-REG-ROUTE",
|
|
"path": "src/features/installed-feature-contracts.ts",
|
|
"exportName": "ROUTE_REGISTRY",
|
|
"owner": "feature-frontend-routing-release-recovery-runtime",
|
|
"keyField": "routeId",
|
|
"requiredFields": [
|
|
"routeId",
|
|
"path",
|
|
"paramsSchema",
|
|
"searchSchema",
|
|
"access",
|
|
"loadingSurface",
|
|
"errorSurface",
|
|
"chunkId",
|
|
"title",
|
|
"navigationLabel",
|
|
"navigationOrder"
|
|
],
|
|
"fieldTypes": {
|
|
"routeId": "string",
|
|
"path": "string",
|
|
"paramsSchema": "string|null",
|
|
"searchSchema": "string|null",
|
|
"access": "string",
|
|
"loadingSurface": "string",
|
|
"errorSurface": "string",
|
|
"chunkId": "string",
|
|
"title": "string",
|
|
"navigationLabel": "string|null",
|
|
"navigationOrder": "integer|null"
|
|
},
|
|
"uniqueFields": ["routeId", "path", "chunkId"],
|
|
"allowedValues": {
|
|
"access": ["public", "session-required"],
|
|
"errorSurface": [
|
|
"route-boundary",
|
|
"feature-boundary",
|
|
"not-found"
|
|
]
|
|
},
|
|
"fieldPatterns": {
|
|
"loadingSurface": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
|
|
},
|
|
"references": [
|
|
{
|
|
"field": "routeId",
|
|
"registryId": "FE-REG-ROUTE-RUNTIME",
|
|
"targetField": "routeId"
|
|
},
|
|
{
|
|
"field": "paramsSchema",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
},
|
|
{
|
|
"field": "searchSchema",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
}
|
|
],
|
|
"consumers": [
|
|
{
|
|
"path": "src/presentation/routes/app-router.tsx",
|
|
"token": "ROUTE_REGISTRY"
|
|
}
|
|
],
|
|
"breakingFields": [
|
|
"routeId",
|
|
"path",
|
|
"paramsSchema",
|
|
"searchSchema",
|
|
"access",
|
|
"chunkId"
|
|
]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-ROUTE-RUNTIME",
|
|
"path": "src/features/installed-feature-contracts.ts",
|
|
"exportName": "ROUTE_RUNTIME_CONTRACT",
|
|
"owner": "feature-frontend-routing-release-recovery-runtime",
|
|
"keyField": "routeId",
|
|
"requiredFields": [
|
|
"routeId",
|
|
"moduleId",
|
|
"paramsCodec",
|
|
"searchCodec"
|
|
],
|
|
"fieldTypes": {
|
|
"routeId": "string",
|
|
"moduleId": "string",
|
|
"paramsCodec": "string",
|
|
"searchCodec": "string"
|
|
},
|
|
"uniqueFields": ["routeId", "moduleId"],
|
|
"references": [
|
|
{
|
|
"field": "routeId",
|
|
"registryId": "FE-REG-ROUTE",
|
|
"targetField": "routeId"
|
|
},
|
|
{
|
|
"field": "paramsCodec",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
},
|
|
{
|
|
"field": "searchCodec",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
}
|
|
],
|
|
"consumers": [
|
|
{
|
|
"path": "src/presentation/routes/route-codecs.ts",
|
|
"token": "ROUTE_RUNTIME_CONTRACT"
|
|
}
|
|
],
|
|
"breakingFields": [
|
|
"routeId",
|
|
"moduleId",
|
|
"paramsCodec",
|
|
"searchCodec"
|
|
]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-API",
|
|
"path": "src/features/loaded-feature-runtimes.ts",
|
|
"exportName": "API_OPERATIONS",
|
|
"owner": "feature-frontend-api-client-response-envelope-contract",
|
|
"keyField": "operationId",
|
|
"requiredFields": [
|
|
"operationId",
|
|
"featureId",
|
|
"method",
|
|
"path",
|
|
"authProfileId",
|
|
"retrySemantics",
|
|
"requestBody",
|
|
"responseBody",
|
|
"responseEnvelope",
|
|
"requestSchema",
|
|
"responseSchema",
|
|
"problemSchema",
|
|
"acceptedStatuses",
|
|
"emptyBodyStatuses",
|
|
"unvalidated",
|
|
"requestByteLimit",
|
|
"responseByteLimit",
|
|
"totalDeadlineMs",
|
|
"retryBudget",
|
|
"traffic",
|
|
"commandEffect",
|
|
"commandRecovery"
|
|
],
|
|
"fieldTypes": {
|
|
"operationId": "string",
|
|
"featureId": "string",
|
|
"method": "string",
|
|
"path": "string",
|
|
"authProfileId": "string",
|
|
"retrySemantics": "string",
|
|
"requestBody": "string",
|
|
"responseBody": "string",
|
|
"responseEnvelope": "string",
|
|
"requestSchema": "string",
|
|
"responseSchema": "string",
|
|
"problemSchema": "string",
|
|
"acceptedStatuses": "array",
|
|
"emptyBodyStatuses": "array",
|
|
"unvalidated": "array",
|
|
"requestByteLimit": "integer",
|
|
"responseByteLimit": "integer",
|
|
"totalDeadlineMs": "integer",
|
|
"retryBudget": "integer",
|
|
"traffic": "object|null",
|
|
"commandEffect": "object|null",
|
|
"commandRecovery": "object|null"
|
|
},
|
|
"uniqueFields": [
|
|
"operationId"
|
|
],
|
|
"allowedValues": {
|
|
"method": [
|
|
"GET",
|
|
"HEAD",
|
|
"POST",
|
|
"PUT",
|
|
"PATCH",
|
|
"DELETE"
|
|
],
|
|
"retrySemantics": [
|
|
"SAFE",
|
|
"IDEMPOTENT",
|
|
"KEYED",
|
|
"NEVER"
|
|
],
|
|
"requestBody": [
|
|
"NONE",
|
|
"JSON"
|
|
],
|
|
"responseBody": [
|
|
"REQUIRED_JSON",
|
|
"OPTIONAL_JSON",
|
|
"NONE"
|
|
],
|
|
"responseEnvelope": [
|
|
"NONE",
|
|
"ENVELOPE_V1"
|
|
]
|
|
},
|
|
"references": [
|
|
{
|
|
"field": "requestSchema",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
},
|
|
{
|
|
"field": "responseSchema",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
},
|
|
{
|
|
"field": "problemSchema",
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"targetField": "schemaId"
|
|
}
|
|
],
|
|
"consumerIdentityField": "operationId",
|
|
"consumerDirectories": [
|
|
"src/features/*/adapters",
|
|
"src/features/*/application"
|
|
],
|
|
"breakingFields": [
|
|
"operationId",
|
|
"method",
|
|
"path",
|
|
"authProfileId",
|
|
"retrySemantics",
|
|
"requestBody",
|
|
"responseBody",
|
|
"responseEnvelope",
|
|
"requestSchema",
|
|
"responseSchema",
|
|
"problemSchema",
|
|
"unvalidated"
|
|
]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-SCHEMA",
|
|
"path": "src/features/loaded-feature-runtimes.ts",
|
|
"exportName": "SCHEMA_REGISTRY",
|
|
"owner": "feature-frontend-contract-schema-registry",
|
|
"keyField": "schemaId",
|
|
"requiredFields": ["schemaId", "boundary", "owner", "runtime"],
|
|
"fieldTypes": {
|
|
"schemaId": "string",
|
|
"boundary": "string",
|
|
"owner": "string",
|
|
"runtime": "string"
|
|
},
|
|
"uniqueFields": ["schemaId"],
|
|
"allowedValues": {
|
|
"boundary": [
|
|
"route-params",
|
|
"route-search",
|
|
"route-search-api-request",
|
|
"api-request",
|
|
"api-response",
|
|
"api-problem"
|
|
],
|
|
"runtime": ["zod"]
|
|
},
|
|
"consumerIdentityField": "schemaId",
|
|
"consumerDirectories": [
|
|
"src/presentation/routes",
|
|
"src/features/*/presentation",
|
|
"src/features/*/contracts"
|
|
],
|
|
"breakingFields": ["schemaId", "boundary", "runtime"]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-ENV",
|
|
"path": "src/contracts/env.ts",
|
|
"exportName": "ENV_REGISTRY",
|
|
"owner": "feature-frontend-env-runtime-config-contract",
|
|
"requiredFields": ["phase", "classification", "required", "defaultValue"],
|
|
"fieldTypes": {
|
|
"phase": "string",
|
|
"classification": "string",
|
|
"required": "boolean",
|
|
"defaultValue": "string|integer|boolean|object|null"
|
|
},
|
|
"allowedValues": {
|
|
"phase": ["build", "runtime"],
|
|
"classification": [
|
|
"public",
|
|
"public-sensitive",
|
|
"public-metadata",
|
|
"compile-time"
|
|
]
|
|
},
|
|
"consumers": [
|
|
{
|
|
"path": "src/bootstrap/runtime-config-schema.ts",
|
|
"token": "APP_ENV"
|
|
},
|
|
{
|
|
"path": "src/contracts/env.ts",
|
|
"token": "getBuildConfig"
|
|
}
|
|
],
|
|
"breakingFields": ["phase", "classification", "required"]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-STORAGE",
|
|
"path": "src/contracts/storage-keys.ts",
|
|
"exportName": "STORAGE_REGISTRY",
|
|
"owner": "feature-frontend-storage-registry-contract",
|
|
"keyField": "logicalName",
|
|
"requiredFields": [
|
|
"logicalName",
|
|
"physicalKey",
|
|
"backend",
|
|
"classification",
|
|
"schemaVersion",
|
|
"valueCodec",
|
|
"ttl",
|
|
"migration",
|
|
"quotaFallback"
|
|
],
|
|
"fieldTypes": {
|
|
"logicalName": "string",
|
|
"physicalKey": "string",
|
|
"backend": "string",
|
|
"classification": "string",
|
|
"schemaVersion": "integer",
|
|
"valueCodec": "string",
|
|
"ttl": "integer|string|null",
|
|
"migration": "string",
|
|
"quotaFallback": "string"
|
|
},
|
|
"uniqueFields": ["logicalName", "physicalKey"],
|
|
"allowedValues": {
|
|
"backend": [
|
|
"memory",
|
|
"sessionStorage",
|
|
"localStorage",
|
|
"disabled",
|
|
"forbidden",
|
|
"external"
|
|
],
|
|
"classification": [
|
|
"public-preference",
|
|
"opaque-cache",
|
|
"sensitive-forbidden"
|
|
],
|
|
"valueCodec": [
|
|
"color-scheme-v1",
|
|
"opaque-string-v1",
|
|
"none"
|
|
],
|
|
"migration": ["discard"],
|
|
"quotaFallback": ["memory", "no-persist", "feature-disable"]
|
|
},
|
|
"consumerIdentityField": "logicalName",
|
|
"consumerDirectories": ["src", "tests"],
|
|
"orphanExemptRows": ["QUERY_PERSISTENCE", "AUTH_TOKEN", "AUTH_REDIRECT_TRANSACTION"],
|
|
"breakingFields": [
|
|
"logicalName",
|
|
"physicalKey",
|
|
"backend",
|
|
"classification",
|
|
"schemaVersion",
|
|
"valueCodec",
|
|
"migration"
|
|
]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-ERROR",
|
|
"path": "src/contracts/errors.ts",
|
|
"exportName": "ERROR_REGISTRY",
|
|
"owner": "feature-frontend-error-classification-boundary-contract",
|
|
"keyField": "kind",
|
|
"requiredFields": [
|
|
"kind",
|
|
"defaultRetryable",
|
|
"userMessageKey",
|
|
"action"
|
|
],
|
|
"fieldTypes": {
|
|
"kind": "string",
|
|
"defaultRetryable": "boolean",
|
|
"userMessageKey": "string",
|
|
"action": "string"
|
|
},
|
|
"uniqueFields": ["kind"],
|
|
"allowedValues": {
|
|
"action": [
|
|
"retry",
|
|
"reauth",
|
|
"navigate",
|
|
"reload-once",
|
|
"contact-support",
|
|
"none"
|
|
]
|
|
},
|
|
"consumers": [
|
|
{
|
|
"path": "src/adapters/http/feature-http-binding.ts",
|
|
"token": "failure("
|
|
}
|
|
],
|
|
"breakingFields": ["kind", "userMessageKey", "action"]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-QUERY-INVALIDATION",
|
|
"path": "src/features/installed-feature-contracts.ts",
|
|
"exportName": "INVALIDATION_REGISTRY",
|
|
"rowsPath": "edges",
|
|
"rowKeyFields": [
|
|
"topicId",
|
|
"namespace.namespaceId",
|
|
"namespace.namespaceVersion"
|
|
],
|
|
"owner": "feature-frontend-server-state-caching-contract",
|
|
"requiredFields": [
|
|
"topicId",
|
|
"namespace.namespaceId",
|
|
"namespace.namespaceVersion"
|
|
],
|
|
"fieldTypes": {
|
|
"topicId": "string",
|
|
"namespace.namespaceId": "string",
|
|
"namespace.namespaceVersion": "integer"
|
|
},
|
|
"uniqueFieldSets": [
|
|
[
|
|
"topicId",
|
|
"namespace.namespaceId",
|
|
"namespace.namespaceVersion"
|
|
]
|
|
],
|
|
"snapshotProjection": {
|
|
"singletonRowKey": "invalidation-graph",
|
|
"canonicalArrayKeyFields": {
|
|
"topics": ["$value"],
|
|
"namespaces": ["namespaceId", "namespaceVersion"],
|
|
"edges": [
|
|
"topicId",
|
|
"namespace.namespaceId",
|
|
"namespace.namespaceVersion"
|
|
]
|
|
}
|
|
},
|
|
"consumers": [
|
|
{
|
|
"path": "src/bootstrap/runtime-adapters.ts",
|
|
"token": "indexInvalidationRegistry(INVALIDATION_REGISTRY)"
|
|
}
|
|
],
|
|
"breakingFields": ["topics", "namespaces", "edges"]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-QUERY-INVALIDATION-TOPIC-VERSION",
|
|
"path": "src/features/installed-feature-contracts.ts",
|
|
"exportName": "INVALIDATION_TOPIC_VERSIONS",
|
|
"rowKeyFields": ["topicId"],
|
|
"owner": "feature-frontend-server-state-caching-contract",
|
|
"requiredFields": ["topicId", "topicVersion"],
|
|
"fieldTypes": {
|
|
"topicId": "string",
|
|
"topicVersion": "integer"
|
|
},
|
|
"uniqueFields": ["topicId"],
|
|
"consumers": [
|
|
{
|
|
"path": "src/bootstrap/runtime-adapters.ts",
|
|
"token": "indexInvalidationTopicVersions("
|
|
}
|
|
],
|
|
"breakingFields": ["topicId", "topicVersion"]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-TELEMETRY",
|
|
"path": "src/contracts/telemetry.ts",
|
|
"exportName": "TELEMETRY_REGISTRY",
|
|
"owner": "feature-frontend-diagnostics-telemetry-runtime",
|
|
"keyField": "eventName",
|
|
"requiredFields": [
|
|
"eventName",
|
|
"trigger",
|
|
"requiredAttributes",
|
|
"optionalAttributes",
|
|
"forbiddenAttributes",
|
|
"sampling",
|
|
"delivery"
|
|
],
|
|
"fieldTypes": {
|
|
"eventName": "string",
|
|
"trigger": "string",
|
|
"requiredAttributes": "array",
|
|
"optionalAttributes": "array",
|
|
"forbiddenAttributes": "array",
|
|
"sampling": "string",
|
|
"delivery": "string"
|
|
},
|
|
"uniqueFields": ["eventName"],
|
|
"allowedValues": {
|
|
"delivery": ["best-effort"]
|
|
},
|
|
"consumers": [
|
|
{
|
|
"path": "scripts/check-diagnostics.ts",
|
|
"token": "TELEMETRY_REGISTRY"
|
|
}
|
|
],
|
|
"breakingFields": [
|
|
"eventName",
|
|
"requiredAttributes",
|
|
"forbiddenAttributes",
|
|
"delivery"
|
|
]
|
|
},
|
|
{
|
|
"registryId": "FE-REG-RELEASE",
|
|
"path": "src/contracts/release-tokens.ts",
|
|
"exportName": "RELEASE_TOKEN_REGISTRY",
|
|
"owner": "feature-frontend-release-cache-rollback-contract",
|
|
"keyField": "token",
|
|
"requiredFields": ["token", "source", "compatibilityRole"],
|
|
"fieldTypes": {
|
|
"token": "string",
|
|
"source": "string",
|
|
"compatibilityRole": "string"
|
|
},
|
|
"uniqueFields": ["token"],
|
|
"consumers": [
|
|
{
|
|
"path": "src/bootstrap/load-release-manifest.ts",
|
|
"token": "assetManifestHash"
|
|
}
|
|
],
|
|
"breakingFields": ["token", "source", "compatibilityRole"]
|
|
}
|
|
]
|
|
}
|