🎌 Anime Piccha Bot

✨ Telegram-бот для отправки случайных аниме-изображений с админ-панелью ✨

Красивые аниме-изображения по команде и мощная админ-панель для управления

🚀 Возможности

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

• /pikcha - Получить случайное аниме-изображение
• /start - Начало работы с ботом

⚡ Для администраторов

• 📊 Статистика - детальная аналитика использования бота
• 📢 Рассылки - массовые сообщения с поддержкой inline-кнопок
• 🛡️ Безопасность - доступ только для авторизованных администраторов

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

Компонент	Технология	Назначение
🎯 Язык		Высокопроизводительный язык для кроссплатформенной разработки
🤖 Фреймворк		Мощный и типобезопасный фреймворк для Telegram Bot API
💾 База данных		Быстрая локальная NoSQL база данных
🌐 HTTP-клиент		Продвинутый HTTP-клиент для работы с API
⚙️ Конфигурация		Читаемые конфигурационные файлы

📸 Примеры работы

🖼️ Основной функционал

Случайное аниме-изображение по команде /pikcha

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

📋 Предварительные требования

• Dart SDK версии 2.19 или выше
• Telegram Bot Token от @BotFather

⚡ Установка и запуск

1. Клонируйте репозиторий

git clone https://github.com/C0dwiz/anime_piccha_bot.git
cd anime_piccha_bot

2. Установите зависимости

dart pub get

3. Настройте конфигурацию

# config.yaml
bot_token: "YOUR_BOT_TOKEN_HERE"
admin_ids:
  - 123456789  # Ваш Telegram ID
  - 987654321  # ID других администраторов

# Дополнительные настройки
waifu_api_url: "https://api.waifu.pics/sfw/waifu"
log_errors: true
enable_stats: true

4. Запустите кодогенерацию

dart run build_runner build

5. Запустите бота

dart run

⚙️ Конфигурация

🔧 Основные настройки

bot_token: "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
admin_ids:
  - 123456789
  - 987654321

# API настройки
waifu_api_url: "https://api.waifu.pics/sfw/waifu"

# Логирование
log_errors: true

# Статистика
enable_stats: true
cleanup_interval_days: 30

🔐 Получение Telegram Bot Token

1. Напишите @BotFather в Telegram
2. Используйте команду /newbot
3. Следуйте инструкциям и получите токен
4. Добавьте токен в config.yaml

🛠️ Разработка

🔨 Сборка проекта

# Установка зависимостей
dart pub get

# Кодогенерация для Hive
dart run build_runner build

# Запуск в режиме разработки
dart run lib/main.dart

🧪 Тестирование

# Запуск тестов
dart test

# Запуск с покрытием кода
dart test --coverage

📈 Производительность

• ⚡ Быстрый отклик - использование асинхронных операций
• 💾 Эффективное хранение - оптимизированная работа с Hive
• 🔒 Надежность - обработка ошибок и повторные попытки
• 📊 Мониторинг - детальное логирование всех операций

🤝 Вклад в проект

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

1. Форкните репозиторий
2. Создайте ветку для функции (git checkout -b feature/amazing-feature)
3. Закоммитьте изменения (git commit -m 'Add amazing feature')
4. Запушьте в ветку (git push origin feature/amazing-feature)
5. Откройте Pull Request

📄 Лицензия

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

👨‍💻 Автор

Ваше Имя

• GitHub: @C0dwiz
• Telegram: @shuseks

🙏 Благодарности

• Televerse за отличный фреймворк для Telegram ботов
• waifu.pics за предоставление API для аниме-изображений
• Сообщество Dart за потрясающую экосистему

---

⭐ Не забудьте поставить звезду репозиторию, если проект вам понравился!

Сделано с ❤️ и Dart