From b9897555a351cf5e242974d46743db28af182687 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9A=D0=B8=D1=80=D0=B8=D0=BB=D0=BB=20=D0=91=D0=BB=D0=B8?= =?UTF-8?q?=D0=BD=D0=BE=D0=B2?= Date: Fri, 29 May 2026 12:17:27 +0300 Subject: [PATCH] Update README with web service documentation --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/README.md b/README.md index e0b2187..2d5f44e 100644 --- a/README.md +++ b/README.md @@ -260,6 +260,46 @@ output: paragraph_pause_sec: 2.0 ``` +## 🌐 Веб-интерфейс + +Проект включает веб-сервис с минималистичным фронтендом для удобной работы через браузер. + +### Функции веб-интерфейса + +- 📤 **Drag & Drop загрузка** — перетащите файлы или выберите через диалог +- 📦 **Пакетная загрузка** — загружайте несколько файлов одновременно +- 📊 **Прогресс в реальном времени** — WebSocket показывает статус обработки каждого файла +- 🌳 **Файловый менеджер** — дерево обработанных совещаний с датами +- 📝 **Просмотр Markdown** — встроенный рендерер с подсветкой синтаксиса +- ⬇️ **Скачивание** — docx и md файлы доступны для скачивания + +### Запуск веб-сервера + +```bash +# Установите HF_TOKEN +export HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxx + +# Запустите сервер +python start_server.py +``` + +Сервер поднимается на `http://localhost:8000` + +Откройте браузер и перетащите файлы в зону загрузки. Обработка происходит в фоне, прогресс отображается в реальном времени. + +### API Endpoints + +| Endpoint | Метод | Описание | +|----------|-------|----------| +| `/` | GET | Фронтенд | +| `/upload` | POST | Загрузка одного файла | +| `/upload-batch` | POST | Пакетная загрузка | +| `/ws` | WebSocket | Прогресс обработки | +| `/api/tasks` | GET | Список задач | +| `/api/files` | GET | Дерево обработанных файлов | +| `/api/files/content?path=...` | GET | Содержимое файла | +| `/api/files/download?path=...` | GET | Скачивание файла | + ## Ограничения - Перекрывающаяся речь (overlap) распознаётся плохо