Kaynak kod düzenleme ve dokümantasyon: kendin yap mı, uzman mı? (İkizdere)

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

• Hatayı yeniden üretmeden kod değiştirmek
• Yapılan değişiklikleri belgelememek
• Sürüm kontrolü kullanmamak

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

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

06Hangi durumlarda gündeme gelir?

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürü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.

07Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.

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

• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Bağımlılık güvenlik uyarıları düzenli taranır.

09Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• kullanılan teknolojilerin güncelliği
• aylık bakım mı olay bazlı iş mi
• kod tabanının büyüklüğü ve durumu

10İkizdere'de uzman desteği

İkizdere'nin PTT verisindeki 90 yerleşim kaydı 2 farklı posta koduna dağılır.

İkizdere'de 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 İyidere, Güneysu ve Ardeşen 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
• Playwright
• Rize
• İkizdere