스트리머용 이용 가이드

1. 이 서비스가 해 주는 일

한 줄로 말하면, 오늘 들어온 후원을 골라 화면에 붙여 두고, 그날 1등 후원자(MVP)를 같이 보여 줍니다.

• 벽지 — 후원 중에서 고른 항목을 OBS에 계속 띄웁니다.
• 오늘의 MVP — 그날 누적 후원이 가장 큰 닉네임을 보여 줍니다.
• 오늘 후원 목록 — 대시보드에서 목록을 보고, 원하는 줄에 「고정」을 누르면 벽지에 올라갑니다.
• 후원 랭킹 — 일·주·월·연·전체 순위를 보고, 필요하면 CSV로 내려받을 수 있습니다. 익명 후원은 기본적으로 따로따로 잡히고, 나중에 라벨로만 묶어 표시할 수 있습니다.
• 디스코드 — 알림을 웹훅으로 보내거나, 봇에서 후원을 직접 넣을 수 있습니다.
• 미션·펀딩바 — 접두어로 구분된 후원만 합산해 목표 금액을 오버레이에 보여 줍니다(설정에서 켜기).
• 시장 인텔(일별) — 연동·ingest 풀 기준 일별 치즈 요약을 대시보드에서 보거나, 연결된 디스코드로만 받을 수 있습니다(봇 `/market_daily`·`!시장`). 공식 전역 랭킹이 아닙니다.

플랫폼 기본 후원 알림(소리·효과)은 그대로 두고, 벽지·MVP는 이 서비스의 브라우저 소스 레이어로 추가합니다.

2. 처음 연동하기 (Oven 채널 + OBS)

1. 홈에서 「스트리머로 시작하기」로 Google 또는 Discord에 로그인해 Oven 채널을 만듭니다.
2. docsStreamer.s2.li2
3. 설정에서 오버레이 URL(토큰이 들어 있는 주소)을 발급·복사합니다.
4. OBS에서 소스 추가 → 브라우저 → URL 칸에 붙여 넣습니다. 크기는 방송 화면에 맞게 조절합니다.
5. 투명 배경을 쓰려면 브라우저 소스 설정에서 투명도 옵션을 켭니다.

연동 전에 화면만 보고 싶으면 「오버레이 미리보기」나 「데모 체험」을 먼저 쓰면 됩니다.

3. OBS 없이 먼저 보기 (추천)

OBS는 방송 송출 직전에만 켜도 됩니다. 그 전에는 아래만으로도 충분히 확인할 수 있습니다.

1. 데모 체험 — 화면 흐름만 보기 (저장 안 됨)
2. 오버레이 미리보기 — 벽지·MVP가 어떻게 보이는지
3. 후원 소스를 연결한 뒤 대시보드 — 실제 오늘 후원·MVP·랭킹 확인

후원은 치지직 실시간 수집, 디스코드 봇(!후원·/donate 등), 또는 운영 쪽에서 허용한 제3자 수집으로 들어올 수 있습니다.

4. 방송할 때마다

• 방송 전 — OBS에 브라우저 소스가 켜져 있고, URL이 예전과 같은지 확인합니다.
• 방송 중 — 후원이 들어오면 대시보드 목록에 쌓입니다. 고정한 항목이 벽지에 오릅니다. 웹훅을 켜 두었다면 디스코드로도 알림이 갑니다.
• 방송 후 — 당일 데이터는 그대로 두고, 다음 방송 때 이어서 쓰면 됩니다.

5. 마이페이지·설정에서 바꾸는 것

• 벽지·MVP 켜기/끄기, 금액·닉네임·메시지 보이기, 익명 처리, 색·크기·레이아웃 등.
• 디스코드 웹훅(후원 알림, 벽지 박제, MVP 알림).
• 시청자가 내 채널 도네를 자기 웹훅으로 구독하게 허용할지 여부.

설정을 바꾼 뒤에는 오버레이 브라우저 소스를 새로고침하면 반영됩니다.

대시보드 랭킹에서 날짜·순위 개수·익명 보기 방식을 고르고, 표를 CSV로 저장할 수 있습니다.

6. 디스코드 봇 — 짧게 쓰는 순서

Oven이 운영 중인 서버에 봇이 붙어 있을 때 아래 순서대로 하면 됩니다. 직접 봇을 호스팅하지 않으면 6.1은 건너뛰어도 됩니다.

6.1 시작 전

• 접두사 명령(!도움말 등)은 Discord에서 Message Content Intent가 필요합니다. 슬래시(/help, /donate 등)는 Intent 없이도 됩니다.
• 봇을 직접 돌리는 경우에만 디스코드 봇 토큰·Oven 서버 주소가 필요합니다. 일반 스트리머는 웹에서 연결 코드만 받으면 됩니다.
• 채널을 연결하기 전에도 !도움말 또는 /help로 안내를 볼 수 있습니다.

6.2 5분 체험

1. 디스코드 채널 연결에서 코드를 받고, 디스코드 채팅에 !채널연결 A1B2C3처럼 입력하거나 /link_channel의 code에 같은 6글자를 넣습니다.
2. !후원 1000 테스트·/donate 또는 !감사 테스트·/thanks
3. !벽지핀·/pin_wall 또는 !수동핀 …·/manual_pin
4. !mvp 닉네임 5000 또는 /mvp
5. 대시보드와 웹훅으로 잘 반영되었는지 확인합니다.
6. 치지직만 빠르게 보려면 봇 가이드의 `/chzzk_glance`·`!치지직한눈 …` 등 — Oven 채널 연결 없이 ID·URL만으로 요약을 띄울 수 있습니다.

6.3 명령어 표

슬래시 이름은 Discord 규칙상 영문입니다. 전체 매핑은 레포 apps/discord-bot/README.md를 참고하세요.

슬래시·접두사 전체와 복사 예시는 디스코드 봇 가이드에 정리해 두었습니다.

한국어 서버에서는 !채널연결·!후원 등 한글 접두사가 기본입니다. 영문 UI를 쓰더라도 동일 API를 /link_channel·/donate 등 슬래시 명령으로 호출할 수 있습니다(봇 README 참고).

6.4 잘 안 될 때

• /help는 되는데 !도움말만 안 되면 → Message Content Intent를 켜세요.
• 후원·핀이 안 되면 → !채널목록 또는 /channel_list로 이 채널이 연결됐는지 확인.
• 데모 사이트에서만 봇을 쓸 수 없다면 → 정상입니다. 봇은 라이브 API용입니다.

7. 특정 플랫폼 로그인 없이 데이터만 넣는 경우

운영자가 허용한 경우, 제3자 알림·운영자용 수집으로 후원이 들어올 수 있습니다. 플랫폼 관리 화면과 스트리머 설정을 함께 맞춰야 합니다.

8. 익명 후원에 대해

익명으로 들어온 후원은 누구인지까지 정확히 알 수 없다고 보는 것이 안전합니다. 서비스는 익명을 기본적으로 따로 잡고, 랭킹·알림도 그 전제에 맞춥니다.

9. 한눈에 보기

문의는 헤더의 문의하기를 이용해 주세요.