Bir Discord ‘Gemi Takip’ Botu: Hafta Sonunda Nasıl Yapılır ve 7/24 Çalışmasını Sağlayan 3 Katmanlı Mimari

Bir Discord ‘Gemi Takip’ Botu: Hafta Sonunda Nasıl Yapılır ve 7/24 Çalışmasını Sağlayan 3 Katmanlı Mimari

Discord’da bir sunucuda aktif olmak ve kullanıcıların ilgisini çekecek özellikler sunmak, günümüzün dijital topluluklarında oldukça önemli. Peki ya bu ilgi çekici özelliklerden biri, gerçek zamanlı veri akışını kullanarak bir “gemi takip botu” olsa? Bu makalede, hafta sonu gibi kısa bir sürede nasıl böyle bir bot geliştirebileceğinizi ve en önemlisi, bu botun kesintisiz bir şekilde 7/24 çalışmasını sağlayan sağlam bir mimariyi adım adım inceleyeceğiz. Belki de ilk başta karmaşık görünen bu proje, doğru yaklaşımla oldukça ulaşılabilir hale geliyor. Amacımız, hem teknik bilgi edinmek hem de pratik bir uygulama geliştirmek.

Neden Bir Gemi Takip Botu? Gerçek Dünya Senaryoları ve Potansiyel Kullanım Alanları

Günümüzde birçok Discord sunucusu, belirli ilgi alanlarına odaklanmış toplulukları barındırıyor. Denizcilik meraklıları, lojistik profesyonelleri, hatta oyun toplulukları için bile gemi takibi, ilgi çekici bir konu olabilir. Örneğin, bir lojistik şirketinin Discord sunucusunda, müşteriler veya çalışanlar, belirli gemilerin konumlarını anlık olarak takip edebilirler. Bu, operasyonel verimliliği artırabilir ve şeffaflığı sağlayabilir. Benzer şekilde, bir denizcilik forumunda, üyeler en sevdikleri gemilerin rotalarını veya yeni seferlerini takip edebilir, bu da topluluk etkileşimini güçlendirir. Hatta, bir oyun topluluğunda, oyun içi “gemilerin” veya sanal ticaretteki “nakliye araçlarının” takibi için de benzer bir bot geliştirilebilir. Bu bot, sadece bir eğlence aracı olmanın ötesine geçerek, gerçek dünya problemlerine çözüm sunabilir veya mevcut süreçleri iyileştirebilir. Bu makalenin odak noktası, bu tür bir botu hafta sonu gibi kısa bir sürede geliştirmek ve onu sürekli olarak çalışır durumda tutacak bir altyapı kurmaktır.

Gerekli Temel Kavramlar: API’ler, Webhook’lar ve Bot Geliştirmenin ABC’si

Bu projeye başlamadan önce, birkaç temel teknoloji ve kavram hakkında bilgi sahibi olmak faydalı olacaktır. Öncelikle, API (Application Programming Interface – Uygulama Programlama Arayüzü), farklı yazılımların birbirleriyle iletişim kurmasını sağlayan bir köprüdür. Gemi takibi için kullanacağımız veri sağlayıcılarının (örneğin, MarineTraffic, VesselFinder gibi platformların API’leri) sunduğu verileri alabilmek için bu API’leri kullanacağız. Bu API’ler genellikle belirli bir veri formatında (JSON gibi) bilgi döndürür.

İkinci önemli kavram ise Webhook’lar. Webhook’lar, bir olayın gerçekleştiğinde otomatik olarak bir URL’ye (bizim durumumuzda botumuza) bildirim gönderilmesini sağlar. Bu, sürekli olarak API’yi sorgulamak yerine, veri güncellendiğinde anında bildirim almamızı sağlar. Discord botları için de webhook’lar, botumuzun mesaj göndermesini veya belirli olaylara tepki vermesini sağlamak için kullanılır.

Discord botu geliştirmek için ise genellikle Node.js, Python veya JavaScript gibi programlama dilleri kullanılır. Bu dillerin sunduğu kütüphaneler (örneğin, Discord.js veya discord.py), Discord API’si ile etkileşim kurmayı kolaylaştırır. Botumuz, belirli komutları dinleyecek (örneğin, “!takip gemi_adı” gibi) ve bu komutlara göre API’den veri çekip Discord sunucusunda ilgili bilgileri paylaşacaktır. Bu süreç, temel olarak bir istek-yanıt döngüsüne dayanır. Kullanıcı bir komut gönderir, bot bu komutu işler, harici bir kaynaktan (API) veri alır ve bu veriyi kullanıcıya anlaşılır bir formatta sunar. Bu temelleri anladığınızda, bot geliştirme sürecine daha rahat adapte olabilirsiniz.

Adım Adım Gemi Takip Botu Geliştirme: Kod Örnekleri ve Uygulama

Bu bölümde, pratik bir örnek üzerinden Discord gemi takip botunu nasıl geliştirebileceğimizi göstereceğiz. Node.js ve Discord.js kütüphanesini kullanarak ilerleyeceğiz. Öncelikle, bir Node.js projesi oluşturup gerekli paketleri yüklememiz gerekiyor.

1. Proje Kurulumu ve Bağımlılıklar:
Yeni bir dizin oluşturup terminalde npm init -y komutuyla package.json dosyasını oluşturun. Ardından npm install discord.js dotenv komutuyla gerekli kütüphaneleri yükleyin. discord.js, Discord API’si ile etkileşim kurmamızı sağlarken, dotenv, gizli bilgilerimizi (bot token’ı gibi) güvenli bir şekilde saklamamıza yardımcı olur.

      
npm init -y
    npm install discord.js dotenv


2.  Discord Bot Oluşturma ve Token Alma:

    Discord Developer Portal'a gidin, yeni bir uygulama oluşturun ve bu uygulamaya bir bot ekleyin. Botunuzun token'ını (bu, botunuzun kimlik kartı gibidir) güvenli bir yere kaydedin. Bu token'ı asla kimseyle paylaşmamalısınız. Botunuza sunucunuzda yetki vermek için "OAuth2" bölümünden gerekli izinleri seçerek bir davet linki oluşturabilirsiniz.
3.  Temel Bot Yapısı (index.js):

    Şimdi botumuzun ana kodunu yazmaya başlayalım. index.js adında bir dosya oluşturun.

      
require('dotenv').config(); // .env dosyasından değişkenleri yükler
    const { Client, GatewayIntentBits } = require('discord.js');
    const client = new Client({ intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent] });

    client.once('ready', () => {
        console.log(Bot hazir! ${client.user.tag} olarak giriş yapildi.);
    });

    client.on('messageCreate', async message => {
        if (message.author.bot) return; // Botların mesajlarını görmezden gel
        if (!message.content.startsWith('!takip')) return; // Sadece !takip ile başlayan mesajları işle

        const shipName = message.content.slice(7).trim(); // !takip komutundan sonraki gemi adını al

        if (!shipName) {
            message.reply('Lütfen takip etmek istediğiniz geminin adını belirtin. Örn: !takip MSC Gülsün');
            return;
        }

        // Burada gemi bilgilerini çekeceğimiz API çağrısı yapılacak
        // Örnek olarak bir placeholder fonksiyon kullanıyoruz:
        const shipInfo = await getShipInfo(shipName);

        if (shipInfo) {
            message.channel.send(Gemi Adi: ${shipInfo.name}\nKonum: ${shipInfo.location}\nDurum: ${shipInfo.status});
        } else {
            message.channel.send('${shipName}' adli gemi bulunamadi veya bilgi çekilemedi.);
        }
    });

    // Bu fonksiyonu daha sonra gerçek API çağrısıyla dolduracağız
    async function getShipInfo(name) {
        // Örnek bir yanıt döndürme
        if (name.toLowerCase().includes('msc')) {
            return {
                name: 'MSC Gülsün',
                location: 'Rotterdam Limani',
                status: 'Demirli'
            };
        }
        return null;
    }

    client.login(process.env.DISCORD_TOKEN); // .env dosyasından token'ı al


    dotenv kullanabilmek için projenizin kök dizinine .env adında bir dosya oluşturun ve içine bot token'ınızı ekleyin:

      
DISCORD_TOKEN=YOUR_DISCORD_BOT_TOKEN_HERE


    getShipInfo fonksiyonunu gerçek bir API ile entegre etmeniz gerekecek. Bu, genellikle fetch veya axios gibi kütüphanelerle HTTP istekleri yaparak ve dönen JSON verisini işleyerek yapılır. Gemi verileri sağlayan birçok ücretli ve ücretsiz API bulunmaktadır. Ücretsiz olanlar genellikle daha az veri veya daha yavaş güncelleme hızına sahip olabilir.
7/24 Çalışma Mimarisi: 3 Katmanlı Yapı ve Süreklilik Sağlama
Bir Discord botunun sürekli olarak çevrimiçi kalması, sadece bot kodunu çalıştırmakla bitmez. Bunun için sağlam bir altyapı gereklidir. Biz burada, "3 Katmanlı Mimari" olarak adlandırabileceğimiz bir yaklaşım kullanacağız:
1.  Uygulama Katmanı (Bot Kodu): Bu, yukarıda yazdığımız index.js gibi botun ana mantığını içeren kısımdır. Komutları dinler, API'lerle konuşur ve Discord'a mesaj gönderir. Bu katmanın kararlı çalışması esastır. Hata yönetimi (error handling), loglama (logging) ve yeniden başlatma mekanizmaları bu katmanda önemlidir. Eğer botumuz beklenmedik bir şekilde çökerse, otomatik olarak yeniden başlatılmalıdır.
2.  Veri Katmanı (API ve Veritabanı): Gemi bilgilerini aldığımız harici API'ler bu katmanın bir parçasıdır. Eğer botumuzun belirli bilgileri (örneğin, takip edilen gemi listesi, kullanıcı tercihleri) saklaması gerekiyorsa, bir veritabanı (örneğin, PostgreSQL, MongoDB veya hatta basit bir SQLite) bu katmana dahil edilir. Bu veritabanı, botun yeniden başlatıldığında bile bilgilerin kaybolmamasını sağlar. Gemi takip botu örneğimizde, dış API'ler ana veri kaynağıdır. Ancak, sıkça sorulan gemiler veya kullanıcı ayarları için bir veritabanı kullanmak, performansı artırabilir ve API kullanım limitlerini aşmayı engelleyebilir.
3.  Sunum/Çalıştırma Katmanı (Hosting ve Orkestrasyon): Bot kodunu çalıştıracak ve sürekli çevrimiçi tutacak altyapı bu katmandır. Bu, bir VPS (Virtual Private Server), bulut tabanlı bir hizmet (AWS EC2, Google Cloud Compute Engine, Azure VM gibi) veya özel bir sunucu olabilir. Bu katmanda, botumuzun 7/24 çalıştığından emin olmak için "Process Manager" (Süreç Yöneticisi) adı verilen araçlar kullanılır. PM2 (Node.js için popüler bir süreç yöneticisi), botumuzu izler, çöktüğünde otomatik olarak yeniden başlatır, logları yönetir ve performans istatistiklerini sunar. Ayrıca, bir "Containerization" (Konteynerleştirme) çözümü olan Docker, botu ve bağımlılıklarını izole bir ortamda paketleyerek farklı ortamlarda tutarlı bir şekilde çalışmasını sağlar. Bu, dağıtım (deployment) sürecini de büyük ölçüde kolaylaştırır.
Bu üç katman, birbirini destekleyerek botunuzun hem işlevsel hem de kesintisiz olmasını sağlar. Uygulama katmanındaki hatalar, sunum katmanındaki araçlarla giderilirken, veri katmanındaki bilgiler her zaman erişilebilir kalır.
Gelişmiş Özellikler ve İpuçları: Botunuzu Daha Akıllı Hale Getirme
Temel bir gemi takip botu oluşturduktan sonra, onu daha kullanışlı ve etkileşimli hale getirecek bazı ileri düzey özellikler ekleyebilirsiniz.
*   Gerçek Zamanlı Bildirimler (Webhooks Kullanımı): API'niz webhook desteği sunuyorsa, sürekli sorgulama yerine veri güncellendiğinde bildirim alabilirsiniz. Bu, hem sunucu yükünü azaltır hem de botunuzun daha hızlı tepki vermesini sağlar. Discord'a bildirim göndermek için, botunuzun belirli bir kanala mesaj göndermesini sağlayabilirsiniz. Örneğin, belirli bir gemi limana yaklaştığında veya rotasını değiştirdiğinde otomatik bir bildirim gönderilebilir.
*   Kullanıcı Tercihleri ve Veritabanı Entegrasyonu: Botunuzun, hangi kullanıcıların hangi gemileri takip etmek istediğini hatırlamasını sağlayabilirsiniz. Bunun için bir veritabanı (örneğin, PostgreSQL, MongoDB) kullanmak en iyi yaklaşımdır. Kullanıcılar !takip ekle gemi_adı gibi komutlarla gemi ekleyebilir ve !takip listem ile takip ettikleri gemileri görebilir. Botunuz, periyodik olarak bu listeyi kontrol ederek güncellemeleri Discord'a bildirebilir. Bu, botunuzu daha kişiselleştirilmiş hale getirir.
*   Daha Detaylı Gemi Bilgileri: Sadece konum ve durum değil, geminin türü, boyutu, inşa yılı, varış limanı gibi ek bilgileri de API'den çekip gösterebilirsiniz. Bu bilgiler, kullanıcıların gemiler hakkında daha fazla bilgi edinmesini sağlar. Hatta, geminin uydu görüntülerini veya geçmiş rotalarını da gösterebilirsiniz.
*   Hata Yönetimi ve Loglama: Botunuzun beklenmedik durumlarda çökmemesi için kapsamlı hata yönetimi eklemelisiniz. Hataları yakalayıp Discord'a veya ayrı bir log dosyasına kaydetmek, sorunları tespit etmenizi ve çözmenizi kolaylaştırır. console.error gibi fonksiyonları kullanarak veya özel bir loglama kütüphanesi ile bu işlemi otomatikleştirebilirsiniz.
*   Performans Optimizasyonu: Eğer botunuz çok sayıda kullanıcıya hizmet verecekse, API çağrılarını optimize etmek, veritabanı sorgularını hızlandırmak ve gereksiz işlemleri kaldırmak önemlidir. Örneğin, aynı gemi için arka arkaya yapılan API çağrılarını önbelleğe alarak (caching) tekrarlayan istekleri azaltabilirsiniz.
Bu gelişmiş özellikler, botunuzu basit bir bilgi sağlayıcıdan daha fazlası haline getirerek, Discord topluluğunuz için değerli bir araç haline getirecektir.
Vaka Analizi: Bir Lojistik Firması İçin Discord Gemi Takip Botu
Bir lojistik firması olan "DenizYolu Lojistik" düşünelim. Bu firma, müşterilerine ve operasyonel ekiplerine gemi takibi konusunda daha iyi bir hizmet sunmak istiyor. Mevcut durumda, müşteriler genellikle e-posta veya telefon yoluyla gemi konumlarını sorguluyorlar, bu da hem zaman alıcı hem de verimsiz bir süreç.
Problem: Müşterilerin ve operasyonel ekiplerin gemi konumlarını anlık olarak takip etmekte zorlanması, iletişimde gecikmeler ve potansiyel yanlış anlaşılmalar.
Çözüm: DenizYolu Lojistik, kendi Discord sunucusunda özel bir kanal oluşturarak, buraya entegre edilmiş bir gemi takip botu kullanmaya karar veriyor. Bot, müşterilerin ve yetkili personelin !takip gemi_adresi komutuyla belirli gemilerin canlı konumlarını, tahmini varış zamanlarını ve mevcut durumlarını (limanda, seyir halinde vb.) sorgulamasını sağlıyor.
Teknik Uygulama:
*   Veri Kaynağı: Firma, güvenilir bir gemi takip API sağlayıcısından (örneğin, AISHub veya ShipServ gibi profesyonel çözümler) veri alıyor. Bu API, gemilerin küresel konum verilerini (AIS - Automatic Identification System) sağlıyor.

*   Bot Geliştirme: Firma, Node.js ve Discord.js kullanarak özel bir bot geliştiriyor. Bot, !takip komutunu işliyor, API'ye gemi adı veya IMO numarası ile istek gönderiyor ve dönen veriyi anlaşılır bir dilde Discord'a iletiyor.

*   7/24 Çalışma: Bot, bir VPS üzerinde PM2 ile yönetiliyor. Bu sayede botun herhangi bir nedenle kapanması durumunda otomatik olarak yeniden başlatılması sağlanıyor.

*   Gelişmiş Özellikler: Bot, sadece anlık konum değil, aynı zamanda geminin tipini, boyutunu, yükünü (eğer API sağlıyorsa) ve bir sonraki limanını da gösteriyor. Ayrıca, belirli bir gemi limana yaklaştığında otomatik bildirim gönderme özelliği de ekleniyor. Bu bildirimler, ilgili departmanlara veya aboneliği olan müşterilere özel bir kanalda duyuruluyor.

*   Kullanıcı Yönetimi: Bot, hangi kullanıcıların hangi gemileri takip edebileceğini yönetmek için basit bir rol tabanlı erişim sistemiyle entegre ediliyor.
Sonuç: Bu Discord botu sayesinde DenizYolu Lojistik, müşteri hizmetlerini önemli ölçüde iyileştiriyor. Müşteriler artık kendi başlarına gemi konumlarını takip edebiliyor, operasyonel ekipler ise daha proaktif olabiliyor. İletişimdeki gecikmeler azalıyor ve genel verimlilik artıyor. Bu, teknoloji ve topluluk etkileşiminin nasıl bir araya gelerek iş süreçlerini optimize edebileceğine dair harika bir örnek teşkil ediyor.
Sıkça Sorulan Sorular (SSS)
*   Bu tür bir bot geliştirmek için hangi programlama dilini öğrenmeliyim?

    Node.js (JavaScript ile), Python (discord.py kütüphanesi ile) veya C# (Discord.Net ile) popüler seçeneklerdir. Node.js, özellikle web geliştirme geçmişi olanlar için öğrenmesi daha kolay olabilir.
*   Gemi takip API'leri genellikle ücretli midir?

    Evet, çoğu kapsamlı ve gerçek zamanlı gemi takip API'si ücretlidir. Ancak, bazı platformlar sınırlı veri veya daha yavaş güncellemelerle ücretsiz deneme sürümleri veya sınırlı ücretsiz planlar sunabilir. Projenizin gereksinimlerine göre bir araştırma yapmanız önerilir.
*   Botumun 7/24 çalışması için en uygun hosting çözümü nedir?

    Kişisel kullanım için veya düşük trafikli sunucular için Raspberry Pi gibi evde bir sunucu kullanmak mümkün olsa da, profesyonel ve kesintisiz hizmet için VPS (Virtual Private Server) veya bulut tabanlı hizmetler (AWS, Google Cloud, Azure) en iyi seçeneklerdir. Bu platformlar, botunuzun sürekli çevrimiçi kalmasını ve ölçeklenebilir olmasını sağlar.
*   Botumun güvenliği için nelere dikkat etmeliyim?

    En önemlisi, bot token'ınızı asla kimseyle paylaşmamalı ve kodunuza gömmemelisiniz. .env dosyası gibi ortam değişkenleri kullanarak token'ı güvenli bir şekilde saklayın. Ayrıca, botunuzun aldığı girdileri (kullanıcı komutları gibi) doğrulayarak olası güvenlik açıklarını önleyin.
*   Bu botu sadece gemi takibi için mi kullanabilirim?

    Hayır, bu mimari ve geliştirme yaklaşımı birçok farklı alanda kullanılabilir. Örneğin, hava durumu botları, haber botları, döviz kuru takip botları veya belirli bir spor dalındaki maç sonuçlarını bildiren botlar geliştirmek için de benzer bir yapı kurulabilir. Önemli olan, harici bir veri kaynağına erişim sağlamak ve bu veriyi Discord'da kullanıcılarla paylaşmaktır.
#DiscordBot #GemiTakibi #WebGeliştirme #API #Nodejs