🎯 Target Assistant Bot

Ваш персональный AI-ассистент для достижения любых целей
_{Умный помощник, который разбивает большие цели на ежедневные задачи и следит за прогрессом}

🌐 English Version • ✨ Возможности • 🚀 Быстрый старт • 📖 Документация

---

🚀 Мгновенный старт Начните достигать целей через 5 минут

🧠 Умный AI-планировщик GPT-4o-mini создает оптимальные планы

📈 Отслеживание прогресса Визуализация в Google Sheets

🌟 Ключевые возможности

🎯 Управление множественными целями

• До 10 активных целей одновременно
• Приоритеты: 🔴 Высокий • 🟡 Средний • 🟢 Низкий
• Теги для группировки: #работа #здоровье #саморазвитие
• Статусы: ✅ Активная • 🏆 Завершенная • 📦 В архиве

🤖 AI-планирование с GPT-4o-mini

• Автоматическое создание SMART-планов
• Разбивка на ежедневные задачи
• Учет вашего расписания и возможностей
• Умная генерация планов с учетом целей

📊 Аналитика и отчеты

• Реальный прогресс по каждой цели
• Статистика выполнения задач
• Детальная аналитика в Google Sheets
• Экспорт в Google Sheets

💬 Удобный интерфейс

• Inline-кнопки для быстрых действий
• Пошаговый wizard создания целей
• Настраиваемые напоминания (через переменные окружения)
• Мотивационные сообщения от AI

📊 Архитектура системы

graph TB
    subgraph "👤 Пользователь"
        A[Telegram App]
    end
    
    subgraph "🤖 Target Assistant Bot"
        B[Bot Interface]
        C[Goal Manager]
        D[Task Scheduler]
        E[Analytics Engine]
    end
    
    subgraph "🧠 AI Services"
        F[OpenAI GPT-4o-mini]
        G[Plan Generator]
        H[Motivation Engine]
    end
    
    subgraph "💾 Data Storage"
        I[Google Sheets API]
        J[User Goals]
        K[Daily Tasks]
        L[Progress Tracking]
    end
    
    A <--> B
    B --> C
    C --> D
    C --> E
    C <--> G
    G <--> F
    H <--> F
    D --> H
    C <--> I
    I --> J
    I --> K
    I --> L
    
    style A fill:#2CA5E0,stroke:#fff,color:#fff
    style F fill:#412991,stroke:#fff,color:#fff
    style I fill:#34A853,stroke:#fff,color:#fff

Loading

🚀 Быстрый старт

🐳 Запуск через Docker (рекомендуется)

# 1. Клонируйте репозиторий
git clone https://github.com/bivlked/target-assistant-bot.git
cd target-assistant-bot

# 2. Создайте файл с настройками
cp .env.example .env

# 3. Заполните обязательные параметры в .env:
# - TELEGRAM_BOT_TOKEN (получите у @BotFather)
# - OPENAI_API_KEY (получите на platform.openai.com)
# - Добавьте google_credentials.json

# 4. Зарегистрируйте команды бота у BotFather
python setup_commands.py

# 5. Запустите бота
docker compose up -d

🐍 Локальная установка

Развернуть инструкцию

# 1. Создайте виртуальное окружение
python3 -m venv .venv
source .venv/bin/activate  # Linux/Mac
# или
.venv\Scripts\activate  # Windows

# 2. Установите зависимости
pip install -r requirements.txt

# 3. Настройте переменные окружения
cp .env.example .env
# Отредактируйте .env файл

# 4. Зарегистрируйте команды бота у BotFather
python setup_commands.py

# 5. Запустите бота
python main.py

☁️ Деплой на сервер

Развернуть инструкцию для Ubuntu/Debian

# 1. Установите зависимости
sudo apt update && sudo apt install -y python3.12 python3.12-venv git

# 2. Создайте пользователя для бота
sudo useradd -m -s /bin/bash targetbot
sudo -u targetbot -i

# 3. Клонируйте и настройте
git clone https://github.com/bivlked/target-assistant-bot.git
cd target-assistant-bot
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 4. Зарегистрируйте команды бота у BotFather
python setup_commands.py

# 5. Настройте systemd сервис
sudo cp deploy/targetbot.service /etc/systemd/system/
sudo systemctl enable --now targetbot

Подробная инструкция: 📖 Установка на Ubuntu

📖 Примеры использования

🎯 Создание первой цели

👤: /start
🤖: Добро пожаловать в Target Assistant Bot! 🎯
    
    Я помогу вам достигать любых целей, разбивая их на 
    конкретные ежедневные задачи.
    
    [🎯 Мои цели] [➕ Создать цель] [📊 Открыть таблицу]

👤: [Нажимает ➕ Создать цель]
🤖: Шаг 1/6: Введите название цели
    Например: "Изучить Python", "Похудеть на 10 кг"

👤: Выучить английский до уровня B2
🤖: Шаг 2/6: Опишите подробнее, чего хотите достичь?

... [пошаговый процесс создания] ...

🤖: ✅ Цель создана! Я составил план на 90 дней.
    Первая задача на завтра:
    📝 Пройти тест на определение текущего уровня

📅 Ежедневная работа

🤖: ☀️ Доброе утро! Ваши задачи на сегодня:

📚 Английский язык (🔴 высокий приоритет)
└─ Выучить 20 новых слов по теме "Бизнес"

🏃 Здоровье (🟡 средний приоритет)  
└─ Пробежка 3 км в парке

💻 Программирование (🟢 низкий приоритет)
└─ Прочитать главу про ООП в Python

[✅ Отметить выполнение] [📊 Статистика]

📋 Полный список команд

Команда	Описание	Пример
/start	🚀 Начало работы с ботом	/start
/my_goals	🎯 Управление всеми целями	/my_goals
/add_goal	➕ Создать новую цель	/add_goal
/today	📅 Задачи на сегодня	/today
/check	✅ Отметить выполнение	/check
/status	📊 Общая статистика	/status
/motivation	💪 Получить мотивацию	/motivation
/help	❓ Справка по командам	/help
/reset	🗑️ Удалить все данные	/reset

🛠️ Технологический стек

Категория	Технологии
🐍 Язык	Python 3.12+ с полной типизацией
🤖 Telegram	python-telegram-bot 22.0 (async)
🧠 AI	OpenAI GPT-4o-mini API
💾 Хранение	Google Sheets API v4
🔄 Асинхронность	asyncio
⏰ Планировщик	APScheduler
🧪 Тестирование	pytest, pytest-asyncio, coverage
📊 Мониторинг	Prometheus, Sentry
🐳 Контейнеризация	Docker, Docker Compose
🔧 CI/CD	GitHub Actions

📚 Документация

📖 Для пользователей

• Руководство пользователя - подробная инструкция по использованию
• FAQ - ответы на частые вопросы
• Примеры целей - идеи и шаблоны целей

🛠️ Для разработчиков

• Архитектура проекта - техническое описание
• API документация - автогенерируемая документация
• Руководство контрибьютора - как внести свой вклад
• Чек-лист разработки - roadmap и задачи

🚀 Установка и настройка

• Быстрая установка - краткая инструкция
• Подробная установка - пошаговое руководство
• Настройка Google Sheets - создание service account
• Переменные окружения - описание всех параметров

🤝 Как внести свой вклад

Мы рады любому вкладу в развитие проекта!

graph LR
    A[🐛 Нашли баг?] --> B[Создайте Issue]
    C[💡 Есть идея?] --> D[Обсудите в Discussions]
    E[💻 Хотите помочь?] --> F[Сделайте Pull Request]
    
    B --> G[Мы исправим!]
    D --> H[Обсудим вместе!]
    F --> I[Review и merge!]
    
    style A fill:#ff6b6b,stroke:#fff,color:#fff
    style C fill:#4ecdc4,stroke:#fff,color:#fff
    style E fill:#45b7d1,stroke:#fff,color:#fff

Loading

Прочитайте CONTRIBUTING.md для подробной информации.

📈 Статистика проекта

🏆 Контрибьюторы

📜 Лицензия

Этот проект распространяется под лицензией MIT. Подробности в файле LICENSE.

---

⭐ Поддержите проект

Если Target Assistant Bot помог вам в достижении целей, поставьте звезду!

Сделано с ❤️ by bivlked

_{Есть вопросы? Создайте Issue • Хотите обсудить? Заходите в Discussions • Нужна помощь? Пишите в Telegram}