e2e-pom

# /qa-e2e-pom: 페이지 객체 디스커버리 & 힐링 두 가지 모드. **Build**는 인터랙티브 -- 발견한 것을 사용자가 확인합니다 (헤드리스: 증명 실행 -- 개수 1, 가시 -- 이 곧 확인이며, 모호함은 Heal과 똑같이 플래그하지 절대 고르지 않습니다). **Heal**은 자율 실행 -- 드리프트를 수리하고 수리할 수 없는 것은 플래그합니다. 둘 다 POM 스타일, 인증, white-box 모드를 위해 `playwright/AUTOMATION.md` (`/qa-e2e-setup` 산출물)를 읽습니다. AUTOMATION.md 없음 → `/qa-e2e-setup` 먼저. **코드 표준:** POM 코드를 쓰기 전에 `{{REFERENCE_PATH}}/playwright-patterns.md`를 읽으세요 -- POM 템플릿, 셀렉터 규칙, exact-match / 스코핑 함정이 거기 있습니다. 그 다음 프로젝트 학습 파일(프리앰블 참조) -- 이 스킬에 스코프된 active `LRN-` 항목이 그 패턴들을 오버라이드합니다. ## 제약 사항 1. **라이브 증명 없이 로케이터 없음.** 셀렉터는 실행 중인 앱에 대해 실행된 후에만 POM에 들어갑니다: 해석됨, 기대 개수(1, 또는 스코프된 n), 보임. 디스커버리 중 앱 접속 불가 → 증명 안 된 요소는 POM 밖에 남고 상태는 BLOCKED. 그럴듯한 추측을 절대 쓰지 않습니다. 2. **수요 기반 인벤토리.** 주어진 테스트 케이스가 건드리는 요소만 매핑합니다. "온 김에 전부 매핑해줘"라는 요청은 거절하고 설명합니다: 참조되지 않는 요소는 검증 불가능한 유지보수 부채 -- 테스트 케이스가 필요로 할 때 매핑됩니다. 3. **셀렉터 우선순위:** `getByTestId` > `getByRole(name)` > label/placeholder > CSS (최후 수단, `fragile: true` 표시). XPath 금지. 4. **중복은 인덱싱이 아니라 스코핑으로.** 로케이터가 요소 2개 이상에 매칭되면 (숨겨진 채 attached된 것도 셈!), 부모로 스코프(`row.getByTestId`)하지 `.nth()`를 쓰지 않습니다. DOM이 해소 못 하는 모호함 → 사용자에게 질문 (build) 또는 플래그 (heal). 5. **이름 조회는 exact-match.** `filter({ hasText: name })`은 부분 일치 -- "Pliers"가 "Combination Pliers"에도 매칭됩니다. 이름 기반 행/카드 로케이터는 `filter({ has: page.getByText(name, { exact: true }) })`. (실전에서 확인: 엉뚱한 상품 클릭 + strict mode 위반, 2026-08-07.) 6. **검증 스펙이 게이트입니다.** build/heal이 DONE을 보고하기 전에 `pom-verification.spec.ts`가 green이어야 합니다. 드리...