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.

İçindekiler
- 01Önce problemi ve kapsam dışını yazın
- 02Teknik şartnamenin kullanılabilir iskeleti
- 03Örnek: satın alma talebi onayı
- 04Veri ve entegrasyon davranışını tarif edin
- 05“Hızlı ve güvenli” yerine doğrulanabilir koşul yazın
- 06Belgeyi sürümleyin ve kararları izleyin
- 07Gereksinimleri teklif ve teslimle bağlayın
- 08Şartnameyi kabul ve devir kayıtlarına bağlayın
- 09Portal için veri erişim sınırını belgeleyin
- ✓Kontrol listesi
- ?Sık sorulan sorular
- ↗Kaynaklar
İ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
| Bölüm | Temel soru | Beklenen çıktı |
|---|---|---|
| Amaç ve kapsam | Hangi sorun çözülecek? | Hedef ve kapsam dışı işler |
| Roller ve yetkiler | Kim neyi görebilir/değiştirebilir? | Yetki matrisi |
| İş akışları | Normal ve istisna durumları neler? | Durumlar ve geçiş kuralları |
| Veri modeli | Hangi bilgi nereden gelir? | Alanlar, ilişkiler ve doğrulama |
| Entegrasyonlar | Hangi 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 teslim | Tamamlandığı 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.
| Durum | İşlem | Beklenen sonuç |
|---|---|---|
| Yetkili yönetici, kendi birim talebi | Talebi onaylar | Durum güncellenir; karar veren ve zaman kaydedilir |
| Başka birimin yöneticisi | Talebe 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 zorunlu | Boş 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
- Scrum Guide: planlama ve tamamlanma ölçütleri (yeni sekmede açılır)
İş listesinin geliştirilmesi, planların gözden geçirilmesi ve tamamlanma tanımı için birincil kaynak. Rehberdeki örnekler Next Medya tarafından hazırlanmıştır.
- W3C WAI: erişilebilirliği planlamak (yeni sekmede açılır)
Erişilebilirlik görevlerini proje boyunca planlamaya ve sorumluları belirlemeye ilişkin kaynaklar.
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 OperasyonSONRAKİ OKUMA
İlgili diğer analizler
YAZILIM GELİŞTİRME
Özel Yazılım Maliyeti Nasıl Hesaplanır?
Özel yazılım bütçesini iş akışları, kullanıcı rolleri, entegrasyon, veri taşıma ve test üzerinden hesaplayın. Teklifleri aynı kapsamla karşılaştırın.
Okumaya devam edinYAZILIM GELİŞTİRME
Yazılım Kaynak Kodu ve Teknik Devir Rehberi
Yazılım devrinde kaynak kod, derleme, veri şeması, ortamlar, erişimler ve operasyon belgelerini doğrulayın. Yeni ekiple çalıştırma ve geri yükleme provası yapın.
Okumaya devam edinİş 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