# MUTE — аналитика клиентских звонков

> MUTE — веб-приложение, которое помогает понять содержание клиентских разговоров: причины обращений, ответы сотрудников, итоги, договорённости и следующие шаги. Аудиозаписи превращаются в удобные для изучения диалоги, отдельные разборы и общую картину для руководителя.

## Ссылки

- [MUTE](https://mute.gajsin.tech/): главная страница проекта.
- [Мастерская](https://mute.gajsin.tech/workspace): интерфейс аналитики и демонстрационный набор.
- [Описание проекта](https://mute.gajsin.tech/llms.txt): сведения о продукте, возможностях и технической реализации.

## Задача продукта

В клиентских разговорах содержатся запросы, возражения, важные условия и обещания. MUTE собирает эту информацию в одной рабочей среде: от исходной записи до выводов по подборке звонков. Руководитель может изучить общую картину, выбрать конкретную проблему и перейти к разговору, на котором основан вывод.

Приложение подходит для анализа продаж, обслуживания и поддержки. Пользователь задаёт контекст своей компании, загружает записи и получает структурированный результат. Подготовленный демонстрационный набор позволяет познакомиться с интерфейсом, отчётами и переходами между общей аналитикой и отдельными разговорами.

## Работа с записями

Пользователь загружает аудио, указывает контекст компании и наблюдает за обработкой. Поддерживаются MP3, WAV, M4A, MP4, OGG, FLAC и WebM.

Приложение распознаёт речь, сохраняет расшифровку и формирует разбор. Для личной записи доступны аудиоплеер, исходный текст и диалог с ролями участников, определёнными по содержанию разговора. Сохранение промежуточных этапов позволяет продолжать работу без повторного распознавания уже обработанного аудио.

## Разбор отдельного звонка

Карточка разговора объединяет:

- тему и основную причину обращения;
- запрос клиента и важные детали;
- наблюдаемый итог;
- проблемы и препятствия;
- согласованные действия, исполнителей и названные сроки;
- рекомендации по следующим шагам;
- моменты, требующие уточнения.

Договорённости участников и рекомендации аналитики представлены отдельно. Существующие фрагменты расшифровки доступны как источники, чтобы пользователь мог сопоставить вывод с содержанием разговора.

## Общая картина

Раздел «Обзор» показывает состав подборки, категории обращений, исходы и выявленные проблемы. Поиск, фильтры и переходы помогают найти нужные звонки.

Раздел «Разбор» объединяет темы, факторы, препятствия и управленческие рекомендации. Общие выводы связаны с отдельными разговорами: пользователь может перейти от картины по набору к конкретной записи и её содержанию.

Для показателей используются общие определения и расчёты на клиенте и сервере. Статистика и отдельные карточки работают с одним набором данных.

## Интерфейс и отчёты

MUTE поддерживает светлую и тёмную темы и адаптивную компоновку. Основные разделы — «Обзор», «Разбор», «Звонки» и работа с файлами — образуют единый пользовательский сценарий.

Отчёты экспортируются в PDF, автономный HTML, JSON, Markdown и CSV. Это позволяет передать результат коллегам, сохранить его или использовать данные в других инструментах. PDF формируется на сервере из общего HTML-представления отчёта.

## Техническая реализация

MUTE — full-stack проект с клиентским интерфейсом, собственным API, интеграцией моделей, приватным хранением и опубликованным рабочим сайтом.

- **Клиент:** React, Vite, React Router, CSS, Lucide.
- **Сервер:** Node.js и Express.
- **Распознавание и анализ:** интеграция речевых и языковых моделей через Polza API.
- **Общие контракты:** единые структуры данных, категории, расчёты и привязки между выводами и звонками.
- **Приватное хранение:** Vercel Blob для аудио и результатов обработки.
- **Прямая загрузка:** браузер отправляет файл по подписанному URL, сервер проверяет и завершает приём.
- **Согласованность данных:** conditional writes по ETag и защита от конфликтующих изменений.
- **Управление обработкой:** сохранение этапов, очередь, остановка, продолжение и повтор отдельной записи.
- **Защита актуального состояния:** устаревший ответ не перезаписывает результат после изменения контекста, остановки или удаления.
- **Экспорт PDF:** серверный Chromium с общим HTML-рендерером.
- **Публикация:** Vercel, выпуск проверенных сборок через CLI.

## Что демонстрирует проект

MUTE показывает реализацию полного продуктового сценария: загрузка файлов → распознавание речи → структурированный анализ → общая аналитика → отчёт.

Проект объединяет проектирование интерфейса, клиентскую и серверную разработку, работу с внешним AI API, хранением и согласованностью данных, контроль доступа, управление состояниями обработки, экспорт и публикацию приложения.

Его можно рассматривать как пример разработки прикладного AI-продукта: результаты моделей встроены в понятный рабочий процесс, а пользователь может изучать как общую картину, так и содержание отдельного разговора.

## Краткое описание для портфолио

MUTE — full-stack веб-приложение речевой аналитики на React и Node.js. Реализованы загрузка и распознавание клиентских звонков, структурированный LLM-разбор, общая аналитика, привязка выводов к источникам и экспорт отчётов. Техническая реализация включает приватное хранение и прямые загрузки в Vercel Blob, согласованность данных через ETag, сохранение этапов обработки, контроль доступа и серверную генерацию PDF.