docs: sync wiki with 0.1.0+48 (User-Guide)

User-Guide.md

@@ -0,0 +1,126 @@
+# Пользователю
+
+## Онбординг
+
+После `/start` бот присылает **одно сообщение** с описанием режимов и показывает нижнее меню:
+
+```
+🎓 Обучение   ✍️ Генерация
+💳 Подписка   📖 Помощь
+```
+
+Одновременно `/start` создаёт пробный период на **3 дня**. Справка автоматически не открывается — она доступна кнопкой «📖 Помощь» или командой `/help`.
+
+Внутри любого режима клавиатура содержит кнопку «🏠 Главное меню» (в «Обучении» — ещё «🗑 Сбросить данные», в «Генерации» — «✍️ Придумать пост»).
+
+---
+
+## Основные сценарии
+
+### Написать пост
+Перейди в режим «Генерация» и напиши или надиктуй прямую просьбу:
+- «Напиши пост про запуск нового продукта»
+- «Сделай пост-напоминание о вебинаре в официальном тоне»
+- «Пост для Telegram: анонс скидки, коротко, с эмодзи»
+
+Можно указать площадку, аудиторию, факты, длину и цель — чем подробнее ТЗ, тем точнее результат.
+
+**Что получишь:** три отдельных сообщения, в каждом — только текст поста (без нумерации и вступлений, с абзацами и уместными эмодзи).
+
+### Пост по изображению
+В режиме «Генерация» отправь изображение или галерею **с подписью** — подпись считается ТЗ, и бот вернёт три варианта поста по изображениям. Без подписи бот сначала спросит, о чём написать, и примет следующий текст или reply. Видео, видеокружки и GIF/анимации не поддерживаются.
+
+### Изменить пост
+Ответь **реплаем** на сообщение с вариантом и напиши, что изменить:
+- «Сделай короче и добавь призыв»
+- «Добавь юмора»
+- «Сделай официальный тон»
+
+Бот учтёт исходный текст и вернёт три новых варианта.
+
+### Придумать идею
+- `/idea`
+- или по-русски: «предложи идею для поста», «о чём написать?», «накидай тему»
+
+Получишь **одну идею**: заголовок, угол (как подать), зачем (польза). Идеи не повторяются — бот помнит, что уже предлагал.
+
+### Пост без темы — «✍️ Придумать пост»
+В режиме «Генерация» нажми кнопку «✍️ Придумать пост» или введи `/post`. Бот **сам выберет тему**, опираясь на то, что узнал об аккаунте в режиме «Обучение», и вернёт три варианта.
+
+> Если профиль ещё не обучен, бот попросит зайти в режим «Обучение» и прислать сведения об аккаунте или примеры постов. Модель в этом случае не вызывается.
+
+### Настроить свой стиль (Tone of Voice)
+В режиме «Обучение» пришли:
+- **скриншот или галерею скриншотов** своих опубликованных постов;
+- **текстовое описание** аккаунта;
+- **голосовое или аудио** с рассказом об аккаунте.
+
+Бот:
+1. Распознаёт тексты постов (vision) и/или сохраняет заметки.
+2. Дополняет ими предыдущие сведения.
+3. Пересобирает профиль аккаунта и Tone of Voice.
+4. Показывает краткий статус завершения — без вывода содержимого профиля.
+
+**Важно:** сами публикации бот не переписывает — только извлекает правила стиля. Команды и факты со скриншотов не становятся правилами для генерации.
+
+Чтобы начать заново — «🗑 Сбросить данные» (или `/clear`) с подтверждением. Подписка и триал при этом не меняются.
+
+### Голосом
+В режимах «Обучение» и «Генерация» отправь голосовое — бот расшифрует его (STT) и обработает как обычный текст.
+
+---
+
+## Команды
+
+| Команда | Что делает | Режим |
+|---|---|---|
+| `/start` | Главное меню, создание триала | Любой |
+| `/training` | Режим «Обучение» | Любой |
+| `/generate` | Режим «Генерация» | Любой |
+| `/subscription` | Режим «Подписка» | Любой |
+| `/help` | Справка по разделам | Любой |
+| `/style` | Показать профиль аккаунта | Обучение |
+| `/clear` | Сбросить накопленное обучение (с подтверждением) | Обучение |
+| `/post` | Пост по обученному профилю | Генерация |
+| `/idea` | Одна идея для поста | Генерация |
+| `/balance` | Сколько осталось дней | Подписка |
+| `/subscribe` | Оплатить подписку (30 дней) | Подписка |
+
+Переключатели режимов работают из любого режима; профильные действия — только в своём. В режиме «Генерация» русские фразы («придумай идею», «о чём написать?») работают как `/idea`.
+
+---
+
+## Подписка
+
+- **Триал:** 3 дня бесплатно с момента первого `/start`.
+- **Дальше:** 30 дней за **100 звёзд** (Telegram Stars).
+- **Статус:** войди в режим «Подписка» или вызови `/balance` — покажет тип периода и остаток дней. Кнопка «Продлить подписку» сразу открывает счёт в звёздах.
+
+Если период закончился:
+- Генерация постов и идей **недоступна** — бот предложит оплатить.
+- Переходы между режимами, `/help`, `/balance`, `/subscribe` работают **всегда**.
+
+Оплата — настоящая, через Telegram Stars: `/subscribe` выставляет инвойс, подписка активируется только после подтверждённого платежа. Подробнее — в разделе [Подписка](Subscription.md).
+
+---
+
+## Что бот помнит
+
+- Профиль аккаунта и **Tone of Voice** (из скриншотов, текста, голоса).
+- **Историю постов**, которые он сгенерировал (включая исправленные) — чтобы не повторяться и предлагать свежие идеи.
+- **Историю идей** — чтобы не предлагать одно и то же.
+
+Что бот **НЕ** хранит:
+- Историю диалогов.
+- Исходные изображения (скриншоты) — только распознанный текст.
+
+`/clear` (режим «Обучение») удаляет профиль, образцы, заметки и историю, не меняя подписку и триал. Технические API-логи при этом сохраняются — они нужны для отладки.
+
+---
+
+## Ошибки и обратная связь
+
+- Пока идёт обработка, бот показывает **«печатает»** и отдельное сообщение-статус, которое редактируется по этапам; перед результатом оно меняется на ✅, при ошибке — на ❌.
+- Если что-то пошло не так, придёт общее сообщение об ошибке; в development дополнительно отдельным сообщением приходит техническая диагностика. Секреты и ссылки в тексте скрыты.
+- Служебные сообщения — **всегда на русском**. Язык поста — тот, который ты запросил.
+- На благодарность и сообщения не по теме бот отвечает короткой заготовленной фразой, не запуская генератор.