.. _meeting_record_plugin:

Chrome-расширение для записи совещаний
========================================

.. contents::
    :depth: 3

.. note::

    Доступно только в Enterprise версии.

**citeck-meeting-recorder** — Chrome-расширение, которое записывает видеоконференцию в Yandex Telemost, автоматически расшифровывает речь и формирует резюме встречи. Результат сохраняется в платформе Citeck как активность и привязывается к нужной бизнес-сущности (сделке или проекту).

.. note::

    Функциональность доступна в Enterprise-версии Citeck при наличии настроенного микросервиса ``citeck-ai`` и сервиса транскрипции ``citeck-stt-sidecar``.


Возможности
-----------

- **Запись конференций** в Yandex Telemost (включая ``telemost.360.yandex.ru``)
- **Захват аудио** — звук вкладки и микрофон пользователя объединяются в единый поток
- **Автоматическая транскрипция** речи через GigaAM
- **Генерация резюме** встречи через LLM: ключевые темы, решения, задачи, открытые вопросы, участники
- **Привязка к сущности** — выбор сделки или проекта перед началом записи
- **Авто-остановка** при завершении встречи (закрытие вкладки, навигация)
- **Авторизация** через сессию Citeck — ничего вводить вручную не нужно


Принцип работы
--------------

1. Пользователь открывает вкладку Yandex Telemost — расширение обнаруживает встречу автоматически.
2. В popup выбирается бизнес-сущность (сделка или проект) и нажимается **Начать запись**.
3. Расширение захватывает аудио участников (звук вкладки) и микрофон пользователя, микширует их и передаёт потоком по WebSocket в ``citeck-ai``.
4. После завершения встречи бэкенд транскрибирует аудио и генерирует резюме.
5. Результат сохраняется как ``meeting-activity`` в Citeck, привязанный к выбранной сущности.
6. Пользователь получает Chrome-уведомление о готовности записи.


Установка
---------

Загрузка в Chrome
~~~~~~~~~~~~~~~~~~

1. Скачайте расширение в виде zip-архива из релизов GitHub.
2. Откройте ``chrome://extensions/``.
3. Включите **Режим разработчика**.
4. Нажмите **Загрузить распакованное расширение** и выберите директорию проекта.


Настройка
~~~~~~~~~~

1. Нажмите на иконку расширения → **Открыть настройки**:

 .. image:: _static/meeting_record_plugin/settings_01.png
       :width: 400
       :align: center

2. Введите URL стенда Citeck (например, ``http://localhost``):

3. Нажмите **Проверить подключение**: 

 .. image:: _static/meeting_record_plugin/settings_02.png
       :width: 400
       :align: center


Использование
-------------

1. Откройте конференцию в Yandex Telemost.
2. Нажмите иконку расширения в панели Chrome.
3. Выберите бизнес-сущность (сделку или проект) через поиск.
4. Нажмите **Начать запись**.

.. list-table::
      :widths: 20 20
      :align: center

      * - |

            .. image:: _static/meeting_record_plugin/record_01.png
                  :width: 350
                  :align: center

        - |

            .. image:: _static/meeting_record_plugin/record_02.png
                  :width: 300
                  :align: center

5. По завершении нажмите **Остановить запись** — или просто закройте/покиньте встречу, запись остановится автоматически.

 .. image:: _static/meeting_record_plugin/record_03.png
       :width: 300
       :align: center

6. Дождитесь уведомления о готовности транскрипта и резюме.

 .. image:: _static/meeting_record_plugin/record_04.png
       :width: 650
       :align: center

7. Итоги встречи автоматически сохраняются в Citeck и привязываются к нужной сделке или проекту.

.. list-table::
      :widths: 20 20
      :align: center

      * - |

            .. image:: _static/meeting_record_plugin/record_06.png
                  :width: 600
                  :align: center

        - |

            .. image:: _static/meeting_record_plugin/record_05.png
                  :width: 600
                  :align: center

Разрешения расширения
---------------------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Разрешение
     - Назначение
   * - ``tabCapture``
     - Захват аудио вкладки
   * - ``activeTab``
     - Доступ к текущей вкладке
   * - ``storage``
     - Хранение настроек расширения
   * - ``cookies``
     - Чтение cookies для авторизации в Citeck
   * - ``<all_urls>``
     - API-запросы к произвольному стенду Citeck


Зависимости
-----------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Компонент
     - Роль
   * - ``citeck-ai``
     - Бэкенд: WebSocket-обработчик, pipeline STT → LLM summary → сохранение активности
   * - ``citeck-stt-sidecar``
     - Сервис транскрипции на базе GigaAM (распознавание русской речи)
   * - nginx
     - WebSocket-прокси ``/gateway/ai/ws/`` напрямую на ``citeck-ai``

.. note::

    Основной gateway Citeck не проксирует WebSocket. Для работы расширения необходимо настроить nginx-маршрут ``/gateway/ai/ws/`` напрямую на ``citeck-ai``.


Подробная техническая информция
-----------------------------------

:ref:`Модуль записи совещаний (callrecording) <call-recording-module>`