Runtime Contract 기반 Release Gate 도입을 통한 브라우저 자동화 신뢰성 확보

Context

Playwright 기반 자동화 작업이 로컬 환경과 팀 실행 환경 간의 불일치로 인해 빈번하게 실패하는 문제 발생. 단순 Retry 방식으로는 해결 불가능한 Profile 불일치, Proxy 지역 오류, Session 만료 등의 런타임 환경 제약 사항이 주요 병목 지점으로 파악됨.

Technical Solution

• 브라우저 Profile, Proxy, Session 상태를 하나의 Runtime Contract로 정의하여 Task 실행 전 검증하는 Release Gate 패턴 설계
• BrowserRunContext 객체를 통해 실행 환경의 메타데이터를 구조화하여 단순 스크립트 중심에서 컨텍스트 중심 모델로 전환
• Profile Identity 검증 로직을 통한 승인된 계정 환경 내에서의 실행 보장
• Proxy 및 Detected Region의 일치 여부를 확인하여 네트워크 환경의 일관성 확보
• SessionCheckUrl을 활용한 실제 DOM 요소 검증으로 로그인 상태의 유효성을 사전에 판별
• Evidence Plan 설정을 통해 디버깅에 필요한 Screenshot, Step Log, Stop Reason의 강제 수집 구조 마련