From 0fb78ff1b40860bfd7312dfac8bbe0c7e72987b4 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Wed, 4 Nov 2026 22:39:52 +0900 Subject: [PATCH] =?UTF-8?q?docs(architecture):=20=EC=A0=9C=ED=92=88=20?= =?UTF-8?q?=EC=84=A4=EC=A0=95=20=ED=82=A4=EC=9D=98=20FE-REG-ENV=20?= =?UTF-8?q?=ED=96=89=EC=9D=84=20=EC=9A=94=EA=B5=AC=ED=95=98=EB=8A=94=20?= =?UTF-8?q?=ED=85=8C=EC=8A=A4=ED=8A=B8=EB=A5=BC=20=EC=A0=95=EB=B3=B8=20?= =?UTF-8?q?=ED=91=9C=EC=97=90=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 starter-experience.md의 제품 소유 파일 표는 제품 런타임 설정 키의 FE-REG-ENV 행에 대해 "nothing requires the row"라고 적는다. tests/unit/env-registry-coverage.test.ts(d0414c8)는 키마다 행을 요구하고, fix/r1103-contracts(13-04)는 그 행의 required·defaultValue까지 스키마와 대조하게 했다. 매뉴얼 03 C절은 이 표를 정본으로 가리킨다. 고른 방법 - 그 셀을 "check:registries가 칸을 보고, env-registry-coverage 테스트 (test:unit)가 키마다 행과 required·defaultValue를 요구한다"로 바꾼다. - 같은 표의 사라진 오류 문구(14-05 ①)는 fix/r1103-app(09-07)이 이미 고쳤다. 위험·한계 - 없음. 문서 한 셀이다. 검증 - verify:documentation PASS_SCOPED. Refs: docs/reviews/2026-11-03-maturity-review/14-template-product-docs.md 14-05 --- docs/architecture/starter-experience.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/architecture/starter-experience.md b/docs/architecture/starter-experience.md index 5c59b1d7..256b7bca 100644 --- a/docs/architecture/starter-experience.md +++ b/docs/architecture/starter-experience.md @@ -201,7 +201,7 @@ Files outside the feature directory. Everything else a feature needs is in | `tests/e2e/accessibility.spec.ts` | a route path has a parameter other than `:resourceId`, or a protected page cannot render while every API answers `[]` | `test:a11y` (FE-GATE-009): the spec fills in only `:resourceId` and answers every API with `[]` | | `src/features/product-capabilities.ts` (product-owned) | `needs` names a capability the template does not build: type it in `ProductFeaturePlatformCapabilities`. `FeaturePlatformCapabilities` extends it, so the app, scripts and tests typecheck programs all see the key (an augmentation inside `product-composition.ts` is not seen by the scripts' program) | `check:types`: `Type '""' is not assignable to type 'keyof FeaturePlatformCapabilities'` in the feature | | `src/bootstrap/product-composition.ts` (product-owned) | `needs` names a capability the template does not build: return the capability here, typed in `product-capabilities.ts`. `indexedDb` is built as in `recipes/frontend-capabilities/indexeddb-feature-capability.ts`. Credentials for a product auth profile are returned here too. A product that owns the session (a BFF's httpOnly cookie) returns its session owner from `composeProductSessionOwner` instead of installing it on the host global before boot | `check:types`; at runtime `feature needs , which the host did not provide`. Without the session owner, `AUTH_MODE: "external"` boots with the session `integration-failed` | -| `src/contracts/product-contracts.ts` (product-owned) | a product auth profile, or a product runtime-config key and its FE-REG-ENV row (`PRODUCT_ENV_REGISTRY`) | auth profile: every gate that loads the operation, with `Installed contract contribution is not composable: /: unknown authProfileId `. Config key: `check:types` where it is read. Give the key a `.default()` or make it `.optional()`: template tests build their config with `tests/helpers/runtime-config.ts`, which fills the product's defaults, and a required key without a default fails them. FE-REG-ENV row: `check:registries` checks its fields; nothing requires the row | +| `src/contracts/product-contracts.ts` (product-owned) | a product auth profile, or a product runtime-config key and its FE-REG-ENV row (`PRODUCT_ENV_REGISTRY`) | auth profile: every gate that loads the operation, with `Installed contract contribution is not composable: /: unknown authProfileId `. Config key: `check:types` where it is read. Give the key a `.default()` or make it `.optional()`: template tests build their config with `tests/helpers/runtime-config.ts`, which fills the product's defaults, and a required key without a default fails them. FE-REG-ENV row: `check:registries` checks its fields, and `tests/unit/env-registry-coverage.test.ts` (`test:unit`) requires a row for every key, with the schema's `required` and `defaultValue` | | `config/runtime/.json` | optional: a `FEATURE_OVERRIDES` entry switches the feature off | nothing | | `package.json`, the lockfile, `config/security/dependency-change-evidence.json` | the contract contribution imports a generated `@org-contracts/*` package as a production dependency | `generate:supply-chain` (in `check:bundle`): `high-risk dependency missing review: add:` |