visual-qa은(는) 무엇을 하나요?
유효한 JSX가 좋은 디자인을 증명하지는 않습니다. UI 작업을 완료했다고 보고하기 전에 반드시 시각적으로 확인하세요.
핵심
웹사이트를 로컬에서 실행하세요.
검사:
375px
390px
768px
1440px
1920px
스크린샷을 캡처하세요.
각 스크린샷을 다음 항목에 대해 검토하세요:
- 깨진 레이아웃
- 약한 계층 구조
- 과도한 여백
- 부족한 여백
- 보기 흉한 줄 바꿈
- 잘못된 이미지 크롭
- 일관되지 않은 여백
- 지나치게 큰 타이포그래피
- 지나치게 작은 타이포그래피
- 약한 CTA 가시성
- 정렬 문제
- 일반적인 AI 디자인 패턴
발견된 문제를 수정하세요.
주요 시각적 문제가 없을 때까지 반복하세요.
실행 방법
개발 서버를 시작한 후:
QA_ROUTES=/,/services,/doctors,/contact node scripts/qa-screenshots.mjs
출력은 qa/<route>/<width>.png에 전체 페이지로, 브레이크포인트당 하나의 파일로 저장됩니다.
스크립트는 브레이크포인트당 가로 오버플로와 콘솔 오류도 보고합니다 — 둘 다 자동 실패로 간주됩니다.
캡처되는 브레이크포인트: 375×812, 390×844, 430×932, 768×1024, 1440×900, 1920×1080.
최초 설정:
npm i -D playwright && npx playwright install chromium
전체 스윕 대신 대화형으로 탐색하려면 에디터 내 브라우저 도구가 더 빠릅니다: 페이지를 열고, 크기를 조정하고, 접근성 트리를 읽고, 콘솔을 확인하세요.
스크린샷 읽기
브레이크포인트별로 진행하세요. 각각에 대해 다음 질문에 답하세요:
- 가로로 오버플로되는 요소가 있습니까?
- 명확한 초점이 하나 있습니까, 아니면 눈이 분산됩니까?
- 제목이 보기 흉한 고아 단어나 한 단어로 마지막 줄이 바뀌었습니까?
- 섹션 간 여백이 일관되어야 할 곳에서는 일관되고, 의도적으로 달라야 할 곳에서는 확연히 다릅니까?
- 이미지가 얼굴, 접시 또는 침대를 통해 크롭되었습니까?
- 기본 CTA가 해당 화면에서 가장 눈에 띄는 요소입니까?
- 모바일에서: 고정 CTA가 보이고, 엄지손가락으로 닿기 쉬우며, 콘텐츠를 가리지 않습니까?
- 기본 AI 페이지처럼 보이는 요소(그라데이션, 아이콘 카드 그리드, 알약 배지, 흐릿한 블롭)가 있습니까?
모바일 전용 확인 사항
지역 비즈니스 방문자는 Instagram, Google Maps, TikTok, 광고 및 메신저 링크를 통해 유입됩니다. 모바일은 부차적인 고려 사항이 아닌 주요 표면입니다.
- 375px에서 가로 스크롤이 없어야 함;
- 히어로 텍스트가 너무 커서 첫 화면 전체를 차지하지 않아야 함;
- 탭 대상이 충분히 크고, 작은 것이 없어야 함;
- 내비게이션에 접근 가능하고 닫을 수 있어야 함;
- 이미지가 세로 모드에 맞게 크롭되고, 가로 데스크톱 크롭에서 찌그러지지 않아야 함;
- 고정 CTA가 있고 정제되어 있어야 함.
루프 규율
- 문제를 수정한 후 다시 캡처하세요. 블라인드로 수정하지 마세요.
- 목록이 지루해질 때가 아니라, 전체 스윕에서 주요 문제가 발견되지 않을 때 중단하세요.
- 수정 후 동일한 문제가 다시 나타나면, 페이지가 아닌 블록에 문제가 있는 것입니다 — 블록 라이브러리에서 수정하세요.
- 정직하게 보고하세요: 브레이크포인트에 여전히 미해결 문제가 있다면 그렇게 말하세요.