Yazılım Projesinde Analiz Dokümanı Nasıl Hazırlanır? | DigiWise
Yazılım Projesinde Analiz Dokümanı Nasıl Hazırlanır?
Başarılı yazılım projelerinde önemli bir aşama, kod yazılmadan önce neyin neden geliştirileceğinin ortak bir dille tanımlanmasıdır. Analiz dokümanı yalnızca yazılımcılara bırakılan teknik bir belge değildir. İşletme yöneticisi, süreç sahibi, tasarımcı, geliştirici ve test uzmanı arasında mutabakat sağlar. İyi hazırlanmış bir doküman belirsiz talepleri görünür kılar, tekliflerin karşılaştırılmasını kolaylaştırır ve teslim sırasında çıkabilecek yorum farklarını azaltır.

1. Projenin amacı ve başarı ölçütleri
Belgenin başına çözülmek istenen iş problemi yazılmalıdır. Örneğin saha servis bilgilerinin telefon mesajları yerine tek merkezde toplanması bir amaçtır. Başarı ölçütü ise servis kaydının aynı gün tamamlanma oranı veya eksik rapor sayısı gibi somut, ölçülebilir göstergeler olabilir.
2. Paydaşlar ve karar yetkileri
Projeye katkı verecek birimler, nihai onayı verecek kişi ve her modülün süreç sahibi tanımlanmalıdır. İlgili departmanların görüşleri başlangıçta alınmazsa sonradan kritik ihtiyaçlar ortaya çıkabilir. Onay ve değişiklik süreçleri de belgeye dahil edilmelidir.
3. Mevcut iş akışının kaydı
Bugünkü süreçleri oldukları gibi belgeleyin. Kullanıcı bir talebi nasıl alıyor, hangi veriyi nereden buluyor, kime iletiyor ve sonuç nasıl kayıt altına alınıyor? Sadece ideal akışı değil, istisnaları ve tekrar yapılan işleri de belirtin. Bu kayıt dijitalleşmenin gerçek fırsatlarını ortaya çıkarır.
4. Hedef süreç ve kapsam dışı konular
Yeni yazılımın hangi adımları otomatikleştireceği ve hangi kararları kullanıcıya bırakacağı netleştirilmelidir. İlk sürümde yapılmayacak işler özellikle yazılmalıdır. Kapsam dışı maddeler, teslim sonrası yanlış beklentilerin önüne geçer.
5. Kullanıcı rolleri ve yetki matrisi
Yönetici, operasyon sorumlusu, saha personeli ve müşteri gibi rollerin erişim alanlarını tabloyla gösterin. Sadece sayfa erişimini değil, kayıt oluşturma, onaylama, silme ve dışa aktarma yetkilerini de tanımlayın. Çok müşterili sistemlerde veri ayrımı kritik öneme sahiptir.
6. Fonksiyonel gereksinimler
Her gereksinime benzersiz bir kod, açıklama, öncelik ve kabul kriteri verin. Örneğin “FR-012: Saha personeli atanmış iş emrinin fotoğraflı servis raporunu gönderebilir.” Bu ifade için zorunlu alanlar, dosya boyutu ve bağlantı kesintisinde sistem davranışı da belirlenmelidir.
7. Veri sözlüğü ve veri kuralları
Müşteri, şube, cihaz, iş emri ve servis raporu gibi kavramların alanlarını tanımlayın. Zorunlu alan, benzersizlik, tarih biçimi ve kayıtların birbirleriyle ilişkileri yazılmalıdır. Veri sözlüğü farklı ekranların aynı terimleri farklı anlamlarda kullanmasını önler.
8. Entegrasyon ve veri alışverişi
Muhasebe, ödeme, SMS, e-posta ve mevcut ERP sistemleriyle paylaşılacak verileri belirtin. Hangi sistemin ana kayıt kaynağı olduğu, senkronizasyon sıklığı ve başarısız isteklerin nasıl ele alınacağı açıklanmalıdır. Test için kullanılacak örnek istek ve yanıtlar eklenebilir.
9. Fonksiyonel olmayan gereksinimler
Performans, erişilebilirlik, güvenlik, yedekleme, izleme ve kullanılabilirlik beklentilerini ayrıca yazın. “Hızlı çalışmalı” gibi belirsiz ifadeler yerine ölçülebilir koşullar tercih edin. Koşullar gerçek iş ihtiyacına uygun ve test edilebilir olmalıdır.
10. Kabul senaryoları ve değişiklik yönetimi
Her önemli iş akışı için başlangıç koşulu, kullanıcı adımları ve beklenen sonucu tanımlayın. Değişiklik taleplerini kaydetmek için sürüm, tarih, gerekçe, maliyet ve onay alanları kullanın. Doküman yaşayan bir belge olmalı ancak değişikliklerin etkisi görünür kalmalıdır.
Örnek analiz senaryosu: Saha servis uygulaması
Bir müşteri servis talebi açar, operasyon sorumlusu talebi uygun personele atar, personel mobil cihazdan hizmet formunu tamamlar ve müşteri raporu portalda görüntüler. Analiz dokümanı bu akış için rol izinlerini, gerekli formları, konum ve fotoğraf kullanımını, bildirimi ve tamamlanma koşulunu ayrı ayrı belirtmelidir.
Dokümanı kullanışlı tutmanın yolu
Uzun anlatımlar tek başına yeterli değildir. İş akışı diyagramı, ekran taslağı, örnek veri, gereksinim listesi ve açık soruların kaydı birlikte tutulmalıdır. Her başlığın sorumlusu ve son güncelleme tarihi görünür olmalıdır.