3.2 | Dosya Mimarisi: Ölçeklenebilir Yapılar

Bir yazılım projesinde dosyaların yerleşimi, tıpkı bir evin oda düzeni gibidir. Proje büyüdükçe bu düzenin esnemesi ama asla bozulmaması gerekir. Bu bölümde, projenizin büyüklüğüne göre nasıl bir iskelet kurmanız gerektiğini ve platformlar arasındaki temel farkları inceleyeceğiz.

1. Ölçek Farkı: Küçükten Büyüğe Mimari

Yazılım mimarisi "tek beden her şeye uyar" mantığıyla çalışmaz. Projenizin ihtiyacına göre şu yaklaşımları benimseyebilirsiniz:

• Küçük Ölçekli (Flat Structure): Eğer tek sayfalık bir araç veya basit bir prototip yapıyorsanız, her şeyi birkaç ana klasörde toplayabilirsiniz. Karmaşadan uzak, erişimi hızlıdır.
• Orta ve Büyük Ölçekli (Feature-Based): Projeniz genişledikçe dosyaları işlevlerine göre değil, özelliklerine (Login, Sepet, Profil gibi) göre ayırmalısınız. Bu, yapay zekanın hata ararken tüm projeyi değil, sadece ilgili "odayı" taramasını sağlar.

[Image of comparison between flat structure and feature-based folder structure]

2. Web ve Mobil Farklılıkları

Yazılım geliştirdiğiniz platform, dosya isimlerini ve hiyerarşisini belirler. Ancak temel mantık değişmez:

• Mobil (Örn. Flutter): Genellikle lib klasörü altında iş mantığı (business logic) ve arayüz (UI) ayrılır.
• Web (Örn. React/Next.js): components, pages ve public gibi standart klasör isimleri üzerinden ilerler.
• Önemli: Bu seride ayrıntılara boğulmasak da, her platformun kendine has bir "yoğurt yiyişi" olduğunu ve profesyonelleştikçe bu standartları öğrenmenin kritik olduğunu bilmelisiniz.

3. Kodbil Denetimi: Haritaya Hakim Olun

Mimari ne kadar karmaşık olursa olsun, bir yazılımcının en büyük görevi projenin haritasına hakim olmaktır. Yapay zeka dosya oluştururken ona müdahale edebilmeli ve "Bu dosya yanlış klasörde, onu ilgili bölüme taşı" diyebilmelisiniz. Kod okuryazarlığı sadece kodu değil, projenin tüm yapısını okuyabilmektir.

[Image of project tree navigation in a modern code editor]

4. Sonuç: Neden Düzen Şart?

Düzensiz bir proje, bir süre sonra yapay zekanın da kafasını karıştırmaya başlar. Yanlış yönlendirilen bir ajan, birbirini tekrar eden veya birbiriyle çelişen kodlar üretir. Temiz bir mimari, temiz bir akıl ve hızlı bir gelişim demektir.

Sözlük (Glossary)

• Flat Structure (Düz Yapı): Dosyaların klasörlere ayrılmadan, tek bir ana dizinde toplandığı basit yerleşim düzenine denir.
• Feature-Based (Özellik Tabanlı): Dosyaların "Giriş" veya "Ödeme" gibi uygulama özelliklerine göre gruplanması yöntemine denir.
• Hiyerarşi: Dosya ve klasörlerin birbiriyle olan alt-üst ve sahiplik ilişkisini gösteren sıralama düzenine denir.

Sonraki Adım: Uygulamanızı dünyaya açmaya hazırlanın: 4.0 | Ekosistem Yönetimi: Git, Terminal ve Yayınlama.