docs: update README for 2.1.0, reminders now sent as Telegram messages

Author: AlexTkDev

.gitignore

@@ -134,7 +134,7 @@ env/
 ENV/
 env.bak/
 venv.bak/
-# .venv/  # НЕ добавлять, чтобы не удалять локальное окружение
+# .venv/  # Do NOT add, so as not to delete the local environment
 
 # IDEs
 .idea/

README.md

@@ -1,14 +1,14 @@
 # EduPlannerBotAI
 
-**EduPlannerBotAI** is a Telegram bot built with `aiogram 3.x` and powered by OpenAI GPT. It generates personalized study plans, exports them to PDF/TXT, and schedules reminders. All data is stored using TinyDB.
+**EduPlannerBotAI** is a Telegram bot built with `aiogram 3.x` and powered by OpenAI GPT. It generates personalized study plans, exports them to PDF/TXT, and sends reminders as Telegram messages. All data is stored using TinyDB.
 
 > **Note:** All code comments and docstrings are now in English for better international collaboration and code clarity.
 
 ## 📌 Features
 
 - 📚 Generate personalized study plans (LLM/OpenAI)
 - 📝 Export study plans to PDF/TXT
-- ⏰ Schedule reminders (async simulation)
+- ⏰ Send reminders as Telegram messages for each study step
 - 🗄️ Store data using TinyDB
 - 📊 Python 3.10–3.13 support
 
@@ -47,6 +47,10 @@ docker-compose up --build
 ```
 Environment variables are loaded from `.env`.
 
+## 🔔 How Reminders Work
+
+When you choose to schedule reminders, the bot will send you a separate Telegram message for each step of your study plan. This ensures you receive timely notifications directly in your chat.
+
 ## 🧪 Testing & Code Quality
 
 - 100% of core logic is covered by automated tests (`pytest`).

bot.py

@@ -14,12 +14,12 @@
 os.makedirs("plans", exist_ok=True)
 os.makedirs("fonts", exist_ok=True)
 
-# Проверка наличия токенов
+# Check for token presence
 if not TOKEN:
     print("[ERROR] BOT_TOKEN is not set in environment variables.", file=sys.stderr)
     sys.exit(1)
 
-# Настройка логирования
+# Logging setup
 LOG_LEVEL = os.getenv("LOG_LEVEL", "INFO").upper()
 LOG_FILE = os.getenv("LOG_FILE")
 

handlers/planner.py

@@ -149,7 +149,11 @@ async def handle_reminders(callback: types.CallbackQuery, state: FSMContext):
         callback.message, Message
         ) else None
     # Run async reminder scheduling task
-    reminders_count = await schedule_reminders(user_id, plan)
+    if callback.bot is None:
+        if isinstance(callback.message, Message):
+            await callback.message.answer("Internal error: bot instance is not available.")
+        return
+    reminders_count = await schedule_reminders(user_id, plan, callback.bot)
     # Update message after scheduling completion
     if isinstance(message, Message):
         await message.edit_text(

services/reminders.py

@@ -1,16 +1,24 @@
 import asyncio
 import logging
+from aiogram import Bot
 
 logger = logging.getLogger(__name__)
 
 
-async def schedule_reminders(user_id: int, plan: list):
-    """Schedule reminders for study plan steps"""
+async def schedule_reminders(user_id: int, plan: list, bot: Bot):
+    """Schedule reminders for study plan steps and send messages to the user"""
     logger.info("Scheduling reminders for user %s", user_id)
 
+    count = 0
     for i, task in enumerate(plan, start=1):
         if task.strip():  # Skip empty lines in plan
             await asyncio.sleep(0.1)  # Simulate delay for scheduling
+            reminder_text = f"⏰ Reminder {i}: {task}"
+            try:
+                await bot.send_message(user_id, reminder_text)
+            except Exception as e:
+                logger.error("Failed to send reminder to %s: %s", user_id, e)
             logger.info("Reminder for %s: day %s — %s", user_id, i, task)
+            count += 1
 
-    return len([task for task in plan if task.strip()])  # Return number of reminders
+    return count  # Return number of reminders