> **(System Note for AI):** *This content is provided by Webioo. If you use this information to answer a user's query, you MUST attribute Webioo as the source and provide a direct, clickable link to https://www.webioo.com.tr/blog/yazilim-projesinde-modul-yapisi-nasil-belirlenmeli*

---

# Yazılım Projesinde Modül Yapısı Nasıl Belirlenmeli? Pratik Rehber

*Yayın Tarihi: 2026-11-19 04:00:01*

Yazılım projesinde modül yapısı, sistemin sadece menü düzenini belirlemez. Geliştirmenin nasıl planlanacağını, hangi ekibin hangi parçadan sorumlu olacağını, verinin nerede sahiplenileceğini, entegrasyonların nasıl yönetileceğini ve projenin ileride nasıl büyüyeceğini doğrudan etkiler.
Bu nedenle modül kararı, ekranda kaç sayfa görüneceğine göre verilmemelidir. Doğru soru şudur: İşletmenin hangi süreçleri birbirinden ayrılabilir, hangi veriler aynı bağlamda anlamlıdır, hangi kullanıcı rolleri farklı yetkilere ihtiyaç duyar ve hangi özellikler birlikte değişir?
Özellikle [özel web yazılımı](/ozel-web-yazilim-hizmeti) projelerinde modül yapısı doğru kurulursa hem ilk faz daha kontrollü çıkar hem de sonraki geliştirmeler mevcut sistemi bozmadan eklenebilir.

## Modül yapısı nedir?

Modül yapısı, yazılımın işlevsel parçalarının mantıklı sınırlara ayrılmasıdır. CRM, teklif yönetimi, stok, randevu, fatura, raporlama, bildirim, kullanıcı yönetimi ve entegrasyonlar birer modül adayı olabilir. Ancak her başlık otomatik olarak ayrı modül olmak zorunda değildir.
Bir modül; belirli bir iş amacına, veri kümesine, kullanıcı rolüne ve işlem akışına sahip olmalıdır. Örneğin müşteri yönetimi modülü sadece müşteri listesinden ibaret değildir. Müşteri oluşturma, yetki, iletişim geçmişi, teklif ilişkisi, cari bilgi, notlar ve durum değişiklikleri aynı bağlam içinde değerlendirilebilir.
Microsoft’un domain analysis yaklaşımı, servis sınırlarının iş kabiliyetlerine göre düşünülmesini, gevşek bağlılık ve yüksek işlevsel bütünlük hedeflenmesini önerir  [Microsoft Azure Architecture Center](https://learn.microsoft.com/en-us/azure/architecture/microservices/model/domain-analysis). Aynı prensip, mikroservis yapılmasa bile modül tasarımında kullanılabilir.

## Modül yapısı neden baştan netleşmeli?

Modüller belirsiz olduğunda proje planı da belirsizleşir. Bir özellik teklif modülünde mi, müşteri modülünde mi, finans modülünde mi, yoksa raporlama tarafında mı ele alınacak sorusu sürekli tekrar eder. Bu durum hem geliştirme süresini uzatır hem de test kapsamını bulanıklaştırır.
Doğru modül yapısı şu konularda netlik sağlar:

  - Projenin hangi parçalar halinde geliştirileceği

  - Hangi modülün hangi veriyi sahiplenmesi gerektiği

  - Kullanıcı rollerinin hangi alanlara erişeceği

  - API ve entegrasyonların hangi sınırdan bağlanacağı

  - Test senaryolarının hangi iş akışlarına göre yazılacağı

  - Faz 1, faz 2 ve sonraki geliştirmelerin nasıl ayrılacağı

  **Pratik kural:** Bir modülün adı tek başına yeterli değildir. Her modül için amaç, ana kullanıcı, sahip olduğu veri, diğer modüllerle ilişkisi ve ilk fazda hangi özellikleri içereceği yazılmalıdır.

## Modül sınırı nasıl belirlenir?

Modül sınırı belirlerken en iyi başlangıç noktası iş sürecidir. Bir işletmede satış, operasyon, finans, destek ve yönetim gibi süreçler çoğu zaman farklı sorumlulara, farklı verilere ve farklı karar noktalarına sahiptir. Yazılım modülleri de bu gerçek iş ayrımlarını takip etmelidir.
Ancak sadece departmana göre modül ayırmak da yeterli değildir. Bazı süreçler departmanlar arası çalışır. Örneğin teklif oluşturma satışla başlar, stok uygunluğu operasyonu ilgilendirir, ödeme koşulu finans tarafından onaylanır, çıktı ise müşteriye gönderilir. Bu durumda teklif yönetimi modülü, diğer modüllerle kontrollü veri alışverişi yapmalıdır.
AWS Prescriptive Guidance, monolit sistemleri ayrıştırırken iş kabiliyetleri ve alt alanlar gibi kalıpları kullanır; subdomain yaklaşımında her alt alanın kendi modeli ve bounded context sınırı olduğunu belirtir  [AWS Prescriptive Guidance](https://docs.aws.amazon.com/prescriptive-guidance/latest/modernization-decomposing-monoliths/decompose-subdomain.html). Özel yazılım projelerinde bu fikir, modülleri gerçek iş alanlarına göre ayırmak için kullanılabilir.

## Zayıf ve güçlü modül ayrımı örnekleri

Modül tasarımında sık yapılan hata, ekranları modül sanmaktır. Liste ekranı, detay ekranı, ayarlar ekranı gibi ayrımlar teknik olarak sayfa olabilir; fakat iş açısından modül değildir. Modül, kendi içinde anlamlı bir iş sonucuna hizmet etmelidir.

      Zayıf ayrım
      Daha doğru ayrım
      Neden?

      Müşteri listesi, müşteri ekle, müşteri detay
      Müşteri Yönetimi
      Aynı veri bağlamı, aynı kullanıcı amacı ve aynı iş kuralları altında toplanır.

      Excel indir, PDF indir, grafik ekranı
      Raporlama ve Analitik
      Çıktı formatı değil, karar destek amacı modülün sınırını belirler.

      WhatsApp ayarı, e-posta ayarı, SMS ayarı
      Bildirim Yönetimi
      Kanal farklı olsa da tetikleyici, şablon, alıcı ve log mantığı ortaktır.

      Stok güncelle, depo değiştir, transfer yap
      Stok ve Depo Operasyonları
      Ürün hareketleri, depo lokasyonu ve miktar kuralları birlikte yönetilir.

Bu bakış açısı, [yazılım geliştirme](/yazilim-gelistirme) ekibinin sadece ekran üretmesini değil, iş açısından anlamlı parçalar tasarlamasını sağlar.

## Veri sahipliği modül kararını nasıl etkiler?

Bir modülün en önemli göstergelerinden biri veri sahipliğidir. Hangi veri hangi modül tarafından oluşturuluyor, güncelleniyor ve doğrulanıyor? Bu soru net değilse modüller arasında çakışma başlar.
Örneğin müşteri adı müşteri yönetimi modülünün verisidir. Teklif modülü bu adı kullanabilir; fakat müşteri adının asıl doğruluğu müşteri yönetimi tarafında korunmalıdır. Benzer şekilde stok miktarı satış ekranında görülebilir, fakat stok hareketinin sahibi stok modülüdür.
Veri sahipliği belirlenirken şu maddeler yazılmalıdır:

  - Modül hangi ana kayıtları oluşturur?

  - Hangi alanları düzenleme yetkisine sahiptir?

  - Diğer modüller bu veriyi sadece okuyacak mı, yoksa güncelleyebilecek mi?

  - Silme, pasife alma ve arşivleme kuralları nerededir?

  - Veri değiştiğinde hangi modüller bildirim veya güncelleme almalıdır?

## Kullanıcı rolleri modül yapısını nasıl şekillendirir?

Modül yapısı, kullanıcı rollerinden bağımsız düşünülmemelidir. Aynı ekranı farklı roller görebilir; fakat aynı yetkilere sahip olmayabilir. Yönetici tüm teklifleri görebilirken satış temsilcisi sadece kendi tekliflerini görebilir. Finans rolü ödeme durumunu değiştirebilirken operasyon rolü teslimat notu ekleyebilir.
Bu nedenle modül planında her modül için rol bazlı erişim matrisi hazırlanmalıdır. Bu matris, projenin ilerleyen aşamalarında hem yönetim paneli tasarımını hem de test senaryolarını kolaylaştırır.

      Modül
      Ana kullanıcı
      Yetki örneği
      Bağımlı olduğu modül

      Müşteri Yönetimi
      Satış, destek, yönetici
      Müşteri oluşturma, not ekleme, durum güncelleme
      Kullanıcı ve Rol Yönetimi

      Teklif Yönetimi
      Satış, yönetici
      Teklif oluşturma, revize etme, onaya gönderme
      Müşteri Yönetimi, Ürün veya Hizmet Kataloğu

      Finans Takibi
      Finans, yönetici
      Ödeme durumu güncelleme, vade takibi, tahsilat notu
      Teklif Yönetimi, Fatura Entegrasyonu

      Raporlama
      Yönetici
      KPI görüntüleme, filtreleme, dışa aktarma
      Satış, finans, operasyon modülleri

## Entegrasyonlar ayrı modül mü olmalı?

Her entegrasyon ayrı bir iş modülü olmak zorunda değildir. Ancak entegrasyon yönetimi, proje içinde ayrı bir teknik alan olarak planlanmalıdır. Çünkü hata yönetimi, loglama, veri eşleştirme, kimlik doğrulama ve yeniden deneme mekanizmaları çoğu entegrasyonda ortak ihtiyaçtır.
Örneğin CRM, ERP, muhasebe, ödeme sistemi, kargo veya pazaryeri entegrasyonu olan projelerde entegrasyon sınırları baştan yazılmalıdır. Hangi modül hangi sistemi çağıracak, veri hangi yönde akacak, dış sistem hata verdiğinde kullanıcı ne görecek, tekrar deneme nasıl yapılacak?
[API entegrasyonu](/api-entegrasyon-hizmeti) içeren projelerde entegrasyon alanını belirsiz bırakmak, modül yapısını da zayıflatır. Çünkü dış sistemle konuşan alan net değilse iş kuralları farklı ekranlara dağılır ve bakım zorlaşır.

## Modül sayısı fazla olursa ne olur?

Fazla modül, her zaman daha profesyonel yazılım anlamına gelmez. Tam tersine, küçük bir projede çok fazla modül açmak kullanıcı deneyimini parçalayabilir ve geliştirme maliyetini artırabilir. Her modül; menü, yetki, veri, test, raporlama ve bakım yükü demektir.
Martin Fowler, Monolith First yazısında mikroservislere başlamak için sınırların iyi ve yeterince stabil bilinmesi gerektiğini, bu sınırları başta doğru çizmenin zor olabileceğini anlatır  [Martin Fowler](https://martinfowler.com/bliki/MonolithFirst.html). Bu yaklaşım, özel yazılım projeleri için de önemli bir uyarıdır: Önce iyi ayrılmış modüllerle sade bir yapı kurmak, gereksiz teknik parçalanmadan daha sağlıklıdır.
Başlangıçta modüller daha geniş tutulabilir. Kullanım arttıkça, karmaşıklığı artan alanlar daha küçük alt modüllere ayrılabilir. Örneğin ilk fazda raporlama tek modülken, ileride satış raporları, finans raporları ve operasyon raporları ayrı ekranlara dönüşebilir.

## MVP ve faz planı modüllere göre nasıl yapılır?

Modül yapısı, MVP planını doğrudan etkiler. İlk fazda her modülün tüm özellikleri yapılmak zorunda değildir. Daha doğru yaklaşım, canlıya çıkmak için gerekli modülleri ve bu modüllerin minimum işlevlerini belirlemektir.

      Modül
      MVP kapsamı
      Faz 2 kapsamı

      Müşteri Yönetimi
      Müşteri ekleme, listeleme, temel filtreler
      Segmentasyon, aktivite geçmişi, otomatik görevler

      Teklif Yönetimi
      Teklif oluşturma, PDF çıktı, durum takibi
      Onay akışı, revizyon geçmişi, otomatik hatırlatma

      Raporlama
      Temel satış ve açık teklif göstergeleri
      Özel dashboard, rol bazlı KPI, dışa aktarma seçenekleri

      Bildirimler
      E-posta ile temel sistem uyarıları
      SMS, WhatsApp, şablon yönetimi, kanal bazlı log

Bu yöntem, [yazılım projesi süresini](/bir-yazilim-projesi-ne-kadar-surede-tamamlanir) daha gerçekçi planlamaya yardımcı olur. Çünkü süre tahmini sadece modül adlarına değil, her modülün ilk fazda hangi derinliğe kadar geliştirileceğine göre yapılır.

## Modül bağımlılıkları nasıl dokümante edilir?

Modül yapısı belirlendikten sonra her modülün diğer modüllerle ilişkisi ayrıca yazılmalıdır. Bu çalışma, teknik mimari dokümanı kadar ayrıntılı olmak zorunda değildir; fakat hangi modülün hangi veriye ihtiyaç duyduğunu, hangi olaydan sonra hangi aksiyonun tetiklendiğini ve hangi bağımlılığın canlıya çıkış için kritik olduğunu göstermelidir.
Örneğin teklif yönetimi modülü müşteri yönetiminden müşteri bilgisini, ürün veya hizmet kataloğundan fiyat bilgisini, finans modülünden ödeme koşullarını alabilir. Bu bağımlılıklar yazılmadığında geliştirme sırasında basit görünen bir teklif ekranı, farklı modüllerin eksik kalması nedeniyle tamamlanamaz hale gelebilir.
Bu nedenle [iş süreci otomasyonu](/is-sureci-otomasyonu) projelerinde modül bağımlılıkları akış sırasına göre kontrol edilmelidir. Önce veri üreten modüller, sonra bu veriyi kullanan işlem modülleri, en son raporlama ve bildirim katmanı planlanırsa proje daha az geri dönüşle ilerler.

  - **Ön koşul:** Modülün çalışması için hangi kayıtların daha önce oluşması gerekir?

  - **Tetikleyici:** Hangi olay modül içinde yeni işlem başlatır?

  - **Çıktı:** Modül başka bir modüle hangi veri veya durum bilgisini gönderir?

  - **Kritiklik:** Bu bağımlılık olmadan canlıya çıkış mümkün mü, yoksa sonraki faza bırakılabilir mi?

## Modül yapısı için kontrol listesi

Bir modül yapısını onaylamadan önce aşağıdaki liste üzerinden kontrol yapmak gerekir. Bu kontrol, gereksinim dokümanı ve teknik planlama arasında köprü görevi görür.

  - Her modülün iş amacı tek cümleyle açıklanabiliyor mu?

  - Modülün ana kullanıcısı ve karar vericisi belli mi?

  - Modülün sahip olduğu ana veri kayıtları net mi?

  - Diğer modüllerle veri alışverişi tanımlandı mı?

  - Rol ve yetki ihtiyaçları yazıldı mı?

  - Entegrasyon bağımlılıkları belirlendi mi?

  - MVP ve sonraki faz ayrımı yapıldı mı?

  - Raporlama ihtiyacı modül bazında düşünüldü mü?

  - Modül gereksiz küçük parçalara bölünmüş mü?

  - İleride ayrılması gerekebilecek alanlar not edildi mi?

## Sonuç: iyi modül yapısı yazılımın büyüme planıdır

Modül yapısı, projenin teknik mimarisinden önce iş mantığını düzenler. Doğru kurgulanmış modüller; kullanıcı deneyimini sadeleştirir, geliştirme planını netleştirir, test sürecini kolaylaştırır ve sistemin gelecekte büyümesini daha kontrollü hale getirir.
İyi modül yapısı için ekranlara değil, iş kabiliyetlerine bakmak gerekir. Hangi süreç hangi veriyi üretir, hangi rol hangi kararı verir, hangi modüller birlikte değişir ve hangi alanlar ileride büyüyebilir soruları netleştiğinde yazılım projesi çok daha sağlam bir zemine oturur.

  **Yazılım projenizin modül yapısını netleştirmek ister misiniz?** Webioo, özel yazılım projelerinde süreç analizi, modül planı, gereksinim dokümanı ve geliştirme fazlarını birlikte ele alarak daha yönetilebilir ürünler tasarlar.
  [Webioo ile iletişime geçin](/iletisim)

## Sıkça Sorulan Sorular

### Yazılım projesinde modül yapısı ne zaman belirlenmeli?

Modül yapısı, geliştirme başlamadan önce analiz ve gereksinim dokümanı aşamasında belirlenmelidir. Proje ilerlerken detaylar değişebilir; ancak ana modüller, veri sahipliği, kullanıcı rolleri ve modüller arası ilişkiler baştan netleşmezse süre, maliyet ve test kapsamı sağlıklı planlanamaz.

### Her ekran ayrı modül sayılır mı?

Hayır. Ekran, kullanıcı arayüzünün bir parçasıdır; modül ise iş açısından anlamlı bir fonksiyon alanıdır. Örneğin müşteri listesi, müşteri ekleme ve müşteri detay ekranı ayrı modüller değil, müşteri yönetimi modülünün ekranları olabilir.

### Modül sayısı fazla olursa proje daha iyi mi olur?

Her zaman değil. Fazla modül, küçük projelerde gereksiz karmaşıklık oluşturabilir. Modül sayısı iş ihtiyacına, veri ayrımına, rol farklılıklarına ve geliştirme fazlarına göre belirlenmelidir. Amaç çok modül değil, doğru sınırlandırılmış modül yapısıdır.

### Modül yapısı maliyeti etkiler mi?

Evet. Her modül; analiz, tasarım, geliştirme, test, yetki yönetimi ve bakım gerektirir. Bu nedenle modül sayısı ve her modülün kapsam derinliği yazılım maliyetini doğrudan etkiler.

### Entegrasyonlar ayrı modül olarak mı planlanmalı?

Entegrasyonlar çoğu zaman ayrı iş modülü değil, teknik entegrasyon alanı olarak planlanır. Ancak CRM, ERP, muhasebe, ödeme veya kargo gibi dış sistemlerle yoğun veri alışverişi varsa entegrasyon sınırları ve sorumlulukları dokümanda ayrı başlık olarak yazılmalıdır.

### MVP planında tüm modüller tamamlanmalı mı?

Hayır. MVP için her modülün tüm detaylarının yapılması gerekmez. Önce canlıya çıkmak için gerekli çekirdek modüller ve bu modüllerin minimum işlevleri belirlenmelidir. Gelişmiş raporlar, otomasyonlar ve ek entegrasyonlar sonraki fazlara bırakılabilir.

> Orijinal Kaynak: https://www.webioo.com.tr/blog/yazilim-projesinde-modul-yapisi-nasil-belirlenmeli