docs: sync wiki with 0.1.0+48 (Home)

2026-10-11 12:06:00 +00:00
1 parent edf1b88aaf
commit b184b51832
@@ -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` репозитория.