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

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
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Sürüm kontrolü kullanmamak

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

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

06Hangi durumlarda gündeme gelir?

README gerektiğinde

README, kaynak kod düzenleme ve dokümantasyon projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.

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

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

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

• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Dokümantasyon değişikliklerle birlikte güncellenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

08Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.

09Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• erişimlerin hazır olup olmadığı
• aciliyet ve destek penceresi
• kod tabanının büyüklüğü ve durumu

10Şuhut'ta uzman desteği

PTT kayıtlarında Şuhut ilçesine bağlı 91 yerleşim bulunur: 16 mahalle ile 75 köy ve köy yerleşimi.

Mesafe yazılım işinin önünde engel değildir: Şuhut'taki 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.

Afyonkarahisar genelinde Afyonkarahisar Bayat, Sinanpaşa ve Sandıklı gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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
• Playwright
• teknik borç
• sürüm yükseltme
• Afyonkarahisar
• Şuhut