검수 시트(Excel .xlsx)를 파싱하여 항목을 등록합니다. DOM 수집은 하지 않고 메타데이터만 저장합니다. 등록 후 groups/independent_items 분류 정보를 반환합니다.

등록된 검수 항목 목록을 조회합니다. site, account로 필터링할 수 있습니다. 조회 전 data/sheets/ 폴더를 자동 동기화합니다.

검수 시트 엑셀 템플릿 파일 경로를 반환합니다. 템플릿이 없으면 자동 생성합니다.

특정 검수 항목의 메타데이터를 수정합니다. description, path 변경 시 scriptStatus가 pending으로 리셋됩니다 (스크립트 재생성 필요).

검수 항목과 관련 스크립트 파일을 삭제합니다. 단일(item_id) 또는 일괄(item_ids) 삭제를 지원합니다. data/sheets/ 폴더 엑셀에서 등록된 항목은 직접 삭제할 수 없으며, 엑셀에서 해당 행을 제거해야 합니다.

특정 항목 1개의 대상 페이지에 접속하여 DOM 구조를 수집합니다. 에이전트에게 스크립트 생성용 데이터를 반환합니다. 여정 그룹의 중간 항목은 선행 스크립트가 모두 ready 상태여야 합니다.

에이전트가 생성한 Playwright 스크립트를 구문 검증하고 저장합니다. 검증 실패 시 에러 메시지를 반환하므로 수정 후 재시도할 수 있습니다.

[스크립트 작성 규약]

• export 형식: module.exports = async (page) => { ... } (CommonJS)

• 인자: page (Playwright Page 객체) 하나만 전달됨. ({ page, expect }) 구조분해 사용 금지

• 반환: { pass: boolean, message: string, details?: object } 객체를 반드시 return

• import 금지: @playwright/test 등 외부 모듈 import/require 사용 금지. page 객체는 이미 제공됨

• 페이지 이동: 첫 페이지는 runner가 page.goto()로 이동 완료 후 스크립트 실행. 추가 이동만 작성

• Playwright API: page.locator(), page.click(), page.waitForSelector() 등 자유롭게 사용 가능

• 검증: expect 대신 직접 조건 체크 후 pass/message로 결과 반환

[올바른 예시] module.exports = async (page) => { const title = await page.locator('h1').textContent(); if (!title) return { pass: false, message: '제목을 찾을 수 없습니다' }; return { pass: true, message: '제목 확인 완료: ' + title }; };

등록된 전체 또는 일부 스크립트를 실행하여 검수를 수행합니다. 결과는 텍스트 요약으로 반환되며, 실패 항목의 스크린샷은 data/screenshots/{runId}/ 에 파일로 저장됩니다. 개별 실패 항목의 스크린샷을 확인하려면 run_qa_single로 해당 항목을 재실행하세요.

특정 항목 1개만 실행합니다. 디버깅 및 확인 용도로, 기본적으로 브라우저를 표시합니다.