Шаблон для Telegram-бота

1# Проект: <bot name>2 3## Что это4Telegram-бот для <задача>. Основной UI — Telegram-чат, опционально mini-app.5 6## Стек7- Python 3.12 + aiogram 3.x  (или Node.js + grammy)8- SQLite для простого / Postgres для серьёзного9- Redis для rate-limiting (опционально)10- Сервер: Hetzner CX22 за €4.5/мес11 12## Структура13- `bot/handlers/` — обработчики команд и сообщений14- `bot/states/` — FSM (если многоступенчатые диалоги)15- `bot/keyboards/` — inline и reply клавиатуры16- `bot/db.py` — работа с БД17- `config.py` — переменные окружения18- `main.py` — точка входа19 20## Конвенции21- Все тексты бота — в `bot/texts.py` (легко переводить)22- Логирование через стандартный `logging`, уровень INFO23- БД — через ORM (SQLAlchemy или Prisma), не raw SQL24- Долгие операции — в фоне через asyncio.create_task25 26## Не делать27- Не хранить состояние в памяти (упадёт перезагрузка)28- Не делать синхронные вызовы внешних API в handler — будет блокировать29- Не отвечать на сообщения медленнее 3 секунд без typing-индикатора30 31## Команды32- `python main.py` — запуск (для разработки)33- `docker compose up -d` — продакшен через docker34- `docker compose logs -f bot` — смотреть логи35 36## Деплой37- Token бота в `.env`38- supervisor / systemd для авто-рестарта