social-post-writer-bot/IDEA.MD at 0ff0e1abe782f538eef20f8ef5b61b14f63577e1

0 Fork 0

Files

T

admin 0ff0e1abe7 feat: онбординг после /start — welcome Rich Message + вызов help_command

- help_message.py: добавлен WELCOME_RICH_HTML (приветствие, примеры, скриншоты)
- bot.py: send_rich_help -> send_rich_html(html, stage) + send_rich_message с plain-fallback
- bot.py: start теперь шлёт welcome Rich Message, пауза 0.8с, затем help_command
- help_command вызывает общий send_rich_message — правки HELP_RICH_HTML меняют и онбординг
- тесты: OnboardingTests (3), README/IDEA/VERSION 0.1.0+22

2026-10-06 22:57:47 +02:00

11 KiB

Raw Blame History

Идея

Telegram-бот, который по запросу пользователя готовит текст публикации для выбранной социальной сети.

Цель

Быстро превращать тему, тезисы или черновик пользователя в готовый к публикации текст, адаптированный под площадку и заданный стиль.

Основной сценарий

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

Первая версия

Принимать запрос обычным сообщением.
Уточнять площадку и стиль, если они не указаны.
Возвращать готовый текст без автоматической публикации.
Поддерживать доработку результата сообщениями вроде «короче», «добавь юмора» или «сделай официальный тон».

Технические заметки

Формат: Telegram-бот.
Стек: Python 3.12, aiogram 3.x, aiohttp, SQLite.
APInex Voice STT расшифровывает голосовые; Gemini 3.8 Flash через APInex классифицирует намерения, пишет/правит посты и извлекает ToV из скриншотов.
Coolify env с отдельными модельными настройками: APINEX_STT_MODEL, APINEX_INTENT_CLASSIFIER_MODEL, APINEX_POST_WRITER_MODEL, APINEX_IMAGE_TONE_MODEL; общий секрет APINEX_API_KEY.
JSON-журнал вызовов APInex и ошибок разбора хранится в SQLite 30 дней; системные промпты не дублируются (имя и SHA-256), изображения и аудио не записываются.
Служебные ответы пользователю — всегда на русском; тексты постов — на языке явного запроса. Техническая ошибка может оставаться дословно.
Настройки пользователей и распознанные тексты публикаций для накопления Tone of Voice хранятся отдельно по Telegram user id; история диалогов и исходные изображения не сохраняются.
На явную просьбу поста и на реплай-правку бот возвращает 3 отдельных варианта.

Подписка и монетизация

Модель: триал 3 дня, затем подписка 30 дней за 100 звёзд (Telegram Stars).
Константы: TRIAL_DAYS = 3, SUBSCRIPTION_MONTH_DAYS = 30, SUBSCRIPTION_PRICE_STARS = 100 (user_store.py).
Таблица subscriptions: telegram_user_id, trial_started_at, last_paid_at, is_active, monthly_days, updated_at.
/start создаёт запись триала (ensure_subscription), если её нет.
/subscribe активирует подписку: пишет оплату 100 звёзд, продлевает на 30 дней (activate_subscription), is_active = 1.
/balance показывает статус: триал активен (сколько дней осталось) / подписка активна (сколько дней, когда списание) / период истёк.
Генерация поста и идеи блокируется, если подписка не активна (_check_subscription). /help, /start, /balance, /subscribe доступны всегда.
/clear обнуляет подписку (deactivate_subscription) и данные пользователя.
Оплата звёздами — имитация: бот не принимает реальные платежи, только симулирует активацию.

Деплой и конфигурация

Gitea: admin/social-post-writer-bot, ветка dev.
Coolify проект: Social Post Writer Bot, окружение development.
Coolify приложение: social-post-writer-bot-development (d32u5zcq2g4odmdpq9hw91yn) на spb-easy-dale.
SQLite: /app/data/social_writer.sqlite3; persistent volume d32u5zcq2g4odmdpq9hw91yn-social-post-writer-dev-data монтируется в /app/data.
Секреты хранятся в переменных окружения приложения Coolify; не сохраняются в репозитории.
DEPLOY_ENV=development, DEV_CHAT_ID — для уведомления о новой версии; версия в файле VERSION (сейчас 0.1.0+22).
Вики Gitea: страницы Home, User-Guide, Developer-Guide, Subscription, Deployment.

Статус

Идея проекта зафиксирована
MVP: генерация трёх вариантов поста по явной просьбе, включая голосовую расшифровку
Классификатор намерений и Tone of Voice из скриншота
SQLite-настройки пользователей и reply-правки без хранения диалога
Development-развёртывание в Coolify: social-post-writer-bot-development (d32u5zcq2g4odmdpq9hw91yn)
Подключён persistent Coolify volume /app/data для SQLite
Проверены на моках STT, LLM, vision, ToV, reply-поля и изоляция пользователей
Выполнен live smoke test: классификатор вернул write_post, генератор — 3 разных варианта; vision распознал тестовый скриншот
Последний development deploy работает без traceback
Обновление ToV галереей: одна обработка группы, ToV-инструкция показывается пользователю
Варианты постов показываются без нумерации и вступительного текста
Редакторский системный промпт неизменен; ToV передаётся отдельно как ограничение стиля
Текст со скриншотов сохраняется отдельно и накапливается по пользователю; новый профиль строится по старым и новым примерам
OCR не переписывает публикации; команды и факты со скриншотов не используются как правила или факты для генерации
APInex JSON-вызовы и ошибки разбора журналируются в SQLite без системного промпта и image base64; срок хранения — 30 дней
/clear полностью очищает данные текущего пользователя: ToV, скриншоты, историю постов, историю идей и настройки; API-логи сохраняются
/idea возвращает одну идею одним сообщением и сохраняет её для исключения повторов
Все отправленные варианты постов сохраняются по пользователю, включая исправленные; история используется для новых идей
Служебные ответы по-русски, язык текстов постов определяется запросом пользователя
Help command uses new Rich Message, with a plain-text fallback.
Development deployment/version notice and user-visible error details.
Онбординг после /start: welcome Rich Message (WELCOME_RICH_HTML) → пауза → вызов help_command; правки справки автоматически меняют онбординг
Подписка: триал 3 дня, /subscribe за 100 звёзд (30 дней), /balance, блокировка генерации без активной подписки
Справка бота (/help) описывает /balance и /subscribe
Проект Gitea «Social Post Writer Bot Roadmap» с задачами (выполненные — в «Готово», будущие — в Backlog)

План работ (проект Gitea)

Колонки: Backlog → В работе → Готово.

Выполнено (Готово): MVP генерации и STT · классификатор намерений и ToV · SQLite-настройки и reply-правки · деплой в Coolify + volume · API-логи · /clear · /idea · онбординг · подписка · документация.

В планах (Backlog):

Реальная оплата звёздами (Telegram Payments: sendInvoice/createInvoiceLink, pre_checkout_query, successful_payment) — сейчас имитация.
Автопродление подписки и уведомления об окончании.
Админ-панель: статистика пользователей, подписок, расходов APInex.
Лимиты на генерации (защита расходов на API).
Обновление Gitea 1.26.2 → 28.x (пропущены security-фиксы 1.27.0).
Расширение тестов: e2e-сценарии, мок платежей.
CI: автозапуск тестов и линтера на push в dev.

Как ведём проект

Одна задача = одна атомарная доработка (issue).
Каждое изменение кода → поднять VERSION, прогнать тесты, запушить в dev, задеплоить.
Готово → задача в колонку «Готово» и закрыта (closed).
Документация (README / IDEA.MD / вики) обновляется вместе с кодом.

11 KiB Raw Blame History Unescape Escape

Social Post Writer Bot