Accommodation API

Accommodation API, modern mikroservis mimarisi ile geliştirilmiş kapsamlı bir konaklama yönetim sistemidir. Proje, ev sahipleri, misafirler ve admin kullanıcıları için özel servisler sunar. Her servis bağımsız çalışabilir ve kendi veritabanına sahiptir. Bu sayede sistemin bir bölümünde yaşanan sorun diğer servisleri etkilemez. API Gateway üzerinden tüm servisler merkezi bir noktadan yönetilir.

Proje 5 ana servisten oluşur: 1. Auth Service: Kullanıcı kayıt ve giriş işlemleri 2. Host Service: Ev sahipleri için mülk listeleme ve yönetim 3. Guest Service: Misafirler için rezervasyon, ödeme ve yorum 4. Admin Service: Sistem yöneticileri için genel denetim 5. API Gateway: Tüm servisleri merkezi noktadan yönlendirir Her servis kendi MongoDB veritabanına sahiptir ve Express.js ile geliştirilmiştir.

JWT (JSON Web Token) tabanlı güvenli kimlik doğrulama sistemi. Kullanıcılar kayıt olurken rollerini seçer: Host, Guest veya Admin. Her rol farklı yetkilere sahiptir: - Host: Mülk ekleyebilir, düzenleyebilir ve silebilir - Guest: Rezervasyon yapabilir, ödeme gerçekleştirebilir ve yorum yazabilir - Admin: Tüm mülkleri görebilir ve sistemi yönetebilir Token-based authentication sayesinde her istekte kullanıcı doğrulaması yapılır.

Host servisi, ev sahiplerinin mülklerini yönetmesini sağlar: - Yeni mülk ekleme (başlık, açıklama, fiyat, konum, fotoğraf) - Mevcut mülkleri görüntüleme ve düzenleme - Mülk silme işlemleri - Mülk durumu güncelleme (müsait/dolu) - Rezervasyon taleplerini görüntüleme Her mülk, MongoDB'de detaylı bilgilerle saklanır ve sadece sahibi tarafından düzenlenebilir.

Guest servisi, misafirlerin konaklama rezervasyonu yapmalarını sağlar: - Mevcut mülkleri arama ve listeleme - Tarih, konum ve fiyata göre filtreleme - Rezervasyon oluşturma - Ödeme işlemleri (RabbitMQ ile asenkron) - Rezervasyon iptali ve iade - Konaklama sonrası yorum ve değerlendirme Ödeme işlemleri RabbitMQ kuyruğuna gönderilir ve arka planda işlenir.

Admin servisi, sistem yöneticilerine kapsamlı kontrol sağlar: - Tüm mülkleri görüntüleme ve yönetme - Kullanıcı hesaplarını inceleme - Şüpheli mülkleri silme veya askıya alma - Sistem geneli raporlama - İstatistik ve analiz verileri Admin paneli, tüm servislere erişim yetkisi olan merkezi bir yönetim arayüzüdür.

RabbitMQ, ödeme ve iade işlemlerinin asenkron olarak gerçekleştirilmesini sağlar: - Payment Queue: Ödeme istekleri kuyruğa eklenir - Refund Queue: İade işlemleri ayrı kuyrukta işlenir - Worker Process: Arka planda kuyrukları dinler ve işler - Error Handling: Başarısız işlemler tekrar kuyruğa eklenir Bu sayede ödeme işlemleri API yanıt süresini etkilemez ve sistem performansı artar.

Merkezi API Gateway, tüm mikroservisleri yönlendirir: - /auth/* → Auth Service - /host/* → Host Service - /guest/* → Guest Service - /admin/* → Admin Service express-http-proxy kullanılarak istekler ilgili servislere yönlendirilir. Bu sayede frontend tek bir endpoint üzerinden tüm servislere erişebilir.

Proje geliştirme sürecinde karşılaşılan zorluklar: 1. RabbitMQ Docker olmadan kurulum: Manuel kurulum ve konfigürasyon 2. API Gateway port yönlendirme: express-http-proxy ile çözüldü 3. Servisler arası iletişim: RESTful API ve message queue kombinasyonu 4. Veritabanı yönetimi: Her servis için ayrı MongoDB instance Bu zorluklar, mikroservis mimarisinin karmaşıklığını ve çözüm üretme becerisini gösterir.