İçeriğe geç
Yazılım ve Teknoloji

Yazılım Projesinde Teknik Borcu Görünür Kılmanın Yolları

Rıfat Akarca 👁️ 101 okunma 📅 ⏱️ 4 dk okuma
İçindekiler

Basit görünen bir özellik günlerce geliştiriliyor, aynı hatalar tekrar ortaya çıkıyor veya ekip belirli dosyalara dokunmaktan çekiniyorsa projenizde teknik borç birikmiş olabilir. Ancak bu belirtileri fark etmek, sorunun nedenini ve boyutunu anlatmaya her zaman yetmez.

Yazılım projesinde teknik borcu görünür kılmak, geliştirmeyi zorlaştıran teknik kararları ve eksikleri somut örneklerle kaydetmek, etkilerini açıklamak ve düzenli olarak değerlendirmek demektir. Böylece “Bu kodun düzeltilmesi gerekiyor” gibi genel ifadeler, planlanabilir iyileştirme işlerine dönüşür.

Bu rehberde, kapsamlı araçlara ihtiyaç duymadan uygulayabileceğiniz adımları bulabilirsiniz.

Teknik borç nedir?

Teknik borç, yazılımda bugün tercih edilen bir çözümün veya ertelenen bir iyileştirmenin gelecekte ek çalışma ve bakım maliyeti oluşturmasıdır.

Örneğin, bir özelliği zamanında yetiştirmek için aynı hesaplama kodunu üç farklı yere kopyaladığınızı düşünün. İlk geliştirme hızlı tamamlanır. Ancak hesaplama kuralı değiştiğinde üç yeri de güncellemeniz ve sonuçların tutarlı olduğunu kontrol etmeniz gerekir. Başlangıçta kazanılan zaman, sonraki değişikliklerde ek maliyet olarak karşınıza çıkar.

Teknik borç her zaman yanlış bir kararın sonucu değildir. Teslim tarihine yetişmek için bilinçli olarak alınabilir veya ürünün ihtiyaçları değiştikçe ortaya çıkabilir. Önemli olan, borcun nerede bulunduğunu ve hangi koşullarda sorun oluşturduğunu bilmektir.

Ayrıca her yazılım hatası teknik borç değildir. Bir hata yanlış bir sonuç üretirken teknik borç, doğru çalışan bir sistemin değiştirilmesini veya bakımını da zorlaştırabilir.

1. Teknik borcun belirtilerini somut örneklerle yakalayın

İlk adım, ekibin yaşadığı güçlükleri gözlemlenebilir olaylarla ilişkilendirmektir.

Şu sorularla başlayabilirsiniz:

  • Küçük bir değişiklik için çok sayıda dosyayı düzenlemek gerekiyor mu?
  • Belirli modüllerde benzer hatalar tekrar ediyor mu?
  • Otomatik test eksikliği nedeniyle kontroller sürekli elle mi yapılıyor?
  • Yeni bir geliştiricinin projeyi çalıştırması uzun sürüyor mu?
  • Bir bileşeni yalnızca tek bir kişi mi anlayabiliyor?

“Ödeme modülü karmaşık” demek yerine, “Son iki ödeme kuralı değişikliğinde aynı mantığı dört farklı yerde güncelledik” şeklinde bir kayıt tutun.

Bu yaklaşım, kişisel değerlendirmeleri ekipçe incelenebilen kanıtlara dönüştürür.

2. Basit bir teknik borç envanteri oluşturun

Teknik borçların sohbetlerde veya kişisel notlarda kalmasını önlemek için ortak bir liste hazırlayın. Mevcut iş takip aracınızda bir etiket ya da paylaşılan bir tablo yeterlidir.

Her kayıt şu bilgileri içersin:

AlanÖrnek
Başlıkİndirim hesaplama mantığı üç yerde tekrarlanıyor
KonumSepet, ödeme ve sipariş servisleri
KanıtSon kampanya değişikliğinde üç ayrı düzenleme yapıldı
EtkiGeliştirme süresi ve tutarsız hesaplama riski artıyor
Önerilen ilk adımMevcut davranış için test eklemek
Takip sorumlusuİlgili modülün bakımını üstlenen ekip
Yeniden değerlendirmeBir sonraki kampanya geliştirmesi öncesi

Kaydın amacı, sorunu eksiksiz analiz etmek değildir. Başka bir ekip üyesinin sorunu anlayıp değerlendirebilmesini sağlamaktır. Hassas verileri veya erişim bilgilerini kayıtlara eklemeyin.

3. Teknik sorunları iş üzerindeki etkileriyle açıklayın

Teknik borcu görünür kılmanın en önemli adımlarından biri, teknik açıklamayı ürün ve iş sonuçlarıyla ilişkilendirmektir.

Örneğin:

  • Teknik durum: Kritik kullanıcı akışında otomatik test bulunmuyor.
    İş etkisi: Her sürümde aynı kontroller elle yapılıyor ve yayın hazırlığı uzuyor.
  • Teknik durum: Raporlama sorguları farklı ekranlarda tekrar ediyor.
    İş etkisi: Yeni bir filtre eklemek için birden fazla noktada geliştirme gerekiyor.
  • Teknik durum: Kurulum dokümanı güncel değil.
    İş etkisi: Yeni ekip üyeleri projeyi çalıştırmak için başka geliştiricilerden sık destek alıyor.

Ölçmediğiniz bir maliyeti kesin bilgi gibi sunmayın. “Her hafta beş saat kaybediyoruz” diyebilmek için veri gerekir. Veri yoksa tahmin olduğunu belirtin ve nasıl doğrulayacağınızı yazın.

4. Az sayıda, anlamlı gösterge seçin

Başlangıçta büyük bir teknik borç panosu hazırlamanız gerekmez. Düzenli takip edebileceğiniz birkaç gösterge seçin:

  • Sorunlu modüldeki değişiklikleri tamamlama süresi.
  • Tekrarlayan hataların sayısı.
  • Sürüm öncesi elle yapılan kontrollerin süresi.
  • Teknik engeller nedeniyle bekleyen işlerin sayısı.

Bu göstergeler tek başına teknik borcu kanıtlamaz. Örneğin, geliştirme süresinin uzaması belirsiz gereksinimlerden de kaynaklanabilir. Sayıları ekip gözlemleri ve somut kayıtlarla birlikte değerlendirin.

Kod analiz araçlarının bulguları da başlangıç noktası olabilir. Ancak her uyarı aynı öneme sahip değildir; kullanıcıya ve geliştirme sürecine etkisini ayrıca inceleyin.

5. Borçları etkisine ve ihtiyaçlara göre önceliklendirin

Her teknik borcu hemen kapatmaya çalışmak, görünürlük sağlamayı kapsamlı bir yeniden yazım projesine dönüştürebilir.

Öncelik belirlerken üç soru sorun:

  1. Bu borç bugün ne kadar ek çalışma veya risk oluşturuyor?
  2. İlgili bölümde yakın zamanda değişiklik yapacak mıyız?
  3. Sorunu azaltacak küçük ve uygulanabilir bir adım var mı?

Yakında geliştirilecek bir özelliği doğrudan etkileyen borç, uzun süredir değişmeyen bir modüldeki benzer sorundan daha öncelikli olabilir. Güvenlik veya veri bütünlüğüyle ilgili bulguları ise ayrıca değerlendirin.

Amaç, en rahatsız edici görünen kodu seçmekten çok, iyileştirmenin nerede anlamlı fayda sağlayacağını belirlemektir.

6. İyileştirmeyi iş planına dahil edin ve sonucu kontrol edin

Teknik borç listesi, düzenli incelenmiyorsa zamanla unutulur. Planlama toplantılarında kısa bir değerlendirme alanı açın ve seçilen iyileştirmeleri somut görevlere dönüştürün.

“Testleri iyileştir” yerine şu şekilde bir iş tanımlayın:

İndirim hesaplamasındaki mevcut davranışları doğrulayan testleri ekle; ardından tekrarlanan hesaplama mantığını ortak bir bileşende topla.

İş tamamlandığında yalnızca kaydı kapatmayın. Beklenen faydanın oluşup oluşmadığını da kontrol edin. Sonraki kampanya değişikliği daha az noktaya dokunarak yapılabiliyor mu? Elle kontrol ihtiyacı azaldı mı?

Sonuçları kayda eklemek, sonraki önceliklendirme kararlarını güçlendirir.

Sık sorulan sorular

Teknik borcu kim takip etmeli?

Geliştiriciler teknik bulguları kaydedebilir; önceliklendirme ise ürün ve proje sorumlularıyla birlikte yapılmalıdır. Her kaydın bir takip sorumlusu olması, konunun unutulmasını önler.

Küçük projelerde teknik borç takibi gerekli mi?

Evet. Birkaç satırlık ortak bir liste bile yeterli olabilir. Takip yönteminin ayrıntısını projenin büyüklüğüne ve ihtiyaçlarına göre belirleyebilirsiniz.

Teknik borcun tamamını ortadan kaldırmak gerekir mi?

Hayır. Bazı borçların etkisi sınırlıdır ve çözüm maliyeti sağlayacağı faydayı aşabilir. Önemli olan, bu borçları bilerek taşımak ve koşullar değiştiğinde yeniden değerlendirmektir.

İlk adım: Tek bir teknik borcu kaydedin

Yazılım projesinde teknik borcu görünür kılmak için tüm kod tabanını incelemek zorunda değilsiniz. Son geliştirmede sizi yavaşlatan tek bir sorunu seçin. Nerede bulunduğunu, hangi ek çalışmaya neden olduğunu ve atılabilecek ilk adımı yazın.

Bu kaydı bir sonraki planlamada değerlendirin. Düzenli tekrarlanan bu küçük alışkanlık, teknik borcu belirsiz bir şikâyet olmaktan çıkarıp yönetilebilir bir iş haline getirir.