From 289be4717ae81d79450f4830ee06f3e57b4da0e7 Mon Sep 17 00:00:00 2001
From: Alexey Barabanov <lexx1318@yandex.ru>
Date: Thu, 20 Nov 2025 16:42:35 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=D0=B8=D0=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 85 +++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 67 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index e1494eb..8b6a8fd 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,67 @@
-# AF_script
-## Установка
-Копируем сервис из репозитория.
-```shell
-sudo cp ~/main/Auto_Anons_Generator.service  /etc/systemd/system/Auto_Anons_Generator.service
-```
-Обновляем список сервисов
-```shell
-systemctl daemon-reload 
-```
-Запускаем сервис
-```shell
-systemctl start Auto_Anons_Generator.service 
-```
-## Проверка логов
-```shell
-sudo journalctl -t AFS
-```
\ No newline at end of file
+## Описание *AF_script*
+
+`AF_script_test_4.py` — это скрипт, написанный на Python, который автоматизирует процесс создания анонсов спортивных событий. Он использует данные из Excel-файла и отправляет их на рендеринг для создания видеоанонсов.
+
+### Основные функции:
+
+1. **Загрузка данных**:
+   - Скрипт загружает данные из Synology NAS с помощью API.
+   - Парсит данные из различных листов Excel-файла (например, `Start`, `SPORT`, `TEAMS`).
+
+2. **Обработка данных**:
+   - Создает словари с необходимыми данными для каждого анонса.
+   - Генерирует имена файлов для выходных видео на основе данных.
+
+3. **Рендеринг видео**:
+   - Формирует запросы к API рендера с необходимыми параметрами (например, шаблон, текст, логотипы команд).
+   - Отправляет запросы на рендеринг и отслеживает состояние задач.
+   - Уведомляет пользователя о ходе обработки через Telegram.
+
+4. **Масштабирование логотипов**:
+   Пример кода, который масштабирует логотип команды "B":
+   ```python
+   if data["team_b_logo_res"]:
+       payload["assets"].append(
+           {
+               "property": "scale",
+               "type": "data",
+               "expression": "if (width > height) {max_size = width;} else {max_size = height;} var real_size = "
+               + data["team_b_logo_res"][0]
+               + "/max_size*100;[real_size,real_size]",
+               "layerName": "TEAM_B_LOGO",
+           }
+       )
+       logger.info(
+           f"{data['team_b']} logo was resized to {data['team_b_logo_res'][0]}"
+       )
+       bot.send_message(
+           message.chat.id,
+           f"<b>{data['team_b']}</b> маштабирован под <b>{data['team_b_logo_res'][0]}</b> пикселей",
+           parse_mode=["html"],
+       )
+   ```
+   Этот код проверяет, установлен ли параметр `team_b_logo_res`, и если да, то добавляет в запрос на рендеринг инструкцию для масштабирования логотипа команды "B" до заданного размера. Затем записывает информацию о масштабировании в лог и отправляет уведомление пользователю через Telegram.
+
+### Команды для управления:
+
+- `/help`, `/start`: Отображает список доступных команд.
+- `/чёкак`, `/status`: Показывает количество задач, находящихся в очереди.
+- `/харе`, `/stop`: Отменяет все текущие задачи рендера.
+- `/ибаш`, `/ibash`: Начинает обработку новых задач на основе данных из Excel-файла.
+
+### Использование:
+
+1. **Установка**:
+   - Копируйте сервисный файл в директорию системных сервисов и обновите список сервисов.
+   ```shell
+   sudo cp ~/main/Auto_Anons_Generator.service  /etc/systemd/system/Auto_Anons_Generator.service
+   systemctl daemon-reload 
+   ```
+   - Запустите сервис:
+   ```shell
+   systemctl start Auto_Anons_Generator.service 
+   ```
+
+2. **Проверка логов**:
+   ```shell
+   sudo journalctl -t AFS
\ No newline at end of file