Admin Practice

VIDLOCK 버그 수정 연습

관리자·개발자가 PC에서 앱을 실행하고, 아래 체크리스트대로 버그를 재현·수정·검증하는 연습용 페이지입니다. 이 페이지는 어디서든 링크로 열 수 있습니다.

← 소개 페이지

01 연습 환경 준비 (PC에서 1회)

웹 링크만으로는 앱이 실행되지 않습니다. 아래 순서로 로컬 PC에서 앱을 켠 뒤, 이 페이지의 체크리스트를 보며 연습하세요.

Node.js 18+ 설치 → VIDLOCK 폴더 열기

# 호스트(관리자) 앱
cd vidlock-desktop
npm install
npm start

# 참가자 앱 (새 터미널)
cd vidlock-participant
npm install
npm start

Windows: 시작_호스트.bat / 시작_참가자.bat 더블클릭으로도 실행 가능

02 연습 진행률

0 / 0 완료 · 체크는 이 브라우저에 저장됩니다

03 알려진 버그 · 연습 과제

Bug #5 참가자 앱에서 Zoom 초대 링크 → 보호 참가 클릭 시 회의 창이 열리는지 확인
IPC 참가자 DevTools(F12, dev 모드)에서 open-meeting-inapp 채널 에러 없는지 확인
링크 https://us06web.zoom.us/j/숫자?pwd=... 형식 링크가 wc/join URL로 변환되는지 확인
호스트 Desktop 트레이 → 정보 → 버전 v1.6.1, 문구 Zoom 전용 표시 확인
호스트 UI에 "웹캔" 오타 없이 웹캠으로 표시되는지 확인

04 테스트 시나리오 (실전 연습)

1 Zoom에서 테스트 회의 1개 생성 (초대 링크 복사)
2 참가자 앱 → 회의 참가 → 링크 붙여넣기 → 보호 참가
3 호스트 앱 → 같은 링크로 보호 참가 (또는 회의 ID + 비밀번호)
4 회의 중 OBS 등 녹화 프로그램 실행 → 블랙아웃/차단 동작 확인
5 회의 종료 버튼 → 창 닫힘 · 에러 없음 확인

05 IPC 채널 참고 (수정 시 맞춰야 할 이름)

preload (호출)	main.js (등록)
`open-meeting-inapp`	`open-meeting-inapp`
`close-meeting-inapp`	`close-meeting-inapp`
`hide-meeting-view`	`hide-meeting-view`

이름이 open-meeting-in-app처럼 다르면 회의 창이 안 열립니다.

06 버그 발견 시 기록 양식

[VIDLOCK 버그 리포트]
앱: 호스트 / 참가자
버전: v1.6.1 / v1.0.0
증상:
재현 순서:
1.
2.
3.
기대 결과:
실제 결과:
스크린샷/콘솔 에러:

07 수정 완료 후 검증

✓ npm start 로 두 앱 모두 재실행 후 동일 시나리오 통과
✓ HANDOFF.md 알려진 버그 항목 업데이트
✓ Cursor/개발자에게 증상·수정 내용 전달