Deal/docs/user-guide/Инструкция-пользователя-Дейл.md

Дейл (Deal) — Инструкция пользователя

Версия: 1.3 (этапы 0–12) Дата: 2026-09-10 Назначение: как работать с продуктом — от регистрации до ежедневного использования. Описывает итоговое состояние; dev-особенности помечены отдельно.

---

1. Регистрация по приглашению

«Дейл» — сервис с доступом по приглашениям: рабочее пространство (тенант) и пользователей заводит оператор (администратор сервиса); самостоятельной регистрации нет.

1. Оператор создаёт приглашение на вашу почту — в новое пространство или в уже существующее.
2. Откройте присланную ссылку приглашения — откроется страница «Активация приглашения». Введите email (обязательно тот же, на который приглашение), имя пространства (необязательно) и пароль (минимум 8 символов).
3. Нажмите «Активировать аккаунт». Приглашение «на новое пространство» при активации создаёт ваше рабочее пространство — данные изолированы от других клиентов. Приглашение «в существующее» добавляет вас пользователем в него.
4. После активации вход — email + пароль (система сразу не входит — это отдельный шаг).

Особенности:

• приглашение действует 72 часа; истекло — оператор пришлёт новое;
• email должен быть свободен: «Этот email уже зарегистрирован» → обратитесь к оператору;
• пароль — минимум 8 символов; код в ссылке можно открыть только целиком (без кода страница сообщит, что ссылка неполная);
• забыли пароль — самостоятельного восстановления нет, обратитесь к оператору;
• вход приостановленного пространства невозможен («Учётная запись приостановлена») — вопросы к оператору.

Dev-окружение (разработка/показ): регистрация не нужна — bootstrap-пространство Default с входом admin/admin. Демо-ручки/кнопки (POST /api/demo/*, флаг DEAL_DEMO) удалены — новые карточки создаются вручную; в обычной (прод) сборке — штатный контур оператор → инвайт.

---

2. Вход в систему

1. Вход — email + пароль, созданные при активации приглашения (раздел 1).
2. В dev-окружении — admin/admin (без приглашения).
3. Выход/смена пароля завершают текущую сессию.

Все данные (каналы, карточки, настройки) принадлежат только вашему пространству и не видны другим клиентам. Оператор видит только служебное: список пространств и их статусы, аудит входов/выходов и действий (включая действия пользователей), расход ИИ-бюджета; к содержимому ваших данных и настроек доступа у оператора нет.

---

3. Первый запуск: подключение Telegram

Приложение Telegram работает через api_id и api_hash. Их задаёт оператор сервиса глобально (раздел «Telegram» в оператор-консоли) — тенант ключи не вводит. Запущенные сервисы (полный стек) поднимает оператор. В dev-окружении без стека раздел показывает неподключённый статус.

1. Убедитесь, что оператор задал ключи приложения (без них подключение недоступно).
2. Перейдите в раздел «Настройки → Telegram» и нажмите «Добавить аккаунт».
3. Отсканируйте QR-код (или введите телефон + код подтверждения).
4. Дождитесь статуса «Telegram подключён». Сессия сохраняется — повторный вход не нужен.

После подключения система загрузит список ваших каналов и групп. Ключи приложения хранятся зашифрованно на стороне сервиса.

---

4. Каналы и источники

Раздел «Каналы» — список диалогов вашего аккаунта и управление мониторингом.

• Включить мониторинг у нужного канала/группы — система начнёт читать новые сообщения.
• «Перечитать» — догнать последние ~10 сообщений всех включённых источников (например, после подключения).
• Включить все — включить мониторинг всех каналов разом.
• Новые чаты, которые вы добавили в Telegram, появятся в списке автоматически. Если включена настройка «новый чат → мониторинг», они начнут читаться сами.
• Удалённые/покинутые чаты исчезают из списка.
• Прочитанные системой сообщения помечаются прочитанными и в вашем Telegram.

Поиск новых каналов (Discovery)

Во вкладке «Каналы → Поиск» можно найти новые источники по вашей теме:

1. Нажмите «Новая задача», опишите, что ищете (например: «каналы с вакансиями для C#-разработчика»).
2. Нажмите «Сгенерировать ключи» — ИИ предложит поисковые слова (можно отредактировать).
3. Задайте параметры: минимум подписчиков, язык, план вступлений, авто-вступление.
4. Запустите задачу. Система найдёт каналы/группы, в которых вы не состоите, и оценит их (участники, язык, содержание — «подходит X из N»).
5. В списке кандидатов выберите действие:
   • «Вступить и мониторить» — система вступит и начнёт читать;
   • «Отклонить» — источник уйдёт в чёрный список и больше не будет предлагаться.
6. Закрытые группы/каналы помечаются — в них система вступить не может, решение за вами.
7. Авто-вступление: если включено, система вступает сама с паузами и в рамках суточного лимита (настройки квот — в этом же разделе). Общий лимит делится между задачами.

---

5. Дашборд (карточки)

«Дашборд» — канбан с колонками. Карточка здесь и на экране «Выбранные» — одна и та же сущность: сняв её с дашборда «В работу», вы не создаёте копию, а переносите карточку в стадии.

• Неразобранное — сообщения, которые не подошли ни под одну колонку.
• Ваши колонки — например, «WPF», «Фриланс», «Резюме» — куда система складывает подходящие карточки.
• Архив и Корзина — служебные.

Карточка

На карточке: тип заявки (вакансия/заказ), время, заголовок, структурированная суть (компания → формат → о задаче → требования → условия), стек, бюджет (в валюте и в пересчёте), контакт и быстрые действия. Свежие карточки — сверху.

Действия с карточкой:

• «Взять в работу» — перенести карточку на экран «Выбранные» (в стадию «Запланировано»); это тот же объект, а не копия;
• клик по карточке — подробный просмотр (справа);
• комментарий — иконка сообщения;
• в корзину — иконка корзины;
• перетащить в другую колонку — система запомнит (ML обучится) и в следующий раз похожие заявки положит туда же;
• контакт — скопировать или открыть диалог;
• «Открыть исходник» — перейти к оригинальному сообщению в Telegram.

В подробном просмотре доступны: полная структура заявки, исходное сообщение (под спойлером), комментарии, история, действия.

Колонки

• Создать колонку — задайте имя, описание и фильтры (ключевые слова, стек, уровень, бюджет, локация и т.д.). Все фильтры опциональны и могут сочетаться.
• Отрицательные фильтры — что НЕ должно попадать в колонку (например, без английского языка).
• ИИ может предлагать колонки по вашим карточкам — вы решаете: принять, переименовать или удалить.
• В карточке видно, по каким критериям она попала в колонку.
• Колонки можно сворачивать в виджет-счётчик, двигать, менять ширину, разворачивать на весь экран.

Архив и корзина

• В архив карточки уходят автоматически, если лежат дольше установленного срока (настройка 1–30 дней). Архив очищается через 90 дней.
• В корзину попадают удалённые карточки; очищается раз в 7 дней.
• Из архива/корзины карточку можно вернуть на канбан, пока её не очистили.
• Полная ручная очистка архива/корзины — кнопка в шапке колонки (безвозвратно).

---

6. «Выбранные» (работа с заявками)

Экран «Выбранные» — канбан для тех же карточек, которые вы взяли в работу (не копии):

1. Возьмите карточку с дашборда кнопкой «Взять в работу» — система перенесёт её в стадию «Запланировано» (или создайте вручную — будет пометка «создано локально»).
2. Ведите её по стадиям: Запланировано → Отклик → Согласование → В работе → Проверка → Готово (или «Отложено»).
3. Перетаскивайте карточки между стадиями; наполняйте модули карточки (сумма, стек, контакты, ссылки, ТЗ, файлы, комментарии).

В карточке «Выбранных» доступно:

• комментарии и история движения (статус, дата, время — под спойлером);
• изменение суммы, стека, контактов;
• прикрепление ссылок и текста ТЗ;
• прикрепление файлов (изображения, документы и др. — тип определяется автоматически); на карточке видны значки количества файлов и ссылок.

Особенности:

• карточки «Выбранных» не попадают в архив/корзину дашборда; свои состояния — «Отклонено» и «Выполнено»;
• «Отложено»: при переносе система спросит, через какой срок напомнить и в какое время (можно выбрать дату в календаре). Если напоминания выключены в настройках — окно не появится.

---

7. Обработка (очередь и отсев)

Раздел «Обработка» — что происходит с сообщениями до карточек.

• Очередь — сырые сообщения, ждущие обработки. Обычно быстро пустеет.
• Отсев — что система отклонила и почему:
  • «правила» — стоп-фраза (указана), резюме, тип заявки, нет суммы;
  • «ML» / «ИИ» — модель или ИИ посчитали сообщение спамом/не вашим;
  • «система» — устарело или повтор (карточка уже есть).
• У записи: кнопка «Открыть исходник» (в Telegram) и исходное сообщение с форматированием.
• Поиск по отсеву — полный текст.
• «Вернуть в обработку»: если система ошиблась — верните сообщение, и оно создаст карточку. Причины отсева для него будут проигнорированы, а система обучится на вашем решении.
• Отсев очищается автоматически раз в 3 дня (можно очистить вручную).

---

8. Настройки

Настройки → Telegram: подключение аккаунта, авто-мониторинг новых чатов.

Настройки → ИИ:

• провайдер и модель (можно выбрать один, включая локальные OpenAI-совместимые);
• ключ API (хранится зашифрованно);
• промпты: базовый (не меняется) + свой промпт; библиотека готовых промптов по сферам с поиском и категориями; сохранённые свои промпты («Мои промпты»);
• вкл/выкл ИИ и ИИ-фильтр. Если ML уже уверенно обрабатывает поток — система подскажет, что ИИ можно отключить.

Настройки → ML: включение, обучение на ваших действиях, проверка модели на сообщении/канале, сброс обучения, показатели самооценки.

Настройки → Обработка: стоп-фразы, минимальная длина, блокировка резюме, тип заявок, ключевые слова вашей сферы. Глобальные исключения — ключевые слова/технологии, локации, тип (вакансия/фриланс/объявление) и диапазон бюджета: такие сообщения отсекаются сразу, ещě до ML и ИИ (токены не расходуются). Отдельно — «не создавать карточку без суммы» (для вакансий и заказов отдельно).

Настройки → Валюта и курсы: валюта отображения, конвертация при получении, пересчёт старых карточек при смене валюты.

Настройки → Хранение: срок до архива (1–30 дней), очистка архива и корзины.

Настройки → Уведомления: общие напоминания и уведомления (в т.ч. об отложенных).

Настройки → Внешний вид: тема оформления — «Тёмная» (по умолчанию), «Светлая» или «Системная». Переключается мгновенно и запоминается.

---

9. ИИ-бюджет и уведомления

Обработка сообщений использует ИИ (классификация, ИИ-фильтр, генерация ключевых слов). У каждого пространства — ИИ-бюджет (обычно месячный, в токенах), который устанавливает оператор.

• При расходе 80% бюджета приходит уведомление «ИИ-бюджет израсходован на 80%».
• При исчерпании — уведомление «ИИ-бюджет исчерпан — обработка в локальном режиме»: система автоматически переходит на локальную обработку (правила/ML без ИИ); приём и разбор сообщений не останавливается, но глубина разбора снижается.
• Увеличить бюджет/сменить период может только оператор; после смены предупреждения сбрасываются.
• При приостановке пространства вход и ИИ-обработка недоступны — обратитесь к оператору.
• Системные уведомления (архив/очистки, подключение Telegram, бюджет) приходят значком-колокольчиком в интерфейсе.

10. Советы

• Начните с подключения аккаунта → включите 2–3 канала → нажмите «Перечитать».
• Создайте колонки под ваши типичные заказы и задайте им фильтры.
• Переносите карточки руками — система учится и скоро начнёт раскладывать сама.
• Заглядывайте в «Отсев»: если там ваши реальные заказы — верните их, система исправится.
• Проверяйте вкладку «ИИ»: когда ML станет уверенной, можно отключить ИИ и сэкономить токены.

---

11. Для оператора сервиса (консоль)

Этот раздел — для администратора сервиса «Дейл». Обычным пользователям он не нужен.

Оператор управляет сервисом из отдельной консоли: она открывается по адресу основного приложения с добавлением #/operator (например, https://<адрес-сервиса>/#/operator). Консоль — отдельный вход со своими учётными данными (логин/пароль выдаёт владелец сервиса).

Разделы консоли:

• Тенанты — список рабочих пространств с числом пользователей и статусом. Здесь можно создать пространство (при необходимости сразу с владельцем — ему выдаётся одноразовый пароль), приостановить и возобновить доступ, а также войти от имени пользователя пространства (impersonation) — удобно для поддержки; завершается обычным выходом.
• Приглашения — создание приглашения на email (в новое или существующее пространство), отзыв и копирование ссылки активации, которую вы передаёте клиенту.
• Лимиты ИИ — сводка расхода ИИ-бюджета по пространствам; можно изменить месячный/дневной бюджет и период. После смены предупреждения о расходе сбрасываются.
• Аудит — лента действий (входы, выходы, приглашения, действия пользователей, изменения по пространствам и лимитам) с фильтрами по типу события, актору, пространству и периоду; есть пагинация.
• Аналитика — обзор за период (число пространств, расход токенов, входы/выходы/неудачные входы), расход токенов с группировкой по дням/пространствам/провайдерам/моделям и лента действий.
• Состояние системы — доступность ядра, базы данных и сервисов (Telegram, ИИ, ML).

Dev-окружение: вход в консоль — operator/operator. В обычной (прод) сборке учётные данные оператора задаются владельцем сервиса при развёртывании.

---

12. Язык интерфейса

Интерфейс «Дейла» — на русском. Все тексты (кнопки, подписи, подсказки, пустые состояния, уведомления, экраны оператора и страница активации) хранятся в словарях-ресурсах, а не в самих экранах. Переключателя языка нет — интерфейс всегда на русском.