# 녹음 동의 사이트 + 따라가며 녹음하는 봇 본인이 직접 사이트에서 **디스코드로 로그인하고 녹음 동의**를 누른 사람만, 디스코드 음성채널에 따라 들어가 **그 사람 목소리만** 녹음합니다. 녹음은 나중에 그 사람 목소리 모델(RVC 등)을 학습하는 데이터로 씁니다. ## 동작 - 사이트 (`src/site.ts`): 디스코드 로그인(OAuth2 `identify` 권한만) → 동의 문구 + 체크 3개(계정 주인 · AI 음성 모델 용도 이해 · 만 14세 이상)를 모두 직접 체크해야 동의. **녹음할 서버**도 같이 고른다 (봇과 내가 함께 들어가 있는 서버만 보이고, 하나 이상 골라야 동의). 동의한 뒤에도 사이트에서 언제든 바꿀 수 있고, 뺀 서버에서는 바로 녹음을 멈춘다. 내 상태(동의 여부 · 지금 녹음 중인 채널 · 녹음 개수/길이), 동의 철회(녹음 파일 같이 삭제 기본), 녹음 파일만 삭제, 로그아웃. - 봇 (`src/bot.ts`): 동의한 사람이 **녹음할 서버로 고른 서버**의 음성채널에 들어가면 따라 들어가고, 옮기면 따라 옮기고, 동의자가 모두 나가면 나간다. 서버마다 음성 연결은 하나라서 한 서버에서 동의자가 여러 채널에 흩어져 있으면 지금 채널 유지 → 방금 움직인 사람 → 동의자가 많은 채널 순으로 고른다 (`src/follow.ts`). - 녹음 (`src/recorder.ts`): 디스코드가 사람별로 따로 보내는 음성 스트림 중 **동의한 사람 것만 구독**한다. 동의 안 한 사람의 소리는 받지도 저장하지도 않는다. 말이 0.8초 끊길 때마다 파일 하나(최대 30초, 0.5초 미만 버림), Opus 그대로 `data/recordings/<아이디>/<날짜>/.ogg`. 말하는 도중 철회하면 쓰던 파일도 버린다. - 운영자 (`ADMIN_DISCORD_IDS`): 사이트에서 **앱 연결 키**를 만들고, 음성 변환기 앱의 "녹음 서버" 화면에서 그 키로 봇이 녹음할 서버를 켜고 끈다 (`GET/POST /api/guilds`, `Authorization: Bearer <키>`, 키는 해시로만 저장, 새로 만들면 예전 키는 무효). 끈 서버에서는 바로 나간다. `.env` 의 `ALLOWED_GUILD_IDS` 밖의 서버는 앱에서도 켤 수 없다. - 알림: 봇이 채널에 들어가면 그 채널 채팅에 녹음 안내(누구 목소리만 녹음하는지 + 사이트 주소)를 남기고, 봇 상태를 "🔴 동의한 사람 녹음 중"으로 바꾼다. - 동의 기록: `consent_log` 테이블에 동의 · 철회 · 삭제 · 내보내기를 시각과 문구 버전으로 남긴다. 동의 문구를 바꾸면 `src/consent-text.ts` 의 `CONSENT_VERSION` 을 올린다 → 예전 동의자는 다시 동의할 때까지 녹음하지 않는다. - 보안: OAuth state 는 로그인을 시작한 브라우저 쿠키와 맞춰 확인, 동의 제출은 화면의 문구 버전이 지금 버전과 같을 때만, 세션 · state 는 해시로만 저장, 디스코드 액세스 토큰은 저장하지 않음, 모든 form 에 CSRF 토큰 + Origin 확인, 클릭재킹 차단(`frame-ancestors 'none'`, `X-Frame-Options: DENY`), https 쿠키는 `__Host-` + Secure. - 디스코드 음성 종단간 암호화(DAVE)는 `@discordjs/voice` 0.19 + `@snazzah/davey` 로 지원. ## 준비 (디스코드 개발자 포털) 1. https://discord.com/developers/applications 에서 앱 만들기 2. **Bot** 탭: 토큰 발급 → `DISCORD_BOT_TOKEN`. Privileged Intent 는 필요 없음 3. **OAuth2** 탭: Client ID / Client Secret → `DISCORD_CLIENT_ID` / `DISCORD_CLIENT_SECRET`, Redirects 에 `/callback` 추가 4. 봇 초대: OAuth2 URL Generator 에서 scope `bot`, 권한 `View Channels` · `Connect` · `Send Messages`(녹음 안내용) ## 실행 ```bash cd consent-recorder npm install cp .env.example .env # 값 채우기 npm run build npm start # 사이트 http://HOST:PORT + 봇 ``` 사이트는 기본 `127.0.0.1:8787` 에 뜬다. 바깥에서는 리버스 프록시(NPMplus 등)로 https 도메인을 붙인다 (`PUBLIC_URL` 은 https 여야 함). ## 학습 데이터 꺼내기 ```bash npm run cli -- status # 동의자 · 녹음 양 npm run cli -- export <디스코드 아이디> ./dataset # 48kHz 모노 wav, -18 LUFS 평준화 + 리미터 (ffmpeg 필요) ``` `export` 는 **지금 동의 중인 사람만** 내보낸다 (철회했거나 문구가 바뀐 사람은 거절). 철회한 사람의 이미 학습된 모델은 이 프로그램 밖에 있으므로 운영자가 직접 지워야 한다. ## 테스트 ```bash npm test # 가짜 디스코드 OAuth 서버로 로그인(state 쿠키) → 동의(문구 버전) → 철회/삭제, CSRF · 클릭재킹, 채널 고르기 · 정원 찬 채널 유지, 동의자만 녹음 · 삭제 시 진행 중 녹음 폐기 ```