feat: external video player flow and discord playback link improvements

README.md

@@ -0,0 +1,135 @@
+# Discord Multi Bot (Music / Manage / Notify)
+
+TypeScript 기반 디스코드 봇 템플릿입니다. 음악 재생은 Lavalink(Shoukaku)로 동작합니다.
+
+## Stack
+- TypeScript + Node.js 20+
+- discord.js v14
+- PostgreSQL + Prisma
+- Redis + BullMQ
+- Lavalink + Shoukaku
+
+## 1) 환경 변수
+```bash
+cp .env.example .env
+```
+
+`.env` 예시:
+```env
+DISCORD_TOKEN=...
+DISCORD_CLIENT_ID=...
+DISCORD_GUILD_ID=... # 개발/테스트 서버 ID
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/discord_multibot
+REDIS_URL=redis://localhost:6379/1
+LAVALINK_NODE_NAME=local
+LAVALINK_HOST=127.0.0.1
+LAVALINK_PORT=2333
+LAVALINK_PASSWORD=youshallnotpass
+LAVALINK_SECURE=false
+LOG_LEVEL=info
+```
+
+## 2) PostgreSQL 준비
+예시:
+```bash
+docker run -d \
+  --name discord-postgres \
+  -e POSTGRES_USER=postgres \
+  -e POSTGRES_PASSWORD=postgres \
+  -e POSTGRES_DB=discord_multibot \
+  -p 5432:5432 \
+  -v discord_postgres_data:/var/lib/postgresql/data \
+  postgres:16
+```
+
+## 3) Lavalink 준비 (Docker)
+프로젝트 루트에서:
+```bash
+docker compose -f docker-compose.lavalink.yml up -d
+```
+
+상태 확인:
+```bash
+docker logs -f discord-lavalink
+```
+
+## 4) 의존성/DB 초기화
+```bash
+npm install
+npm run prisma:generate
+npm run prisma:push
+```
+
+## 5) 실행
+```bash
+npm run dev
+```
+
+정상 로그 예시:
+- `Guild commands registered`
+- `Bot ready`
+
+## 명령어
+### Music (Lavalink)
+- `/play query:<검색어 또는 유튜브 URL>`
+- `/queue`
+- `/skip`
+- `/stop`
+
+### Manage
+- `/warn user:<user> reason:<string>`
+- `/warnings user:<user>`
+
+### Notify
+- `/notify_schedule channel:<channel> cron:<expr> message:<text>`
+- `/notify_list`
+- `/notify_disable rule_id:<id>`
+
+### News
+- `/news query:<optional>`
+
+### Summarize (Google AI Studio)
+- `/summarize url:<url> mode:<auto|fast|quality>`
+
+### Translate
+- `/translate text:<text> source:<optional> target:<optional>`
+- 우선순위: `DeepL API` -> `deepl-cli(web)` -> `Google Web v2`
+
+## 실제 사용 예시
+1. 봇과 사용자 모두 같은 음성 채널 입장
+2. 텍스트 채널에서:
+   - `/play query:아이유 밤편지`
+   - `/play query:https://www.youtube.com/watch?v=...`
+3. 제어:
+   - `/queue` (대기열 확인)
+   - `/skip` (다음 곡)
+   - `/stop` (정지 + 음성채널 퇴장)
+
+4. 접두사 명령:
+   - `!play <검색어 또는 URL>`
+   - `!queue`
+   - `!skip`
+   - `!stop`
+   - `!뉴스 [키워드]`
+   - `!news [keyword]`
+   - `!요약 <url> [auto|fast|quality]`
+   - `!summarize <url> [auto|fast|quality]`
+   - `!번역 [source->target] <텍스트>` (기본 `auto->ko`)
+   - `!translate [source->target] <text>`
+   - `!ani "제목"` (gds_dviewer 애니 검색)
+   - `!영화 "제목"` / `!movie "title"` (gds_dviewer 영화 검색)
+
+## 참고
+- `REDIS_URL`이 없으면 BullMQ 워커는 비활성화됩니다.
+- YouTube 재생 안정성은 Lavalink 서버 상태/플러그인에 영향받습니다.
+- 요약 기능은 `GEMINI_API_KEY`가 필요합니다.
+- 번역 기능은 `DEEPL_API_KEY`가 없으면 `deepl-cli`를 먼저 시도하고, 실패 시 `Google Web v2`를 사용합니다.
+- `deepl-cli` 테스트용 설정:
+  - `DEEPL_CLI_BIN=deepl`
+  - `DEEPL_CLI_TIMEOUT_MS=45000`
+  - pyenv 사용 시 예시: `DEEPL_CLI_BIN=/Users/yommi/.pyenv/versions/3.11.0/envs/FF_3.11/bin/deepl`
+- `!ani` 기능 환경 변수:
+  - `GDS_DVIEWER_BASE_URL=http://127.0.0.1:9099/gds_dviewer/normal/explorer`
+  - `GDS_DVIEWER_API_KEY=...`
+  - `GDS_DVIEWER_SOURCE_ID=0`
+  - `EXTERNAL_VIDEO_PLAYER_URL=https://your-domain/player/external_video_player.html` (Discord 노출 URL 분리용, 권장)