diff --git a/Home.md b/Home.md deleted file mode 100644 index d1f0784..0000000 --- a/Home.md +++ /dev/null @@ -1,54 +0,0 @@ -# Social Post Writer Bot - -**Телеграм-бот** для генерации постов для соцсетей. По запросу пользователя готовит три варианта текста, адаптированных под его Tone of Voice. - -- **Бот:** [@post_master_bot](https://t.me/post_master_bot) -- **Репозиторий:** `admin/social-post-writer-bot` -- **Стек:** Python 3.12, aiogram 3.x, aiohttp, SQLite, APInex (LLM / STT / vision) -- **Деплой:** Coolify, окружение `development`, приложение `social-post-writer-bot-development` - ---- - -## Возможности - -| Возможность | Описание | -|---|---| -| **Генерация постов** | На явную просьбу или реплай-правку — **3 отдельных варианта** сообщениями | -| **Tone of Voice** | Пришли скриншоты своих постов — бот распознаёт тексты и накапливает твой стиль | -| **Голосовой ввод** | Голосовые сообщения расшифровываются (APInex STT) и работают как текст | -| **Идеи** | «предложи тему» или `/idea` — одна идея (заголовок, угол, зачем) | -| **Подписка** | Триал 3 дня, затем 30 дней за 100 звёзд | - ---- - -## Быстрый старт - -1. Напиши боту `/start` — получишь онбординг и пробный период на 3 дня. -2. Опиши тему: «напиши пост про запуск нового продукта». -3. Получишь три варианта. Не нравится — ответь реплаем: «сделай короче». -4. Хочешь, чтобы посты были в твоём стиле — пришли скриншоты своих публикаций. - ---- - -## Разделы вики - -- **[Пользователю](User-Guide.md)** — сценарии, команды, подписка, FAQ -- **[Разработчику](Developer-Guide.md)** — архитектура, потоки, функции, БД -- **[Деплой](Deployment.md)** — Coolify, переменные, деплой-скрипт, уведомления -- **[Подписка](Subscription.md)** — модель, таблица БД, жизненный цикл - ---- - -## Ключевые файлы репозитория - -``` -bot.py — роутинг, команды, обработка сообщений -apinex_client.py — клиент APInex (LLM, STT, vision), промпты, логи -user_store.py — SQLite: пользователи, ToV, посты, идеи, API-логи, подписки -help_message.py — Rich Message справка -VERSION — версия релиза -Dockerfile — python:3.12-slim -tests/ — юнит-тесты (unittest) -``` - -Полная документация — в [README.md](../../src/branch/main/README.md) и `IDEA.MD` репозитория. diff --git a/unnamed.md b/unnamed.md new file mode 100644 index 0000000..c605ed6 --- /dev/null +++ b/unnamed.md @@ -0,0 +1,62 @@ +# Social Post Writer Bot + +**Телеграм-бот** для генерации постов для соцсетей. По запросу пользователя готовит три варианта текста, адаптированных под его Tone of Voice. + +- **Бот:** [@post_master_bot](https://t.me/post_master_bot) +- **Репозиторий:** `admin/social-post-writer-bot` +- **Стек:** Python 3.12, aiogram 3.x, aiohttp, SQLite, APInex (LLM / STT / vision) +- **Деплой:** Coolify, окружение `development`, приложение `social-post-writer-bot-development` +- **Версия разработки:** `0.1.0+48` + +--- + +## Возможности + +| Возможность | Описание | +|---|---| +| **Генерация постов** | На явную просьбу или реплай-правку — **3 отдельных варианта** сообщениями | +| **Пост без темы** | «✍️ Придумать пост» / `/post` — бот сам выбирает тему по обученному профилю аккаунта | +| **Пост по изображению** | Изображение или галерея с подписью-ТЗ → три варианта поста | +| **Tone of Voice** | Скриншоты, текст, голос или аудио — бот накапливает сведения об аккаунте и обновляет профиль | +| **Голосовой ввод** | Голосовые расшифровываются (APInex STT) и работают как текст | +| **Идеи** | «предложи тему» или `/idea` — одна идея (заголовок, угол, зачем) | +| **Режимы** | «Обучение», «Генерация», «Подписка», «Помощь» — нижнее меню с кнопкой возврата | +| **Подписка** | Триал 3 дня, затем 30 дней за 100 звёзд (реальная оплата Telegram Stars) | + +--- + +## Быстрый старт + +1. Напиши боту `/start` — получишь онбординг и пробный период на 3 дня. +2. Зайди в «Обучение» и пришли скриншоты своих постов или расскажи об аккаунте. +3. Зайди в «Генерация» и опиши тему: «напиши пост про запуск нового продукта» — получишь три варианта. +4. Не нравится — ответь реплаем: «сделай короче». +5. Нет темы? Нажми «✍️ Придумать пост» — бот придумает её сам по профилю аккаунта. + +--- + +## Разделы вики + +- **[Пользователю](User-Guide.md)** — сценарии, команды, подписка +- **[Разработчику](Developer-Guide.md)** — архитектура, потоки, функции, БД, логирование +- **[Деплой](Deployment.md)** — Coolify, переменные, деплой-скрипт, проверка после деплоя +- **[Подписка](Subscription.md)** — модель, таблица БД, жизненный цикл, Stars + +--- + +## Ключевые файлы репозитория + +``` +bot.py — роутинг, команды, обработка сообщений +payments.py — оплата Telegram Stars +apinex_client.py — клиент APInex (LLM, STT, vision) +user_store.py — SQLite: пользователи, ToV, посты, идеи, API-логи, подписки +raw_updates.py — dev-only БД сырых входящих Telegram Update +keyboards.py — клавиатуры режимов +help_message.py — Rich Message справка +VERSION — версия релиза +Dockerfile — python:3.12-slim +tests/ — юнит-тесты (unittest) +``` + +Полная документация — в [README.md](../../src/branch/dev/README.md) и `IDEA.MD` репозитория.