Руководство администратора — панель клуба «Цимус»

Панель управления клубом амбассадоров «Цимус» — это веб-приложение для кураторов клуба: модерация участников и контента, управление магазином, наградами и заданиями, настройка правил и аналитика.

Где открыть. Панель работает только на компьютере (десктоп) по адресу https://ecogarden-cimus.ru/admin. Версии для телефона нет.

Документ описывает все разделы панели: что вы видите на экране, какие действия доступны и какие правила при этом действуют. Термины и все статусы собраны в Глоссарии в конце.

Оглавление

  1. Введение
  2. Вход, роли и навигация
  3. Аналитика (дашборд)
  4. Пользователи
  5. Заявки
  6. Публикации
  7. Заказы
  8. Магазин, награды и задания
  9. Баннеры, теги и уровни
  10. Промокоды и события
  11. Администраторы, конфигурация и воркеры
  12. Рассылки
  13. Глоссарий

1. Введение

«Цимус» — клуб амбассадоров: люди подают заявку, вступают в клуб, публикуют посты о растениях и удобрении «Цимус» с хэштегами клуба, выполняют задания и приглашают друзей. За активность они получают баллы, растут по уровням (от «Семечка» до «Дерева») и тратят баллы в магазине.

Эта панель — рабочее место кураторов клуба. Через неё вы:

Панель ничего не делает «сама» без вашего ведома: все начисления, блокировки и решения — это ваши действия. Автоматика (проверка заявок, скан публикаций, распознавание фото) лишь готовит данные и подсказки, а окончательное решение принимаете вы.

2. Вход, роли и навигация

Вход в панель

  1. Откройте https://ecogarden-cimus.ru/admin в браузере на компьютере.
  2. Нажмите «Войти через VK ID» — вас перенаправит на страницу входа ВКонтакте.
  3. Подтвердите вход своим аккаунтом ВК и вернитесь обратно — вы окажетесь в панели.

Войти могут только заранее добавленные администраторы и модераторы. Если ваш аккаунт ВК не в списке, панель покажет сообщение об отказе в доступе — обратитесь к главному администратору клуба, чтобы вас добавили (см. раздел 11.1 «Администраторы»).

Сессия действует около 12 часов, после чего вход нужно повторить. Выход — через меню по клику на ваш аватар (или имя) в правом верхнем углу → «Выход».

Ваше имя в панели подтягивается из ВКонтакте автоматически при первом входе.

Роли: администратор и модератор

В панели две роли доступа:

Роль Что доступно
Администратор Полный доступ ко всем разделам: аналитика, пользователи, заявки, публикации, заказы, все каталоги и настройки системы.
Модератор Модерация Публикаций и Заказов — проверка контента и обработка заказов. Остальные разделы (пользователи, заявки, каталоги, аналитика, настройки) — только у администратора.

⚠️ В боковом меню сейчас видны все пункты независимо от роли, но фактический доступ определяется вашей ролью. Если модератор откроет раздел, недоступный для его роли, панель покажет сообщение об отказе в доступе — это ожидаемо.

Роль каждому назначает администратор в разделе «Администраторы».

Навигация (боковое меню)

Слева — меню, сгруппированное по смыслу. Группы «Модерация», «Каталоги» и «Система» раскрываются по клику.

Группа / пункт Раздел документа
Аналитика 3
Модерация → Пользователи 4
Модерация → Заявки 5
Модерация → Публикации 6
Модерация → Заказы 7
Каталоги → Магазин / Награды / Задания 8
Каталоги → Баннеры / Теги / Уровни 9
Каталоги → Промокоды / События 10
Система → Администраторы / Конфиг / Воркеры 11
Рассылки 12

Многие таблицы поддерживают фильтры (сверху над таблицей) и постраничную навигацию (снизу). Клик по VK ID участника в любой таблице обычно ведёт на его карточку в разделе «Пользователи».

💡 Подсказки «?». По панели рядом с заголовками блоков и полей стоят серые значки-вопросы ?. Наведите на них курсор — во всплывающей подсказке кратко описано, что делает этот блок или параметр. Это быстрая справка прямо в интерфейсе, дублирующая пояснения из этого руководства.

3. Аналитика (дашборд)

Раздел «Аналитика» — это главный дашборд клуба: одним взглядом показывает, сколько людей в клубе, как идут заявки и публикации, что происходит с баллами, как загружена автоматическая проверка фото и кто из амбассадоров «уснул». Здесь ничего нельзя изменить — это только просмотр цифр. Открывается через пункт меню «Аналитика» (обычно самый первый в боковом меню); заголовок страницы — «Аналитика».

Как устроена страница и выбор периода

В правом верхнем углу страницы есть выбор периода — поле с двумя датами (формат ДД.ММ.ГГГГ). Нажмите на него и выберите начальную и конечную дату в календаре. Очистить период нельзя — какой-то диапазон выбран всегда; по умолчанию открываются последние 30 дней.

Этот период управляет почти всеми блоками страницы сразу: восемью карточками сверху, «Популярными товарами» и четырьмя нижними секциями (кроме блока «Динамика» — у него свой отдельный период, см. ниже).

⚠️ Не все цифры зависят от выбранного периода. Три показателя всегда отражают текущее состояние клуба на сегодня, а не выбранный диапазон дат: «Обязательства (Σ баланс)» в блоке «Экономика баллов», блок «Амбассадоры по уровням» и блок «Спящие амбассадоры». Меняя период, вы на этих цифрах разницы не увидите — это нормально.

Если какой-то блок не смог загрузиться, появится всплывающее сообщение об ошибке — обновите страницу или попробуйте позже.

Восемь карточек-метрик (верх страницы)

Восемь плиток с ключевыми числами за выбранный период.

Карточка Что показывает
Всего пользователей Общее число всех, кто когда-либо открывал приложение. Это счётчик за всё время, он не ограничен периодом (при смене дат не меняется).
Заявок подано Сколько заявок на вступление в клуб было подано за период.
Заявок одобрено Сколько заявок было одобрено за период.
Заявок отклонено Сколько заявок было отклонено за период.
Активных (публикации/транзакции) Сколько уникальных людей проявили активность за период: сделали хотя бы одну публикацию или у них было хотя бы одно движение баллов (начисление/списание). Человек, у которого было и то и другое, считается один раз.
Публикаций Сколько публикаций было заведено в систему за период (все, включая ещё не проверенные).
Баллов начислено Сумма всех начислений баллов за период.
Баллов списано Сумма всех списаний баллов за период (показывается положительным числом).

⚠️ «Заявок подано», «одобрено» и «отклонено» считаются по разным датам (подача, одобрение, отклонение), поэтому в один и тот же период эти три числа между собой не обязаны сходиться — заявку могли подать в прошлом месяце, а одобрить в этом.

Популярные товары

Таблица под карточками — топ товаров магазина по числу заказов за выбранный период (не больше 10 строк).

Колонка Что показывает
Товар Название товара. Это ссылка — по клику вы переходите в раздел «Магазин» с открытой карточкой этого товара.
Заказов Сколько раз товар заказали за период.

Если за период заказов не было, в таблице будет надпись «Нет заказов за период».

Динамика (график)

Блок «Динамика» справа от «Популярных товаров» строит график изменения одного выбранного показателя по времени. У этого блока свой собственный период — он не связан с общим периодом страницы вверху.

Три органа управления над графиком:

Элемент Что делает
Выбор показателя (левый список) Какую из восьми метрик рисовать на графике (те же, что на карточках вверху: всего пользователей, заявки поданы/одобрено/отклонено, активные, публикации, баллы начислено/списано).
Шаг «По дням» или «По месяцам» — с какой детализацией разбивать линию. При переключении период графика автоматически подстраивается: «По дням» — последние 30 дней, «По месяцам» — последние 12 месяцев.
Период графика Свой выбор диапазона дат для графика. В режиме «По месяцам» выбираются месяцы (формат ММ.ГГГГ), в режиме «По дням» — дни (ДД.ММ.ГГГГ).

Наведите курсор на точку линии, чтобы увидеть подпись: дату (или месяц) и значение в этой точке.

⚠️ График наполняется ежедневным автоматическим расчётом. Данные за самые свежие дни могут появиться с небольшой задержкой, а по совсем новому периоду график может быть пустым — тогда в блоке будет надпись «Нет данных за период». Это не ошибка: значения подтянутся после очередного автоматического пересчёта.

Экономика баллов

Секция о том, что происходит с баллами клуба. Пять чисел вверху и список источников начислений под ними.

Показатель Что означает
Обязательства (Σ баланс) Сумма всех текущих балансов всех участников — сколько баллов «висит» на руках у людей прямо сейчас. Это по сути «долг» клуба перед амбассадорами. Показывает состояние на сегодня, период не учитывается.
Начислено за период Сколько баллов начислено за выбранный период.
Потрачено в магазине Сколько баллов потрачено на заказы в магазине за период.
Сгорело Сколько баллов сгорело за период (аннулировано по правилам сгорания).
Redemption Доля начисленных баллов, которая ушла на покупки: «Потрачено в магазине» ÷ «Начислено за период», в процентах. Ориентировочный показатель «насколько активно тратят баллы»; может быть неточным на коротких периодах (тратить могут баллы, накопленные раньше). Если за период ничего не начислено — показывается 0%.

Ниже — список «Источники начислений»: за что именно начислялись баллы за период (например, «Публикация», «Задание», «Реферал», «Мероприятие», «Награда», «Бонус уровня», «День рождения», «Ручная корректировка»). Рядом с каждой строкой — сумма баллов, а длина полоски показывает вклад источника относительно самого крупного. Если начислений не было — «Нет данных за период».

Амбассадоры по уровням

Список из шести уровней-растений (Семечко, Росток, Стебель, Цветок, Плодонос, Дерево) и число участников на каждом. Полоска рядом наглядно показывает, где людей больше. Показаны все шесть уровней, даже если на каком-то пока никого нет (там будет 0).

⚠️ Это срез на текущий момент, а не за период — распределение по уровням отражает сегодняшнее состояние клуба.

AI-модерация

Секция о работе автоматической проверки публикаций (распознавание фото и текста). Данные — за выбранный период.

Показатель Что означает
Стоимость AI Сколько рублей потрачено на автоматические проверки за период (с точностью до копеек).
Проверок (попыток) Сколько всего попыток автоматической проверки было выполнено за период. Одну публикацию система может проверять несколько раз, поэтому это число обычно больше числа публикаций.

Под числами — два списка:

Спящие амбассадоры

Блок помогает найти кандидатов на «пробуждение» — членов клуба, которые давно ничего не делают. Показаны три числа:

Показатель Что означает
30+ дней Сколько членов клуба не публиковали ничего и не имели движений баллов более 30 дней.
60+ дней То же, но неактивных более 60 дней.
90+ дней То же, но неактивных более 90 дней.

Считаются только полноправные члены клуба (не заявки и не заблокированные). Это подсказка кураторам, к кому стоит обратиться, чтобы вернуть человека к активности.

⚠️ Числа считаются относительно сегодняшней даты, а не выбранного вверху периода. Учтите, что группы вложены друг в друга: тот, кто «спит» 90+ дней, попадает и в счётчики 60+, и 30+.

4. Пользователи

Этот раздел — главная картотека клуба: здесь собраны все амбассадоры и посетители приложения. Отсюда вы находите нужного человека, смотрите его профиль, баллы, публикации и заказы, начисляете или списываете баллы, меняете статус, ставите теги и при необходимости блокируете. Открывается пунктом меню «Пользователи».

Список пользователей

При открытии раздела вы видите таблицу всех пользователей, отсортированную так, что сверху — недавно появившиеся. Над таблицей находится строка фильтров и поиска, справа сверху — кнопка «Добавить». Каждая строка кликабельна: щелчок по любому месту строки открывает карточку этого пользователя.

Внизу таблицы — постраничная навигация. По умолчанию показывается по 20 человек на странице; количество на странице можно увеличить переключателем размера страницы.

Фильтры и поиск

Фильтры можно комбинировать между собой — тогда останутся только те, кто подходит сразу под все выбранные условия.

Поле Что делает
Поиск Введите имя или числовой VK ID. Поиск идёт по имени и фамилии (без учёта регистра); если ввести число — ищет по VK ID.
Теги Введите одно или несколько названий тегов через запятую. Останутся только те, у кого есть все перечисленные теги одновременно (а не любой из них). Пустое поле — показать всех.
Статус Выпадающий список статусов амбассадора (см. таблицу статусов ниже). Оставляет только людей в выбранном статусе.
Активность Выпадающий список статусов активности. Оставляет только людей с выбранным уровнем активности.

Статусы амбассадора (колонка «Статус» и фильтр):

Статус Что означает
Не подал Человек зашёл в приложение, но заявку в клуб не подавал.
Заявка Заявка подана и ожидает решения (заявки разбираются в разделе «Заявки»).
Член клуба Полноправный участник клуба.
Член (одобрен) Тот же член клуба с ручной отметкой о дополнительной проверке. На доступный функционал эта отметка не влияет — это пометка «сверено вручную».
Заблокирован Доступ в приложение закрыт (ставится через кнопку блокировки, см. ниже).

Статусы активности (колонка «Активность» и фильтр). Активность вычисляется автоматически по датам вступления и последнего действия и не задаётся вручную, кроме «На паузе»:

Статус Что означает
Новичок Недавно вступил и ещё не проявлял активности. С первой публикацией переходит в «Активен».
Активен Есть активность за последний период (около месяца).
Низкая активность Активности не было примерно от одного до двух месяцев.
Неактивен Активности нет более длительный срок (свыше двух месяцев).
На паузе Устанавливается вручную.
Заблокирован Активность заблокированного участника.

Колонки таблицы

Колонка Что показывает
VK ID Числовой идентификатор пользователя во ВКонтакте. Значок копирования рядом позволяет скопировать его в один клик.
Имя Имя и фамилия.
Статус Статус амбассадора (цветная метка).
Активность Статус активности (цветная метка).
Ур. Текущий уровень (номер уровня-растения).
Баллы Текущий баланс баллов, доступный к трате.
Накоплено Сколько баллов человек накопил за всё время. От этого числа зависят уровень и место в рейтинге; списания в магазине его не уменьшают.
Теги Проставленные пользователю теги — каждый в своём цвете из каталога тегов.

Добавление амбассадора вручную (кнопка «Добавить»)

Кнопка нужна, чтобы завести в клубе человека «задним числом» — например, перенести уже существующего амбассадора из старого учёта, минуя обычную подачу заявки и автоматическую проверку. Открывает окно «Добавить амбассадора (legacy)» с полями:

Поле Обязательно Что вводить
VK ID Да Числовой идентификатор ВКонтакте будущего амбассадора.
Уровень Нет Уровень вручную, от 0 до 5. Задаётся напрямую, без автоматического пересчёта по баллам.
Баллы (начислить) Нет Сколько баллов сразу начислить (0 и больше).
Статус Нет Статус амбассадора; по умолчанию «Член клуба».

После сохранения появляется сообщение «Амбассадор добавлен», и список обновляется. Такой участник помечается как добавленный вручную (в его карточке поле «Legacy» будет «да»). Датой регистрации и вступления считается момент добавления — поэтому его прежние публикации, сделанные до этого момента, автоматически в зачёт не идут.

⚠️ Повторное добавление того же VK ID не удваивает баллы: если случайно нажать сохранение дважды, баланс не задваивается.

Добавление вручную доступно только администраторам.

Карточка пользователя

Открывается кликом по строке в списке. Наверху — шапка с фото, именем и метками статусов и кнопками действий; ниже — таблица со сведениями; внизу — блоки транзакций, публикаций, рефералов и заказов.

Шапка: живой профиль из ВК и кнопка «Обновить из VK»

В шапке показывается актуальный профиль ВКонтакте: аватар и имя подтягиваются напрямую из ВК (если ВК недоступен — показывается последнее сохранённое). Рядом со статусами стоит метка источника данных:

Метка Что означает
VK · сейчас Профиль только что получен из ВКонтакте напрямую.
VK · кэш Показаны недавно полученные данные из временного хранилища (чтобы не дёргать ВК на каждый заход).
БД (VK недоступен) ВКонтакте сейчас недоступен, показаны последние сохранённые данные.

Кнопка «Обновить из VK» заново запрашивает профиль из ВКонтакте и сохраняет свежие данные. После успеха появляется «Профиль обновлён из VK»; если ВК недоступен — «Не удалось получить профиль из VK».

⚠️ Важное правило при обновлении из ВК. Имя, фамилия и город, указанные человеком в заявке, считаются приоритетными и при обновлении из ВК не перезаписываются (город — только если в заявке он был заполнен). А вот аватар и ссылка на профиль ВК обновляются всегда. Поэтому фото в шапке может стать новее, но имя и город из заявки останутся прежними — это сделано намеренно, чтобы не терять данные, которые человек сам о себе указал.

Из-за этого правила имя и город в шапке (живые из ВК) и в таблице сведений ниже (сохранённые, приоритетно из заявки) могут отличаться — это нормально.

Сведения о пользователе

Под шапкой — таблица с подробностями. Поля только для просмотра:

Поле Что показывает
Имя Сохранённое имя (приоритетно — из заявки).
Город Город (приоритетно — из заявки); «—», если не указан.
Уровень Текущий уровень.
Активность Статус активности.
Баланс Доступные к трате баллы.
Накоплено (lifetime) Всего накоплено за всё время (влияет на уровень и рейтинг).
Дата рождения Дата рождения (из заявки, переносится при одобрении).
Часовой пояс Смещение от UTC (например «UTC+03:00»), по которому поздравление с днём рождения уходит человеку в его локальные 9:00. Обычно определяется автоматически по устройству; «МСК по умолчанию (UTC+03:00)» — если пояс ещё не определён (тогда время берётся московское).
Вступил Дата вступления в клуб.
Регистрация Дата первого появления в приложении.
Legacy «да» — если человек был заведён вручную кнопкой «Добавить»; иначе «нет».
Подписка на бота Включил ли человек уведомления в приложении и дал ли реальное разрешение ВК на сообщения. Сообщения от клуба уходят только когда оба ответа «да».
Согласия Отмечены ли согласие на обработку персональных данных и согласие с правилами (✓ — дано).
Реф. код Персональный код для приглашения друзей.
Пригласил (vk) VK ID того, кто пригласил этого человека (если он пришёл по приглашению).
Теги Проставленные теги — они же показаны цветными метками в шапке карточки (цвет берётся из каталога тегов).

Если человек заблокирован, над таблицей появляется красная плашка с датой, до которой действует блокировка, и причиной.

Действия в карточке

Кнопки действий расположены в правом верхнем углу карточки.

Баллы (корректировка баланса)

Кнопка «Баллы» открывает окно «Корректировка баллов»:

После сохранения показывается новый баланс. Записанная корректировка появляется в блоке «Последние транзакции» как «Начисление» (для плюса) или «Корректировка» (для минуса) с причиной «Ручная корректировка».

⚠️ Списать больше, чем есть на балансе, нельзя — увести баланс в минус система не даст.

Особенности: начисление в плюс увеличивает и «Накоплено», значит может поднять уровень. Списание в минус на «Накоплено» и уровень не влияет — уровень от корректировки не падает.

Корректировка баллов доступна только администраторам.

Статус (смена статуса амбассадора)

Кнопка «Статус» открывает окно «Сменить статус» с выпадающим списком статусов (те же, что в таблице статусов выше). Выберите нужный и сохраните — появится «Статус обновлён».

⚠️ Заблокировать или разблокировать человека через это окно нельзя — для этого есть отдельные кнопки блокировки (см. ниже). Статус «Член (одобрен)» — это ручная отметка о дополнительной проверке; на доступный участнику функционал она не влияет.

Смена статуса доступна только администраторам.

Теги (проставить/снять)

Кнопка «Теги» открывает окно «Теги амбассадора» с полем выбора тегов. Список тегов подставляется из общего каталога тегов; можно выбрать сразу несколько. Отмеченные теги остаются на человеке, снятые — убираются. После сохранения — «Теги обновлены».

⚠️ Присвоить можно только теги, которые уже заведены в каталоге. Если нужного тега нет — его сначала создают в разделе управления тегами. Теги — это внутренние пометки команды, они помогают фильтровать людей в списке.

Часовой пояс

Кнопка «Пояс» открывает окно «Часовой пояс пользователя» с одним полем — смещение от UTC в минутах. По этому поясу авто-поздравление с днём рождения уходит человеку в его локальные 9:00.

Пояс обычно приходит автоматически с устройства пользователя. Задавать вручную нужно только тогда, когда поздравление приходит не в 9:00 по местному времени человека — впишите правильное смещение:

После сохранения — «Часовой пояс обновлён». Изменение фиксируется в журнале аудита.

Изменение пояса доступно администраторам и модераторам.

Блокировка и разблокировка

Если человек не заблокирован, есть красная кнопка «Заблокировать». Она открывает окно «Заблокировать амбассадора»:

После блокировки статус меняется на «Заблокирован». Заблокированный человек не сможет пользоваться приложением — при входе он увидит экран с сообщением, что заблокирован до указанной даты, и с указанной причиной.

Если человек уже заблокирован, вместо этой кнопки показывается «Разблокировать». Она спрашивает подтверждение «Снять блокировку?» и после согласия снимает блокировку — статус возвращается к тому, что был до неё.

Блокировка и разблокировка доступны только администраторам.

Профиль / ЛС

Кнопка «Профиль / ЛС» открывает страницу этого человека во ВКонтакте в новой вкладке — оттуда можно перейти в его профиль и написать ему личное сообщение.

Удаление из базы

Красная кнопка «Удалить из БД» полностью стирает человека и все связанные с ним данные: заявки, публикации, историю баллов, заказы, прогресс заданий, рефералов (и как приглашающего, и как приглашённого), записи о выданных промокодах и неотправленные уведомления. Действие необратимо — восстановить эти данные нельзя.

В окне удаления два поля:

Поле Как заполнять
Что сделать с его промокодами «Вернуть в пул» — коды снова станут свободными и достанутся другим амбассадорам; «Удалить коды совсем» — коды исчезнут вместе с человеком, и пул уменьшится; «Не трогать» — коды останутся помеченными как выданные удалённому участнику.
Подтверждение Введите VK ID удаляемого человека — так система убеждается, что удаляется именно тот, кого вы открыли.

⚠️ Промокод, который уже у человека на руках, отозвать невозможно. Выбор влияет только на записи в базе: сам код мог быть уже использован на сайте магазина.

⚠️ Удаление не закрывает доступ. Если этот человек снова зайдёт в приложение, он заведётся заново — с нулевым балансом, без статуса и без истории. Чтобы закрыть доступ, используйте блокировку, а не удаление.

Удалять пользователей может только администратор. В журнале действий остаётся запись о том, кто и когда удалил человека, со снимком его основных данных — это единственный след, который сохраняется.

Разделы карточки

Внизу карточки собрана история и связи пользователя.

Последние публикации — список последних постов человека: ссылка на пост, его статус («На проверке», «Засчитана», «Не засчитана», «Перепроверка») и дата. Ссылка открывает пост во ВКонтакте. Если публикаций нет — «Нет публикаций».

Последние транзакции — таблица движений баллов:

Колонка Что показывает
Дата Когда прошла операция.
Тип «Начисление», «Списание», «Возврат» или «Корректировка».
Причина За что: Публикация, Задание, Реферал, Мероприятие, Награда, Заказ магазина, Возврат заказа, Ручная корректировка, Бонус уровня, Сгорание, День рождения.
Сумма Плюс (зелёным) или минус (красным).
Баланс Каким стал баланс после этой операции.
Описание Пояснение (в том числе комментарий ручной корректировки).

Если операций нет — «Нет транзакций».

Рефералы — сводка по приглашённым: Всего (сколько человек привёл), Вступили (сколько из них вступили), Квалиф. (сколько дошли до засчитанного, квалифицированного приглашения).

Последние заказы — последние заказы из магазина: название товара, его стоимость в баллах и статус заказа («Новый», «Ждёт подтверждения», «Подтверждён», «В работе», «Выполнен», «Отклонён», «Возвращён»). Если заказов нет — «Нет заказов».

5. Заявки

Раздел «Заявки» — это очередь людей, которые подали заявку на вступление в клуб амбассадоров. Здесь вы видите, кто хочет вступить, прошла ли его страница автоматическую проверку по условиям клуба, и принимаете решение: принять человека в клуб или отклонить заявку. Открывается через пункт меню «Заявки» в боковом меню админки.

Как работает автоматическая проверка (что происходит до вас)

Когда человек отправляет заявку в приложении, система сразу же автоматически проверяет его страницу ВКонтакте по условиям вступления в клуб. Пока проверка идёт, заявка находится в статусе «На проверке». По итогам проверки заявка обычно сама переходит в «Принята» (если страница подходит) или «Отклонена» (если какое-то условие не выполнено, с указанием причин).

Условия вступления (значения ниже — по умолчанию, они настраиваются командой клуба):

Условие Требование по умолчанию
Подписчики не менее 50
Посты о растениях за последние 2 месяца не менее 2 (считаются только собственные посты автора, репосты не учитываются; анализируются последние N постов — см. «Окно анализа постов» в настройках)
Доступ к странице профиль или сообщество должны быть открыты для всех

За «слишком много постов» заявка не отклоняется — верхней границы по числу постов нет.

⚠️ Автопроверка — это первичный фильтр, а не окончательный приговор. В очереди вы можете вручную одобрить даже ту заявку, которую автопроверка отклонила (например, пограничный случай), или наоборот — отклонить заявку, которая формально прошла. Ваше решение имеет приоритет.

Фильтр по статусу

Над таблицей есть фильтр по колонке «Статус». Выберите нужный статус из списка и примените — таблица покажет только заявки в этом состоянии. Это единственный фильтр в разделе (искать по имени автора или номеру страницы здесь нельзя). Заявки всегда отсортированы так, что самые новые — сверху. На странице показывается по 20 заявок, остальные — на следующих страницах.

Возможные статусы заявки:

Статус Что означает
На проверке Заявка подана, автоматическая проверка ещё идёт или поставлена в очередь. Решение пока не принято.
Принята Заявка одобрена (автоматически или вами вручную). Человек стал членом клуба.
Отклонена Заявка не одобрена — автоматически по невыполненным условиям либо вручную. Человек может исправить страницу и запросить повторную проверку.
Истекла Заявка просрочена (не была решена в отведённый срок — 30 дней с момента подачи).
Отменена Заявка отменена.

Колонки таблицы

Колонка Что показывает
VK ID Числовой идентификатор человека во ВКонтакте. Это ссылка — по клику открывается карточка пользователя в админке (раздел «Пользователи»).
Автор Имя и фамилия человека, подавшего заявку (из формы заявки). Длинное имя обрезается — наведите курсор, чтобы увидеть целиком.
Статус Текущее состояние заявки цветным тегом (см. таблицу статусов выше).
Цель Страница, которую человек указал как свой блог: «Профиль …» или «Сообщество …» с номером. Это ссылка — по клику открывается сама страница ВКонтакте в новой вкладке (удобно, чтобы вручную посмотреть блог перед решением).
Последняя проверка Итог автоматической проверки страницы. Зелёный тег «прошла» — страница удовлетворяет всем условиям; красный тег «не прошла» — какое-то условие не выполнено. Рядом две цифры: 👥 — число подписчиков, 🌱 — число постов о растениях за 2 месяца. Наведите курсор — во всплывающей подсказке будут точные числа: сколько подписчиков, сколько всего постов и сколько постов о растениях за 2 месяца. Если проверок ещё не было, стоит прочерк «—».
Причины Оранжевые теги с перечнем условий, которые страница не выполнила (подробнее ниже). У прошедших заявок этот столбец пустой.
Создана Дата подачи заявки.
Действия Кнопки «Одобрить» и «Отклонить» (см. ниже).

Что показывают «Причины»

Оранжевые теги в колонке «Причины» — это конкретные условия вступления, которые страница человека не прошла. Их проставляет автоматическая проверка, чтобы вы сразу видели, почему заявка «не прошла», не открывая страницу вручную.

Тег Что это значит
Мало подписчиков На странице меньше подписчиков, чем требуется для вступления.
Мало постов о растениях За последние 2 месяца слишком мало постов на тему растений.
Профиль/сообщество закрыты Страница закрыта настройками приватности — система не смогла её проверить. Такому человеку нужно открыть профиль для всех и запросить проверку заново.
Не прошла модерацию Заявка отклонена по решению модерации.

Если тегов несколько — значит, не выполнено сразу несколько условий.

Действие «Одобрить»

Кнопка «Одобрить» принимает человека в клуб. По клику появляется подтверждение «Одобрить заявку?» с кнопками «Одобрить» и «Отмена» — так исключены случайные нажатия.

Что происходит после подтверждения:

⚠️ Уведомление об одобрении дойдёт только к тем, кто разрешил сообщения от сообщества и подписался на бота в приложении. Если человек этого не сделал, он узнает о принятии сам, зайдя в приложение.

⚠️ После подтверждения одобрение отменить через эту кнопку нельзя. Убедитесь, что заявка действительно подходит, прежде чем нажимать «Одобрить».

Действие «Отклонить»

Кнопка «Отклонить» открывает окно «Отклонить заявку» с полем «Причина (необязательно)». Здесь вы можете своими словами написать, почему отклоняете заявку, — либо оставить поле пустым.

Как это работает:

Что происходит после отклонения:

⚠️ Отклонение заявки, в отличие от одобрения, не отправляет человеку сообщение от бота. Он увидит, что заявка отклонена, и причины — самостоятельно, открыв приложение.

Кто может принимать решения

Раздел «Заявки» и решения по ним («Одобрить» / «Отклонить») доступны администраторам.

6. Публикации

Этот раздел — очередь публикаций амбассадоров с хэштегом клуба и карточка каждого поста. Здесь модератор видит результат автоматической проверки (в том числе распознавание фото нейросетью) и принимает окончательное решение: засчитать пост и начислить баллы, отклонить или отправить на повторную автопроверку. Открывается пунктом меню «Публикации».

Как посты попадают в очередь

Посты собираются автоматически: система находит на стенах зарегистрированных амбассадоров записи с клубным хэштегом и заводит их в этот раздел — даже если пост не прошёл остальные условия. Часть постов проходит проверку и засчитывается сама, без участия человека. В очередь на ручное решение попадают посты, которые автоматика не может закрыть сама:

⚠️ Нейросеть распознаёт фото точно, но не на 100%. Поэтому даже засчитанный автоматикой пост можно пересмотреть, а спорные случаи всегда остаются под ручной модерацией.

Список публикаций

Таблица со всеми найденными постами. Каждая строка — один пост; клик по строке открывает карточку. По умолчанию показывается очередь на модерацию (посты на проверке, на перепроверке и отклонённые). Сортировка — сначала недавно найденные.

Колонка Что показывает
VK ID Числовой ID автора. Это ссылка — открывает карточку амбассадора в разделе «Пользователи».
Автор Имя автора поста.
Статус Текущее состояние поста цветным ярлыком (см. таблицу статусов ниже). По этой колонке есть фильтр — можно выбрать один статус и увидеть только такие посты.
Медиа Тип вложения: «фото», «видео» или «—» (без медиа).
Хэштег Клубный хэштег, по которому найден пост (или «—»).
Ссылка Прямая ссылка на пост во ВКонтакте. Открывается в новой вкладке, клик по ней не открывает карточку.
Причины Ярлыки с причинами, по которым пост не прошёл (например «Не прошла модерацию», «Мало подписчиков», «Профиль/сообщество закрыты»). Пусто, если причин нет.
Найдена Дата, когда система обнаружила пост.

Фильтр по статусу. Над таблицей в колонке «Статус» можно выбрать конкретный статус — список перестроится только под него. Постранично показывается по 20 постов.

Карточка публикации

Открывается кликом по строке. Вверху — заголовок «Публикация · имя автора» и набор ярлыков рядом с ним:

Ярлык Значение
Цветной статус Текущее состояние поста (см. таблицу статусов).
«фото» / «видео» Тип вложения.
«репост» (красный) Пост является репостом чужой записи.
«соавторство» (фиолетовый) Пост оформлен в соавторстве.

Справа вверху — четыре кнопки-действия (разобраны ниже в блоке «Решения модератора»), включая ссылки:

Если пост не прошёл какие-то условия, под шапкой показывается жёлтая плашка «Не пройдены критерии» со списком причин.

Данные автора и поста

Поле Что показывает
Автор Имя автора — ссылка на его карточку в «Пользователях».
Опубликован Дата и время публикации поста.
Хэштег Клубный хэштег поста.
Источник Как пост попал в систему (например, найден при сканировании или отправлен автором на пересмотр).
Баллы начислено Сколько баллов уже начислено за этот пост (0, если ещё не засчитан).
Соавторы Перечень соавторов, если пост совместный (иначе «—»).
Текст Текст поста (или «—»).

Критерии

Чек-лист условий клуба. Напротив каждого пункта — один из трёх значков: зелёная галочка ✓ (выполнено), красный крестик ✗ (не выполнено) или серый прочерк — (не применимо к типу поста, например фото-критерии для видео). Под списком продублирована расшифровка: ✓ пройден · ✗ не пройден · — не применимо.

Если критерии по посту ещё не проверялись (пост на ручной модерации или отклонён до автопроверки), вместо чек-листа будет надпись «Критерии не проверялись».

Пункт Что проверяется
Не репост Пост авторский, а не репост чужой записи.
Есть обязательный клубный хэштег В тексте есть обязательный клубный хэштег (он нужен во всех постах). Если у поста другой/категорийный тег, но обязательного нет — пункт будет ✗.
Есть описание У поста есть текстовое описание.
Ключевые слова в описании В описании присутствуют нужные ключевые слова.
Есть фото К посту приложено фото.
На фото растение Нейросеть увидела на фото растение.
На фото удобрение «Цимус» Нейросеть увидела на фото удобрение «Цимус».
Не дубль соавтора Фото не использовалось раньше в уже засчитанном посте (защита от повторного зачёта одного фото у соавторов).

⚠️ Фото, видео или фото+видео. Автопроверка нейросетью распознаёт растение/удобрение только на фото. Поэтому:

💡 Правки постов учитываются автоматически. Если амбассадор отредактирует уже отклонённый пост (добавит обязательный хэштег или фото удобрения), система заметит правку при очередном сканировании стены (в пределах последних ~10 дней) и сама переоценит пост — вручную запускать перепроверку не нужно.

Метрики

Показатели поста ВКонтакте на момент проверки: Просмотры, Лайки, Комменты.

Автопроверка (AI)

Итоги автоматической проверки нейросетью:

Поле Что показывает
Попыток Сколько раз пост прогонялся через автопроверку.
Стоимость AI Во сколько обошлась проверка фото нейросетью, в рублях.
Последний прогон Дата и время последней автопроверки.
Ошибка Текст ошибки красным — показывается, только если при проверке что-то пошло не так (например, фото не удалось загрузить). Если ошибок нет, строки нет.

Модерация

Блок появляется, только если по посту уже было ручное решение. Показывает, какое решение принято и когда.

Фото и AI-вердикты

Галерея всех фото поста. В заголовке — сводка: у скольких фото найдено растение и у скольких — удобрение (например «растение: 2/3, удобрение: 1/3»). Клик по фото открывает его в увеличенном виде.

Под каждым фото — два ярлыка с вердиктом нейросети (зелёные при наличии, серые при отсутствии):

Это помогает модератору быстро сверить решение нейросети со своим глазом: если автоматика ошиблась (например, отметила ✗, а удобрение на фото видно), пост можно засчитать вручную.

Решения модератора

Четыре кнопки в правом верхнем углу карточки. Каждое решение фиксируется в системе.

Засчитать

Главная кнопка (синяя). Открывает небольшое окно с одним полем «Баллы»:

После подтверждения пост переходит в статус «Засчитана», баллы начисляются автору, и появляется сообщение «Засчитана, баллы начислены». Начисление отражается в балансе и истории транзакций амбассадора.

⚠️ Пост можно засчитать только один раз. Если он уже засчитан, повторный зачёт не пройдёт — система не даст начислить баллы дважды за один пост. Это же правило защищает от двойного начисления, если пост параллельно засчитала автоматика.

⚠️ Кнопка «Засчитать» не списывает баллы. Снять или скорректировать баллы амбассадора можно только через его карточку в разделе «Пользователи» (ручная корректировка баллов) — здесь такого действия нет.

На перепроверку

Кнопка отправляет пост на повторную автоматическую проверку (нейросетью и по условиям), а не на решение человека. Перед действием система спросит подтверждение («Отправить на авто-перепроверку?»). После подтверждения пост переходит в статус «На проверке» и снова встаёт в автоматическую очередь; появляется сообщение «Отправлена на перепроверку».

Используйте, когда автопроверка, возможно, ошиблась из-за временной причины (например, была ошибка загрузки фото) и есть смысл прогнать пост заново, вместо того чтобы решать вручную.

Автопроверка фото ограничена по количеству в сутки на одного амбассадора. Поэтому отправленный на перепроверку пост может ненадолго «подвиснуть» в очереди, пока не подойдёт его черёд, — это нормально.

Отклонить

Красная кнопка. Перед действием система спросит подтверждение («Отклонить публикацию?»). После подтверждения пост переходит в статус «Не засчитана» с причиной «Не прошла модерацию», и появляется сообщение «Отклонена». Баллы не начисляются. Автор в своём приложении увидит, что пост не засчитан по причине непрохождения модерации.

Статусы публикации

Статус Цвет Что означает
На проверке синий Пост в очереди на автоматическую проверку (или отправлен на перепроверку).
Засчитана зелёный Пост принят, баллы начислены.
Не засчитана красный Пост отклонён (автоматикой или модератором).
Перепроверка жёлтый Автор оспорил результат — пост ждёт ручного решения модератора в этой очереди.

Разница между «На проверке» и «Перепроверка»: «На проверке» — пост находится у автоматики; «Перепроверка» — пост ждёт именно человека (амбассадор нажал «Оспорить» в приложении). После вашего решения статус меняется на «Засчитана» или «Не засчитана».

Репост и соавторство

Ручная модерация видео

Видеозаписи нейросеть по фото не проверяет, поэтому видео не засчитываются автоматически и попадают в эту очередь на ручное решение. Модератор сам смотрит видео (по кнопке «Открыть пост»), сверяет его с условиями клуба и принимает решение теми же кнопками — «Засчитать» (с нужным числом баллов), «Отклонить» или «На перепроверку».

Исключение — посты-благодарности по специальному хэштегу (например, благодарность клубу): такие записи засчитываются по самому хэштегу, независимо от того, фото это или видео, и в ручную очередь обычно не попадают.

7. Заказы

Этот раздел — очередь заказов из магазина клуба. Здесь администратор видит, кто и какой товар заказал за баллы, следит за обработкой каждого заказа, меняет его статус по мере выполнения и при необходимости возвращает баллы покупателю. Чтобы открыть раздел, выберите в меню слева пункт «Заказы».

Что это за экран

Заказы показаны списком (таблицей), самые новые — сверху. Внизу таблицы — постраничная навигация: на одной странице помещается 20 заказов, остальные — на следующих страницах. Над таблицей есть строка фильтра, чтобы быстро отобрать нужные заказы.

Фильтр

Фильтр Что делает
Статус Выпадающий список: выберите один статус (например, «Ждёт подтверждения») — в таблице останутся только заказы с этим статусом. Чтобы снова увидеть все заказы, очистите поле и нажмите поиск/сброс.

По другим полям (покупатель, товар, дата) отдельного поиска на этом экране нет — ориентируйтесь на фильтр по статусу и сортировку по дате.

Колонки таблицы

Колонка Что показывает
VK ID Числовой идентификатор покупателя. Это ссылка: по клику откроется карточка пользователя в разделе с амбассадорами — оттуда можно посмотреть его профиль, баланс и историю.
Покупатель Имя человека, оформившего заказ. Длинное имя сокращается — наведите курсор, чтобы увидеть целиком.
Товар Картинка и название заказанного товара. Важно: здесь показан «слепок» товара на момент заказа — название и картинка сохраняются такими, какими были при покупке, даже если позже товар в магазине переименовали, заменили картинку или удалили.
Стоимость Цена заказа в баллах (например, «500 б.»). Это сумма, которая списывается или уже списана с покупателя.
Статус Текущее состояние заказа, показано цветной меткой (см. таблицу статусов ниже).
Списание Режим списания баллов по заказу: «сразу» или «при подтверждении» (см. раздел ниже). Это справочная колонка — здесь режим не меняют.
Оформлен Дата, когда покупатель сделал заказ.
Действия Кнопки «Статус» и «Возврат» для работы с конкретным заказом.

Статусы заказа

Статус Что означает
Новый Заказ только что оформлен, баллы за него уже списаны (режим «сразу»); ждёт, чтобы администратор взял его в работу.
Ждёт подтверждения Заказ оформлен в режиме «при подтверждении»: баллы ещё НЕ списаны, покупатель ждёт, пока администратор подтвердит заказ.
Подтверждён Заказ подтверждён администратором. Для режима «при подтверждении» именно в этот момент с покупателя списываются баллы.
В работе Заказ обрабатывается (например, товар готовится к выдаче/отправке).
Выполнен Заказ полностью закрыт: товар передан покупателю.
Отклонён Заказ отклонён администратором.
Возвращён По заказу сделан возврат (см. действие «Возврат»).
Промокод выдан, ждёт подтверждения Только для автоматических товаров: приложение выдало покупателю промокод, но он ещё не подтвердил, что применил его. До подтверждения новый период у него не начинается. Вмешательство не требуется.

Порядок статусов не жёсткий — вы сами выбираете нужный статус из списка. Но помните про особое правило подтверждения (ниже).

⚠️ Возвращённый заказ изменить нельзя. После возврата баллы уже вернулись покупателю, и кнопки «Статус» и «Возврат» для такого заказа выключены. Если попытаться сменить статус в обход интерфейса, система ответит «Заказ возвращён — менять статус нельзя». Иначе заказ можно было бы вернуть в работу уже неоплаченным, то есть выдать товар бесплатно.

Режим списания баллов: «сразу» и «при подтверждении»

У каждого заказа в колонке «Списание» указано, когда с покупателя снимаются баллы:

Режим списания — общая настройка магазина, а не поле, которое администратор задаёт в каждом заказе. Здесь он показан лишь для информации, чтобы вы понимали, списаны баллы или ещё нет.

Действие «Статус» — сменить статус заказа

Кнопка «Статус» в строке заказа открывает окно «Сменить статус заказа».

Поле Как заполнять
Статус Обязательное. Выпадающий список; по умолчанию подставлен текущий статус заказа. Выберите новый статус.
Заметка (необязательно) Свободный текст: короткий комментарий для команды, почему статус изменён. Можно оставить пустым.

После нажатия кнопки сохранения статус заказа обновится, таблица сама обновится, и вверху появится сообщение «Статус обновлён».

⚠️ Особое правило подтверждения со списанием. Если заказ в режиме «при подтверждении» и вы переводите его в статус «Подтверждён» — именно в этот момент с покупателя списываются баллы. Если на балансе покупателя не хватает баллов, статус НЕ изменится, а система покажет ошибку «Недостаточно баллов». В этом случае сначала разберитесь с балансом покупателя (например, дождитесь начислений) или отклоните заказ.

Если по такому заказу баллы уже были списаны при предыдущем подтверждении, повторное сохранение статуса «Подтверждён» не спишет их второй раз — двойного списания не будет.

Для всех остальных переходов (в «В работе», «Выполнен», «Отклонён» и т. п.) смена статуса баллы не трогает — она просто фиксирует новое состояние заказа и вашу заметку.

Действие «Возврат» — вернуть баллы по заказу

Красная кнопка «Возврат» в строке заказа открывает окно «Вернуть баллы по заказу».

Поле Как заполнять
Причина (необязательно) Свободный текст: почему делается возврат. Можно оставить пустым, но лучше указать причину для истории.

После сохранения заказ получит статус «Возвращён», таблица обновится, и появится сообщение «Баллы возвращены». Если у товара ведётся учёт остатков на складе, единица товара автоматически вернётся в наличие в магазине.

⚠️ Главное правило возврата: баллы возвращаются только если они были реально списаны.

Возврат можно сделать только один раз. Если заказ уже в статусе «Возвращён», повторный возврат не пройдёт — система сообщит, что заказ уже возвращён. Дважды баллы не вернутся.

На что обратить внимание

8. Магазин, награды и задания

Этот раздел объединяет три справочника, которыми администратор наполняет игровую и товарную часть клуба: Магазин (товары, которые амбассадоры покупают за баллы), Награды (промокоды на наборы, которые выдаются бесплатно за достижения) и Задания (действия, за которые начисляются баллы). Каждый открывается своим пунктом в левом меню — «Магазин», «Награды», «Задания».

⚠️ Общее правило для всех трёх разделов: здесь ничего не удаляется навсегда. Даже кнопка «Удалить» в магазине только выключает позицию — она пропадает из приложения, но остаётся у вас в списке и не ломает уже оформленные заказы и выданные награды. Это сделано специально, чтобы история клуба оставалась целой.

8.1. Магазин

Витрина, где амбассадоры тратят накопленные баллы. Администратор здесь заводит товары, назначает им цену в баллах, управляет наличием и сроком показа. Открывается пунктом меню «Магазин».

Что показывает список

Колонка Что означает
Название Наименование товара, как его видит амбассадор.
Тип «Обычный» — заказ обрабатывает администратор вручную. Фиолетовая метка «Авто · N мес» — автоматический товар: приложение само выдаёт промокод и снова открывает товар через N месяцев.
Стоимость Цена в баллах.
Активна «Да» (зелёная метка) — товар виден в приложении; «Нет» — скрыт.
Остаток Сколько штук ещё можно купить. Значок ∞ — количество не ограничено.
Порядок Число, задающее место товара в списке: чем меньше, тем выше.
Период Срок показа товара. «бессрочно» — показывается всегда. Если задана только одна граница, вторая отображается как «…».
Действия Кнопки «Изменить» и «Удалить» для этой строки.

Список листается постранично (по умолчанию 20 позиций на страницу, число можно увеличить внизу списка).

Добавить или изменить товар

Кнопка «Добавить» (справа над списком) открывает форму создания, кнопка «Изменить» в строке — ту же форму с уже заполненными полями. Поля одинаковы:

Поле Обязательно Как заполнять
Название Да Короткое имя товара.
Описание Нет Пояснение для амбассадора (состав, размер и т. п.).
Ссылка на изображение Нет Адрес картинки товара. Оставьте пустым, если картинки нет.
Стоимость (баллы) Да Целое число баллов, 0 и больше.
Активна — Переключатель. Включён — товар сразу виден в приложении. При создании включён по умолчанию.
Остаток на складе Нет Сколько штук доступно. Пустое поле означает «без ограничения» (в списке показывается как ∞).
Порядок сортировки Нет Позиция в витрине; меньше — выше. По умолчанию 0.
Начало показа Нет Дата и время, с которых товар появится. Пусто — показывается сразу.
Окончание показа Нет Дата и время, после которых товар исчезнет. Пусто — показывается бессрочно.
Тип товара — «Обычный» — как раньше, заказ обрабатываете вы. «Автоматический» — приложение всё делает само (см. ниже). По умолчанию «Обычный».

При выборе типа «Автоматический» появляются три дополнительных поля:

Поле Обязательно Как заполнять
Наборы промокодов Да Наборы, из которых амбассадор выбирает при получении (те же, что у подарка новичка). Код берётся строго из выбранного набора: если он пуст, амбассадор получит ошибку «Промокоды закончились», а не код из соседнего набора. Следите за остатками в разделе «Промокоды».
Повтор, месяцев Нет Через сколько месяцев товар снова станет доступен этому же амбассадору. Пусто или 0 — товар можно купить один раз. Для набора для тестирования — 5.
Код награды-ключа Нет Код награды, получение которой открывает товар. Пока амбассадор её не забрал, товар ему вообще не показывается. Для набора для тестирования — newbie_gift. Пусто — товар доступен всем сразу.

После сохранения появится сообщение «Позиция создана» или «Позиция обновлена», и список обновится.

⚠️ Период показа. Начало и окончание задаются независимо — можно указать обе даты, только одну или ни одной. Но если начало окажется позже или равно окончанию, система не даст сохранить и сообщит о некорректном периоде. Амбассадоры видят товар в витрине, только если он «Активна: Да» и сейчас внутри указанного периода.

Важные правила магазина

Автоматический товар (набор для тестирования)

Такой товар проходит весь путь без участия администратора — в очереди заказов вмешиваться не нужно.

Как это выглядит у амбассадора:

  1. Он забирает подарок новичка на главной. После этого набор появляется в магазине, но заблокирован: на карточке идёт обратный отсчёт. Отсчёт ведётся от момента, когда амбассадор закрыл баннер подарка на главной: пока баннер висит, сценарий получения подарка не завершён, и после закрытия срок пересчитывается от этой даты. У тех, кто закрыл баннер до этого изменения, отсчёт остался от даты получения подарка.
  2. Через указанное число месяцев товар открывается. Дальше ограничения по времени нет — купить можно хоть через год.
  3. После покупки он нажимает «Забрать», выбирает набор и получает промокод.
  4. Затем подтверждает: «Да, спасибо!». Только с этого момента начинается новый отсчёт.

⚠️ Отсчёт идёт от подтверждения, а не от покупки. Если амбассадор купил набор и даже забрал промокод, но не нажал «Да, спасибо!», заказ остаётся в статусе «Промокод выдан, ждёт подтверждения», новый период не начинается, и купить набор ещё раз он не может. Это сделано намеренно.

⚠️ Не меняйте статус такого заказа руками. Отсчёт привязан к подтверждению амбассадора, а не к статусу: выставив «Выполнен» из очереди заказов, вы не завершите сценарий, а только запутаете картину.

⚠️ Возврат вернёт баллы, но НЕ отзовёт уже выданный промокод. Код физически находится у амбассадора, и система не может его аннулировать. Поэтому возврат заказа, по которому промокод уже выдан, баллы вернёт, но следующий период всё равно будет отсчитываться от этой выдачи — иначе амбассадор получил бы и баллы обратно, и рабочий код, и сразу новую покупку. Если промокод ещё не выдан (статус «Новый»), возврат снимает блокировку полностью.

⚠️ Не удаляйте автоматический товар, если хотите его перенастроить — отредактируйте существующий. Удаление и создание заново обнулит историю периодов: у всех амбассадоров отсчёт начнётся с нуля.

8.2. Награды

Награды — это бесплатные поощрения: амбассадор при выполнении условия получает промокод на набор продукции. Баллы за награды не списываются. Открывается пунктом меню «Награды».

Что показывает список

Колонка Что означает
Код Внутренний опознавательный код награды (можно скопировать кликом). Задаётся при создании и в дальнейшем менять его не следует.
Название Название награды для амбассадора.
Описание Пояснение; «—» если не заполнено.
Условие Что нужно выполнить, чтобы получить награду (метка типа условия и, если применимо, число).
Пул промокодов Название набора промокодов, из которого выдаётся код; «—» если не задан.
Ссылка «Открыть» — переход на сайт, привязанный к награде; «—» если ссылки нет.
Порядок Место в списке наград; меньше — выше.
Статус «Активна» (зелёная) — награда показывается амбассадорам; «Отключена» — скрыта.
Действия «Изменить» и (для активных) «Деактивировать».

Создать или изменить награду

Кнопка «Создать» открывает форму «Новая награда»; «Изменить» в строке — форму «Изменить награду · <код>». Поля:

Поле Обязательно Как заполнять
Код Да Уникальный опознаватель награды. Если такой код уже есть, система не даст создать и сообщит, что код занят.
Название Да Как называется награда для амбассадора.
Описание Нет Дополнительное пояснение.
Тип условия Да Выбор из списка (см. таблицу условий ниже).
Значение условия Зависит от типа Число: порог баллов, номер уровня или число публикаций. Для условия «Первое вступление» не требуется.
Пул промокодов Нет Название набора кодов, из которого амбассадору выдадут промокод.
Ссылка на сайт Нет Ссылка, которая показывается вместе с наградой (например, где применить набор).
Порядок сортировки Нет Позиция в списке наград.
Активна — Переключатель видимости. При создании включён по умолчанию.

Типы условия получения

Тип условия Когда награда становится доступной Что писать в «Значение условия»
Первое вступление Разовая награда «промокод на первый набор» — доступна, пока амбассадор её ещё не забрал. Не требуется.
Порог баллов Когда суммарно накоплено (заработано за всё время) не меньше указанного числа баллов. Нужное число баллов.
Достигнут уровень Когда амбассадор дорос до указанного уровня. Номер уровня.
Число публикаций Когда у амбассадора набралось нужное число засчитанных публикаций. Требуемое число публикаций.

Пороговые условия считаются по накопленным за всё время баллам, а не по текущему остатку на счёте — трата баллов в магазине не отбирает уже полученные награды.

Как выдаются промокоды и деактивация

8.3. Задания

Задания — действия, за которые амбассадоры получают баллы (подписаться на бота, опубликовать посты, пригласить друга и т. д.). Здесь администратор заводит задания, назначает награду и цель, задаёт срок и включает или выключает их. Открывается пунктом меню «Задания».

Поиск и фильтры

Над списком есть строка фильтров:

Фильтр Что делает
Поиск Поле «Код или название» — оставляет задания, чей код или название содержат введённый текст.
Тип Выбор одного из типов заданий — показывает только задания этого типа.
Статус «Активные» или «Неактивные».

Что показывает список

Колонка Что означает
Тип Вид задания (цветная метка, см. таблицу типов ниже).
Код Внутренний опознаватель задания (можно скопировать кликом).
Название Название задания для амбассадора.
Награда Сколько баллов даёт задание и метка вида награды.
Цель Сколько единиц нужно выполнить (постов, приглашений, просмотров и т. п.).
Скоуп постов Только для типа «Публикация постов»: какие публикации засчитывают это задание — по хэштегам и/или типу медиа. Красная метка «не задан — не засчитывается» означает, что задание не получит прогресс ни от одной публикации: откройте его и укажите хэштег или тип медиа. «—» стоит у заданий других типов.
Повтор. «да»/«нет» — можно ли выполнять задание повторно.
Лимит/мес Сколько раз в календарный месяц задание может быть засчитано. «без лимита» — ограничения нет.
Авто «да»/«нет» — засчитывается ли выполнение автоматически.
Порядок Место в списке; меньше — выше.
Статус «Активно» (зелёная) — задание видно амбассадорам; «Неактивно» — скрыто.
Период Срок действия задания (начало — конец).
Действия «Изменить» и «Деактивировать»/«Активировать».

Типы заданий

Тип Что должен сделать амбассадор
Подписка на бота Подписаться на сообщения бота клуба.
Вступление в сообщество Вступить в сообщество клуба.
Публикация постов Опубликовать нужное число засчитанных постов.
Набрать просмотры Набрать нужную сумму просмотров на своих засчитанных публикациях.
Публикация истории Опубликовать историю с готовой картинкой клуба.
Пригласить друга Пригласить друзей, которые дорастут до нужного уровня.
Топ-3 месяца Попасть в тройку лучших за месяц.
Опрос Проголосовать в опросе сообщества (появляется на время после публикации опроса).
Произвольное Свободный тип для временных активностей, которые вы придумываете сами.

Виды награды

Вид награды Что означает
Баллы Начисление баллов — основной рабочий вид награды.
Открытие уровня Открытие уровня — заготовка на будущее.
Бейдж Значок-достижение — заготовка на будущее.

На практике используйте вид награды «Баллы». Виды «Открытие уровня» и «Бейдж» присутствуют в списке как задел на будущее.

Создать или изменить задание

Кнопка «Создать» открывает форму «Новое задание»; «Изменить» в строке — форму «Редактирование: <код>». Поля:

Поле Обязательно Как заполнять
Код Да Уникальный опознаватель задания (например, publish_5_posts). При изменении задания это поле недоступно для правки — код закрепляется навсегда при создании. Если код уже занят, создать не получится.
Тип задания Да Выбор из списка типов (см. выше).
Название Да Название для амбассадора.
Описание Нет Пояснение, что нужно сделать.
Тип награды — Выбор вида награды. По умолчанию «Баллы».
Баллы награды — Сколько баллов начислить за выполнение. По умолчанию 0.
Индекс уровня (для награды-уровня) Нет Заполняется только если вид награды — «Открытие уровня». Для награды баллами не нужно.
Цель Да Сколько единиц нужно выполнить, минимум 1 (число постов, приглашений, просмотров и т. п.).
Засчитывать по хэштегам Да, если не задан тип медиа Появляется только для типа «Публикация постов». Хэштеги, публикации с которыми двигают прогресс задания. Клубные теги предлагаются в выпадающем списке, но можно ввести свой — например #ЦимусТестирования для временного задания: система начнёт искать посты по нему сама. Тег пишется с решётки и без пробелов.
Засчитывать по типу медиа Да, если не заданы хэштеги Появляется только для типа «Публикация постов». «Фото» и/или «Видео» — какие публикации двигают прогресс. Пусто — и фото, и видео.
Лимит выполнений в месяц Нет Появляется, если включён переключатель «Повторяемое». Сколько раз задание может быть засчитано за календарный месяц. Пусто или 0 — без лимита. Например, 2 для поста-благодарности («не более 2-х раз в мес.» по ТЗ).
Порядок сортировки Нет Позиция в списке; меньше — выше. По умолчанию 0.
Повторяемое — Переключатель: можно ли выполнять задание циклами повторно. По умолчанию выключен.
Авто-завершение — Переключатель: засчитывается ли выполнение автоматически по состоянию (см. ниже). По умолчанию выключен.
Активно — Переключатель видимости. При создании включён по умолчанию.
Параметры Нет Необязательное поле для дополнительных настроек сложных заданий (на экране подписано «Параметры (JSON)»). Заполняется в строгом формате и только по указанию технической команды; при неверном формате система подсветит ошибку «Некорректный JSON» и не даст сохранить. В обычной работе оставляйте это поле пустым.
Начало периода Нет Дата и время, с которых задание доступно. Пусто — доступно сразу.
Конец периода Нет Дата и время, после которых задание перестаёт действовать. Пусто — бессрочно.

После сохранения появится «Задание создано» или «Задание сохранено».

Правила и подводные камни заданий

⚠️ Период действия. Начало и конец задаются независимо (обе границы, только одна или ни одной). Задание доступно амбассадорам, только если оно «Активно» и сейчас внутри указанного периода. Если начало окажется позже или равно концу, система сообщит о некорректном периоде и не сохранит. Связка «Произвольное + период» позволяет запускать временные акции без доработки приложения.

Источники: экраны разделов «Магазин», «Награды», «Задания» и бизнес-правила проектной документации (магазин, награды, задания, включая порядок списания баллов, мягкое выключение позиций и логику условий/периодов).

9. Баннеры, теги и уровни

Этот раздел объединяет три справочника, которыми администратор настраивает то, что видят амбассадоры, и то, как они организованы в клубе: рекламные баннеры на экране приложения, теги для пометки амбассадоров и уровни-растения, по которым участники растут. Каждый справочник открывается своим пунктом бокового меню — «Баннеры», «Теги» и «Уровни».

9.1. Баннеры

Баннеры — это оформленные блоки (картинка, текст, кнопка), которые показываются амбассадорам в приложении. Открывается пунктом меню «Баннеры». В списке видны все баннеры, включая выключенные.

Где какой баннер показывается — задаётся «Слотом» (местом размещения). Доступны два места:

Слот Где показывается
Главный баннер Основной баннер на главном экране приложения
Подарок новичку Блок-приветствие для новых участников

Колонки списка

Колонка Что показывает
Слот Место размещения (цветная метка)
Картинка Уменьшённое превью загруженного изображения
Заголовок Заголовок баннера (если не задан — «—»)
Аудитория Кому показывается баннер: «Все», «Новички» или «Уровень N+». У «Подарка новичку» — «не применяется»
Активен «Активен» (зелёная метка) или «Выключен» (серая)
Период показа «бессрочно», если даты не заданы, иначе «начало — конец»
Создан Дата и время создания
Действия Кнопки «Изменить» и «Удалить»

Над таблицей есть панель фильтров: можно отобрать баннеры по слоту и по состоянию («Активен» / «Выключен»). Список разбит на страницы по 20 записей; количество на странице можно изменить.

Создание и изменение баннера

Кнопка «Создать» (справа над таблицей) открывает окно нового баннера; кнопка «Изменить» в строке — то же окно с уже заполненными данными. Поля в обоих случаях одинаковые:

Поле Обязательно Что вводить и какие правила действуют
Слот Да Выбрать место размещения из списка (Главный баннер / Подарок новичку)
Заголовок Нет Короткий заголовок баннера
URL картинки Да Ссылка на изображение. Должна начинаться с https:// — иначе панель не даст сохранить
Текст Нет Основной текст (поле подписано «Текст (HTML)»). Можно использовать простое оформление — полужирный, курсив, ссылки и переносы строк; всё остальное система автоматически очистит при сохранении. Этот текст виден всем пользователям приложения
Кнопка: текст Нет Надпись на кнопке баннера
Кнопка: ссылка Нет Куда ведёт кнопка. Тоже только https://
Аудитория Да Кому показывать — выбор из списка: «Все», «Новички (ещё не забрали первую награду)» или «Уровень N и выше» по каждому уровню из раздела «Уровни». У нового баннера по умолчанию «Все»
Активен Нет Переключатель показа. У нового баннера по умолчанию включён
Начало показа Нет Дата и время, с которых баннер начнёт показываться
Конец показа Нет Дата и время, после которых баннер перестанет показываться

⚠️ Кнопка сохранится, только если заполнены оба поля — и «Кнопка: текст», и «Кнопка: ссылка». Если заполнить лишь одно из них, кнопка у баннера не появится.

⚠️ Все ссылки — только защищённые (https://). Это касается и адреса картинки, и ссылки кнопки. Обычные ссылки (http://) не принимаются.

Про аудиторию. Она учитывается только у слота «Главный баннер»: «Подарок новичку» показывается по своему правилу (пока участник не закрыл приветственный блок), поэтому у него поле выключено. «Новички» — те, кто ещё не забрал первую награду. «Уровень N и выше» сравнивается с текущим уровнем амбассадора. Если в списке баннеров аудитория подсвечена оранжевым — значение в базе не распознано (заведено до появления списка), и такой баннер показывается всем; чтобы это исправить, откройте баннер и выберите нужный вариант.

Про период показа. Если оставить обе даты пустыми, баннер считается бессрочным (в списке — «бессрочно»). Можно задать только начало, только конец или оба значения.

После сохранения появляется сообщение «Баннер создан» / «Баннер обновлён», и список обновляется автоматически.

Удаление баннера

Кнопка «Удалить» в строке спрашивает подтверждение «Удалить баннер?». После подтверждения баннер убирается из списка и перестаёт показываться в приложении. Баннеры ни с чем не связаны, поэтому удаление безопасно — оно ни на что, кроме самого баннера, не влияет. Если баннер нужен лишь временно скрыть, вместо удаления достаточно выключить переключатель «Активен».

⚠️ Удаление необратимо: восстановить баннер через панель нельзя, придётся создавать заново и заново загружать картинку. Само действие и содержимое удалённого баннера записываются в журнал действий администратора.

9.2. Теги

Теги — это метки, которыми вручную помечают амбассадоров, чтобы потом удобно их фильтровать в списке участников. Это справочник (каталог) всех доступных тегов клуба. Открывается пунктом меню «Теги». Автоматически теги не проставляются — их присваивают амбассадорам вручную в разделе участников; здесь только ведётся сам перечень меток.

Колонки списка

Колонка Что показывает
Тег Название метки (в её цвете)
Цвет Заданный цвет метки (если не задан — «—»)
Создан Дата создания
Действия Кнопка «Удалить»

На этой странице нет фильтров и поиска — виден весь каталог. Список разбит по 20 записей на страницу.

Создание тега

Кнопка «Создать» открывает окно с двумя полями:

Поле Обязательно Что вводить и правила
Название Да Название метки
Цвет (HEX) Нет Цвет метки в формате `#