User Guide

### 1. 오버레이 위젯 URL 준비 및 OBS 등록
* **위젯 링크 복사**: 대시보드의 `상품/시그` 카드 옆의 **복사 아이콘(📋)**을 클릭하여 순위표 전용 오버레이 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
  1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
  2. 복사한 순위표 위젯 URL을 붙여넣습니다.
  3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.

---

### 2. 실시간 멤버 추가 및 삭제 관리 (실시간 관제)
엑셀 방송 시작 전 또는 진행 중에 랭킹보드에 표시할 BJ 멤버들을 유연하게 구성할 수 있습니다.

* **간편 멤버 추가**:
  * 설정 페이지 하단에 제공되는 사이트 정회원(레벨 3 이상) 목록에서 참여할 멤버들의 체크박스를 체크하여 선택합니다.
  * 목록에 없는 멤버는 ID 입력 칸에 줄바꿈이나 쉼표(,)로 구분하여 직접 ID를 입력해 빠르게 추가할 수 있습니다.
* **멤버 즉시 삭제**:
  * 리스트에서 체크 해제하거나 수동 입력란에서 삭제 후 설정을 저장하면, 해당 멤버의 기록이 방송 화면 랭킹 테이블에서 즉시 제외됩니다.

---

### 3. 정산용 엑셀(Excel) 데이터 다운로드 기능
* **엑셀 추출 방법**:
  * 설정 화면 우측 상단 또는 리스트 영역 주변의 **[엑셀 다운로드]** 버튼을 클릭합니다.
  * 현재 방송 기간(금일 또는 전체 누적) 동안 각 멤버들이 획득한 캐시, 하트, 매출 기여도가 집계된 고유 데이터가 정산용 엑셀 시트로 즉시 저장됩니다.
  * 합동 방송 종료 후 기여도에 따른 수익 분배 및 정산 처리를 할 때 수작업 없이 1초 만에 깔끔하게 처리가 가능합니다.

---

### 4. 엑셀 방송용 맞춤형 연출 설정
* **커스텀 레이블 지정**:
  * 테이블의 헤더 이름(예: 순위 ➡️ '#', 멤버 ➡️ 'BJ명', 캐시 ➡️ '후원금액', 하트 ➡️ '별풍선' 등)을 원하는 호칭으로 변경할 수 있습니다.
* **목표 달성 게이지바 기능 (`gauge_max`)**:
  * 각 멤버별 개인 목표치 금액을 지정해 두면, 순위 테이블 옆에 **실시간 게이지 그래프 바**가 차오르는 효과가 부여되어 시청자들의 경쟁적 후원을 유도하기 좋습니다.
* **확장 필드 표시 (예: 화장실 벌칙 등)**:
  * 회원 DB 정보 중 별도 여분 필드(예: `mb_2` 등)를 연동하여 특정 리액션 횟수나 벌칙 카운트 현황 등을 표에 추가 열로 노출할 수 있습니다.

---

### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **멤버를 추가했는데 화면에 바로 순위가 반영되지 않을 때**:
  * 추가된 멤버의 DB 후원 매출 기록이 0원일 경우, 설정에서 '0원 멤버 노출 여부'가 체크되어 있지 않다면 숨김 처리될 수 있습니다.
  * OBS 소스 갱신 주기를 감안하여 소스 새로고침을 실행하면 즉시 적용됩니다.