Админ-панель

Зачем это нужно: если забудешь пароль, на странице входа можно будет нажать «Забыли пароль?» — бот пришлёт код подтверждения именно в этот чат, и только с ним пароль реально сменится. Без привязки сброс через бота недоступен.

Как привязать — 3 шага:
1. Открой Telegram и напиши боту гильдии в личку что угодно (например «привет») — он сразу ответит коротким меню, это нормально, значит бот тебя увидел.
2. Вернись сюда и нажми «Найти мой chat_id» ниже — в списке появится чат, который ты только что открыл.
3. Найди себя в списке (по имени/тексту сообщения) и нажми на него, потом нажми «Привязать».

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

Пароль: от 8 символов, минимум одна заглавная, одна строчная буква, одна цифра и один спецсимвол.

У игры нет открытого API — расписание респавна видно только в самом клиенте (меню Schedule) и обычно не влезает в один экран. Загрузи один или сразу НЕСКОЛЬКО скриншотов (кнопкой ниже, выделив сразу все файлы, или по одному через Ctrl+V) — сервер распознает их по очереди и сам склеит совпадающие по времени строки без дублей, но ничего не сохранится на сайт, пока ты не проверишь строки ниже и не нажмёшь «Сохранить расписание». Именно эта таблица (после сохранения) — то, что бот в Telegram использует для уведомлений; страница «Расписание боссов» её только показывает. Если скриншотов давно не грузили и таблица пустая — кнопка «Подставить из стабильного расписания» заполнит сегодня/завтра из уже проверенной недельной закономерности (та же, что видна на странице «Расписание боссов»), проверь и сохрани.

Текст в формате Markdown (**жирный**, списки через "- ", заголовки через "## Заголовок") — отобразится на странице «Правила гильдии».

Текст в формате Markdown — отобразится на странице «Правила гильдии», во втором блоке.

Текст в игре бежит строкой и на скриншоте иногда попадает обрезанным — OCR может прочитать вместо полного названия только обрывок (например "рупп а" вместо "...группа А"). Если название из этого списка есть в распознанной строке хотя бы частично, оно автоматически подставится целиком. По одному названию на строку — допиши новое, если увидишь очередной обрывок в таблице расписания, и в следующий раз он должен исправиться сам.

Загружай сюда файл участия гильдии из игры (GuildParticipation.xml) — можно хоть каждый день, хоть несколько раз в день. За каждую отмеченную активность из списка (Гильдейский рейд, Экспедиция, Битва за Элизиум, Арена Стали, Авангардный бой, Война за ресурсы, Крепость Альберн) игрок получает +1 к счётчику на странице состава гильдии — но не больше одного раза за одну и ту же активность за игровую неделю (сброс — понедельник 05:00 МСК), даже если в файле она уже отмечена с прошлой загрузки. «Выполнено»/«Пожертвование»/«Активность» в счётчик не идут — это не активности из списка.

Разовое объявление в общий Telegram-чат гильдии — например, что ивент закончился или продлится до такого-то времени. Поле времени пустое — уйдёт сразу; указано будущее время — отправится автоматически, когда оно наступит (пока не отправлено, можно отменить в списке ниже).

Бот пишет в чат за N минут до времени из расписания (по каждой строке — один раз), а в личку — сам отвечает на «/start» коротким приветствием с кнопками: групповой чат и Discord появляются, только если вписать ссылки ниже (пусто — кнопки нет), «Сайт гильдии» / «Правила гильдии» / «Сброс пароля» — всегда, по адресу сайта. Заявки на модерацию ростера тоже приходят сюда с кнопками «Одобрить»/«Отклонить» — нажать их может только админ сайта с привязанным личным Telegram (см. вкладку «Администраторы»). 1) Создай бота через @BotFather, вставь токен ниже и сохрани. 2) Напиши в каждую тему группы гильдии, куда должны падать уведомления (общая тема, «Военные игры», модерация), любое сообщение — бот должен состоять в группе и видеть сообщения. 3) Нажми «Найти chat_id» — появится список последних чатов/тем; у каждой обнаруженной темы есть кнопки, назначающие её как основную/«Военные игры»/«Модерация» прямо в нужное поле. 4) Сохрани ещё раз и включи уведомления.

Ключ для Google Gemini API (бесплатный уровень — 1500 запросов в день, без карты: aistudio.google.com/apikey). Сейчас используется бэкендом при разборе скриншота инвентаря заявки игрока — читает качество/грейд/заточку по всем 16 ячейкам сразу, точнее и с грейдом (которого раньше не было вообще). Пусто — сервер тихо остаётся на старой пиксельной эвристике/OCR, ничего не ломается.