chore(features): 참조 기능과 예제 화면을 지우고 레지스트리를 다시 승인한다
소유자 결정(2026-11-07, design-docs repo-structure/README.md 3.4절)으로 템플릿 샘플을 지운다. 샘플이 맡던 시험 대상은 앞 커밋들이 옮겼다. 참조 기능과 예제 화면, 두 context, 그 시험, e2e 3개, 수동 접근성 기록 7개, 런타임 프로필 키, test:reference-feature(명령, 산출물, 게이트 참조), 커버리지 정책 행을 지웠다. removable-template-features 목록은 비우고 장치는 남겼다: test:sample-removal은 인자가 없으면 목록을 하나씩 지우고, 비면 SKIP을 출력하고 보고서에 건너뛴 사례를 남긴다. 기능 스위치 시험과 홈 시작 링크 스위치 시험은 시험 전용 fixture 기능으로 옮겼다. browser soak은 생성 기능을 넣은 빌드에서 돈다. 문서의 샘플 경로를 고쳤다. 날짜가 붙은 설계·리뷰 기록의 본문은 그대로 두었다. 레지스트리 기준선(update:registry-baseline, OWNER DongHyeonka), CI 계약 기준선과 workflow, 초기 JS 기록(194,354B, 17파일, 첫 기능 6,327B, 기능 539B, context 4B)을 다시 받았다. 위험: 레지스트리 행 삭제는 breaking이다. 샘플을 고쳐 쓰는 다운스트림은 수정/삭제 충돌을 만난다. 성능 lab의 기능 라우트 측정은 템플릿에 공개 기능 라우트가 없어 measured:false다. TEMPLATE_FIXTURE 출처는 플랫폼 코드에 남았다. 검증(desktop): check:types, lint, check:architecture, check:registries, check:ci, verify:documentation, test:unit, test:component, test:contract, test:integration, test:recipes, test:coverage(Risk coverage PASS 378/378, 문턱 68개), test:e2e 183, test:a11y, test:visual, test:storybook, test:browser-capabilities, test:feature-scaffold PASS(76 checks), test:sample-removal SKIP, build, check:bundle.
This commit is contained in:
+3
-3
@@ -51,9 +51,9 @@ checkout이 없거나 그 커밋이 없으면 실패 대신 확인하지 못한
|
||||
지난 상태를 적는 문서라 빼고, git이 무시하는 생성 산출물과 복사한 프로젝트가 지운 작업 이력은
|
||||
없어도 된다. 설명·수치가 코드와 맞는지는 검사하지 않는다. 규칙과 예외의 정본은
|
||||
`scripts/verify-documentation-readiness.ts`다.
|
||||
복사한 프로젝트가 지울 수 있는 템플릿 기능(참조 기능, 예제 화면. 목록은
|
||||
`scripts/lib/removable-template-features.ts`)의 경로와 script는 그 기능이 설치돼 있을 때
|
||||
(`src/features/<id>/feature-module.ts`가 있을 때) 검사하고, 지운 뒤에는 없어도 된다.
|
||||
프로젝트가 지울 예정인 샘플 기능(목록은 `scripts/lib/removable-template-features.ts`, 템플릿은
|
||||
비어 있다)의 경로와 script는 그 기능이 설치돼 있을 때(`src/features/<id>/feature-module.ts`가
|
||||
있을 때) 검사하고, 지운 뒤에는 없어도 된다.
|
||||
|
||||
게이트가 직접 읽는 파일이라 지우거나 옮기면 게이트가 실패한다.
|
||||
|
||||
|
||||
@@ -57,8 +57,8 @@ The reviewer must verify:
|
||||
- M7: non-essential motion is suppressed with reduced-motion preference
|
||||
- Screen reader: headings, live regions, errors, and actions are announced once
|
||||
|
||||
`EXAMPLES_UI` requires real M4 modal and M5 field-error review; those items must
|
||||
not be marked not-applicable on that route. Passing automated evidence means
|
||||
A route with a form or a dialog requires real M4 modal and M5 field-error
|
||||
review; those items must not be marked not-applicable on that route. Passing automated evidence means
|
||||
only that tested pages had no critical or serious axe findings under the
|
||||
recorded Chromium, Firefox, and WebKit runs.
|
||||
|
||||
@@ -78,7 +78,7 @@ What the automated run scans:
|
||||
route's `paramsSchema` is the input of such a read, the report expects that
|
||||
record from the descriptors alone and fails without it
|
||||
(`scripts/write-a11y-report.ts`).
|
||||
- The reference sample's list in its success, empty and error states, its
|
||||
detail, its form with submit errors and its status page, each after that
|
||||
state is on screen (`tests/e2e/reference-form.spec.ts`, removed with the
|
||||
sample).
|
||||
- The list of the feature `create:feature` writes, in its success, empty and
|
||||
error states, its detail and its form with submit errors, each after that
|
||||
state is on screen (`tests/e2e/generated-feature.spec.ts`, on a build with
|
||||
that feature). A product's own features get the route scan above.
|
||||
|
||||
@@ -124,36 +124,22 @@ runtime config의 version 문자열 일치만 compatibility 증거로 사용하
|
||||
artifact digest가 없는 동안에는 실제 staging conformance fixture와 수동 승인
|
||||
evidence가 필요하다.
|
||||
|
||||
## 4. 현재 reference REST 계약
|
||||
## 4. 현재 REST 계약
|
||||
|
||||
현재 frontend에 실제 조립된 operation은 다음 세 개다.
|
||||
템플릿에는 조립된 기능 operation이 없다. 참조 샘플(`LIST_REFERENCE_RESOURCES` 등
|
||||
problem details 모양의 세 operation)은 2026-11-07에 지웠다. 기능의 operation은
|
||||
`corepack pnpm create:feature <id>`가 만든다. 짝 백엔드 `new-feature.sh`와 같은 경로
|
||||
규칙이다(`docs/manual/reference/create-feature.md`).
|
||||
|
||||
| operation | request | success |
|
||||
| --- | --- | --- |
|
||||
| `LIST_REFERENCE_RESOURCES` | `GET /api/reference-resources?cursor&limit&tags` | `200 application/json` |
|
||||
| `GET_REFERENCE_RESOURCE` | `GET /api/reference-resources/{resourceId}` | `200 application/json` |
|
||||
| `CREATE_REFERENCE_RESOURCE` | `POST /api/reference-resources` | `200` 또는 `201 application/json` |
|
||||
| `<BASE>_LIST_ITEMS` | `GET /<plural>` | `200`, Envelope 안의 항목 배열과 `meta.page` |
|
||||
| `<BASE>_GET_ITEM` (`--with-create`) | `GET /<plural>/{<camel>Id}` | `200`, Envelope 안의 항목 |
|
||||
| `<BASE>_CREATE_ITEM` (`--with-create`) | `POST /<plural>` | `201`, Envelope 안의 항목 |
|
||||
|
||||
현재 list payload는 `ReferenceResource[]`다. `cursor` 입력이 존재하더라도
|
||||
`CursorPage` 출력 계약은 아직 아니다. backend가 같은 operation에서 배열을
|
||||
page object로 조용히 바꾸면 schema mismatch로 실패한다.
|
||||
|
||||
resource DTO:
|
||||
|
||||
```text
|
||||
ReferenceResourceDtoV1
|
||||
id: non-empty string, maximum 120 characters
|
||||
name: non-empty string, maximum 240 characters
|
||||
createdAt?: RFC 3339 date-time
|
||||
```
|
||||
|
||||
create command:
|
||||
|
||||
```text
|
||||
CreateReferenceResourceCommandV1
|
||||
name: trimmed string, 1..120
|
||||
note?: trimmed string, 0..500
|
||||
```
|
||||
모든 operation이 `responseEnvelope: "ENVELOPE_V1"`이다. Envelope가 없는 백엔드(DTO와
|
||||
problem details)에 붙이는 법은 [매뉴얼 02 결정표 4절](../manual/02-decision-tables.md)의
|
||||
「problem details 백엔드의 예」다.
|
||||
|
||||
Backend는 frontend validation을 신뢰하지 않고 동일하거나 더 좁은 validation과
|
||||
authorization을 다시 수행한다.
|
||||
@@ -193,8 +179,9 @@ Envelope의 모양과 키 존재 규칙은 짝 백엔드 템플릿 문서가 정
|
||||
바뀐 파일마다 다시 볼 프론트 위치를 말하며 1로 끝난다(1105/16-02).
|
||||
- 프론트에서 Envelope를 읽는 곳: `src/adapters/http/backend-envelope.ts`(스키마와
|
||||
해석). V3 실행기는 descriptor가 `responseEnvelope: "ENVELOPE_V1"`일 때 쓴다.
|
||||
`create:feature`가 만든 기능은 이 값을 선언한다. 참조 기능은 `"NONE"`을
|
||||
선언하고 DTO와 problem details를 검증한다. 이 칸은 descriptor 타입의 필수
|
||||
`create:feature`가 만든 기능은 이 값을 선언한다. Envelope가 없는 백엔드의
|
||||
operation은 `"NONE"`을 선언하고 DTO와 problem details를 검증한다(매뉴얼 02
|
||||
결정표 4절의 예). 이 칸은 descriptor 타입의 필수
|
||||
칸이라 빠뜨리면 `check:types`가 실패한다(1103/16-01).
|
||||
- 실패 Envelope의 `error.code`가 "적용 안 됨"인지는 6.1절이 정한다.
|
||||
- 페이지 목록의 `meta.page`(`number`·`size`·`total`·`sort`)는 기능의
|
||||
@@ -272,7 +259,7 @@ Cross-origin bearer provider 최소 CORS:
|
||||
|
||||
## 6. Command와 idempotency
|
||||
|
||||
`CREATE_REFERENCE_RESOURCE`는 keyed command다. frontend memory single-flight는
|
||||
`create:feature <id> --with-create --keyed`의 작성 operation은 keyed command다. frontend memory single-flight는
|
||||
backend idempotency를 대체하지 않는다.
|
||||
|
||||
멱등성 응답의 status·`error.code`·`retryable`·`Retry-After`와 키 문법은 짝
|
||||
@@ -287,9 +274,8 @@ backend idempotency를 대체하지 않는다.
|
||||
`src/presentation/adapters/query/application-query.ts`
|
||||
- Envelope operation의 거절 판정: `src/adapters/http/backend-envelope.ts`
|
||||
`REFUSED_BEFORE_WRITE`(6.1절 표)
|
||||
- 참조 기능(Envelope 없음) 판정: `src/features/reference-feature/contracts/reference-feature-contract-contribution.ts`
|
||||
(effect), `src/features/reference-feature/adapters/reference-http-gateway.ts`
|
||||
(code)
|
||||
- Envelope 없는 operation의 판정: 기능의 `commandEffect.classifyProblem`과
|
||||
`mapProblem`(예: [매뉴얼 02 결정표 4절](../manual/02-decision-tables.md)의 코드 조각)
|
||||
|
||||
### 6.1 거절 code와 적용 여부
|
||||
|
||||
@@ -411,10 +397,10 @@ mutation이 400·409·422로 실패하면 프론트는 그 요청이 적용됐
|
||||
|
||||
프론트 판정과 표가 다른 곳(고치면 이 줄을 지운다):
|
||||
|
||||
- 참조 기능 분류기(`classifyProblem`)는 참조 fixture(problem+json)용이라
|
||||
400·422를 모두 `NOT_APPLIED`로 본다. 참조 기능은 Envelope operation이 아니라
|
||||
이 표의 대상이 아니다. 짝 백엔드에 붙이는 Envelope operation은
|
||||
`src/adapters/http/backend-envelope.ts`의 표가 400·409·422를 정한다(`3261208`).
|
||||
- 매뉴얼 02 결정표의 problem details 예(`classifyProblem`)는 400·422를 모두
|
||||
`NOT_APPLIED`로 본다. Envelope operation이 아니라 이 표의 대상이 아니다. 짝
|
||||
백엔드에 붙이는 Envelope operation은 `src/adapters/http/backend-envelope.ts`의
|
||||
표가 400·409·422를 정한다(`3261208`).
|
||||
|
||||
남은 위험: "쓰기 전"은 현재 코드에서 그 handler에 닿는 출처를 센 결과다. 백엔드가
|
||||
application bean에 `@Validated`를 달거나 JPA entity에 Bean Validation 제약을
|
||||
|
||||
@@ -8,23 +8,24 @@ These measurements are baselines, not score targets. A lower line count is not
|
||||
automatically better if it hides business semantics or creates a universal
|
||||
repository abstraction.
|
||||
|
||||
## Scenario A — reference REST feature
|
||||
## Scenario A — a REST feature
|
||||
|
||||
The existing reference feature is the executable REST consumer.
|
||||
The REST consumer is the feature `corepack pnpm create:feature <id> --with-create`
|
||||
writes (the template's reference sample had this role until 2026-11-07).
|
||||
|
||||
It covers list/detail/create behavior, mapping, typed operation inputs,
|
||||
application ports and an optimistic mutation path.
|
||||
It covers list/detail/create behavior, mapping, typed operation inputs and
|
||||
application ports.
|
||||
|
||||
The feature-owned boundary and application source is these four files:
|
||||
|
||||
- `application/reference-feature-api.ts`
|
||||
- `contracts/reference-mapper.ts`
|
||||
- `adapters/reference-http-gateway.ts`
|
||||
- `adapters/create-reference-feature-input.ts`
|
||||
- `application/<base>-feature-api.ts`
|
||||
- `contracts/<base>-mapper.ts`
|
||||
- `adapters/<base>-http-gateway.ts`
|
||||
- `adapters/create-<base>-feature-input.ts`
|
||||
|
||||
This document does not keep their line counts; a hand-typed count drifted
|
||||
from the code (review 14-07). Measure them with
|
||||
`wc -l src/features/reference-feature/{application/reference-feature-api.ts,contracts/reference-mapper.ts,adapters/reference-http-gateway.ts,adapters/create-reference-feature-input.ts}`.
|
||||
from the code (review 14-07). Measure them in a generated feature with
|
||||
`wc -l` on those four files.
|
||||
|
||||
The important boundary metric is not the raw total. It is what those files need
|
||||
to know about the platform.
|
||||
|
||||
@@ -101,8 +101,8 @@ Feature-specific contracts stay inside the vertical slice:
|
||||
|
||||
`features/<feature>/contracts`
|
||||
|
||||
The reference feature owns routes, schemas, mapper definitions, message
|
||||
catalogs and contribution identities. Central installed files aggregate those
|
||||
A feature owns its routes, schemas, mapper definitions, message catalogs and
|
||||
contribution identities (`create:feature` writes them under its `contracts/`). Central installed files aggregate those
|
||||
contributions; they do not own their semantics.
|
||||
|
||||
The message catalog is a deliberate special case: the compiled catalog remains
|
||||
|
||||
@@ -71,9 +71,9 @@ route/form/failure 의미 값
|
||||
- `check:i18n`은 catalog key와 placeholder parity, backend message JSX 렌더링을
|
||||
검사한다. 검사 범위는 공통 UI 디렉터리, `src/presentation/pages`, 모든
|
||||
`src/features/*/presentation`이다. 플랫폼 구성 화면
|
||||
`src/presentation/examples`와 예제 화면
|
||||
`src/features/platform-examples-feature/presentation`(1103/09-04)은 화면
|
||||
문구 ESLint 규칙에서 일부러 뺐다(`eslint.config.ts`).
|
||||
`src/presentation/examples`와 Storybook story(디자인 시스템·화면 상태 갤러리,
|
||||
2026-11-07 전에는 예제 화면 기능)는 화면 문구 ESLint 규칙에서 일부러
|
||||
뺐다(`eslint.config.ts`).
|
||||
- 화면 문구가 catalog에서 오는지는 ESLint `no-restricted-syntax`가 본다
|
||||
(`eslint.config.ts`의 `screenTextSelectors`, 0929/08-02). 대상은 글자가 든
|
||||
`JSXText`와 표시·접근성 속성(`aria-label`, `title`, `placeholder`, `alt`,
|
||||
|
||||
@@ -5,8 +5,8 @@ an independent general-purpose SDK. Its architectural role is:
|
||||
|
||||
> Frontend Application Foundation = Starter / Composition Skeleton + Reusable Capability Platform
|
||||
|
||||
The starter side owns bootstrap, routing, providers, project conventions and a
|
||||
removable reference feature. The capability side owns reusable technical
|
||||
The starter side owns bootstrap, routing, providers, project conventions and
|
||||
the `create:feature` command that writes a feature; it ships no sample feature. The capability side owns reusable technical
|
||||
problems such as HTTP execution, Server State, authentication boundaries,
|
||||
IndexedDB/OPFS, Cache Storage, realtime, browser RPC, transfer and diagnostics.
|
||||
|
||||
@@ -78,9 +78,9 @@ A reusable capability boundary is composed from:
|
||||
- feature-selected policy,
|
||||
- one capability-specific runtime.
|
||||
|
||||
The HTTP reference path is the first concrete example.
|
||||
The HTTP path is the first concrete example.
|
||||
`src/adapters/http/feature-http-binding.ts` owns transport/outcome
|
||||
normalization. The reference feature contributes only:
|
||||
normalization. A feature `create:feature` writes contributes only:
|
||||
|
||||
- operation ID,
|
||||
- route ID,
|
||||
@@ -152,11 +152,11 @@ repository or move dataset/migration/lifecycle policy into the feature.
|
||||
|
||||
The repository now has two executable contribution shapes:
|
||||
|
||||
- Reference feature: `needs: ["http"]`
|
||||
- Local Draft feature: `needs: ["indexedDb"]`
|
||||
- A feature `create:feature` writes: `needs: ["http", "telemetry"]`
|
||||
- The Local Draft consumer: `needs: ["indexedDb"]`
|
||||
|
||||
Local Draft is a compiled architecture consumer used to prove the second
|
||||
capability shape; it is not added to the default product manifest. Its
|
||||
Local Draft is a test fixture (`tests/fixtures/indexeddb-consumer`) used to
|
||||
prove the second capability shape; it is not a feature of the product. Its
|
||||
browser-capability test composes the feature over the real
|
||||
`createIndexedDbRuntime` and native IndexedDB, proving that this seam is not
|
||||
limited to an in-memory contract fixture.
|
||||
|
||||
@@ -124,7 +124,7 @@ bootstrap은 page별 orchestration이나 업무 규칙을 소유하지 않는다
|
||||
| `src/adapters` | HTTP, auth, storage, cache, telemetry 구현 | outbound adapter |
|
||||
| `src/bootstrap` | runtime config와 구현 조립 | 유일한 composition root |
|
||||
| `src/contracts` | 여러 계층의 registry가 혼재 | 소유 계층으로 분산 |
|
||||
| `src/features/reference-feature` | 완전한 제거 가능 수직 예제 | installed contribution과 제거 gate 유지 |
|
||||
| `src/features/<id>` | 제품 기능의 수직 slice. 템플릿은 비어 있고 `create:feature`가 만든다(참조 샘플은 2026-11-07 삭제) | installed contribution과 제거 gate 유지 |
|
||||
|
||||
현재 구조가 잘 제공하는 기반은 다음과 같다.
|
||||
|
||||
@@ -178,7 +178,7 @@ Data Router tree, codec, surface, title, navigation, chunk/release recovery의
|
||||
단일 조립 입력이며 registry/type/build 검증이 누락과 orphan을 거절한다.
|
||||
|
||||
RP-05에서 두 번째 불일치도 닫혔다. feature별 domain/application/adapter/
|
||||
contract/presentation은 `src/features/reference-feature`가 소유하고, generic
|
||||
contract/presentation은 그 기능 폴더(`src/features/<id>`)가 소유하고, generic
|
||||
installed catalog만 bootstrap과 router에 노출된다. 제거 gate는 feature와 test를
|
||||
삭제한 복제본에서 전체 P0 경로를 다시 실행한다.
|
||||
|
||||
@@ -351,7 +351,7 @@ src/
|
||||
platform/
|
||||
|
||||
features/
|
||||
reference-feature/
|
||||
<feature>/
|
||||
domain/
|
||||
application/
|
||||
ports/
|
||||
@@ -376,8 +376,8 @@ src/
|
||||
application capability만 둔다. `shared`, `common`, `utils` 같은 이름으로
|
||||
기술과 업무 규칙을 무제한 혼합하지 않는다.
|
||||
|
||||
`features/reference-feature`는 구조를 설명하기 위한 완전한 수직
|
||||
슬라이스다. 이 폴더를 삭제하고 route 등록 한 곳만 제거했을 때
|
||||
`features/<feature>`는 구조를 설명하기 위한 완전한 수직
|
||||
슬라이스다(2026-11-07부터 템플릿의 예는 `create:feature`가 만드는 기능이다). 이 폴더를 삭제하고 route 등록 한 곳만 제거했을 때
|
||||
typecheck, architecture check, test와 build가 모두 통과해야 한다.
|
||||
|
||||
## 8. Input port 설계 규칙
|
||||
@@ -835,6 +835,10 @@ status/attempt/duration bucket만 전달한다.
|
||||
|
||||
## 16. Feature 경계와 removable reference feature
|
||||
|
||||
> 2026-11-07: 템플릿의 참조 샘플은 지웠다. 이 절이 참조 기능에 요구한 수직 경로와
|
||||
> 제거 검증은 `create:feature`가 만드는 기능이 맡는다(`test:feature-scaffold`가 게이트와
|
||||
> 제거를, `tests/e2e/generated-feature.spec.ts`가 실제 브라우저 경로를 본다).
|
||||
|
||||
Reference feature는 단순 UI fixture가 아니라 다음 경로를 모두 실행해야
|
||||
한다.
|
||||
|
||||
@@ -871,7 +875,7 @@ operation을 전역 core registry 안에 하드코딩하지 않는다.
|
||||
|
||||
제거 테스트는 다음을 수행해야 한다.
|
||||
|
||||
1. `src/features/reference-feature` 전체 삭제
|
||||
1. `src/features/<feature>` 전체 삭제
|
||||
2. reference route registration 삭제
|
||||
3. reference test 삭제 또는 제외
|
||||
4. 잔여 import와 registry owner 검색
|
||||
|
||||
@@ -101,21 +101,16 @@ rather than adding another independent route or data-loading convention.
|
||||
feature takes it over by declaring that route id (see "Product home and
|
||||
layouts"). Its starter links are the first three screens of the navigation.
|
||||
|
||||
The example screens `/examples/ui`, `/examples/states` and `/examples/auth`
|
||||
are one feature, `src/features/platform-examples-feature/`, in its own context
|
||||
`src/contexts/platform-examples-context/` (1103/09-04). A product turns them
|
||||
off like any feature: leave the id out of `VITE_PRODUCT_FEATURES`, or delete
|
||||
the feature. To delete it, remove those two folders and
|
||||
`tests/features/platform-examples-feature/` (its component tests), then run
|
||||
`corepack pnpm generate:feature-index`;
|
||||
`corepack pnpm test:sample-removal -- --feature=platform-examples-feature`
|
||||
does the same in a copy of the repository and runs the gates there. Their
|
||||
routes then leave the registry, the navigation, the bundle and the manual
|
||||
accessibility list (FE-GATE-028). This document keeps naming the three
|
||||
folders after they are gone: `verify:documentation` checks the paths of a
|
||||
removable template feature (`scripts/lib/removable-template-features.ts`)
|
||||
while the feature is installed and accepts them once its `feature-module.ts`
|
||||
is gone (1105/14-01).
|
||||
The template ships no example feature. Its example screens (`/examples/ui`,
|
||||
`/examples/states`, `/examples/auth`) and its reference sample were deleted on
|
||||
2026-11-07: the design-system and screen-state galleries are workshop stories
|
||||
(`src/presentation/design-system/galleries.stories.tsx`), and the manual
|
||||
(`docs/manual/`) with `create:feature` shows how a feature is built. A sample a
|
||||
product keeps for a while is listed in
|
||||
`scripts/lib/removable-template-features.ts`: `verify:documentation` checks its
|
||||
paths while it is installed and accepts them once its `feature-module.ts` is
|
||||
gone (1105/14-01), and `corepack pnpm test:sample-removal` removes it in a copy
|
||||
of the repository and runs the gates there.
|
||||
|
||||
The platform overview (`/examples/platform`,
|
||||
`src/presentation/examples/platform-overview-page.tsx`) stays a platform
|
||||
@@ -125,11 +120,12 @@ routes module before the page, a second request round the 200 ms budget does
|
||||
not fit. Its tests are the `tests/component/starter-*.test.tsx` files.
|
||||
|
||||
The platform's component tests (router, boundaries, shell, runtime tree) run
|
||||
on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx`
|
||||
and keep passing without the examples. The browser-level checks in
|
||||
`tests/e2e` and `tests/visual` use the example screens as their pages and run
|
||||
where the examples are installed: a product that leaves them out points those
|
||||
specs at its own screens or deletes them.
|
||||
on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx`.
|
||||
The browser-level checks in `tests/e2e` and `tests/visual` use the home page,
|
||||
the platform overview and the gallery stories; what needs a feature
|
||||
(`tests/e2e/generated-feature.spec.ts`, the chunk recovery spec) builds a copy
|
||||
of the repository with the one `create:feature` writes
|
||||
(`scripts/lib/generated-feature.ts`).
|
||||
|
||||
### Ownership declarations
|
||||
|
||||
@@ -168,7 +164,7 @@ selected app. Every build and check script runs it first; run it yourself with
|
||||
invalidation, topic versions and the external `contractPackages` the
|
||||
release manifest is checked against at boot), its message catalogs, and
|
||||
`loadRuntime`, which imports `feature-runtime.ts` dynamically.
|
||||
`src/features/reference-feature/feature-module.ts` is the complete example.
|
||||
`create:feature` writes a complete one.
|
||||
2. Create `src/features/<feature>/feature-runtime.ts` with
|
||||
`defineFeatureRuntime`: the `schemas` (FE-REG-SCHEMA rows for the
|
||||
feature's route and API schemas), the adapter contributions
|
||||
@@ -183,13 +179,14 @@ selected app. Every build and check script runs it first; run it yourself with
|
||||
executes, and `check:registries` governs the FE-REG-API row projected from
|
||||
it (`projectApiOperationRows` in `src/contracts/api-operations.ts`).
|
||||
A product feature's contract contribution uses an `EXTERNAL_PACKAGE`
|
||||
source. `TEMPLATE_FIXTURE` belongs to `reference-feature` only and never
|
||||
joins the release contract set; the composer rejects it anywhere else.
|
||||
source. `TEMPLATE_FIXTURE` was the template's reference sample source; it
|
||||
never joins the release contract set, and the composer rejects it in any
|
||||
product feature.
|
||||
3. Create `src/features/<feature>/context-routes.ts` exporting
|
||||
`FEATURE_CONTEXT_ROUTES`. Page components are imported lazily here, and each
|
||||
route handle carries the route's params/search `codecs`; the owning context
|
||||
loads this file only when its route root is visited
|
||||
(`src/features/reference-feature/context-routes.ts`). Each handle's
|
||||
(a `create:feature <id> --with-create` feature's `context-routes.ts`). Each handle's
|
||||
`routeId` must be a route of a feature contract in the same context; the
|
||||
context refuses the routes when they load, naming the route, context and
|
||||
features (`src/contexts/bounded-context-module.ts`).
|
||||
|
||||
@@ -157,7 +157,7 @@ export interface ApplicationFeatureInputs {}
|
||||
|
||||
declare module "../../../application/ports/in/application-api.ts" {
|
||||
interface ApplicationFeatureInputs {
|
||||
"reference-feature": ReferenceFeatureInput;
|
||||
"invoice-feature": InvoiceFeatureInput;
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -342,8 +342,8 @@ export function useCreateResourceMutation() {
|
||||
`useApplicationMutation`은 bound 정의(`BoundMutation`)만 받는다(1101/08-03).
|
||||
`{ execute }`만 넘기는 raw 형태는 멱등 키와 scope 확인 없이 쓰기를 보내고
|
||||
결과 불명 뒤 "다시 보내기"가 아무것도 하지 않아 타입에서 막는다. 실제 정의는
|
||||
`src/features/reference-feature/presentation/use-reference-feature.ts`의
|
||||
`REFERENCE_CREATE_MUTATION_POLICY`를 본다.
|
||||
`create:feature <id> --with-create`가 만드는 `presentation/use-<base>-create.ts`의
|
||||
작성 뮤테이션 정책을 본다.
|
||||
|
||||
기본 mutation은 navigation만으로 취소됐다고 가정하지 않는다. 서버 작업의 취소가
|
||||
안전한 operation만 controller가 보관한 `AbortController`와 명시적 cancel action을
|
||||
@@ -622,10 +622,9 @@ Form 또는 TanStack Form adapter를 평가한다.
|
||||
|
||||
- controller와 mapping: `src/presentation/forms`
|
||||
- layout-only template: `src/presentation/templates`
|
||||
- feature form schema/command mapper:
|
||||
`src/features/reference-feature/presentation/reference-resource-form.ts`
|
||||
- 실제 create page:
|
||||
`src/features/reference-feature/presentation/reference-resource-form-page.tsx`
|
||||
- feature form schema/command mapper: `create:feature <id> --with-create`의
|
||||
`presentation/<base>-form.ts`
|
||||
- 실제 create page: 같은 판의 `presentation/<base>-create-page.tsx`
|
||||
|
||||
`ApiFailure.validationIssues`는 HTTP 경계가 투영한 `path`와 `code`만 담는다.
|
||||
backend message와 알 수 없는 path는 field copy로 사용하지 않는다.
|
||||
|
||||
@@ -25,7 +25,7 @@ reader that accepts it must ship before any writer sends it.
|
||||
| `FEATURE_OVERRIDES` | record; unknown feature id ignored | additive | `featureOverrideArtifactSchema` in `src/contracts/release-artifacts.ts` |
|
||||
| Release manifest V2 | strict object | breaking | `releaseManifestV2ArtifactSchema` in `src/contracts/release-artifacts.ts` |
|
||||
| HTTP success/failure envelope (V3 with `responseEnvelope: "ENVELOPE_V1"`) | strict object (`meta` strips) | breaking | `successEnvelopeSchema`, `failureEnvelopeSchema` in `src/adapters/http/backend-envelope.ts` |
|
||||
| HTTP V3 response DTO (reference feature) | `.strip()` drops unknown fields | additive | `referenceResourceDtoSchema` in `src/features/reference-feature/contracts/reference-schemas.ts` |
|
||||
| HTTP V3 response DTO (a feature's) | `.strip()` drops unknown fields | additive | `<camel>ItemDtoSchema` in `contracts/<base>-schemas.ts` of a feature `create:feature` writes |
|
||||
| Realtime envelope | exact key set; unknown `eventType` is `MALFORMED_EVENT` | breaking | `decodeUnsafe` in `src/adapters/realtime/event-codec.ts` |
|
||||
| Browser RPC transport error code | closed vocabulary; unknown code is a protocol violation | breaking | `decodeTransportFailure` in `src/adapters/browser-rpc/browser-rpc-runtime.ts` |
|
||||
| Persisted client storage | versioned key; incompatible value discarded | use a new key version | `defineStorageKey` in `src/contracts/storage-keys.ts` |
|
||||
|
||||
@@ -156,10 +156,13 @@ node scripts/write-dev-release-manifest.ts # dev manifest에서 그 기능의
|
||||
- `test:feature-scaffold` (FE-GATE-020)
|
||||
- 저장소 복사본에 기능 둘(기본 하나, `--with-create --keyed` 하나)을 만들고 커밋한 뒤 게이트를 돈다.
|
||||
- 타입, lint, 아키텍처, 레지스트리, i18n, 디자인 시스템, 진단, 문서, unit, component, integration, 기능 테스트, 커버리지, CI 계약, 빌드.
|
||||
- `test:sample-removal` (FE-GATE-020)
|
||||
- 참조 기능을 지운 복사본에서 이 명령(`--with-create`)으로 기능을 만들고 같은 게이트를 다시 돈다. 명령과 쓰기 slice가 참조 기능에 기대지 않는다는 증거다.
|
||||
- `test:sample-removal -- --feature=<id>` (`test:feature-scaffold`가 부른다)
|
||||
- 위에서 만든 기본 기능을 복사본에서 지우고 같은 게이트를 다시 돈다. 생성 기능이 지워진다는 증거다.
|
||||
- 인자 없이 돌면(FE-GATE-020) `scripts/lib/removable-template-features.ts`에 적힌 샘플을 하나씩 지우고, 지운 복사본에서 이 명령(`--with-create`)으로 기능을 만들어 게이트를 다시 돈다. 템플릿은 그 목록이 비어 있어 건너뛰었다고(SKIP) 출력한다.
|
||||
- `tests/e2e/generated-feature.spec.ts` (`test:e2e`, FE-GATE-008)
|
||||
- 저장소 복사본에 `--with-create --keyed` 기능을 만들어 빌드하고, 실제 브라우저에서 로그인 뒤 목록, 폼 검증, 이탈 확인, 저장(멱등 키), 429 뒤 다시 시도, 결과 불명과 같은 키 재전송, 접근성(axe)을 본다. 생성기 출력이 바뀌면 여기서 잡힌다.
|
||||
|
||||
## 알려진 한계
|
||||
|
||||
- 드릴은 브라우저 테스트(FE-GATE-008·009의 `test:e2e`, `test:a11y` 등)와 `test:system`을 돌리지 않는다. `check:bundle`(FE-GATE-012)은 돈다.
|
||||
- 드릴은 브라우저 테스트(FE-GATE-008·009의 `test:e2e`, `test:a11y` 등)와 `test:system`을 돌리지 않는다. `check:bundle`(FE-GATE-012)은 돈다. 브라우저에서의 동작은 위 e2e spec이 고정한 이름(`order-feature`)의 기능 하나로만 본다.
|
||||
- 새 context는 앱이 하나일 때만 만든다. 앱이 여럿이면 `--context`로 기존 context를 고른다.
|
||||
|
||||
@@ -194,7 +194,7 @@ Captured after every correctness task landed.
|
||||
| `git diff --check` | 0 | clean |
|
||||
| `corepack pnpm test:component` | 0 | 126 passed |
|
||||
| `corepack pnpm test:integration` | 0 | 52 passed |
|
||||
| `corepack pnpm test:reference-feature` | 0 | 26 passed |
|
||||
| 참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) | 0 | 26 passed |
|
||||
| `corepack pnpm test:recipes` | 0 | 17 passed |
|
||||
| `corepack pnpm test:unit` | 1 | 1585 passed / 19 failed tests; the 19 are the unchanged pre-existing `ci-artifact-contract` sandbox failures |
|
||||
| `corepack pnpm check:registries` | 0 | 11 registries PASS |
|
||||
@@ -340,7 +340,7 @@ Run on the landed tree. Only what actually passed is claimed as passing.
|
||||
| `tests/unit` + `tests/integration`, no exclusions | — | 1643 passed / 1747; the 104 failures are the four environmental files below |
|
||||
| `corepack pnpm test:component` | 0 | 126 passed |
|
||||
| `corepack pnpm test:recipes` | 0 | 17 passed |
|
||||
| `corepack pnpm test:reference-feature` | 0 | 26 passed |
|
||||
| 참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) | 0 | 26 passed |
|
||||
|
||||
### Environmental failures, not claimed as green
|
||||
|
||||
|
||||
@@ -20,15 +20,16 @@ Performance evidence is deliberately split by measurement context:
|
||||
보고 예산을 정한다.
|
||||
|
||||
기준선 숫자는 이 문서에 적지 않는다. 손으로 적은 숫자는 두 번 낡았다. 기록은
|
||||
`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. 이 파일과 아래
|
||||
측정 테스트는 참조 기능을 복사해 재므로 샘플과 함께 지워진다. 문서 검사는 샘플을 지운 사본에서
|
||||
이 경로들을 요구하지 않는다(`scripts/lib/removable-template-features.ts`).
|
||||
`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. 측정은
|
||||
`create:feature <id> --with-create --keyed`가 만드는 기능을 복사해 잰다
|
||||
(`scripts/scale/measure-feature-shape-growth.ts`, 2026-11-07 전에는 참조 샘플을 복사했다).
|
||||
|
||||
| 칸 | 뜻 |
|
||||
|---|---|
|
||||
| `gzipBytes`, `files` | 템플릿 그대로의 초기 JS gzip bytes와 파일 수(entry 포함) |
|
||||
| `perFeatureGzipBytes` | 있는 context에 참조 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB |
|
||||
| `perContextGzipBytes` | 새 context를 하나 더할 때 느는 초기 JS. 상한 512 B |
|
||||
| `firstFeatureGzipBytes` | 기능이 없는 템플릿에 첫 기능(과 그 context)을 더할 때 느는 초기 JS. 모든 기능이 함께 쓰는 코드가 이때 초기 청크에 들어온다. 한 번만 든다. 상한 없음(전체는 `check:bundle`의 예산이 막는다) |
|
||||
| `perFeatureGzipBytes` | 있는 context에 생성 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB |
|
||||
| `perContextGzipBytes` | 둘째 기능을 같은 context 대신 새 context에 둘 때 느는 초기 JS. 상한 512 B |
|
||||
|
||||
- `tests/unit/feature-shape-growth.test.ts`(unit, merge 단계)가 매번 빌드해 이
|
||||
값을 재고, 상한을 넘거나 기록과 다르면(합계 256 B 초과, 파일 수 불일치, 기능·
|
||||
@@ -120,11 +121,14 @@ lab 측정(`scripts/test-performance.ts`, FE-GATE-026)은 local 프로필 build
|
||||
`context.sampling.targetDeepLink`에 남긴다. 예산은 `cls`와 같다(1105/15-01).
|
||||
- 대상 화면(플랫폼 구성)은 기능 코드를 받지 않으므로 기능이 늘어도 수치가
|
||||
거의 그대로다. 그래서 run마다 설치된 기능이 가진 첫 공개 내비게이션
|
||||
라우트(`labFeatureRoute`, 템플릿에서는 `EXAMPLES_UI`)를 같은 시계로 따로 잰다
|
||||
라우트(`labFeatureRoute`)를 같은 시계로 따로 잰다
|
||||
(`metrics.featureRouteInteractionMs`, `context.sampling.featureRoute`,
|
||||
1105/15-04). 그런 라우트가 없으면 `measured: false`로 남기고 판정하지 않는다.
|
||||
템플릿은 기능이 없어 재지 않는다(2026-11-07 예제 화면 삭제 뒤. 그 전에는 예제
|
||||
화면 `/examples/ui`가 이 라우트였다). 공개 내비게이션 라우트를 가진 제품 기능이
|
||||
생기면 그 라우트를 잰다.
|
||||
- 예산 `lab.featureRouteInteractionMs`는 500 ms다. 근거: `8a44226`에서 lab
|
||||
조건으로 `EXAMPLES_UI`를 5회 재니 중앙값 406 ms(403~410)였다. 그 진입은 요청
|
||||
조건으로 그때의 예제 화면 라우트를 5회 재니 중앙값 406 ms(403~410)였다. 그 진입은 요청
|
||||
두 묶음이다(context 라우트 모듈과 기능 실행부, 그다음 페이지 청크와 공유
|
||||
청크). 둘째 묶음이 약 100 ms(클릭 뒤 98~204 ms)다. 500 ms는 지금 진입을
|
||||
통과시키고, 같은 크기의 묶음이 하나 더 붙으면 넘는다.
|
||||
|
||||
@@ -62,8 +62,8 @@ Arbitrary-value policy:
|
||||
- user-controlled or runtime-composed class strings are forbidden
|
||||
- class variants must be selected from a closed static map
|
||||
|
||||
The removable reference feature may demonstrate tokens, but generic production
|
||||
starter modules do not import its domain, application, adapter, or presentation
|
||||
A feature may demonstrate tokens, but generic production starter modules do
|
||||
not import a feature's domain, application, adapter, or presentation
|
||||
implementation.
|
||||
|
||||
This file documents the currently implemented token and primitive baseline.
|
||||
|
||||
@@ -503,8 +503,9 @@ tests/support/query/
|
||||
helper는 production default를 복사하지 않는다. production factory를 호출하고
|
||||
필요한 시간·retry만 test override로 주입한다.
|
||||
|
||||
RP-05의 executable reference matrix는
|
||||
`tests/features/reference-feature`에 모여 있다. 설치 모드에서는 URL codec과
|
||||
RP-05의 executable reference matrix는 참조 샘플의 시험 폴더에 모여 있었다(2026-11-07
|
||||
샘플과 함께 삭제). 지금 기능 하나의 경로는 `create:feature`가 만든 기능의 시험
|
||||
(`tests/features/<id>/`)과 `tests/e2e/generated-feature.spec.ts`가 본다. 그때 설치 모드에서는 URL codec과
|
||||
query key/HTTP search의 동일성, DTO 차단, loading/success/empty/terminal,
|
||||
refreshing/stale, pending/duplicate/optimistic/conflict/rollback과 MSW production
|
||||
composition을 검증한다. 제거 모드는 feature source/tests와 installed
|
||||
@@ -513,8 +514,8 @@ contract/runtime/adapter contribution을 제거한 복제본에서 P0 gate와 bu
|
||||
|
||||
RP-06 form/page matrix는 `tests/component/form-foundation.test.tsx`,
|
||||
`tests/component/page-templates.test.tsx`,
|
||||
`tests/features/reference-feature/reference-page.test.tsx`와
|
||||
`tests/e2e/reference-form.spec.ts`에 있다. client validation에서 command 0회와
|
||||
생성 기능의 `<base>-create-page.test.tsx`와
|
||||
`tests/e2e/generated-feature.spec.ts`에 있다(2026-11-07 전에는 참조 샘플의 페이지 시험과 폼 e2e). client validation에서 command 0회와
|
||||
첫 오류 focus, Zod transform/default, pending 중 중복 제출, 승인된 422
|
||||
field/unknown field mapping, conflict 입력 보존, reset/dirty, navigation
|
||||
confirmation/focus restore, URL/storage 비노출과 320px reflow를 검증한다.
|
||||
|
||||
@@ -19,7 +19,7 @@ Each gate is blocking in its declared scope. Failures are not downgraded with
|
||||
`test:all` is the normal product-development loop. It runs, in order,
|
||||
`test:runtime-schema`, `test:unit`, `test:contract`, `test:component`,
|
||||
`test:integration`, the rest of what `test:coverage` runs (`tests/features`,
|
||||
the reference sample's tests among them, `tests/scripts` and
|
||||
each installed feature's tests, `tests/scripts` and
|
||||
`tests/scale/browser-soak.contract.test.ts`), `test:platform` (`tests/platform`
|
||||
and `tests/architecture`), `check:release-coherence` and `test:recipes`
|
||||
(`package.json` `test:all`). So every Vitest path the merge gate's coverage
|
||||
|
||||
Reference in New Issue
Block a user