YAZILIM GELİŞTİRME

Yazılım Gereksinim Analizi ve Teknik Şartname

Yazılım şartnamesini kullanıcı rolleri, iş kuralları, veri, entegrasyon ve kabul testleriyle hazırlayın. Teklif ve geliştirme için somut örnekler kullanın.

Next Medya Strateji ve Teknoloji EkibiYayın: Güncelleme: 5 dk · 861 kelime
İhtiyaçtan iş kuralına ve kabul testine ilerleyen şartname akışı
Teknik şartname
İçindekiler

İyi bir yazılım şartnamesi yalnızca ekran ve özellik listesi değildir. Kimin, hangi koşulda, hangi işi yapacağını; sistemin hangi veriyi kullanacağını ve sonucun nasıl kabul edileceğini açıklar. Böylece teklif veren ekipler aynı problemi değerlendirir.

Belgeyi baştan kusursuz yazmak zorunda değilsiniz. Bilinmeyenleri açık sorular olarak kaydedin, karar sahiplerini belirleyin ve kritik akışları örneklerle netleştirin. Aşağıdaki satın alma talebi senaryosu, yöntemi açıklamak için hazırlanmış temsili bir örnektir.

Önce problemi ve kapsam dışını yazın

“Bir yönetim paneli istiyoruz” yerine bugün kimin hangi işi nasıl yaptığını anlatın. Verinin tekrar girildiği, onayların kaybolduğu veya durumun takip edilemediği adımları gösterin. Mevcut dosya ve ekran örnekleri, soyut özellik adlarından daha açıklayıcı olabilir.

İlk sürümün iş sonucunu ve kapsam dışını birlikte belirtin. Örneğin satın alma talebinin kaydedilip yöneticinin kararının izlenmesi hedeflenebilir; muhasebe fişi üretme sonraki sürüme bırakılabilir. Bu sınırı teklif metninde de koruyun.

Teknik şartnamenin kullanılabilir iskeleti

Her bölümün cevaplaması gereken soru
BölümTemel soruBeklenen çıktı
Amaç ve kapsamHangi sorun çözülecek?Hedef ve kapsam dışı işler
Roller ve yetkilerKim neyi görebilir/değiştirebilir?Yetki matrisi
İş akışlarıNormal ve istisna durumları neler?Durumlar ve geçiş kuralları
Veri modeliHangi bilgi nereden gelir?Alanlar, ilişkiler ve doğrulama
EntegrasyonlarHangi sistemle ne paylaşılır?Veri yönü ve hata davranışı
Kalite koşullarıHangi yükte nasıl çalışmalı?Ölçülebilir test koşulları
Kabul ve teslimTamamlandığı nasıl doğrulanır?Senaryolar, kanıt ve sorumlu

Örnek: satın alma talebi onayı

REQ-01 gereksinimi için üç rol tanımlayalım: talep sahibi, birim yöneticisi ve sistem yöneticisi. Talep sahibi kendi taslağını düzenleyebilir; gönderilmiş talebin kararını birim yöneticisi verir. Yöneticinin yalnızca kendi birimindeki taleplere erişmesi bu örneğin iş kuralıdır.

Durumları taslak, onay bekliyor, onaylandı ve reddedildi olarak yazın. Reddetme gerekçesinin zorunlu olup olmadığını, karar sonrası değişiklik yapılıp yapılamayacağını ve yöneticinin kendi talebini onaylayıp onaylayamayacağını karar listesine ekleyin. Bu sorular cevaplanmadan ekranın görünmesi, akışın tamamlandığını kanıtlamaz.

REQ-01 için temsili kabul senaryoları
DurumİşlemBeklenen sonuç
Yetkili yönetici, kendi birim talebiTalebi onaylarDurum güncellenir; karar veren ve zaman kaydedilir
Başka birimin yöneticisiTalebe doğrudan URL/API ile erişirİşlem reddedilir; talep bilgileri gösterilmez
Talep daha önce sonuçlanmışTekrar onay gönderilirİkinci bir karar veya yan etki oluşmaz
Reddetme gerekçesi zorunluBoş gerekçeyle reddederİşlem yapılmaz; anlaşılır hata gösterilir

Veri ve entegrasyon davranışını tarif edin

Her alan için veri türünü, zorunluluğu ve kaynağı belirleyin. Örneğin birim bilgisi şirket dizininden geliyorsa kullanıcının bunu değiştirme yetkisi ayrı karardır. Eski talepler taşınacaksa alan eşlemeleri, eksik kayıtlar ve kontrol yöntemi yazılmalıdır.

Bağlantı kesildiğinde kullanıcı ne görecek, işlem tekrar denenecek mi ve aynı kayıt iki kez gönderilirse ne olacak? Entegrasyon şartnamesinde başarılı yanıt kadar bu istisnaları da ele alın. Test ortamı ve teknik muhatap bilgisini ekleyin; gerçek erişim anahtarlarını şartnameye koymayın.

“Hızlı ve güvenli” yerine doğrulanabilir koşul yazın

Performans şartında hangi işlem, hangi veri hacmi, hangi eşzamanlı kullanıcı yükü ve hangi ölçüm ortamının kullanılacağını belirtin. Kabul eşiğini paydaşlarla belirleyin. Sayısal bir hedefin gerçek ihtiyaçtan ve test düzeninden bağımsız yazılması, tek başına kalite güvencesi sağlamaz.

Yetki kontrolleri, yedek geri yükleme, hata kaydı ve erişilebilirlik için sorumlu ve doğrulama yöntemi tanımlayın. Scrum Guide içindeki tamamlanma tanımı, bir işin ortak kalite ölçütleriyle değerlendirilmesini açıklar; gereksinime özel kabul senaryoları ise beklenen davranışı somutlaştırır. Bu iki katmanı birlikte kullanabilirsiniz.

Belgeyi sürümleyin ve kararları izleyin

Her gereksinime bir kimlik verin. İlgili ekran, iş kuralı, kabul senaryosu ve açık soruyu bu kimliğe bağlayın. Böylece bir talep değiştiğinde hangi geliştirme ve testlerin etkilendiği görülebilir.

Yeni bir ihtiyaç geldiğinde gerekçesini, ilk sürüme etkisini, tahmin değişikliğini ve onaylayan kişiyi kaydedin. Sadece belgenin son halini paylaşmak yerine karar geçmişini koruyun. Kabul toplantısında hangi sürümün esas alındığı da belli olsun.

Gereksinimleri teklif ve teslimle bağlayın

Özel yazılım maliyeti rehberi ile bu iş paketlerini bütçeye dönüştürün. Teslim koşullarını kaynak kod ve hesap devri üzerinden kontrol edin. İş akışlarınızı birlikte incelemek için özel yazılım geliştirme hizmetimizin kapsamına bakabilirsiniz.

Şartnameyi kabul ve devir kayıtlarına bağlayın

Kabul testleri rehberi ile her kritik gereksinimi bir doğrulama senaryosuna dönüştürün. Teknik devir listesi üzerinden kod, veri ve operasyon belgelerini teslim kapsamına ekleyin. İlk sürümü daraltmak için MVP kapsamı rehberini kullanabilirsiniz.

Portal için veri erişim sınırını belgeleyin

Müşteri portalı yetki matrisi kullanıcı, kurum ve kayıt ilişkisini gereksinimlere dönüştürür. Yetkili işlemler kadar reddedilmesi gereken senaryoları da şartnameye ekleyin.

UYGULAMA ÖZETİ

Karar vermeden önce kontrol edin

Hazırlık

  • Amaç, roller ve kapsam dışı işler belirlendi.
  • Veri kaynakları ve dış sistem sorumluları kayıtlı.

Doğrulama

  • Kritik akışların başarılı ve hatalı senaryoları yazıldı.
  • Kabul sorumlusu, belge sürümü ve değişiklik yöntemi belli.

SSS

Sık sorulan sorular

Teknik bilgim yoksa şartname hazırlayabilir miyim?

İşinizi, kullanıcılarınızı ve örnek durumları tarif ederek başlayabilirsiniz. Teknik ekip bu ihtiyaçları veri, entegrasyon ve kalite gereksinimlerine dönüştürürken belirsiz noktaları birlikte netleştirmelidir.

Kullanıcı hikâyesi tek başına yeterli mi?

Kimin neyi neden istediğini anlatır; ancak yetki kuralları, veri sınırları ve hata durumlarını her zaman kapsamaz. Kabul senaryoları ve ilgili iş kurallarıyla tamamlayın.

Şartname proje başladıktan sonra değişebilir mi?

Evet. Değişiklikler sürüm, gerekçe ve etki kaydıyla yönetilmelidir. Yeni talebin bütçe ve takvime etkisi karar verilmeden önce görünür olmalıdır.

BİRİNCİL KAYNAKLAR

Kaynaklar ve İleri Okuma

YAZAR

Next Medya Strateji ve Teknoloji Ekibi

Web ve yazılım projeleri

Web ve yazılım kararlarını kapsam, içerik, teknik gereksinimler ve işletme süreçleriyle birlikte ele alan Next Medya ekibi. Rehberlerdeki tablolar ve senaryolar karar yöntemini açıklamak için hazırlanmış temsili örneklerdir.

İLGİLİ HİZMET

Özel Yazılım GeliştirmeBulut, Bakım ve Teknik Operasyon

İş akışlarınızı geliştirilebilir gereksinimlere dönüştürelim

Mevcut yapınızı, hedeflerinizi ve kısıtlarınızı paylaşın; projenin kapsamını birlikte değerlendirelim.

Projenizi görüşelim