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

01Sık yapılan hatalar

Test ortamı olmadan canlıda düzeltme yapmak

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

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

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

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

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

• Eski (legacy) sistemler
• Web siteleri
• E-ticaret siteleri
• Özel yazılımlar

05Kapsamı ve maliyeti etkileyenler

• kod tabanının büyüklüğü ve durumu
• erişimlerin hazır olup olmadığı
• aylık bakım mı olay bazlı iş mi
• dokümantasyon ve test kapsamı

06Hangi durumlarda gündeme gelir?

Yazılımı geliştiren firma artık ulaşılamaz olduğunda

Kaynak kod düzenleme ve dokümantasyon kapsamında kod ve erişimler devralınır, belgelenir ve risk analizi çıkarı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.

07Planlama notları

• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.

08Atabey'de destek

Atabey, Isparta iline bağlı bir ilçedir ve PTT adres verisine göre 17 mahalle ve köy kaydından oluşur.

Mesafe yazılım işinin önünde engel değildir: Atabey'deki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.

Aynı ildeki Isparta Aksu, Yenişarbademli ve Senirkent 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
• test ortamı
• Playwright
• Isparta
• Atabey