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
+72
View File
@@ -2,6 +2,7 @@ package server
import (
"context"
"log/slog"
"net/http"
"time"
@@ -282,10 +283,55 @@ func (s *Server) registerVoiceRoutes(api huma.API) {
action = "voice.unmute"
}
s.recordAudit(ctx, actor, guildID, action, "user", &targetID, "")
// Мьют применяется на стороне SFU: клиент не может его обойти.
if input.Body.ServerMute != nil {
s.applyServerMute(ctx, state, *input.Body.ServerMute)
}
s.dispatchVoiceState(ctx, state)
return s.voiceStatesOutput(ctx, guildID)
})
huma.Register(api, huma.Operation{
OperationID: "disconnectVoiceMember",
Method: http.MethodDelete,
Path: "/guilds/{guild_id}/voice-states/{user_id}",
Summary: "Отключить участника от голосовой комнаты",
Tags: []string{"Voice"},
Security: security,
}, func(ctx context.Context, input *struct {
GuildID string `path:"guild_id"`
UserID string `path:"user_id"`
},
) (*voiceStateListOutput, error) {
actor, _, err := requireUser(ctx)
if err != nil {
return nil, err
}
guildID, resolved, err := s.requireGuildPermission(ctx, input.GuildID, actor, permissions.ViewGuild)
if err != nil {
return nil, err
}
if !resolved.Has(permissions.MuteMembers) {
return nil, humaErrorStatus(http.StatusForbidden, "perm.denied", "MUTE_MEMBERS is required")
}
targetID, err := parseID("user_id", input.UserID)
if err != nil {
return nil, err
}
state, err := s.store.GetVoiceState(ctx, guildID, targetID)
if err != nil {
return nil, humaError(err)
}
// Убираем участника из комнаты на стороне SFU и в БД.
s.removeFromLiveKit(ctx, guildID, state.ChannelID, targetID)
if err := s.store.DeleteVoiceState(ctx, guildID, targetID); err != nil {
return nil, humaError(err)
}
s.recordAudit(ctx, actor, guildID, "voice.disconnect", "user", &targetID, "")
s.dispatchVoiceLeave(ctx, guildID, state.ChannelID, targetID)
return s.voiceStatesOutput(ctx, guildID)
})
huma.Register(api, huma.Operation{
OperationID: "moveVoiceMember",
Method: http.MethodPost,
@@ -347,12 +393,38 @@ func (s *Server) registerVoiceRoutes(api huma.API) {
if err != nil {
return nil, humaError(err)
}
// На стороне SFU участник должен переподключиться в новую комнату.
s.removeFromLiveKit(ctx, guildID, current.ChannelID, targetID)
s.recordAudit(ctx, actor, guildID, "voice.move", "user", &targetID, "")
s.dispatchVoiceState(ctx, state)
return s.voiceStatesOutput(ctx, guildID)
})
}
// applyServerMute применяет мьют микрофона на стороне SFU.
func (s *Server) applyServerMute(ctx context.Context, state *store.VoiceState, muted bool) {
if s.voiceAdmin == nil || !s.voiceAdmin.Enabled() {
return
}
room := voice.RoomName(state.GuildID, state.ChannelID)
if err := s.voiceAdmin.SetMicrophoneMuted(ctx, room, formatSnowflake(state.UserID), muted); err != nil {
// Участник мог уже отключиться: это не ошибка операции.
s.logger.DebugContext(ctx, "livekit mute skipped", slog.Any("error", err))
}
}
// removeFromLiveKit убирает участника из комнаты на стороне SFU: клиент
// получит Disconnected и вернётся в список комнат.
func (s *Server) removeFromLiveKit(ctx context.Context, guildID, channelID, userID uint64) {
if s.voiceAdmin == nil || !s.voiceAdmin.Enabled() {
return
}
room := voice.RoomName(guildID, channelID)
if err := s.voiceAdmin.RemoveParticipant(ctx, room, formatSnowflake(userID)); err != nil {
s.logger.DebugContext(ctx, "livekit remove skipped", slog.Any("error", err))
}
}
// ensureVoiceCapacity проверяет лимит участников голосовой комнаты (AGENT.md 7.14).
func (s *Server) ensureVoiceCapacity(ctx context.Context, channel *store.Channel, user *store.User) error {
if channel.UserLimit <= 0 || user.IsInstanceAdmin {