Библиотека компонентов
Служебный экран Pass 0. Все экраны прототипа собираются только из элементов ниже — новые визуальные примитивы не вводятся.
Pass 0 · каркасБаннеры
носитель 28 предупреждений о несостыковкахБейджи статусов
Включено
Выключено
Ожидает прав администратора
Заблокирован постоянно
Ожидает попадания в очередь
VIP
Нейтральный
Захардкожено в коде
Карточки-счётчики
Тумблеры
Включено
Выключено
Таблица
сортировка по заголовку, поиск, массовый выбор| Название | Статус | Значение | |
|---|---|---|---|
| Первая строка@example_one | Включено | 128 | |
| Строка с конфликтом | Конфликт | 12 | |
| Строка риска | Риск | 9 |
3 записиПрототип: пагинация не реализована
Тосты и модалка
Пустое состояние и скелетон
◇
Ни одна группа ещё не подключена
Добавьте бота в группу и выдайте ему права администратора.
Переключатель демо-состояний
на каждом экране, где спека описывает состояния (п.5)Обычное содержимое экрана.
◇
Пусто
Текст пустого состояния берётся из п.5 спеки.
Прочее
Подсказка под полем
Текст ошибки
Не редактируется
128 / 4096
4300 / 4096
- Ключ
- Значение
- Длительность
- 10 лет
Пояснение read-only, когда баннер избыточен.
Дашборд
Сводная картина состояния бота во всех 9 доменах сразу, точка входа.
INTERFACE_SPEC.md · строки 63–80Счётчики
клик по карточке — переход в разделOCR
Обработано изображений через OCR
24 118
Статистический счётчик из глобальных настроек (домен 2, п.5). Не является ограничением на количество обработанных изображений.
Лента последних событий
| Время | Тип | Событие | Группа |
|---|---|---|---|
| 14:01 | Блокировка | @nikita_prom — стоп-слово в подписиДлительность: 10 лет | Барахолка СПб |
| 13:47 | Анти-флуд | Эскалация: 3-я ступеньДлительность: 3 часа | Работа удалённо |
| 13:12 | Рассылка | «Правила чата» отправлена в 4 группы | — |
| 12:58 | Блокировка | Мгновенный мут при вступленииДлительность: 10 лет | Барахолка СПб |
| 12:30 | Анти-флуд | Эскалация: 1-я ступеньДлительность: 3 часа | Аренда квартир |
5 записейПрототип: пагинация не реализована
Кнопка «Экспорт сводки» на этом экране намеренно отсутствует: выгрузки в бизнес-логике привязаны только к стоп-словам и рекламодателям (домены 2 и 4), опоры для экспорта сводки нет (строка 73).
Группы: список
Управление подключёнными группами: без этого раздела невозможно настроить ни один из привязанных к группе доменов (1, 2, 7).
INTERFACE_SPEC.md · строки 84–101| Группа | Модерация | OCR | Капча группы | Уникальная капча | ||
|---|---|---|---|---|---|---|
| Барахолка СПб@barakholka_spb | Включена | Включён | Выключена | Выключена | ||
| Работа удалённо@remote_jobs_ru | Включена | Выключен | Включена | Включена | ||
| Аренда квартир Мск@arenda_msk_chat Данные группы будут обновлены при следующей активности | Ожидает прав администратора Группа не активирована: бот добавлен без прав администратора (домен 1, п.4) | |||||
| Отдам даром Казань@darom_kzn | Выключена | Включён | Выключена | Выключена | ||
4 записи1 группа ожидает прав администратора
◇
Ни одна группа ещё не подключена
Добавьте бота в группу — это должен сделать владелец или администратор группы — и выдайте боту права администратора (домен 1, п.4).
Выдайте боту права администратора
Тот же текст, что бот сейчас присылает в чат:
- удаление сообщений
- ограничение пользователей
- приглашение пользователей
- назначение администраторов
🖼
Картинка-инструкция о необходимых правах
Модерация
сохраняется немедленноКапча
Выключена
Используется общий текст капчи и приветствия. Чтобы задать свой — включите «уникальную капчу».
Модерация
Капча
форма заблокирована на время сохраненияМодерация
Капча
Стоп-слова
Единственное место редактирования списка, влияющего сразу на все группы (домен 2).
INTERFACE_SPEC.md · строки 127–144| Слово или фраза | Добавлено | ||
|---|---|---|---|
| заработок в интернете | 12.07.2026 | ||
| инвестиции без риска | 12.07.2026 | ||
| крипто | 03.08.2026 | ||
| пишите в лс | 03.08.2026 |
4 записиОбщий список · ID 0 (встречается также как -0)
◇
Список пуст
Общая фильтрация не выполняется, если группы не подключают собственные слова.
| Строка файла | Содержимое | Результат |
|---|---|---|
| 4 | (пустая ячейка) | Не прочитана |
| 17 | #ERROR! | Не прочитана |
| 42 | (объединённые ячейки) | Не прочитана |
3 проблемные строкиПравила валидации содержимого в бизнес-логике не описаны — проверяется только читаемость строки
Капча и приветствие: глобально
Владелец — единственный, кто меняет глобальный переключатель капчи и время ожидания автомута (домены 1 и 7).
INTERFACE_SPEC.md · строки 148–164Капча
Включена
секунд
По умолчанию 30 секунд. Диапазон допустимых значений в бизнес-логике не задан — проверяется только «положительное целое число».
Введите положительное целое число
Определение скам-имени
символов
Захардкожено в коде
Как устроен вопрос капчи
справка, не редактируется- Математический пример
- вероятность 50%
- Один из 8 текстовых вопросов
- вероятность 50%
- Кнопка-ловушка «Ответа нет»
- шанс появления 40%
Алгоритм генерации вопроса капчи не управляется из интерфейса: в бизнес-логике нет описанного способа его изменить. Блок выводится как справка «как есть».
Общие тексты
для групп без «уникальной капчи»
Плейсхолдеры
[user] и [group] будут заменены реальными именами.
Глобальные настройки
Единая точка правки порогов, используемых доменами 1, 2, 4, 5 (домен 7).
INTERFACE_SPEC.md · строки 168–184Проверка по фото
символов
Используется одновременно для запуска OCR (домен 2) и для решения — засчитывать ли рекламный пост (домен 4).
Обработано изображений
24 118
Часовой пояс бота
GMT+3, 9-00, 17:30. Текущее сохранённое значение: GMT+0:00.
Не удалось распознать значение. Прежнее значение сохранено без изменений.
Быстрый выбор:
При нераспознанном вводе форма не сохраняется, прежнее значение остаётся видимым (строка 181).
Журнал модерации (мьют/бан)
Надзор и ручное вмешательство в автоматические ограничения (домен 3).
INTERFACE_SPEC.md · строки 188–204| Пользователь | Группа | Тип нарушения | Почему такое наказание | Длительность | Время | ||
|---|---|---|---|---|---|---|---|
| @nikita_promid 588213904 | Барахолка СПб | Стоп-слово | 2-е в той же группе → мут навсегда в группедомен 3, п.4 | 10 летявное значение, не «навсегда» | 14:01 | ||
| @spam_bot_44id 771020331 | Работа удалённо | Мультивступление | 2-е в другой группе <60 сек → мут 3 часа во всех группах | 3 часа | 13:47 | ||
| @anna_kotovaid 402118776 | Барахолка СПб | Мгновенный мут при вступлении | Имя длиннее 24 символов → скам Фактическое наложение ограничения в Telegram технически не подтверждено Полагается на «слепой» мут капча-сервиса. Открытый вопрос 9 · строка 546 | 10 лет | 12:58 | ||
| @dmitry_rid 190338402 | Аренда квартир Мск | Неответ на капчу | Автомут по истечении 30 секунд ожидания | 10 лет | 11:20 | ||
| @olga_vid 655401229 | Отдам даром Казань | Стоп-слово | Повтор текста за 7 дней → мут навсегда во всех группах | 10 лет | 09:04 |
5 записей
Столбец «Длительность» всегда показывает разрешённое значение — «10 лет» / «3 часа», никогда «навсегда» (открытый вопрос 10, строка 547)
◇
Нарушений не зафиксировано
За выбранный период автоматические ограничения не применялись.
В бане
Не прошёл капчу
Постоянной ручной блокировки нет
Активное ограничение
- Тип
- Неответ на капчу
- Длительность
- 10 лет (явное значение, не «навсегда»)
- Наложено
- 05.08.2026, 11:20
- Действует в группах
- Аренда квартир Мск
История нарушений
| Дата | Группа | Тип | Длительность |
|---|---|---|---|
| 05.08.2026 | Аренда квартир Мск | Неответ на капчу | 10 лет |
| 28.07.2026 | Барахолка СПб | Стоп-слово | 3 часа |
| 14.07.2026 | Барахолка СПб | Стоп-слово | Предупреждение (1-е) |
Ручные действия
Ручное снятие или наложение мьюта администратором всегда применяется ко ВСЕМ подключённым группам (домен 3, п.4) — интерфейс предупреждает об этом перед подтверждением.
Self-unban: журнал
Надзор за самостоятельными разблокировками и постановка постоянной блокировки (домен 9).
INTERFACE_SPEC.md · строки 208–224| Пользователь | Результат | Причина отказа (для администратора) | Технический код результата | Попытки за 48 ч | Время | Чат / сообщение | |
|---|---|---|---|---|---|---|---|
| @dmitry_rid 190338402 | Успех | — | UNBAN_OK | 1 / 3 | 14:12 | -1001887 / 44012 | |
| @spam_bot_44id 771020331 | Отказ | Превышен лимит 3/48ч | LIMIT_48H | 3 / 3 | 13:55 | -1001887 / 43980 | |
| @crypto_shillid 903117240 | Отказ | Постоянная блокировка | PERMA_BLOCK | 0 / 3 | 12:41 | -1001887 / 43902 | Уже заблокирован постоянно. Снятие через интерфейс невозможно (требуется прямой доступ к БД) |
| @nina_pid 220876311 | Отказ | Некорректный запрос | BAD_REQUEST | 1 / 3 | 11:03 | -1001887 / 43811 |
4 записи
Лимит 3 попытки за скользящее окно 48 часов на пользователя
◇
Попыток разблокировки не было
Ни один пользователь ещё не обращался к сервису самостоятельной разблокировки.
Рекламодатели: список разрешений
Коммерческая функция, доступна и владельцу, и администратору (домен 4).
INTERFACE_SPEC.md · строки 228–247| Рекламодатель | Группа | Остаток постов | Срок, дней | Выдано | Окончание | Менеджер | Статус | |
|---|---|---|---|---|---|---|---|---|
| @shop_lampa | Барахолка СПб | 18 из 30 | 30 | 14.07.2026 | 19.08.2026 | @maks_adm | Использование начато | |
| @remont_pro | Работа удалённо | 3 из 3 | 7 | 03.08.2026 | — | @alex_adm | Ещё не начато Отсчёт срока начнётся с первого реального поста | |
| @auto_podbor | Барахолка СПб | 0 из 10 | 30 | 10.07.2026 | 12.08.2026 | @maks_adm | Остаток = 0 Сообщения удаляются автоматически | |
| @dostavka_spb | Отдам даром Казань | 22 из 60 | 30 | 01.06.2026 | 04.08.2026 | @alex_adm | Срок истёк Текущий пост удаляется, остаток НЕ списывается | |
| @old_partner | Барахолка СПб | 7 из 30 | 30 | 02.05.2026 | 05.06.2026 | @maks_adm | Удалено мягкое удаление — запись сохранена |
5 записей
«Остаток = 0» и «Срок истёк» — разные события с разными последствиями (домен 4, п.4)
◇
Рекламодателей ещё нет
Выдайте первое разрешение — выберите рекламодателя, группу из закладок и пакет.
- Рекламодатель
- @shop_lampa
- Группа
- Барахолка СПб
- Остаток постов
- 18 из 30
- Удалено
- 05.08.2026, 10:12 — каскадно
Поля разрешения
- Рекламодатель
- @shop_lampa
- Группа
- Барахолка СПб
- Остаток постов
- 18 из 30
- Срок действия
- 30 дней
- Менеджер
- @maks_adm
- Дата выдачи
- 14.07.2026
- Дата окончания
- 19.08.2026 (от первого поста 20.07.2026)
- Использование начато
- Удалено
- нет
Поле «использование начато» нормализовано в интерфейсе до «Да / Нет». Техническая подсказка при наведении: в хранилище представлено как текст «0»/«1». Открытый вопрос 15 · строка 555
Когда пост не засчитывается
Пост не засчитывается, если нет ссылки в тексте или подписи И длина текста/подписи превышает порог (сейчас: 10 символов).
Порог берётся из «Глобальных настроек» и используется одновременно для запуска OCR. Открыть настройки
Ручные действия
Журнал изменений остатка
кем и когда изменено| Когда | Кто | Изменение | Стало |
|---|---|---|---|
| 03.08.2026 16:40 | @maks_adm | +2 (возврат за сбой) | 18 |
| 28.07.2026 09:12 | @renata_owner | −1 (списание вручную) | 16 |
| 20.07.2026 12:01 | система | −1 (зачтён пост) | 17 |
Группы для размещения
Рабочий список-закладка для быстрой выдачи разрешений (домен 4).
INTERFACE_SPEC.md · строки 269–282| Группа | Кто добавил | id владельца-администратора | |
|---|---|---|---|
| @barakholka_spb | @renata_owner | 588213904 | |
| @remote_jobs_ru | @maks_adm | 771020331 | |
| @darom_kzn | @alex_adm | 402118776 | |
| @arenda_msk_chat | @renata_owner | 588213904 |
4 записи · страница 1Постранично, по 12 групп на страницу (домен 4, п.4)
◇
Список закладок пуст
При выдаче разрешения группу нужно будет ввести вручную.
Рассылки
Управление плановыми публикациями (домен 5).
INTERFACE_SPEC.md · строки 286–302| Название | Статус | Режим | Время | Групп | Остаток повторов | Очередь | |
|---|---|---|---|---|---|---|---|
| Правила чата ⚠ Конфликт: порядок отправки не определён бизнес-логикой Совпадает с «Анонс барахолки»: Барахолка СПб, 12:00 | Активна | По дням неделипн, ср, пт · повтор еженедельно | 12:00 GMT+3 | 4 | — | Реально в очереди | |
| Анонс барахолки ⚠ Конфликт: порядок отправки не определён бизнес-логикой Совпадает с «Правила чата»: Барахолка СПб, 12:00 | Активна | По дням неделипн, ср, пт | 12:00 GMT+3 | 1 | — | Реально в очереди | |
| Напоминание про ссылки | Активна | По количеству повторов | 09:30 GMT+7 | 12 | 7 из 30 | Ожидает попадания в очередьучтётся не позднее чем за 12 ч до отправки | |
| Акция августа Значение похоже на результат ошибки ввода Остаток повторов 37 совпадает с длиной введённой строки | Активна | По количеству повторов | 18:00 GMT+3 | 2 | 37 | Ожидает попадания в очередь | |
| Черновик: осенний набор | Выключена | По дням недели | 12:00 GMT+0:00 | 0 | — | ||
5 записей2 рассылки в конфликте по группе и времени
◇
Рассылок ещё нет
Создайте первую рассылку — она будет сохранена выключенной, пока не настроены группы и расписание.
Основное
0 / 4096
Лимит 4096 символов — без вложений. С вложениями действует лимит подписи 1024. Гиперссылки не учитываются в счёте длины.
Превышен лимит
Группы-получатели
Расписание
режимы взаимоисключающие
По умолчанию 12:00
Если группы, дни или повторы не заданы — рассылка всё равно сохранится, но будет помечена неактивной с чек-листом недостающих условий, а не останется «включённой» и никуда не уходящей.
VIP: список
Управление белым списком (домен 6).
INTERFACE_SPEC.md · строки 328–344| ID записи | Username | Освобождает от | Срок действия | |
|---|---|---|---|---|
| 1 | @renata_owner | Только антиспам-проверкакапча и анти-флуд применяются | Бессрочно (до ручного удаления) | |
| 2 | @maks_adm | Только антиспам-проверкакапча и анти-флуд применяются | Бессрочно (до ручного удаления) | |
| 3 | @shop_lampa | Только антиспам-проверкакапча и анти-флуд применяются | Бессрочно (до ручного удаления) |
3 записи
Срок действия VIP не предусмотрен бизнес-логикой — все записи бессрочны до ручного удаления (открытый вопрос 20, строка 566)
◇
Список VIP пуст
Добавьте участников, которых нужно освободить от антиспам-проверки.
Администраторы бота
Доступно только владельцу (домен 8, п.4): «Только владелец видит и может использовать пункт меню „Админы“».
INTERFACE_SPEC.md · строки 348–366| ID записи | Username | Проверка формата | |
|---|---|---|---|
| 1 | @maks_adm | Даёт доступ | |
| 2 | @alex_adm | Даёт доступ | |
| 3 | anastasiia_m | Не даёт доступа В имени нет «@» — запись «мёртвая». Открытый вопрос 25 · строка 577 | |
| 4 | @nadia_support | Даёт доступ |
4 записи1 запись не даёт реального доступа
◇
Список администраторов пуст
Владелец бота существует отдельно и всегда сохраняет доступ — см. экран «Владельцы бота».
Системные доверенные учётные записи
read-only · не редактируется из интерфейса| Тип записи | Значение | Статус |
|---|---|---|
| Telegram id | 588213904 | Захардкожено в коде |
| Номер телефона | +7 9•• ••• •• •• | Захардкожено в коде |
| Username | @noname | Захардкожено в коде |
| Префикс имени | @helper_admin_* | Захардкожено в коде |
4 записиНазначение неизвестно · изменение требует доступа к коду
Владельцы бота
Информационный экран. Состав владельцев не редактируется через интерфейс — он жёстко задан в коде и конфигурации (домен 8, п.4).
INTERFACE_SPEC.md · строки 370–384| Username | Источник записи | Редактируется |
|---|---|---|
| @t_root | Жёстко задано в коде | Нет |
| @iamallearsII | Жёстко задано в коде | Нет |
| @renata_owner | Конфигурация приложения | Нет |
3 записи — максимум, предусмотренный бизнес-логикойСостояние всегда одно и то же · загрузка не требуется
Действий на этом экране не предусмотрено бизнес-логикой, поэтому обратной связи по действиям тоже нет. Единственный интерактивный элемент экрана — отсутствует намеренно.
Мои разрешения
Все ваши активные разрешения на размещение. Пакет назначает администратор бота — самостоятельно изменить или запросить его через этот интерфейс нельзя.
INTERFACE_SPEC.md · строки 453–468
«Остаток = 0» и «Срок истёк» — разные события: в первом случае посты закончились, во втором закончился срок, а неизрасходованные посты остались. Действий по изменению пакета на этом экране нет — пакет выдаёт только администратор бота.
◇
У вас пока нет активных разрешений
Обратитесь к администратору бота — выдать пакет может только он.
- Группа
- Барахолка СПб
- Остаток постов
- 18 из 30
- Статус
- Архивное
Ваш пакет
- Группа
- Барахолка СПб
- Остаток постов
- 18 из 30
- Срок действия
- 30 дней
- Дата выдачи
- 14.07.2026
- Дата окончания
- 19.08.2026
- Использование начато
- Да (первый пост 20.07.2026)
- Ваш менеджер
- @maks_adm · id 771020331
Отсчёт срока начинается не с даты выдачи, а с вашего первого реального поста. Изменить пакет через этот интерфейс нельзя — добавить или списать посты может только администратор бота.
Когда пост не засчитывается
Пост не засчитывается, если нет ссылки в тексте или подписи И длина текста/подписи больше 10 символов для медиа-сообщения.
Альбом из нескольких фото или видео, отправленный одним постом, считается за 1 пост.
Ошибочное списание
История уведомлений
Уведомления, которые бот и так вам отправляет, собранные в одном месте. Список только для чтения.
INTERFACE_SPEC.md · строки 491–505| Дата | Группа | Событие | |
|---|---|---|---|
| 04.08.2026 18:20 | Барахолка СПб · второй пакет | Остаток постов достиг 0 Сообщения в этой группе теперь удаляются автоматически | |
| 04.08.2026 09:00 | Отдам даром Казань | Истёк срок действия пакета Остаток постов сохранён, но не используется | |
| 22.07.2026 14:11 | Работа удалённо | Остаток постов достиг 0 |
3 уведомления
Статус «прочитано / непрочитано» бизнес-логикой не предусмотрен
◇
Уведомлений пока нет
Здесь появятся сообщения об исчерпании остатка постов и об истечении срока пакета.
Связь с менеджером
Состояние экрана всегда одно — это статичная информация, серверных действий здесь нет.
INTERFACE_SPEC.md · строки 509–522Ваш менеджер
- Имя
- @maks_adm
- id
- 771020331
- Закреплён за разрешениями
- Барахолка СПб, Работа удалённо
Кнопка только открывает чат в Telegram. Сам возврат поста происходит вне системы, полностью вручную — интерфейс не подменяет собой этот процесс и не отслеживает его результат, поэтому подтверждения здесь не будет.
⛔
Доступ ограничен: только для владельца бота
Раздел «—» доступен только владельцу бота.
Домен 8, п.4: «Только владелец видит и может использовать пункт меню „Админы“». Обычным администраторам этот пункт недоступен — в том числе при переходе по прямой ссылке.