🤖 Telegram Bot Projesi

Bu proje, bir Telegram botu oluşturmak için geliştirilmiştir. Bot, belirli aralıklarla kelime quizleri gönderir ve basit bir HTTP sunucusu çalıştırır.

🚀Başlarken

Bu talimatlar, yerel makinenizde projeyi çalıştırmak için gereken adımları sağlar.

🛠️Gereksinimler

• Java 17
• Maven

💾Kurulum

1. Projeyi klonlayın:

   git clone <repository-url>
   cd <repository-directory>

2. Gerekli bağımlılıkları yükleyin:

   mvn clean install

3. config.properties dosyasını düzenleyin ve bot token ve kullanıcı adını girin:

   bot.token = <YOUR_BOT_TOKEN>
   bot.username = <YOUR_BOT_USERNAME>
   bot.chatId = <CHANNEL_CHAT_ID>

▶️Çalıştırma

Projeyi çalıştırmak için aşağıdaki komutu kullanın:

mvn exec:java -Dexec.mainClass="org.example.Main"

⚙️Yapılandırma

• pom.xml dosyasında, Java 17 kullanımı ve gerekli bağımlılıklar tanımlanmıştır.
• Botun ayarları için bir config.properties dosyası gereklidir. Bu dosyada bot token, kullanıcı adı ve kanalın chat ID'si gibi bilgiler bulunur. (Örnek bir dosya yoksa, yukarıdaki formatta manuel olarak resources klasörünün altına ekleyin)
• words.json dosyasında, "word"-"definition" keyleri bulunur. (Dilerseniz mevcut bir JSON dosyasını kullanabilir ya da kendi kelime listenizi manuel olarak ekleyebilirsiniz.) (Bu dosyayı da "resources/data" klasörünün altında oluşturabilirsiniz.)

├── src
│   ├── main
│   │   ├── java
│   │   └── resources
│   │       ├── config.properties
│   │       └── data
│   │           └── words.json

Örnek JSON

[
  {
    "word": "algorithm",
    "definition": "algoritma"
  },
  {
    "word": "apple",
    "definition": "elma"
  }
]

✨Özellikler

• Kelime Quizleri: Bot, belirli aralıklarla(5 dakika) kelime quizleri gönderir.
• HTTP Sunucusu: Basit bir HTTP sunucusu çalıştırır ve botun çalıştığını doğrular.

🔍Test ve Hata Ayıklama

Cannot parse null string

• Eğer projeyi Heroku üzerinde çalıştırıyorsanız, ortam değişkenlerinden PORT değerini alın.
  Ancak, projeyi lokal ortamda çalıştırırken application.properties ya da config.properties dosyasına şu satırı ekleyebilirsiniz:

server.port=8080  

🤝Katkıda Bulunma

1. Projeyi forklayın.
2. Yeni bir branch oluşturun (git checkout -b feature/AmazingFeature).
3. Değişikliklerinizi işleyin (git commit -m 'Add some AmazingFeature').
4. Branch'e push yapın (git push origin feature/AmazingFeature).
5. Bir Pull Request açın.

💬İletişim

Proje hakkında sorularınız veya önerileriniz için lütfen Muhammet Kaya adresine e-posta gönderin.