Kaynak kod düzenleme ve dokümantasyon sırasında sık yapılan hatalar (Şirvan)

01Sık yapılan hatalar

Test ortamı olmadan canlıda düzeltme yapmak

Bu hata çoğu zaman geri dönüşü zor bir durum yaratır; önce yedek ve test ortamı şarttır.

Hatayı yeniden üretmeden kod değiştirmek

Sonucu hemen görülmeyebilir; ancak birkaç gün içinde veri kaybı veya kesinti olarak ortaya çıkar.

Sürüm kontrolü kullanmamak

Çözümü basittir ama sonradan düzeltmek iş yükünü katlar.

Tüm sistemi aynı anda yeniden yazmaya kalkmak

Çözümü basittir ama sonradan düzeltmek iş yükünü katlar.

Yapılan değişiklikleri belgelememek

Çözümü basittir ama sonradan düzeltmek iş yükünü katlar.

02Doğru yaklaşım

• Önce yedek, sonra tespit
• Değişiklikleri test ortamında denemek
• Her adımı kayıt altına almak
• Sonucu ölçümle doğrulamak

03Belirti, neden ve çözüm

04İşletim ve bakım ipuçları

• Bağımlılık güvenlik uyarıları düzenli taranır.
• Dokümantasyon değişikliklerle birlikte güncellenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

05Kapsamı ve maliyeti etkileyenler

• kullanılan teknolojilerin güncelliği
• aciliyet ve destek penceresi
• kod tabanının büyüklüğü ve durumu
• erişimlerin hazır olup olmadığı

06Kaynak kod düzenleme ve dokümantasyon hangi işletmelerde kullanılır?

• Yarım kalan projeler
• Özel yazılımlar
• E-ticaret siteleri
• Eski (legacy) sistemler

07Planlama notları

• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.

08Hangi durumlarda gündeme gelir?

Yazılım yavaşladığında

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürülür.

09Şirvan'da destek

Şirvan'ın PTT verisindeki 104 yerleşim kaydı 4 farklı posta koduna dağılır.

Şirvan'da bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Aynı ildeki Pervari, Kurtalan ve Siirt Merkez ilçeleri için de kaynak kod düzenleme ve dokümantasyon talepleri değerlendirilir; toplantılar uzaktan yapılır.

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• README
• mimari şema
• kurulum kılavuzu
• bakım sözleşmesi
• dokümantasyon
• Git
• otomatik test
• Playwright
• refactoring
• sürüm yükseltme
• Siirt
• Şirvan