Yeni bir projede ilk engel çoğu zaman kod yazmak değil, doğru kodu bulmaktır. Klasörlerin adlarını bilmek tek başına yeterli olmaz; bir isteğin hangi dosyalardan geçtiğini anlamak gerekir. Codex’ten bir kod tabanını tanımasını isterken, somut bir kullanıcı akışını merkez almak daha kullanışlı bir başlangıçtır.
Klasör listesi yerine bir akışı izleyin
Örnek olarak “kategori sayfasında son yazıları gösterme” davranışını seçelim. Tarayıcıdaki adres hangi rotaya gidiyor? Rota hangi denetleyiciyi çağırıyor? Kategori ve yazılar nereden alınıyor? Sonuç hangi şablonda gösteriliyor? Bu sorular, dağınık bir dosya koleksiyonunu takip edilebilir bir zincire dönüştürür.
Codex’ten önce yalnızca bu zinciri çıkarmasını isteyebilirsiniz. Yanıtın her halkasında gerçek dosya veya sembol adı bulunması, açıklamayı denetlenebilir yapar. “Servis katmanı işleri yürütüyor” gibi genel bir cümle yerine, hangi servis metodunun hangi veriyi döndürdüğünü görmek istersiniz.
Bu aşamada eski bir mimari belgesine körü körüne güvenmeyin. Belge yararlı bir yön tabelasıdır; kullanılan yolun kanıtı ise güncel kaynakta bulunur. Örneğin bir depoda hem eski hem yeni arama bileşeni duruyor olabilir. Dosyanın var olması, aktif kullanıcı akışında çalıştığını göstermeyebilir.
Sorularınızı değişiklik niyetine bağlayın
Proje keşfi bütün depoyu eksiksiz anlama çabasına dönüşürse gereksiz yere uzar. Yakında kategori sıralaması değişecekse, sıralamanın nerede belirlendiği ve hangi başka sayfalarda kullanıldığı önem kazanır. Görsel kart güncellenecekse ortak bileşenler, stil kaynakları ve responsive kurallar öne çıkar.
Bu nedenle keşif promptuna bir sonraki işi ekleyin:
Kategori listesinin sıralamasını değiştirmeyi düşünüyorum. Şimdilik dosya düzenleme. İsteğin rotadan şablona kadar geçtiği yolu bul; sıralamanın kaynağını, ortak kullanım noktalarını ve ilgili mevcut testleri gerçek dosya adlarıyla açıkla. Belgeden gelen bilgiyle kaynakta doğruladığın bilgiyi ayır.
Burada “şimdilik dosya düzenleme” sınırı, keşif ile uygulamayı bilinçli biçimde ayırır. Değişiklik kararından önce hangi alanlara dokunulacağını öğrenmek istediğiniz durumlar için uygundur. Her küçük görevde ayrı bir keşif turu açmak zorunlu değildir.
Bir akışın birden fazla giriş noktası olabilir. Ana sayfadaki kategori kartı, navbar bağlantısı ve arama filtresi aynı veriyi farklı yollarla kullanabilir. Haritada bunları aynı başlık altında ilişkilendirmek, sonraki düzenlemede yalnızca görünen ilk bağlantıyı düzeltip diğerlerini unutmanızı önler. Özellikle ortak yardımcıların nerede paylaşıldığını görmek, küçük değişikliklerin gerçek etki alanını anlamaya yardımcı olur.
Kısa bir çalışma haritası hazırlayın
Çıktıyı birkaç işlevsel başlıkta toplamak faydalıdır: giriş noktası, veri seçimi, sunum, önbellek ve doğrulama. Her başlığın altında yalnızca görev için gerekli dosyaları tutun. Yüzlerce satırlık bir envanter, önemli bağlantıları görünmez hale getirebilir.
Bulunamayan noktaları da kaydedin. Bir zamanlanmış görev kaynakta görünmüyor ama verinin düzenli güncellendiği biliniyorsa, bunun dış bir sistemden geliyor olması mümkündür. Böyle bir boşluğu varsayımla doldurmak yerine açık soru olarak bırakmak, sonraki araştırmanın yönünü belirler. Aynı yaklaşım ortam değişkenleri ve yönetim paneli ayarları için de geçerlidir.
Son olarak haritayı tek bir davranışla sınayın. Kategoride sıralamayı belirleyen değerin gerçekten sonuçlara yansıdığını geliştirme ortamında gözlemleyin veya ilgili testi inceleyin. Kod okuma ile davranışın bağlantısı kurulunca, ilk düzeltmeyi yapmak çok daha kolaylaşır. Keşfin değeri, ne kadar dosya saydığıyla değil, bir sonraki güvenli değişikliği ne kadar netleştirdiğiyle ölçülür.
Kaynak: Codex ile kod tabanı modernleştirme.
