Zilant2025/tools/README.md

Вспомогательные скрипты

Скрипты вне основного пайплайна (runner.sh) и systemd-сервисов. Запускать из корня проекта с активированным venv.

ops/ — эксплуатация

Файл	Назначение
genkey.py	Генерация hex-ключа для SECRET_KEY / WEBHOOK_SECRET
register_tg_webhook.py	Ручная регистрация webhook (в норме — wsgi_bot.py при старте)
copy_databases.sh	Клонирование MariaDB между базами

python tools/ops/genkey.py
./venv/bin/python tools/ops/register_tg_webhook.py
bash tools/ops/copy_databases.sh <source_db> <target_db> <username>

dev/ — отладка и примеры

Файл	Назначение
send_telegram_example.py	CLI-пример API /send_message
volk_telegram_testing.py	Отладочный тест публикации в Telegram
volk_category_testing.py	Отладочный тест загрузки категории VOLK

python tools/dev/send_telegram_example.py <user_id> "<message>"
python tools/dev/volk_telegram_testing.py
python tools/dev/volk_category_testing.py <category_id>

legacy/ — снятые с пайплайна

Файл	Назначение
evt_prefetch.py	Массовая пометка видимых событий marked_to_publication=1. Убран из runner.sh в 1.0.0

./venv/bin/python tools/legacy/evt_prefetch.py