feat(room): очередь поднятых рук видна всем + отключаемый модуль

Раньше HandQueueMenu.tsx рендерился только организатору — теперь очередь
видит любой участник, но опустить чужую руку по-прежнему может только
организатор (сервер это уже проверял, менял только фронт). Кнопка
«Опустить» показывается у записи, только если это своя рука или
пользователь — организатор.

Модуль «поднятие руки» (кнопка «Рука» + очередь целиком) — отключаемый
в админке (instance_settings.hand_queue, дефолт enabled=true, как у
chat_enabled). Настройка едет участнику в JoinOut ещё до входа в
комнату; выключенный модуль гасит кнопки и на фронте, и на бэке —
raise_hand/lower_hand отклоняются кодом hand_queue_disabled, если
модуль выключен, даже если у клиента на руках старый JoinOut.

backend/tests/test_admin_api.py

@@ -646,12 +646,17 @@ async def test_put_settings_partial_update(
 
     response = await client.put(
         "/api/v1/admin/settings",
-        json={"chat_enabled": False, "display_timezone": "Asia/Yekaterinburg"},
+        json={
+            "chat_enabled": False,
+            "hand_queue_enabled": False,
+            "display_timezone": "Asia/Yekaterinburg",
+        },
         headers=_auth_headers(admin),
     )
     assert response.status_code == 200, response.text
     body = response.json()
     assert body["chat_enabled"] is False
+    assert body["hand_queue_enabled"] is False
     assert body["display_timezone"] == "Asia/Yekaterinburg"
     assert body["ai_level"] == "min"
     assert body["transcription_queue_served"] is False

backend/tests/test_hand_queue_ws.py

@@ -8,13 +8,15 @@ import uuid
 from collections.abc import Callable
 from typing import Any
 
+import httpx
 from sqlalchemy.ext.asyncio import AsyncSession
 
-from core.security import hash_password
+from core.security import create_access_token, hash_password
 from models.conference import Conference
 from models.guest import GuestAccess
 from models.user import User
 from services.conference_ids import generate_number, generate_slug
+from services.instance_settings import InstanceSettingsService, SettingsUpdateIn
 from services.livekit_tokens import create_room_access_token
 from tests.conftest import ASGIWebSocketSession
 
@@ -270,3 +272,66 @@ async def test_organizer_joining_late_sees_already_raised_hands(
     initial_queue = await _connect_auth_and_queue(ws_owner, _user_token(conference, owner))
 
     assert _identities(initial_queue) == [str(alice.id)]
+
+
+# --- Отключаемый модуль (`instance_settings.hand_queue`) ---------------------
+
+
+async def test_hand_queue_disabled_rejects_raise_and_lower(
+    db_session: AsyncSession, ws_client: WSFactory
+) -> None:
+    """Выключенный модуль — вторая линия защиты сверх фронта: `raise_hand`/
+    `lower_hand` отклоняются кодом `hand_queue_disabled`, очередь не меняется."""
+    conference = await _make_conference(db_session)
+    alice = await _make_user(db_session, name="Alice")
+    await db_session.commit()
+
+    await InstanceSettingsService(db_session).update(SettingsUpdateIn(hand_queue_enabled=False))
+
+    ws = ws_client(_chat_path(conference.id))
+    await _connect_auth_and_queue(ws, _user_token(conference, alice))
+
+    await ws.send_json({"type": "raise_hand"})
+    error = await ws.receive_json()
+    assert error == {"type": "error", "code": "hand_queue_disabled"}
+
+    await ws.send_json({"type": "lower_hand"})
+    error = await ws.receive_json()
+    assert error == {"type": "error", "code": "hand_queue_disabled"}
+
+
+async def test_join_out_reflects_hand_queue_enabled_toggle(
+    client: httpx.AsyncClient, db_session: AsyncSession
+) -> None:
+    user = await _make_user(db_session, name="Toggle Tester")
+    await db_session.commit()
+    headers = {"Authorization": f"Bearer {create_access_token(user.id, user.role)}"}
+
+    response = await client.post(
+        "/api/v1/conferences", json={"title": "Standup"}, headers=headers
+    )
+    assert response.status_code == 201, response.text
+    assert response.json()["join"]["hand_queue_enabled"] is True
+
+    await InstanceSettingsService(db_session).update(SettingsUpdateIn(hand_queue_enabled=False))
+
+    response = await client.post(
+        "/api/v1/conferences", json={"title": "Standup 2"}, headers=headers
+    )
+    assert response.status_code == 201, response.text
+    assert response.json()["join"]["hand_queue_enabled"] is False
+
+
+async def test_guest_join_out_reflects_hand_queue_enabled(
+    client: httpx.AsyncClient, db_session: AsyncSession
+) -> None:
+    conference = await _make_conference(db_session)
+    await db_session.commit()
+
+    await InstanceSettingsService(db_session).update(SettingsUpdateIn(hand_queue_enabled=False))
+
+    response = await client.post(
+        f"/api/v1/conferences/{conference.id}/guest-join", json={"display_name": "Dave"}
+    )
+    assert response.status_code == 200, response.text
+    assert response.json()["hand_queue_enabled"] is False

backend/tests/test_instance_settings.py

@@ -65,6 +65,7 @@ _MANAGED_KEYS = (
     "transcriber",
     "summarizer",
     "chat",
+    "hand_queue",
     "ai_level",
     "summary_recipients",
     "display_timezone",
@@ -121,6 +122,7 @@ async def test_ensure_bootstrapped_imports_yaml_defaults(
         "transcriber",
         "summarizer",
         "chat",
+        "hand_queue",
         "ai_level",
         "summary_recipients",
         "display_timezone",
@@ -132,6 +134,9 @@ async def test_ensure_bootstrapped_imports_yaml_defaults(
     cfg = await service.get()
     assert cfg.transcriber.provider == "faster_whisper_cpu"
     assert cfg.ai_level == "min"
+    # Дефолт обязан сохранять поведение существующих инсталляций — модуль
+    # «поднятие руки» был доступен всегда, тоггл включён по умолчанию.
+    assert cfg.hand_queue.enabled is True
     assert cfg.summary_recipients == "all"
     assert cfg.display_timezone == "Europe/Moscow"
     assert cfg.registration_team_choice is False
@@ -162,6 +167,22 @@ async def test_ensure_bootstrapped_is_idempotent_and_keeps_admin_edits(
     assert cfg.display_timezone == "Asia/Yekaterinburg"
 
 
+async def test_update_hand_queue_enabled(
+    db_session: AsyncSession, clean_instance_settings: None
+) -> None:
+    service = InstanceSettingsService(db_session)
+    await service.ensure_bootstrapped(PLUGINS_YAML)
+
+    cfg = await service.update(SettingsUpdateIn(hand_queue_enabled=False))
+    assert cfg.hand_queue.enabled is False
+
+    cfg = await service.get()
+    assert cfg.hand_queue.enabled is False
+
+    cfg = await service.update(SettingsUpdateIn(hand_queue_enabled=True))
+    assert cfg.hand_queue.enabled is True
+
+
 @pytest.mark.parametrize(
     ("preset", "chat_enabled", "ai_enabled", "ai_level"),
     [