Kaynak kod düzenleme ve dokümantasyon: kendin yap mı, uzman mı? (Büyükorhan)

01Kendiniz yapabilecekleriniz

• tüm erişim bilgilerini tek listede toplamak
• hataları ekran görüntüsü ve adımlarıyla kaydetmek
• kritik iş akışlarını yazılı hale getirmek

02Uzman gerektirenler

• kod denetimi ve teknik borç analizi
• regresyon testleriyle güvenli düzeltme
• sürüm yükseltme ve mimari iyileştirme

03Belirti, neden ve çözüm

04Yanlış uygulamanın riskleri

• Test ortamı olmadan canlıda düzeltme yapmak
• Hatayı yeniden üretmeden kod değiştirmek
• Tüm sistemi aynı anda yeniden yazmaya kalkmak

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

• E-ticaret siteleri
• Eski (legacy) sistemler
• Mobil uygulamalar
• Yarım kalan projeler

06Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• aciliyet ve destek penceresi
• erişimlerin hazır olup olmadığı
• aylık bakım mı olay bazlı iş mi

07Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• 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.

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

• Dokümantasyon değişikliklerle birlikte güncellenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Hata kayıtları önceliğe göre sınıflandırılır.

09Hangi durumlarda gündeme gelir?

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

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

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.

10Büyükorhan'da uzman desteği

Büyükorhan, Bursa iline bağlı bir ilçedir ve PTT adres verisine göre 43 mahalleden oluşur. Birden fazla ilçede ekibi veya şubesi olan işletmelerde kaynak kod düzenleme ve dokümantasyon için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

Büyükorhan'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 Nilüfer, İznik ve Kestel 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
• refactoring
• test ortamı
• otomatik test
• Bursa
• Büyükorhan