From cad856b5eeb66ea8197e1ddd12960b2456ee79ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=A2=D0=BE?=
 =?UTF-8?q?=D1=80=D0=BE=D0=B2?= <dtorov@bk.ru>
Date: Tue, 14 Jul 2026 14:57:31 +0000
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20instr.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 instr.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 instr.md

diff --git a/instr.md b/instr.md
new file mode 100644
index 0000000..cf03ecc
--- /dev/null
+++ b/instr.md
@@ -0,0 +1,71 @@
+Раздел панели администрирования: **Общие настройки → вкладка «Статистика по пользователям»**.
+
+## Как начать
+1. Укажите период (**За последние N дней**) и нажмите **Загрузить**.
+2. При необходимости воспользуйтесь **поиском** по списку.
+3. Слева — список пользователей (имя и число сообщений).
+4. Клик по строке открывает карточку справа. Повторный клик или **Закрыть** — скрывает карточку.
+В карточке три вкладки: **Сообщения**, **Maker-GPT**, **Фото → ИИ**.
+---
+## Вкладка «Сообщения»
+Показывает, какие тексты пользователь отправлял за выбранный период и сколько раз.
+| Что видно | Описание |
+|-----------|----------|
+| Число рядом с текстом | Сколько раз отправлено это сообщение |
+| Зелёный бейдж | Системные кнопки бота (меню) |
+| Обычный текст | Свободные сообщения пользователя |
+Данные подтягиваются при общей загрузке статистики (кнопка **Загрузить** вверху).
+---
+## Вкладка «Maker-GPT»
+Карточка пользователя в сервисе Maker-GPT (баланс, настройки, текущий контекст диалога).
+### Кнопки
+| Кнопка | Действие |
+|--------|----------|
+| **Загрузить / Обновить** | Загрузить данные пользователя из Maker-GPT |
+| **Включить unlim** | Добавить пользователю тег безлимита |
+| **Отключить unlim** | Снять тег безлимита |
+При первом открытии вкладки данные обычно подгружаются автоматически.
+### Поля карточки
+| Поле | Описание |
+|------|----------|
+| **Создан** | Дата создания пользователя в Maker-GPT |
+| **personalBalance** | Текущий баланс |
+| **balanceOwner** | Владелец баланса (ключ) |
+| **Тариф** | Тарифный план (`free` и др.) |
+| **Модель** | Модель ИИ по умолчанию |
+| **isCorpOwner** | Является ли владельцем корпоративного аккаунта (да/нет) |
+| **Роль** | Имя роли и её тип |
+| **commonKey** | Общий ключ доступа |
+| **Теги** | Теги пользователя (в т.ч. `unlim`) |
+| **Контекст** | Число сообщений в текущем контексте, суммарные токены и стоимость (₽) |
+### Сообщения в контексте
+Список реплик текущего контекста диалога:
+- **user** — сообщение пользователя (иногда с картинками);
+- **assistant** — ответ ИИ.
+У ответов ИИ отображается расход:
+| Показатель | Описание |
+|------------|----------|
+| **prompt** | Токены / стоимость запроса |
+| **completion** | Токены / стоимость ответа |
+| **всего** | Суммарно токены / ₽ |
+| **todayUsedTokens** | (если есть) токены, учтённые за день на момент ответа |
+| **Модель** | Модель, которой был сгенерирован ответ |
+---
+## Вкладка «Фото → ИИ»
+История обращений к ИИ: фото пользователя и сгенерированный анализ.
+### Панель сверху
+| Элемент | Описание |
+|---------|----------|
+| **только с фото** | Если включено — показываются только диалоги с картинками (по умолчанию включено). Если выключено — все загруженные диалоги |
+| **Загрузить / Обновить** | Загрузить историю диалогов |
+| Счётчик | Сколько карточек показано / сколько загружено / сколько пришло с API |
+### Карточка диалога
+| Блок | Описание |
+|------|----------|
+| **Дата** | Когда был выполнен запрос |
+| **Модель** | Модель ИИ |
+| **Фото** | Превью изображений (клик открывает оригинал в новой вкладке) |
+| **Запрос** | Текст пользователя (если был) |
+| **Ответ ИИ** | Текст анализа / рекомендации |
+| **prompt / completion / всего** | Расход токенов и стоимость ответа |
+---
\ No newline at end of file