androidkrdbot

KO | EN

gitlite — search

#python #go #golang #deep-learning #docker #macos #java #windows #awesome #cli #kubernetes #security #pytorch #open-source

(★ 17)

Телеграм бот для сообщества "Android Krasnodar" https://t.me/androidkrd

androidkrdbot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🤖 Telegram-бот для сообщества [Android Krasnodar](https://t.me/androidkrd)

**androidkrdbot** — это Telegram-бот-модератор для Android Краснодар сообщества.  
Он проверяет новых участников группы с помощью простых (но коварных) вопросов, и удаляет тех, кто не прошёл проверку.

Создан в духе строгой, но ироничной модерации.  
Во главе — товарищ Берия. Он всё видит. Он всё фиксирует. Он не даст спамерам и случайным людям войти без боя.

---

## 🧠 Возможности

- ✅ Проверка новых участников по контрольному вопросу.
- 🛠 Возможность перезагрузки вопросов без перезапуска бота.
- 🔒 Только администраторы могут управлять ботом.
- 📥 Ответы обрабатываются внутри чата.
- ⏳ Таймер — если пользователь не ответил, он будет удалён.

---

## ⚙️ Установка

> Требуется: JDK 17+, Gradle, Telegram Bot Token

1. Клонируй репозиторий:
   ```bash
   git clone https://github.com/i-redbyte/androidkrdbot.git
   cd androidkrdbot
   ```

2. Создай `.env` в корне проекта:

```env
   TELEGRAM_BOT_TOKEN=123456789:ABCDEFyourTokenHere
   ```

3. Убедись, что у тебя есть файл с вопросами:  
   `src/main/resources/questions.json`

Пример:

```json
   [
     {
       "text": "Назови любой цвет радуги.",
       "correctAnswers": ["красный", "red", "orange", "оранжевый"]
     }
   ]
   ```

4. Запусти бота:
   ```bash
   ./gradlew run
   ```

---

## 🔐 Настройка Telegram

Чтобы бот работал в группе:

1. Добавь бота в группу.
2. Назначь его **администратором**.
3. Через [@BotFather](https://t.me/BotFather):
   - Открой настройки бота
   - `Group Privacy` → `Turn off` (обязательно!)

---

## 💬 Команды

| Команда | Описание |
|--------|----------|
| `/startVerification` | Включить режим проверки новичков |
| `/stopVerification` | Выключить режим |
| `/verificationStatus` | Узнать статус режима |
| `/reload_questions` | Перезагрузить файл с вопросами |

---

## 🧪 Поведение

1. При включённом режиме проверки:
   - Новый участник получает вопрос в чате.
   - Если он отвечает правильно — остаётся.
   - Если неправильно или не отвечает — удаляется.
2. Ответы принимаются **в чате**, а не в ЛС.
3. Вопросы выбираются случайно из файла `questions.json`.

---

## 📡 Логика команд доступна только администраторам

Если неадмин попытается управлять ботом, он получит предупреждение, что:

> 🚫 Только администрация может отдавать приказы товарищу Берии. Ваше поведение записано в досье.

---

## 🤝 Contributing

Буду очень рад, если вы захотите поучаствовать в развитии этого проекта!

Если вы нашли баг, хотите внести улучшение, добавить новые вопросы или поправить структуру — не стесняйтесь открыть pull request или создать issue.  
Проект открыт для развития и будет только лучше с вашей помощью.

### Что можно улучшить:
- Добавить новые вопросы в `questions.json`
- Расширить функциональность (например, логирование, отчёты, фильтры)
- Обновить документацию и тексты
- Провести рефакторинг или тестирование

### Требования к изменениям:
Пожалуйста, придерживайтесь принципов, уже использованных в проекте:
- Чистая архитектура:
    - `data/` — репозитории
    - `domain/` — use cases, модели, состояние
    - `presentation/` — Telegram-интеграция и запуск
- Kotlin DSL + Gradle
- Логическая изоляция слоёв
- Минимум магии, максимум читаемости
- Вопросы хранятся в `resources/questions.json`

🙌 Спасибо всем, кто захочет внести вклад!

---

## 📄 Лицензия

Этот проект распространяется под лицензией [Apache License 2.0](LICENSE).  
Вы можете свободно использовать, изменять и распространять код, соблюдая условия этой лицензии.

androidkrdbot

androidkrdbot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

androidkrdbot

androidkrdbot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README