~/oes-software
Node.js & Express ile Dünya Kupası (World Cup) RESTful API
GitHub Öne Çıkan Proje •

Node.js & Express ile Dünya Kupası (World Cup) RESTful API

Proje İncelemesi & Teknik Detaylar
### Proje Hakkında
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