docs: обновить справку и версию 0.1.0+60

hermes committed 2026-10-11 22:11:58 +02:00
1 parent cad5e15422
commit 76e208bf08
4 files changed
+16 -5

No files matched your search

+2 -2
@@ -11,7 +11,7 @@
| **Сервер приложения** | `spb-easy-dale` (`31.129.103.242`) |
| **Бот** | [@post_master_bot](https://t.me/post_master_bot) |
| **Группа поддержки** | супергруппа с темами, `chat.id = -1008000863273` |
| **Версия** | `VERSION`, сейчас `0.1.0+59` |
| **Версия** | `VERSION`, сейчас `0.1.0+60` |
> Сервер управления Coolify и сервер приложения — **разные хосты**. Проверять контейнер нужно на сервере приложения, а не на хосте Coolify.
@@ -49,7 +49,7 @@ ssh root@31.129.103.242 'docker logs --tail 60 <CONTAINER_NAME>'
Успешный запуск:
```
INFO:__main__:Development deploy notice sent: version=0.1.0+59
INFO:__main__:Development deploy notice sent: version=0.1.0+60
INFO:aiogram.dispatcher:Start polling
INFO:aiogram.dispatcher:Run polling for bot @post_master_bot id=2201652808 - 'Мастер постинга'
```
+10 -2
@@ -77,6 +77,14 @@ update_tone_from_image → _handle_image_message
---
### Навигация справки (`help_message.py`)
`help_menu_html()` и `help_section_html()` формируют только кнопки перехода к разделам справки.
Кнопки собираются последовательно в строки по бюджету ширины `HELP_BUTTON_ROW_WIDTH`; подписи
не сокращаются и переносятся целиком. Отдельной кнопки «В меню» нет; текущий раздел disabled.
---
## Ключевые функции
### `bot.py`
@@ -95,7 +103,7 @@ update_tone_from_image → _handle_image_message
| `handle_successful_payment` | Активирует подписку после реальной оплаты |
| `clear_command` | `/clear` и «Сбросить данные» — inline-подтверждение, сброс только в режиме обучения |
| `style_command` | `/style` — профиль аккаунта |
| `help_command` / `help_navigation` | Справка Rich Message + переключение разделов |
| `help_command` / `help_navigation` | Справка Rich Message; разделы ведут друг к другу, без кнопки «В меню»; подписи целиком упаковываются в строки |
| `notify_development_deploy` | Dev-уведомление о новой версии в `DEV_CHAT_ID` |
| `typing_status` | Индикатор «печатает» |
| `report_error` | Понятная ошибка пользователю; секреты вырезаны |
@@ -259,7 +267,7 @@ SELECT payload FROM raw_updates WHERE update_id = ?;
.venv/bin/python -m unittest discover -s tests -v
```
Тесты: 251 (на версии `0.1.0+59`). Покрытие: STT, LLM, vision, ToV, reply-поля, изоляция пользователей, API-логи, **raw update log**, режимные клавиатуры и роутинг, платежи (Stars, защита от повторов, dev-подтверждение), ошибки, справка, онбординг, подписки, самостоятельная генерация поста, восстановление обрезанного JSON, индикатор «печатает», **поддержка** (топики, подписи, кнопка «Ответить», закрытие обращения).
Тесты: 251 (на версии `0.1.0+60`). Покрытие: STT, LLM, vision, ToV, reply-поля, изоляция пользователей, API-логи, **raw update log**, режимные клавиатуры и роутинг, платежи (Stars, защита от повторов, dev-подтверждение), ошибки, справка, онбординг, подписки, самостоятельная генерация поста, восстановление обрезанного JSON, индикатор «печатает», **поддержка** (топики, подписи, кнопка «Ответить», закрытие обращения).
> Запускай через `.venv` проекта: вне виртуального окружения `aiogram` может быть не установлен.
+2 -1
@@ -6,7 +6,7 @@
- **Репозиторий:** `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+59`
- **Версия разработки:** `0.1.0+60`
---
@@ -22,6 +22,7 @@
| **Идеи** | «предложи тему» или `/idea` — одна идея (заголовок, угол, зачем) |
| **Режимы** | «Обучение», «Генерация», «Подписка», «Помощь» — нижнее меню с кнопкой возврата |
| **Поддержка** | «🆘 Поддержка» — переписка с оператором в личке, у него в персональном топике группы |
| **Помощь** | `/help` — меню разделов; кнопки расположены последовательно, переносятся целиком и ведут между разделами без кнопки «В меню» |
| **Подписка** | Триал 3 дня, затем 30 дней за 100 звёзд (реальная оплата Telegram Stars) |
---
+2
@@ -11,6 +11,8 @@
Одновременно `/start` создаёт пробный период на **3 дня**. Справка автоматически не открывается — она доступна кнопкой «📖 Помощь» или командой `/help`.
В меню справки кнопки разделов идут друг за другом и переносятся на следующую строку целиком, когда не помещаются. Отдельной кнопки «В меню» нет; внутри раздела можно перейти к любому другому.
Внутри любого режима клавиатура содержит кнопку «🏠 Главное меню» (в «Обучении» — ещё «🗑 Сбросить данные», в «Генерации» — «✍️ Придумать пост», в «Помощи» — «🆘 Поддержка»).
---