orhanefesacli.com/proje/3
~/oes-software
GitHub
Öne Çıkan Proje
•
Node.js & Express ile Dünya Kupası (World Cup) RESTful API
Proje İncelemesi & Teknik Detaylar
Bu proje, futbol Dünya Kupası turnuvalarına ait takım, maç, grup ve istatistik verilerini yönetmek amacıyla **Node.js** ve **Express.js** kullanılarak geliştirilmiş modüler bir **Dünya Kupası RESTful API** servisidir.
Frontend sistemlerinden bağımsız olarak çalışan bu servis; turnuva verilerinin sorgulanması, filtreleme, yeni maç/takım verisi eklenmesi ve mevcut kayıtların yönetilmesi (CRUD) süreçlerini standart HTTP protokolleri üzerinden sunar.
---
### Öne Çıkan Özellikler ve Mimari
* Katmanlı Mimari (Separation of Concerns): Rotalar (Routes), Denetleyiciler (Controllers) ve İş Mantığı (Services) katmanları temiz kod ilkelerine uygun olarak modüler yapıda kurgulanmıştır.
* RESTful API Standartları: Anlamlı kaynak adlandırmaları (/api/v1/matches, /api/v1/teams), doğru HTTP metodları (GET, POST, PUT, DELETE) ve standart yanıt kodları (200 OK, 201 Created, 404 Not Found) kullanılmıştır.
* Modern ES Modules (ESM): Geleneksel CommonJS yerine güncel JavaScript import/export standartlarıyla yazılmıştır.
* Merkezi Hata Yönetimi (Global Error Handling): Rotalarda oluşabilecek teknik aksaklıkları ve bulunamayan kaynakları yakalayarak istemciye standart JSON formatında yanıt dönen ara yazılım (Middleware) mimarisi entegre edilmiştir.
---
### Teknoloji Yığını
* Runtime Environment: Node.js
* Web Framework: Express.js
* Modül Yapısı: ES Modules (ESM)
* API Test ve Dokümantasyon: Postman / REST Client
---
### Temel API Rotaları (Endpoints)
* GET /api/v1/teams — Turnuvaya katılan takımları listeler.
* GET /api/v1/matches — Tüm maç sonuçlarını ve fikstürü getirir.
* GET /api/v1/matches/:id — Spesifik bir maçın detay verisini sunar.
* POST /api/v1/matches — Yeni bir maç sonucu/verisi kaydeder.
* PUT /api/v1/matches/:id — Belirtilen maçın skor veya detay bilgilerini günceller.
* DELETE /api/v1/matches/:id — Belirtilen maçı sistemden siler.
Proje Künyesi
Kategori / Tür
GitHub
Geliştirici
Orhan Efe Saçlı (OES)
Yayın Tarihi
16 Ekim 2026
Kaynak & Lisans
Açık Kaynak (GitHub)
Bir Projeniz mi Var?
Modern web mimarileri, backend API çözümleri veya kurumsal yazılımlarınız için hemen iletişime geçin.
İletişime Geçin