Руководство по плагину TradeManager

Trade Manager выключает лоты по расписанию и включает их обратно — например, на ночь, когда вы не можете отвечать покупателям, или по выходным. Правил может быть несколько: у каждого своё окно времени, дни недели и набор лотов. Включает обратно плагин только те лоты, которые выключил сам.

🎯 Для чего это нужно

1. Ночью лоты не продаются: покупатель не оплатит то, что вы не выдадите до утра.
2. Гибко: разные лоты — разное расписание, по дням недели.
3. Безопасно: лоты, снятые вами вручную, плагин не включит.

✨ Что умеет плагин

• Окна времени, в том числе через полночь (23:00 → 08:00)
• Дни недели: правило работает только в выбранные дни
• Выбор лотов кнопками, «только эти лоты» или исключения
• Пресеты — именованные наборы лотов
• Разовые действия: «выключить до утра» и «пропустить правило сегодня»
• Часовой пояс: МСК, Киев, UTC и другие
• Уведомления о переключениях, экспорт и импорт правил

⚡ Быстрый старт

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. /trade_manager → «⚙️ Настройки» → часовой пояс.
3. «📋 Правила» → «➕ Добавить правило»: Название | HH:MM | HH:MM | смещение UTC.
4. Выберите лоты и дни, проверьте «🧪 Тест сейчас».

🛠️ Пошаговая настройка

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите TradeManager.
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Шаг 1. Часовой пояс

1. /trade_manager → ⚙️ Настройки → часовой пояс.

ШАГ 3. Шаг 2. Правило

1. 📋 Правила → ➕ Добавить правило. Формат: Название | HH:MM | HH:MM | смещение UTC.
2. Пример: Ночное | 23:00 | 08:00 | 3 — лоты выключены с 23:00 до 08:00 по Москве.

ШАГ 4. Шаг 3. Лоты и дни

1. 🎯 Только эти — какие лоты выключать; 🚫 Исключения — какие не трогать.
2. 📅 Дни недели; 🧪 Тест сейчас — какие лоты затронет правило.

ШАГ 5. Шаг 4. Разовые действия

1. «⛔ Выключить лоты до утра» — выбранные лоты выключатся и включатся утром (по умолчанию в 08:00).
2. «⏱ Пропуск сегодня» в карточке правила — правило не сработает до конца дня.

ШАГ 6. Шаг 5. Проверка и уведомления

1. /tm_test — какие лоты затронут правила прямо сейчас.
2. ⚙️ Настройки: ⏱ Интервал проверки (по умолчанию 60 секунд), 🔔 Уведомления о переключениях, включение и выключение плагина.

🕹️ Меню и кнопки

Меню /trade_manager

• 📋 Правила — список правил: «➕ Добавить правило», «🏷 Пресеты», «⏱ Разовые», «📤 Экспорт JSON», «📥 Импорт JSON»
• ⚙️ Настройки — часовой пояс, интервал проверки, лог успешных, уведомления, включение плагина
• 📜 Логи — что и когда переключалось; «🧹 Очистить»

Карточка правила

• 🔴 Выключить / 🟢 Включить — работает ли правило
• 🎯 Только эти · ✍️ ID — выключать только выбранные лоты (кнопками или списком ID)
• 🚫 Исключения — лоты, которые правило не трогает
• 📅 Дни недели — в какие дни правило работает
• 🧪 Тест сейчас — какие лоты правило затронет прямо сейчас
• ⏱ Пропуск сегодня — правило не сработает до конца дня
• 🗑 Удалить — удалить правило

⏱ Разовые и 🏷 Пресеты

• ⛔ Выключить лоты до утра — выбранные лоты выключатся и включатся утром (по умолчанию в 08:00)
• ❌ Отменить: … — отменить разовое действие
• ➕ Новый пресет — именованный набор лотов для правил

🔄 Как это работает

1. Раз в интервал (по умолчанию 60 секунд) плагин смотрит время в часовом поясе каждого правила.
2. Внутри окна и в выбранный день — выключает лоты правила (с учётом «только эти» и исключений).
3. Вне окна — включает обратно только лоты, которые выключил сам.
4. О каждом переключении — уведомление, если оно включено.

⌨️ Команды

• /trade_manager — меню плагина
• /tm_guide — встроенный гайд
• /tm_test — проверка правил

💡 Важно знать

• Перед первым ночным окном нажмите «🧪 Тест сейчас» — увидите, какие лоты затронет правило.
• Правила можно выгрузить «📤 Экспорт JSON» и загрузить на другом боте «📥 Импорт JSON».
• ⚠️ Не запускайте одновременно расписание Lot Toggler на тех же лотах — плагины будут переключать их друг за другом.

❓ Частые вопросы

Плагин включит лоты, которые я выключил сам?

Нет. Вне окна включаются обратно только лоты, выключенные плагином. Снятые вами вручную или закончившиеся не трогаются.

Окно через полночь работает?

Да: «Ночное | 23:00 | 08:00 | 3» выключит лоты в 23:00 и включит в 08:00 по Москве.

Выключил плагин — лоты останутся выключенными?

Нет, выключенный плагин включает обратно лоты, которые выключил сам.