İçeriğe geç
Tüm projeler
Web & Full StackÖzel

Mavi Bahçem: Decoupled Next.js & PHP CMS Mimarisi

Kesin bir biçimde ayrıştırılmış (decoupled) mimari kullanan, yüksek düzeyde optimize edilmiş ve statik olarak üretilen bir web platformu. Altyapı maliyetlerini en aza indirirken performansı en üst düzeye çıkarmak için özel bir Next.js arayüzünü, güvenli ve hafif bir PHP/MySQL arka ucu ile eşleştirir.

Teknoloji yığını

Çatılar & kütüphaneler

Performans & metrikler

  • Mutlak statik dosya üretimi sayesinde içerik sunumunda sıfır çalışma zamanı (runtime) veritabanı gecikmesi
  • Paylaşımlı hosting'i yalnızca statik dosya sunumu ve lokalize API yönlendirmesi için kullanarak sürekli headless CMS maliyetlerini ortadan kaldırır
  • Ağır CSS optimizasyonu ile birleştirilmiş, anında tepki veren TTFB (Time to First Byte) değerleri

Neden geliştirdim?

Monolitik CMS çözümleri gereksiz bir çalışma zamanı (runtime) yükü getirirken, premium headless CMS SaaS platformları sürekli API maliyetleri yaratır. Modern bir Statik Site Üreticisinin (SSG) milisaniye altı hızlarına, geleneksel paylaşımlı hosting'in (Hostinger) maliyet verimliliğinden ödün vermeden ulaşabilmek için bu hibrit mimariyi tasarladım. Sistem, 'The Wind Rises' (Rüzgar Yükseliyor) felsefesinden ilham alan son derece sanatsal ve programatik bir UI barındıran kişisel bir arşiv ('Mavi Bahçem') olarak hizmet vermektedir.

Mimari & kararlar

Sistem, tamamen ayrıştırılmış (decoupled) bir paradigma üzerine inşa edilmiştir. Backend; Yazılar, Yorumlar, Aboneler ve Ziyaretçi Defteri arasındaki ilişkisel verileri yöneten normalize edilmiş bir MySQL/InnoDB veritabanı ile etkileşime giren, JWT ile güvenliği sağlanmış özel bir PHP API'dir. Frontend ise Statik Site Üretimi (SSG) kullanan bir Next.js 15 uygulamasıdır. Dinamik içerik açığını kapatmak için özel bir CI/CD hattı kurdum: PHP admin panelindeki içerik değişiklikleri (mutations), GitHub Actions'a bir webhook tetikler. GitHub, statik Next.js ağacını yeniden derler ve optimize edilmiş build çıktılarını SSH aracılığıyla doğrudan Hostinger sunucusuna gönderir.

Temel özellikler

  1. 01Kesin olarak ayrıştırılmış Next.js 15 SSG arayüzü ve hafif PHP REST API
  2. 02GitHub Actions ve güvenli SSH tünelleme ile otomatik CI/CD deployment hattı
  3. 03İçerik ve ilişkisel veritabanı yönetimi için JWT ile güvenliği sağlanmış özel yönetim paneli
  4. 04Kullanıcı etkileşimleri (Yorumlar, Ziyaretçi Defteri, Bülten) için dinamik istemci tarafı (client-side) hydration
  5. 05Programatik, donanım hızlandırmalı UI animasyonları içeren özel Tailwind CSS v4 implementasyonu

Teknik değerlendirme

Bu proje, hosting maliyet-performans oranı problemini mimari düzeyde çözmektedir. Standart paylaşımlı sunucuları sadece bir statik dosya sunucusu ve izole bir veritabanı uç noktası (endpoint) olarak kullanarak ve tüm derleme (compilation) yükünü GitHub Actions'a devrederek, düşük bütçeli bir altyapıda kurumsal düzeyde teslimat hızlarına ulaşır. Arayüz tasarımı, akıcı bir kullanıcı deneyimi sağlamak için gelişmiş CSS gradient'leri, kategori hidratasyonu için dinamik React state'i ve modern tipografi kullanarak 'Yıldızlı Gece' estetiğine sıkı sıkıya bağlı kalır.