IHS Strategic
Tüm Blog Yazıları
HowTo09 Eylül 2026•2 dk okuma

Micro-Frontend Mimarisi: Büyük Ölçekli Projelerde Takım Yönetimi Rehberi

Büyük ölçekli modern web projelerinde monolitik frontend yapılarını mikro parçalara bölerek bağımsız takımlar kurma, entegrasyon yöntemlerini seçme ve dağıtık süreçleri yönetme adımları.

S

Sistem Yöneticisi

Kıdemli Yazılım Mimarı

1. Monolit Yapıdan Micro-Frontend Mimarisine Geçiş

Büyük ölçekli sistemlerde tek repo ve monolitik frontend, ekip büyüdükçe darboğaz oluşturur. Micro-frontend mimarisi; kullanıcı arayüzünü bağımsız deploy edilebilen, kendi iş mantığına sahip küçük parçalara ayırır. Conway Yasası uyarınca sistem mimarisi organizasyon yapısını yansıtır. Her takım kendi etki alanını (domain) uçtan uca yönetir.

2. Adım Adım Micro-Frontend Kurulumu ve Takım Entegrasyonu

Adım 1: Sınırları Belirleyin (Domain-Driven Design)

Uygulamayı teknik katmanlara göre değil, iş alanlarına göre bölün. Örneğin: Kimlik doğrulama, sepet/ödeme, ürün kataloğu ve kullanıcı profili.

  • Her etki alanı tek bir takıma atanır.
  • Takımlar kendi kod tabanını, testlerini ve release döngülerini yönetir.

Adım 2: Uygun Entegrasyon Yöntemini Seçin

Proje ihtiyacına göre entegrasyon yöntemi belirlenmelidir:

  • Module Federation (Vite / Webpack 5): Çalışma zamanında (runtime) dinamik yükleme sağlar. En popüler modern web çözümüdür.
  • Web Components (Custom Elements): Framework bağımsızdır. Tarayıcı yerel API'lerini kullanır.
  • Routing / Reverse Proxy Seviyesinde: URL bazlı farklı SPA'ları sunar (Örn: Nginx, Cloudflare Workers). Basit ve risksiz geçiş sağlar.

Adım 3: Ortak Tasarım Sistemi (Design System) ve Bağımlılık Yönetimi

Arayüz bütünlüğü ve performans için ortak kurallar şarttır:

  • Paylaşılan UI bileşenleri için bağımsız bir npm paketi veya federated kütüphane oluşturun.
  • Kütüphane sürümlerini sabitleyin (singleton dependencies) ve çifte yükleme (duplicate bundle) sorunlarını engelleyin.
  • CSS izolasyonu için CSS Modules, Tailwind CSS scoping veya Shadow DOM kullanın.

Adım 4: Bağımsız CI/CD Dağıtım Hatları Kurun

Bir takımın dağıtımı diğerini durdurmamalıdır.

  • Her micro-frontend bağımsız S3/CDN bucket'ına deploy edilir.
  • Host uygulama (shell), uzak manifest dosyasından modül adreslerini dinamik çeker.
  • Hata anında sadece sorunlu modül geri alınır (rollback).

3. Takım Yönetimi ve Organizasyonel Stratejiler

Dağıtık ekipler ve dijital ajans işbirliklerinde yönetim net protokollere dayanmalıdır:

  • Otonomi ve Sorumluluk: Takımlar kendi CI/CD, hata izleme ve kod kalitesinden tam sorumludur.
  • Core / Governance Ekibi: Shell (kabuk) uygulamayı, ortak auth mekanizmasını ve global state stratejisini yöneten merkezi bir çekirdek ekip oluşturun.
  • İletişim Protokolü: Modüller arası doğrudan event paylaşımından kaçının. Tarayıcı yerel CustomEvent veya basit bir event bus kullanın.

4. Modern Web ve Gelecek Trendler

Micro-frontend ekosistemindeki güncel trendler şunlardır:

  • Edge Side Composition: SSR ile birleştirilmiş micro-frontendlerin CDN seviyesinde derlenmesi.
  • Import Maps: Tarayıcı yerel ESM modül desteği ile sıfır konfigürasyonlu runtime entegrasyon.
  • Multi-Framework Stratejileri: Farklı teknolojilerin (React, Vue, Svelte) aynı kabukta izolasyonu.

5. Kaçınılması Gereken Hatalar

Mikro servislerdeki veri tutarlılığı riskleri micro-frontend mimarisinde DOM ve State çakışması olarak ortaya çıkar. Global state (Redux/Zustand) nesnelerini modüller arasında zorunlu olmadıkça paylaştırmayın.
  • Payload Şişmesi: React core paketini 5 farklı micro-frontend içinde 5 kez tarayıcıya yükletmeyin.
  • Aşırı Parçalama: Bir buton veya form için ayrı micro-frontend açmayın. Bounded context dışına çıkmayın.