Справочник системы
Administrator
АДМИНИСТРАТОР
Дашборд
Главная страница системы
Сводка по всей системе одним взглядом. Открывается первой при входе в админку. У каждого блока есть иконка help с подсказкой — наведите курсор.
widgets Карточки метрик (верхняя строка)
- Новости сегодня — сколько новостей создано парсерами за день + разбивка: одобрено / отклонено / черновик
- AI Прогнозы — прогнозы от AI-экспертов (LLM) за сегодня + общее кол-во за всё время и процент точности
- Матчи сегодня — матчи из API-Sport + сколько сейчас LIVE и завершено
- Ошибки сегодня — логи error/critical из всех сервисов. 0 = всё штатно. Цвет: зелёный (0), жёлтый (1-5), красный (>5)
dns Здоровье сервисов
- Работает — сервис доступен, проверка пройдена
- Ожидает — сервис не активен (например, AI без ключа)
- Ошибка — сервис недоступен, требуется внимание
Проверяются: PostgreSQL, Redis, Parser Service, AI Processing, API-Sport, Celery Workers.
receipt_long Системный журнал
Последние 10 событий уровня warning/error/critical из всех сервисов. Логи пишутся в БД автоматически при работе парсера, AI-обработки, синхронизации матчей.
tune Готовность системы
- API-Sport — настроен ли API-ключ
- Эксперты — есть ли активные AI-эксперты
- Источники — есть ли активные источники новостей
- ИИ-движок — настроен ли OpenRouter ключ
api Дневной лимит API-Sport
Шкала использования дневного лимита запросов к API-Sport. Данные из Redis, обновляются при загрузке дашборда.
sync Кнопка «Синхронизация»
Запускает ручной сбор новостей из всех активных источников прямо сейчас. Результат: «Собрано N статей из M источников».
Лента новостей
Все собранные и обработанные статьи
Центральная страница контента. Здесь все новости — от только что собранных до опубликованных.
filter_alt Фильтры
- Вид спорта — показать только футбол, баскетбол и т.д.
- Статус — черновик, на модерации, опубликовано, отклонено
touch_app Действия с новостью
- Одобрить — публикует новость, становится доступна через API
- Отклонить — снимает с публикации
- Редактировать — открывает карточку: заголовок, текст, картинка
- AI-обработка — рерайт нейросетью + генерация картинки
- Удалить — безвозвратно удаляет
menu Кнопки в шапке
- Создать — создать новость вручную
- Удалить все — удаляет ВСЕ новости. Осторожно!
Очередь модерации
Проверка новостей перед публикацией
Страница для проверки новостей перед публикацией. Три вкладки:
tab Вкладки
- Ожидают — новости, прошедшие AI-обработку и ждущие вашего решения
- Одобрено — уже опубликованные
- Отклонено — отклонённые ранее
touch_app Действия
- Одобрить — публикует новость
- Отклонить — отправляет в архив
- Можно открыть карточку для просмотра полного текста и картинки
Источники
Откуда система собирает новости
category Типы источников
- RSS — стандартная RSS/Atom лента (например, sports.ru/rss)
- Web (парсер) — парсинг HTML-страниц сайтов
- ESPN API — автоматический сбор с ESPN
add_circle Как добавить
- Нажмите «Добавить источник»
- Укажите название, URL, тип и привяжите к виду спорта
- Нажмите «Сохранить» — источник появится в таблице
touch_app Действия
- Парсить — запустить сбор вручную
- Редактировать — изменить URL, название, интервал
- Вкл/Выкл — отключить без удаления
Настройки новостей
Промпты, лимиты, авто-одобрение
settings Основные параметры
- Лимит новостей в день — максимум статей за сутки
- Авто-одобрение — публиковать сразу без модерации
- Авто AI-обработка — автоматически рерайтить собранные новости
psychology Промпты (инструкции для AI)
Текстовые поля, где вы указываете нейросети как переписывать статьи и генерировать картинки. Можно менять стиль, длину, язык.
label Теги
Список тегов для классификации новостей (футбол, трансфер, лига чемпионов и т.д.).
Математические прогнозы
AI-прогнозы на матчи
Все сгенерированные прогнозы с фильтрацией по спорту, статусу и дате.
- Перегенерировать — пересоздать прогноз (если данные обновились)
- Каждый прогноз содержит: исход, тоталы, уверенность AI
Матчи
Расписание, результаты, статистика
Матчи загружаются автоматически из API-Sport. Две версии:
- Матчи (API-Sport) — базовая таблица
В карточке матча: составы, коэффициенты, статистика встреч.
Настройки прогнозов
Автогенерация и расписание
- Глубина (дней) — на сколько дней вперёд генерировать
- Авто-генерация — создавать прогнозы для новых матчей
- Авто-пересчёт — обновлять при изменении данных
- Утреннее/вечернее время — когда запускать
Виды спорта
Справочник категорий
Категории, к которым привязываются источники, новости, матчи и прогнозы.
- Название и slug — например: Футбол / football
- Иконка — значок для интерфейса
Обычно создаётся один раз при настройке.
Эксперты
Виртуальные AI-авторы прогнозов
Каждый эксперт — персонаж со своим стилем. AI пишет прогнозы от его имени.
- Имя и фото — показываются рядом с прогнозом
- Специализация — виды спорта
- Шаблон — промпт, задающий стиль эксперта
API-ключи
Доступ для внешних сервисов
Ключи для сайтов и приложений, получающих данные из системы.
add_circle Как создать
- Нажмите «Создать API-ключ»
- Укажите название клиента (например: «Основной сайт»)
- Задайте лимиты запросов (в час и в день)
Webhook
Автоуведомления при событиях
При публикации новости система автоматически отправляет данные на указанный URL вашего сервера.
- URL — адрес вашего сервера
- События — на что реагировать (новая новость, прогноз и т.д.)
- Тест — отправить тестовый запрос
RSS-ленты
Выдача контента через RSS
Система генерирует RSS-ленты, которые можно подключить к Telegram-каналам, сайтам или агрегаторам.
Каждая лента фильтруется по виду спорта и типу контента.
Документация API
Для разработчиков
Описание всех API-эндпоинтов с примерами запросов и ответов. Нужна разработчикам для интеграции.
Включает: авторизацию, получение новостей, прогнозов, матчей, фильтры, пагинацию.
Статус сервисов
Здоровье системы
Состояние каждого компонента системы:
- Зелёный — работает нормально
- Красный — не отвечает, нужно внимание
- Жёлтый — работает медленно
Сервисы: Backend API, PostgreSQL, Redis, Celery Worker, Celery Beat.
Логи
Журнал событий системы
Записи о работе: парсинг, AI-обработка, ошибки, входы пользователей.
Фильтры по уровню (info, warning, error) и по дате помогают быстро найти проблему.
Алерты
Уведомления о проблемах
Включите уведомления на конкретные события:
- Парсер не работает — сбор новостей остановился
- Очередь Celery — задачи накапливаются
- AI недоступен — нейросеть не отвечает
- Место на диске — осталось мало места
Каналы: Email, Telegram.
Общие настройки
Платформа, уведомления, безопасность
desktop_windows Платформа
- Название — заголовок в браузере
- Часовой пояс — для дат
- Язык — русский или английский
notifications Уведомления
- Email администратора — для системных писем
- Telegram Chat ID — для уведомлений в Telegram
- Частота — мгновенно, раз в час, дайджест
security Безопасность
- 2FA — дополнительный код при входе
- Время сессии — через сколько минут выкидывает
- IP-фильтрация — вход только с разрешённых IP
AI настройки
Нейросеть и генерация картинок
hub Провайдер и модель
- Провайдер — OpenRouter, OpenAI, Claude, YandexGPT
- API-ключ — получите на сайте провайдера
- Модель — дешёвые быстрее, дорогие качественнее
tune Параметры
- Температура — 0 = точный текст, 1 = креативный. Рекомендация: 0.7
- Макс. длина — лимит ответа. 4096 токенов — стандарт
image Генерация картинок
- Сервис — Kinetto, DALL-E, Stable Diffusion
- Модель — генератор внутри сервиса
- Вкл/Выкл — отключить полностью
account_balance_wallet Баланс OpenRouter
Остаток средств, траты за месяц и за сегодня.
API-Sport
Матчи и статистика
- API-ключ — от api-sport.io (платная подписка)
- Проверить соединение — тестовый запрос
- Синхронизировать — загрузить матчи вручную
- Интервал обновления — частота авто-загрузки
- Кэширование — сколько минут хранить без повторного запроса
Пользователи
Учётные записи, роли и права доступа
Создавайте учётные записи для сотрудников и назначайте им роли.
person_add Как создать
- Нажмите «Добавить пользователя»
- Заполните: имя, email (логин), пароль (от 6 символов), роль
- Нажмите «Сохранить» — сотрудник сразу может войти
touch_app Действия
- Редактировать — изменить имя, email, роль, статус
- Заблокировать — сотрудник не сможет войти, но данные сохранятся
- Удалить — безвозвратно
table_rows Колонки таблицы
- Пользователь — имя + email
- Роль — цветной бейдж
- Статус — активен или заблокирован
- Последний вход — когда заходил
- Создан — дата регистрации
shield_person Роли и права доступа
Админ
Полный контроль. Все разделы, пользователи, настройки, бэкапы.
Модератор
Контент + аналитика. Новости, прогнозы, матчи, эксперты, мониторинг.
Редактор
Только новости. Лента, модерация, источники, настройки новостей, AI.
Просмотр
Только вход. Заготовка для будущего использования.
table_chart Таблица доступа по ролям
| Раздел | Админ | Модер. | Редакт. | Просм. |
|---|---|---|---|---|
| Дашборд | + | + | + | - |
| Новости (лента, модерация, источники) | + | + | + | - |
| Настройки новостей, AI настройки | + | + | + | - |
| Прогнозы, матчи | + | + | - | - |
| Виды спорта, эксперты | + | + | - | - |
| Мониторинг, логи, алерты | + | + | - | - |
| API-ключи, webhook, RSS, документация | + | - | - | - |
| Общие настройки, API-Sport | + | - | - | - |
| Пользователи, бэкапы | + | - | - | - |
Бэкапы
Резервное копирование базы данных
schedule Расписание
- Автобэкап — вкл/выкл автоматическое копирование
- Частота — ежедневно, каждые 12 часов, еженедельно
- Время — во сколько запускать (лучше ночью, 03:00)
- Хранить последних — сколько копий оставлять
touch_app Ручные действия
- Создать бэкап — немедленно создать копию
- Восстановить — откатить базу к копии (текущие данные будут перезаписаны!)
- Удалить — удалить файл бэкапа
cloud Хранилище
Полоска внизу — сколько места занимают бэкапы из лимита.