feat: added more telegram commands, updated modules part

Author: An0nX

docs/cli/manage-account.md

@@ -18,26 +18,28 @@ docker compose exec userbot python3 -m scripts.manage_account <команда> [
 
 -   `<имя_аккаунта>`: Уникальное имя для нового аккаунта.
 
-Скрипт запросит `API ID`, `API Hash`, язык и другие параметры.
-
-### `toggle`
-
-Включает или выключает аккаунт.
-
-**Синтаксис:** `toggle <имя_аккаунта>`
-
--   `<имя_аккаунта>`: Имя существующего аккаунта.
+Скрипт запросит `API ID`, `API Hash`, номер телефона и все остальные данные, необходимые для создания полноценной сессии и записи аккаунта в базу данных. Вы сможете настроить язык, устройство, прокси и статус активации.
 
 ### `delete`
 
-Безвозвратно удаляет аккаунт и все его данные.
+Безвозвратно удаляет аккаунт и все его данные (включая сессию).
 
 **Синтаксис:** `delete <имя_аккаунта>`
 
 -   `<имя_аккаунта>`: Имя аккаунта для удаления.
 
 Скрипт запросит подтверждение перед удалением.
 
+### `toggle`
+
+Включает или выключает аккаунт.
+
+**Синтаксис:** `toggle <имя_аккаунта>`
+
+-   `<имя_аккаунта>`: Имя существующего аккаунта.
+
+Отключенные аккаунты не будут запускаться при старте бота.
+
 ### `edit`
 
 Изменяет параметры существующего аккаунта.
@@ -48,12 +50,11 @@ docker compose exec userbot python3 -m scripts.manage_account <команда> [
 
 **Опции:**
 -   `--lang <код>`: Устанавливает новый код языка (например, `en`).
--   `--enable`: Включает аккаунт.
--   `--disable`: Отключает аккаунт.
+-   `--enable` / `--disable`: Включает или отключает аккаунт (взаимоисключающие).
 -   `--device-model "Новая модель"`: Устанавливает новую модель устройства.
--   `--proxy-type <http|socks5>`: Устанавливает тип прокси.
+-   `--proxy-type <http|socks4|socks5>`: Устанавливает тип прокси.
 -   `--proxy-ip <ip>`: IP-адрес прокси.
 -   `--proxy-port <port>`: Порт прокси.
--   `--proxy-user <user>`: (Опционально) Имя пользователя прокси.
--   `--proxy-pass <pass>`: (Опционально) Пароль прокси.
+-   `--proxy-user <user>`: (Опционально) Имя пользователя прокси. Используйте `''` для пустого значения.
+-   `--proxy-pass <pass>`: (Опционально) Пароль прокси. Используйте `''` для пустого значения.
 -   `--clear-proxy`: Удаляет все настройки прокси для аккаунта.

docs/for-developers/creating-modules.md

@@ -51,7 +51,7 @@ def register(client):
 ## Метаданные
 
 -   `__requires__` (опционально): Список строковых имен Python-пакетов, которые необходимы для работы модуля. DeBot автоматически попытается установить их через `pip` при добавлении модуля.
--   `__trusted__` (опционально): `True` или `False`. Если `True`, модуль считается потенциально опасным и требует явного одобрения от пользователя командой `.trustmod`. Только доверенные модули получают доступ к реальному объекту `TelegramClient`.
+-   `__trusted__` (опционально): `True` или `False`. Если `True`, модуль считается потенциально опасным и требует явного одобрения от пользователя командой `.trustmod`. Только доверенные модули получают доступ к реальному объекту `TelegramClient` и его расширенным возможностям.
 -   `__config__` (опционально): Словарь, описывающий настраиваемые параметры модуля. Для каждого ключа можно указать `default` (значение по умолчанию) и `description` (описание).
 -   `info` (обязательно): Экземпляр класса `ModuleInfo`, который используется для генерации справки в команде `.help`.
 
@@ -61,25 +61,64 @@ def register(client):
 
 В зависимости от статуса доверия модуля, в `client` будет передан либо **реальный `TelegramClient`** (если модуль доверенный), либо **безопасная обертка `ModuleClient`** (если нет).
 
+## Мультиаккаунтное взаимодействие
+
+> ⚠️ **Требуется `__trusted__ = True`**
+>
+> Эта функция предоставляет доступ ко всем активным клиентам и является потенциально опасной. Используйте ее только в доверенных модулях.
+
+Вы можете создавать модули, которые управляют всеми активными аккаунтами одновременно. Например, модуль для массового вступления в чат.
+
+Для этого используйте метод `client.get_all_clients()`, который возвращает список всех активных экземпляров `TelegramClient`.
+
+**Пример модуля `mass_joiner.py`:**
+
+```python
+import asyncio
+from telethon import events
+from telethon.tl.functions.channels import JoinChannelRequest
+from userbot import TelegramClient
+from userbot.src.module_info import ModuleInfo
+
+# Этот модуль должен быть доверенным, чтобы получить доступ к другим клиентам
+__trusted__ = True
+
+info = ModuleInfo(
+    name="Mass Joiner",
+    category="tools",
+    patterns=[".mjoin <chat>"],
+    descriptions=["Зайти в указанный чат со всех активных аккаунтов."]
+)
+
+async def mass_join_handler(event: events.NewMessage.Event):
+    chat_to_join = event.pattern_match.group(1)
+    if not chat_to_join:
+        await event.edit("Укажите ссылку на чат.")
+        return
+
+    await event.edit(f"Начинаю вход в `{chat_to_join}` со всех аккаунтов...")
+    
+    all_clients: list[TelegramClient] = event.client.get_all_clients()
+    tasks = []
+    
+    for client_instance in all_clients:
+        task = client_instance(JoinChannelRequest(chat_to_join))
+        tasks.append(task)
+        
+    try:
+        await asyncio.gather(*tasks, return_exceptions=True)
+        await event.edit(f"✅ Все аккаунты ({len(all_clients)}) попытались войти в `{chat_to_join}`.")
+    except Exception as e:
+        await event.edit(f"Произошла ошибка: {e}")
+
+def register(client: TelegramClient):
+    client.add_event_handler(mass_join_handler, events.NewMessage(outgoing=True, pattern=r"^\.mjoin\s+(.+)"))
+```
+
 ## Локализация
 
 Ваши модули могут и должны поддерживать несколько языков.
 
 1.  Создайте папку `locales` внутри папки вашего модуля (например, `userbot/modules/my_module/locales/`).
 2.  Внутри создайте JSON-файлы для каждого языка (например, `ru.json`, `en.json`).
-    ```json
-    // ru.json
-    {
-        "response_message": "Ваш API ключ"
-    }
-    ```
-3.  В коде модуля получайте строки через `client`, который автоматически определит язык текущего аккаунта:
-    ```python
-    text = await event.client.get_string("response_message", module_name="my_module")
-    ```
-
-Бот будет искать перевод в следующей последовательности:
-1.  Перевод модуля на языке аккаунта.
-2.  Перевод модуля на русском/английском (fallback).
-3.  Системный перевод на языке аккаунта.
-4.  Системный перевод на русском/английском (fallback).
+3.  В коде модуля получайте строки через `client.get_string("key", module_name="my_module")`.

docs/system-architecture/overview.md

@@ -6,33 +6,35 @@ DeBot построен на модульной и асинхронной арх
 graph TD
     subgraph "Docker Environment"
         subgraph "Userbot Container (Python/Telethon)"
-            Init["<b>userbot/__init__.py</b><br>Точка входа<br>Загружает аккаунты из БД<br>Запускает асинхронные задачи для каждого клиента"]
-            Main["<b>userbot/__main__.py</b><br>Основной цикл событий<br>Обработчики команд<br>APScheduler для фоновых задач"]
+            Init["<b>userbot/__init__.py</b><br>Точка входа<br>Загружает аккаунты и сессии из БД<br>Запускает асинхронные задачи для каждого клиента"]
+            Main["<b>userbot/__main__.py</b><br>Основной цикл событий<br>APScheduler для фоновых задач"]
             DBManager["<b>DB Manager (SQLAlchemy)</b><br>Слой для работы с БД<br>Все CRUD-операции"]
             Locales["<b>TranslationManager</b><br>Кэширует и предоставляет переводы из .json файлов"]
             
             subgraph "Для каждого аккаунта"
-                Client[("TelegramClient Instance")]
-                Session[("DbSession")]
+                TempSession["Temp .session file"]
+                Client[("TelegramClient Instance")] -- "использует" --> TempSession
             end
         end
 
         DBContainer["<b>Database Container</b><br>(PostgreSQL)"]
     end
 
-    User((Telegram User)) -- ".addacc, .help, ..." --> Main
+    User((Telegram User)) -- "Команды (.addacc, .help, ...)" --> Client
     Init -- "Читает аккаунты" --> DBManager
     Init -- "Создает" --> Client
-    Client -- "Использует" --> Session
-    Main -- "Выполняет операции" --> DBManager
-    Main -- "Получает текст" --> Locales
-    Session -- "Сохраняет/читает сессию" --> DBManager
+    Init -- "Дешифрует сессию из БД и пишет в" --> TempSession
     DBManager -- "Подключается к" --> DBContainer
 ```
 
--   **`userbot/__init__.py` (Ядро)**: Это первая точка входа при запуске. Его задача — подключиться к базе данных, получить список всех **активных** аккаунтов (`is_enabled = True`) и создать для каждого из них отдельную асинхронную задачу по запуску клиента.
--   **`userbot/__main__.py` (Основной цикл)**: Этот файл содержит логику обработки команд, полученных от Telegram. Здесь же инициализируется и запускается `APScheduler`, который выполняет фоновые задачи (сборка мусора, автообновление).
+-   **`userbot/__init__.py` (Ядро)**: Это первая точка входа при запуске. Его задача — подключиться к базе данных, получить список всех **активных** аккаунтов (`is_enabled = True`). Для каждого аккаунта он выполняет следующие шаги:
+    1.  Извлекает зашифрованный файл сессии из базы данных.
+    2.  Дешифрует его.
+    3.  Записывает содержимое во временный файл на диске.
+    4.  Создает экземпляр стандартного `telethon.sessions.SQLiteSession`, указывая на этот временный файл.
+    5.  Создает и запускает отдельную асинхронную задачу для `TelegramClient`, передавая ему эту сессию.
+-   **`userbot/__main__.py` (Основной цикл)**: Этот файл содержит логику основного цикла событий и инициализирует `APScheduler` для выполнения фоновых задач (сборка мусора, автообновление).
 -   **DB Manager (SQLAlchemy)**: Слой абстракции для работы с базой данных. Все функции для добавления, получения, обновления и удаления данных (аккаунтов, сессий, модулей) реализованы здесь с использованием SQLAlchemy ORM.
 -   **TranslationManager**: Глобальный сервис, который отвечает за загрузку, кэширование и предоставление переведенных строк. Он обеспечивает мультиязычность во всем приложении.
--   **TelegramClient Instance**: Для каждого активного аккаунта создается свой собственный экземпляр кастомного класса `TelegramClient`, который наследуется от `telethon.TelegramClient`. Он содержит дополнительную логику, например, для работы с переводами.
--   **DbSession**: Кастомный класс сессии Telethon, который хранит данные сессии не в файле, а в базе данных PostgreSQL.
+-   **TelegramClient Instance**: Для каждого активного аккаунта создается свой собственный экземпляр кастомного класса `TelegramClient`, который наследуется от `telethon.TelegramClient`.
+-   **Хранение сессии**: В отличие от стандартного подхода, DeBot не хранит `.session` файлы на диске постоянно. Весь SQLite файл сессии хранится в базе данных PostgreSQL в зашифрованном виде (в поле типа `BYTEA`). Это обеспечивает безопасность и централизованное хранение.

docs/user-guide/module-management.md

@@ -33,6 +33,10 @@ DeBot обладает мощной модульной системой. Упр
 
 -   **`<модуль>`**: Имя модуля.
 -   **`<ключ>`**: Ключ параметра, который нужно изменить.
--   **`<значение>`**: Новое значение. Если значение содержит пробелы, его следует взять в кавычки (на данный момент не поддерживается, передавайте как одно слово или JSON).
+-   **`<значение>`**: Новое значение.
+
+### `.updatemodules`
+
+(В разработке) Команда для автоматического обновления модулей.
 
 > **Важно:** После добавления или удаления модулей может потребоваться перезапуск бота (`docker-compose restart userbot`) для корректной загрузки или выгрузки обработчиков событий.