docs: initial spec and implementation plan

2026-04-03 21:48:24 +05:00
commit ebd86cd6e8
12 changed files with 5937 additions and 0 deletions
@@ -0,0 +1,103 @@
+<h2>Секция 4: Интеграция с мессенджерами</h2>
+<p class="subtitle">Telegram и Lensa боты — полный цикл работы</p>
+
+<div class="section">
+  <h3>Сценарий взаимодействия с ботом</h3>
+  <div class="mockup">
+    <div class="mockup-header">Telegram / Lensa — диалог с ботом</div>
+    <div class="mockup-body" style="padding: 20px; background: #0e1621; color: #e2e8f0; font-size: 13px; line-height: 1.8;">
+
+      <div style="margin-bottom: 16px;">
+        <div style="background: #2b5278; padding: 8px 14px; border-radius: 12px 12px 12px 4px; display: inline-block; max-width: 80%;">
+          👤 <em>Пользователь отправляет видео/аудио файл</em>
+        </div>
+      </div>
+
+      <div style="margin-bottom: 16px; text-align: right;">
+        <div style="background: #2b5278; padding: 8px 14px; border-radius: 12px 12px 4px 12px; display: inline-block; max-width: 80%; text-align: left; background: #1e3a5f;">
+          🤖 Файл получен! Выберите тип протокола:<br><br>
+          <span style="display: inline-flex; gap: 6px; flex-wrap: wrap;">
+            <span style="background: #3b82f6; padding: 4px 12px; border-radius: 6px; font-size: 12px;">📋 Обследование процессов</span>
+            <span style="background: #3b82f6; padding: 4px 12px; border-radius: 6px; font-size: 12px;">🤝 Вводная встреча</span>
+            <span style="background: #3b82f6; padding: 4px 12px; border-radius: 6px; font-size: 12px;">🏢 Внутренняя встреча</span>
+            <span style="background: #3b82f6; padding: 4px 12px; border-radius: 6px; font-size: 12px;">⚙️ Кастомный</span>
+          </span>
+        </div>
+      </div>
+
+      <div style="margin-bottom: 16px;">
+        <div style="background: #2b5278; padding: 8px 14px; border-radius: 12px 12px 12px 4px; display: inline-block;">
+          👤 <em>Нажимает «Обследование процессов»</em>
+        </div>
+      </div>
+
+      <div style="margin-bottom: 16px; text-align: right;">
+        <div style="background: #1e3a5f; padding: 8px 14px; border-radius: 12px 12px 4px 12px; display: inline-block; max-width: 80%; text-align: left;">
+          🤖 ⏳ Принято! Обработка займёт несколько минут.<br>
+          <span style="color: #94a3b8;">Транскрибация: ▓▓▓▓░░░░ 50%</span>
+        </div>
+      </div>
+
+      <div style="margin-bottom: 16px; text-align: right;">
+        <div style="background: #1e3a5f; padding: 8px 14px; border-radius: 12px 12px 4px 12px; display: inline-block; max-width: 80%; text-align: left;">
+          🤖 ✅ Протокол готов!<br><br>
+          <strong>Тема:</strong> Обследование процесса закупок ООО «Клиент»<br>
+          <strong>Дата:</strong> 01.04.2026<br>
+          <strong>Участники:</strong> Иванов И.И., Петров П.П., ...<br><br>
+          <em style="color: #94a3b8;">[показан полный текст протокола]</em><br><br>
+          <span style="display: inline-flex; gap: 6px; flex-wrap: wrap;">
+            <span style="background: #10b981; padding: 4px 12px; border-radius: 6px; font-size: 12px;">📄 DOCX</span>
+            <span style="background: #10b981; padding: 4px 12px; border-radius: 6px; font-size: 12px;">📕 PDF</span>
+            <span style="background: #10b981; padding: 4px 12px; border-radius: 6px; font-size: 12px;">📝 MD</span>
+            <span style="background: #f59e0b; padding: 4px 12px; border-radius: 6px; font-size: 12px;">🔄 Перегенерировать</span>
+            <span style="background: #6366f1; padding: 4px 12px; border-radius: 6px; font-size: 12px;">🌐 Открыть в вебе</span>
+          </span>
+        </div>
+      </div>
+
+    </div>
+  </div>
+</div>
+
+<div class="section" style="margin-top: 24px;">
+  <h3>Команды бота</h3>
+  <div style="display: flex; gap: 12px; flex-wrap: wrap;">
+
+    <div style="background: #f8fafc; border: 1px solid #e2e8f0; padding: 14px; border-radius: 8px; flex: 1; min-width: 220px; font-size: 13px; line-height: 1.8;">
+      <strong>Основные</strong><br>
+      <code>/start</code> — авторизация (логин/пароль)<br>
+      <code>/upload</code> — загрузить файл (или просто отправить)<br>
+      <code>/list</code> — список записей<br>
+      <code>/protocols</code> — список протоколов
+    </div>
+
+    <div style="background: #f8fafc; border: 1px solid #e2e8f0; padding: 14px; border-radius: 8px; flex: 1; min-width: 220px; font-size: 13px; line-height: 1.8;">
+      <strong>Работа с протоколами</strong><br>
+      <code>/view [id]</code> — просмотреть протокол<br>
+      <code>/export [id] [формат]</code> — экспорт<br>
+      <code>/regenerate [id]</code> — перегенерировать<br>
+      <code>/templates</code> — список шаблонов
+    </div>
+
+    <div style="background: #f8fafc; border: 1px solid #e2e8f0; padding: 14px; border-radius: 8px; flex: 1; min-width: 220px; font-size: 13px; line-height: 1.8;">
+      <strong>Настройки</strong><br>
+      <code>/settings</code> — шаблон по умолчанию<br>
+      <code>/help</code> — справка<br>
+      <code>/logout</code> — выход
+    </div>
+
+  </div>
+</div>
+
+<div class="section" style="margin-top: 24px;">
+  <h3>Технические детали</h3>
+  <div style="background: #f1f5f9; padding: 16px; border-radius: 8px; font-size: 13px; line-height: 1.8;">
+    <ul style="margin: 0;">
+      <li><strong>Telegram</strong> — aiogram 3.x, webhook mode (через FastAPI), inline-кнопки для навигации</li>
+      <li><strong>Lensa</strong> — SDK/webhook интеграция (аналогичный интерфейс)</li>
+      <li><strong>Общий слой</strong> — единый MessengerService абстрагирует логику от конкретного мессенджера</li>
+      <li><strong>Лимит файлов</strong> — Telegram ограничивает загрузку 50 МБ через бот API; для больших файлов — ссылка на веб-загрузку</li>
+      <li><strong>Авторизация</strong> — привязка аккаунта мессенджера к учётной записи через /start</li>
+    </ul>
+  </div>
+</div>