54 lines
2.3 KiB
Markdown
54 lines
2.3 KiB
Markdown
# Режим VOLK
|
|
|
|
Режим включается в `.env` (скопируйте из [`.env.example`](../.env.example)):
|
|
|
|
```env
|
|
WORKMODE = "VOLK"
|
|
```
|
|
|
|
Проект поддерживает оба режима — **ZILANT** и **VOLK**; переключение только через `WORKMODE`, без смены кодовой базы.
|
|
|
|
## Отличия от ZILANT
|
|
|
|
| Аспект | ZILANT | VOLK |
|
|
|--------|--------|------|
|
|
| Загрузка данных | `vk_load.py`, `zk_load.py` | `volk_load.py` |
|
|
| Публикация | `tg_publish.py`, `evtg_publish.py` | `volk_cat_publish.py` |
|
|
| Runner | Полный пайплайн ZILANT | Отдельные кнопки рескана в UI |
|
|
| UI | Посты + события VK/Zilant | Категории (площадки) + события VOLK |
|
|
|
|
## Модули VOLK
|
|
|
|
### `volk_load.py`
|
|
|
|
- Загружает список категорий и событий с VOLK API.
|
|
- Переменные: `VOLK_CATEGORY_LIST`, `VOLK_CATEGORY_DESC_PREFIX`, `VOLK_EVENT_LIST_PREFIX`, `VOLK_API_VERSION`.
|
|
- Вызывается из `db_edit.py` (API `/api/run_volk_rescan`, кнопка «Рескан ВОЛК»).
|
|
|
|
### `volk_cat_publish.py`
|
|
|
|
- Публикует категории (площадки) в Telegram-канал.
|
|
- Функции `tg_post_category_by_id`, `tg_post_all_categories` — из веб-UI.
|
|
|
|
### Шаблоны
|
|
|
|
- `templates/edit_category.html` — редактирование площадки (только VOLK).
|
|
- Блоки `{% if g.workmode == 'VOLK' %}` в `templates/index.html`.
|
|
|
|
## Отладочные скрипты (не в production-пайплайне)
|
|
|
|
| Файл | Запуск |
|
|
|------|--------|
|
|
| `tools/dev/volk_category_testing.py` | `python tools/dev/volk_category_testing.py <category_id>` |
|
|
| `tools/dev/volk_telegram_testing.py` | `python tools/dev/volk_telegram_testing.py` |
|
|
|
|
См. [`tools/README.md`](../tools/README.md).
|
|
|
|
## Переключение режима на сервере
|
|
|
|
1. Изменить `WORKMODE` в `/opt/testbot-git/.env`.
|
|
2. Перезапустить UI: `sudo systemctl restart testedit-git.service`.
|
|
3. Responder-бот (`testbot-git`) от режима не зависит; сезонные ссылки общие (`SEASON`).
|
|
|
|
При смене режима проверьте переменные VOLK/ZILANT в `.env` (префиксы URL, API, `LOG_FILE`).
|