Kod tabanının düzenlenmesi ve belgelenmesi.
01Hangi durumlarda gerekir?
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.
Yazılım yavaşladığında
Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.
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.
02Belirtiler
- Hataların tekrar tekrar ortaya çıkması
- Kütüphane ve çatı sürümlerinin desteğinin bitmesi
- Dokümantasyon ve kurulum bilgisinin olmaması
- Kodu yazan kişiye veya firmaya ulaşılamaması
03Belirti, neden ve çözüm
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Önceki firmaya ulaşılamıyor | Kod/erişim işletmede değil | Devralma ve erişim kurtarma |
| Her düzeltme yeni hata doğuruyor | Test yok | Otomatik testler |
| Eski PHP/framework sürümü | Güncelleme yapılmamış | Kademeli sürüm yükseltme |
04Hangi sistemlerde uygulanır?
- Web siteleri
- Özel yazılımlar
- Mobil uygulamalar
- E-ticaret siteleri
- Yarım kalan projeler
- Eski (legacy) sistemler
05İş nasıl ilerler?
- Kod, erişimler ve ortamlar üzerinde durum tespiti yapmak
- Riskleri ve öncelikleri listelemek
- Test ortamı ve sürüm kontrolünü düzene sokmak
- Kritik hataları ve güvenlik açıklarını gidermek
- Testleri ve dokümantasyonu tamamlamak
- Düzenli bakım ve geliştirme planına geçmek
NotHer değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
06Kapsam
- README
- mimari şema
- kurulum kılavuzu
İhtiyaca göre yazılım projesi kurtarma, üçüncü taraf yazılıma modül ve yazılım projesi devralma da aynı yol haritasına eklenebilir.
07Mahmudiye'de kaynak kod düzenleme ve dokümantasyon
Mahmudiye, Eskişehir iline bağlı bir ilçedir ve PTT adres verisine göre 19 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için kaynak kod düzenleme ve dokümantasyon tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Mahmudiye'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.
Eskişehir genelinde Beylikova, Odunpazarı ve Çifteler gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Sorunu kısa bir notla ve ekran görüntüsüyle WhatsApp'tan iletin; kaynak kod düzenleme ve dokümantasyon için ön değerlendirme yapalım. Telefon: 0540 003 19 81.
08Çalışma düzenimiz
Tasarım, geliştirme, test ve yayın adımları aynı ekip içinde yürür. Kod Git ile sürümlenir, kritik akışlar Playwright testleriyle korunur, yayın Docker konteynerleriyle tekrarlanabilir biçimde yapılır.
- Yayın sonrası bakım ve destek planlanır.
- KVKK baştan tasarlanır.
- Kaynak kod ve veri işletmeye teslim edilir.
Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Eskişehir de bunlardan biri.
SSSSık sorulan sorular
Kaynak kod düzenleme ve dokümantasyon öncesinde neleri hazırlamalıyım?
Kaynak kod deposu, sunucu ve veritabanı erişimi ve varsa mevcut dokümanlar ve hata kayıtları işi hızlandırır.
Kaynak kod düzenleme ve dokümantasyon sırasında site veya uygulama kapanır mı?
Hazırlık test ortamında yapılır; canlı ortamdaki değişiklik önceden haber verilen kısa bir bakım penceresinde uygulanır.
Ne kadar sürer?
Süre işin kapsamına ve erişimlerin hazır olmasına göre değişir; ön değerlendirmeden sonra planlı bir takvim paylaşılır.
Uzaktan yapılabilir mi?
Çoğu teknik iş uzaktan, verilen erişimlerle yapılır; donanım veya yerinde kurulum gereken işler ayrıca planlanır.
İş sırasında site kapanır mı?
Hazırlık test ortamında yapılır; canlı ortamdaki değişiklik önceden haber verilen kısa bir bakım penceresinde uygulanır.
Mahmudiye'de bulunuyorum, yerinde görüşme mümkün mü?
Analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
Sadece Eskişehir için mi çalışıyorsunuz?
Askadar Yazılım 81 ilde uzaktan çalışır; Eskişehir de bunlardan biridir. Yerinde iş gerektiğinde ziyaret planlanır.
Bakım anlaşmasında neler olur?
İzleme, güncelleme, yedek kontrolü, hata düzeltme ve küçük geliştirmeler kapsamda yazılı olarak belirtilir; kapsam dışı işler ayrıca planlanır.
→İlgili sayfalar
Kaynak Kod Düzenleme ve Dokümantasyon hakkında diğer konular
- Kaynak kod düzenleme ve dokümantasyon tespit ve analizSorunun nasıl tespit edildiği
- Kaynak kod düzenleme ve dokümantasyon öncesi hazırlıkErişimler, yedek ve hazırlık
- Kaynak kod düzenleme ve dokümantasyon sık yapılan hatalarKaçınılması gerekenler
- Kaynak kod düzenleme ve dokümantasyon: acil durumda ne yapılmalı?Site veya uygulama çöktüğünde ilk adımlar
- Kaynak kod düzenleme ve dokümantasyon kontrol listesiAdım adım kontrol listesi
Mahmudiye'de ilgili hizmetler
Eskişehir içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- README
- mimari şema
- kurulum kılavuzu
- bakım sözleşmesi
- dokümantasyon
- Git
- refactoring
- otomatik test
- sürüm yükseltme
- Eskişehir
- Mahmudiye