feat(voice): модерация через RoomService, саундборд и звуковая палитра

AGENT.md 7.13, 7.14:

- `internal/voice/admin.go` — клиент RoomService (Twirp/JSON, без SDK):
  GetParticipant, ListParticipants, MutePublishedTrack, RemoveParticipant с
  административным токеном; внутренний адрес SFU задаётся LIVEKIT_API_URL;
- серверный мьют теперь применяется и на стороне SFU (клиент не обойдёт),
  кик из голосовой (DELETE /guilds/{id}/voice-states/{user_id}) удаляет
  участника из комнаты через RemoveParticipant, перемещение — тоже;
- саундборд и звуковая палитра: таблица `guild_sounds` (миграция 00010),
  загрузка MP3/OGG/WAV/WebM/M4A до 512 КБ с MANAGE_SOUNDS, отдельные лимиты
  30 + 30, переименование, удаление, список с фильтром по виду;
- проигрывание POST /guilds/{id}/sounds/{sound_id}/play: нужно право
  USE_SOUNDBOARD и присутствие в голосовой комнате, событие SOUNDBOARD_PLAY
  уходит только участникам этой комнаты (звук играют клиенты), лимит 3 звука
  за 10 секунд; набор звуков приходит в READY и обновляется событием
  GUILD_SOUNDS_UPDATE;
- тесты: права на загрузку, требование события для звука интерфейса, запрет
  проигрывания вне комнаты, лимит частоты, переименование и удаление.
This commit is contained in:
2026-09-20 19:01:14 +03:00
parent 3ae03ec515
commit 1552146aa1
13 changed files with 1056 additions and 10 deletions
+12
View File
@@ -81,6 +81,18 @@ type ReadyGuild struct {
Emojis []ReadyEmoji `json:"emojis"`
// VoiceStates — кто находится в голосовых комнатах (AGENT.md 7.14).
VoiceStates []ReadyVoiceState `json:"voice_states"`
// Sounds — саундборд и звуковая палитра сервера (AGENT.md 7.13).
Sounds []ReadySound `json:"sounds"`
}
// ReadySound — звук сервера в снапшоте.
type ReadySound struct {
ID string `json:"id"`
Name string `json:"name"`
FileID string `json:"file_id"`
Kind string `json:"kind"`
Event string `json:"event,omitempty"`
Emoji string `json:"emoji,omitempty"`
}
// ReadyVoiceState — участник голосовой комнаты в снапшоте.
+17
View File
@@ -139,6 +139,7 @@ func (s *Snapshot) buildGuild(ctx context.Context, guild store.Guild, user *stor
MyPerms: []string{},
Emojis: []ReadyEmoji{},
VoiceStates: []ReadyVoiceState{},
Sounds: []ReadySound{},
}
// Кастомные эмодзи сервера: клиент показывает их в пикере и в тексте.
@@ -160,6 +161,22 @@ func (s *Snapshot) buildGuild(ctx context.Context, guild store.Guild, user *stor
})
}
// Звуки сервера: саундборд и палитра интерфейса.
sounds, err := s.store.ListGuildSounds(ctx, guild.ID, "", 100)
if err != nil {
return readyGuild, err
}
for _, sound := range sounds {
readyGuild.Sounds = append(readyGuild.Sounds, ReadySound{
ID: formatID(sound.ID),
Name: sound.Name,
FileID: formatID(sound.FileID),
Kind: string(sound.Kind),
Event: sound.Event,
Emoji: sound.Emoji,
})
}
// Кто сейчас в голосовых комнатах сервера.
voiceStates, err := s.store.ListVoiceStates(ctx, guild.ID)
if err != nil {