docs: 출시 후 Ref 비교 기준을 개념 계약으로 조정

This commit is contained in:
2026-08-28 07:07:06 +00:00
parent c741ef4be5
commit 8ad10e6b2c
3 changed files with 44 additions and 9 deletions
@@ -6,6 +6,14 @@
상태 mutation과 persistence 순서를 비교합니다. 명령 이름이나 최종 성공 여부만
같은 것은 호환성 근거가 아닙니다.
이 비교는 차이를 검출하는 장치이지 모든 차이를 제품 결함으로 판정하는 장치가
아닙니다. 대상 영역을 먼저 계승 계약, 의도적 제품 차이, 누락·회귀 또는 비교
불가로 분류합니다. Exact equality는 계승 계약에만 요구합니다. 밸런스 조정이나
신규 규칙처럼 의도적으로 결과가 달라지는 영역은 목적·적용 버전·영향 필드·RNG와
persistence 변화·migration 경계를 mapping/report에 기록하고, versioned fixture나
명시적인 기대 차이와 Core 회귀 테스트로 검증합니다. 단순히 Ref 차등 suite를
skip하거나 느슨한 정규화로 차이를 숨기지 않습니다.
## 검증 계층
| 계층 | 위치 | 보장 범위 |
+8
View File
@@ -5,6 +5,14 @@ are enforced while the PHP frontend is moved to the Vue applications. The
workspace-level `docs/ref-core2026-mapping.md` remains the source of truth for
the end-to-end PHP-to-core2026 mapping.
Ref comparison detects missing information and unintended interaction or layout
regressions; it does not permanently freeze every Core screen pixel-for-pixel.
Classify each difference as an inherited contract, an intentional product
difference, a missing/regressed behavior, or a Core-only feature. Exact visual
equality applies only where the inherited contract declares it. Intentional UX,
accessibility, or responsive changes need a documented scope, user impact, and
Core-owned geometry and interaction assertions instead of a disabled parity test.
## Canonical browser fixture
`tools/frontend-legacy-parity/fixtures/canonical.ts` contains deterministic,