38 lines
2.0 KiB
Markdown
38 lines
2.0 KiB
Markdown
---
|
|
type: concept
|
|
status: stable
|
|
related_pages: ["[[multi_environment_safety]]", "[[design_data_lifecycle]]"]
|
|
last_updated: 2026-09-12
|
|
source: ["docs/raw/verification/2026-09-12_공용_브라우저_운용.md"]
|
|
---
|
|
|
|
# 화면 검증 브라우저 운용
|
|
|
|
## 기본 선택
|
|
|
|
- 화면 검증 기본은 Orca 내장 브라우저다. 공용 브라우저는 사용자가 명시한 때만 쓴다.
|
|
- 공용 창과 Orca 탭을 동시에 띄우면 `snapshot`·`screenshot`이 충돌하므로 함께 사용하지 않는다.
|
|
- 검증은 직접 조작하고 `sessionStorage`, SVG 좌표, 툴팁, 스크린샷 등 수치 근거로 판정한다. 바꾼 값은 원래 상태로 복원한다.
|
|
|
|
## 공용 브라우저 시동과 조작
|
|
|
|
| 항목 | 위치·명령 | 역할 |
|
|
|---|---|---|
|
|
| 시동 | `./venv/Scripts/python.exe .claude/dev_up.py` | 서버와 공용 창을 시작하거나 살아 있는 프로세스 재사용 |
|
|
| Orca용 시동 | `dev_up.py --no-browser` | 서버만 시작 |
|
|
| 명령 큐 | `tmp/browser/cmd/NN_이름.py` | `page`, `log`, `shot`, `time` 전역으로 이름순 조작 |
|
|
| 드라이버 로그 | `tmp/browser/driver.log` | RUN·OK·ERROR·SHOT 결과 기록 |
|
|
| 스크린샷 | `tmp/browser/shots/` | 화면 검증 증거 저장 |
|
|
|
|
`tmp/`는 환경 사이에 전달되지 않는다. 남길 시험은 `resources/tester/`에 둔다. 브라우저 창 종료·재시작은 사용자 지시가 있을 때만 하며, 캐시는 CDP `Network.clearBrowserCache` 뒤 `page.reload()`로 비운다.
|
|
|
|
## 변경 종류별 반영
|
|
|
|
| 변경 | 공용 브라우저 | Orca |
|
|
|---|---|---|
|
|
| 페이지·공용 TypeScript | `page.reload()` | `orca reload` |
|
|
| B07 WebCAD | `npm run build` 후 캐시 비우기 | 빌드 후 `orca reload`; 캐시 잔존 여부 미확인 |
|
|
| Python·도면 템플릿 JSON | 백엔드만 재시작 | 백엔드만 재시작 |
|
|
|
|
공용 서버·브라우저의 포트와 주인은 현재 `OWNERS.md`를 따른다. `sessionStorage`는 포트별로 갈리므로 검증 포트에서 상태를 다시 세운다.
|