Bir web sitesi projesindeki yanlış anlaşılmaların büyük kısmı teknik işten değil, beklentilerin yazılı olarak üzerinde anlaşılmamasından kaynaklanır. Müşteri bir şey hayal eder, yüklenici başka bir şey anlar ve fark ancak teslimde ortaya çıkar. Teknik şartname bu riski azaltan temel belgedir. Tarafların neyi, neden ve hangi koşullarla hazırladığını tek bir yerde tanımlar. Aşağıda böyle bir belgenin pratik yapısını ve her bölüme ne yazılması gerektiğini anlatıyoruz.
Teknik şartname neden gerekli
Teknik şartname sadece resmi bir belge değildir. Birkaç gerçek işlevi vardır:
- Tahmin için temel. Yüklenici bütçeyi ve süreyi ancak net gereksinimlere dayanarak doğru hesaplayabilir.
- Ortak dil. Müşteri, tasarımcı, yazılımcı ve iş ortakları aynı belgeye başvurur.
- Değişiklik yönetimi. Belgede olmayan her yeni gereksinim ayrıca fiyatlandırılır ve bu, anlaşmazlıkların önüne geçer.
- Kabul kriterleri. İşin bitip bitmediği öznel görüşe göre değil, üzerinde anlaşılmış bir listeye göre kontrol edilebilir.
Teknik şartnameyi müşteri kendisi yazabilir, ancak çoğu zaman bu ortak bir çalışmadır: iş tarafı hedefleri ve süreci anlatır, teknik taraf ise bunları net gereksinimlere dönüştürür.
İş tarafı: amaç ve hedef kitle
Projenin amacı ve bağlamı
Belge teknolojiyle değil, işin kendisiyle başlamalıdır. Bu bölümde kısa ve somut yazın:
- Şirket ne iş yapıyor ve site hangi sorunu çözmeli.
- Sitenin ana amacı: talep toplamak, ürün satmak, bilgi vermek, müşteri hizmetlerini dijitalleştirmek.
- Başarıyı nasıl ölçeceksiniz: hangi eylemler (talep, sipariş, kayıt) sizin için sonuç sayılır.
- Mevcut bir site varsa, ondan neyin korunması, neyin değiştirilmesi gerektiği ve neden.
Hedef kitle ve kullanım senaryoları
Siteyi kim kullanacak? Potansiyel müşteriler, mevcut müşteriler, iş ortakları, iş arayanlar, şirket çalışanları. Her grup için siteye neden geldiklerini ve orada ne yapmaları gerektiğini yazın. Örneğin: "Kurumsal müşteri hizmetleri inceler ve teklif ister" veya "Mevcut müşteri hesabına giriş yapar ve siparişlerinin durumunu görür".
Bu senaryolar daha sonra sayfa yapısını ve işlevlerin önceliğini belirlemek için temel olur.
Hedef kitlenin dili, coğrafyası ve hangi cihazları kullandığı da burada belirtilmelidir. Örneğin ziyaretçilerin çoğu siteyi cep telefonundan açıyorsa, tasarım ve işlevler öncelikle mobil ekran için düşünülmelidir. Uluslararası bir kitle varsa hangi dillerin gerektiği ve içeriğin her dilde aynı olup olmayacağı önceden belirlenmelidir.
Yapı, sayfalar ve işlevler
Site haritası
Tüm sayfaları ve bölümleri hiyerarşik bir liste halinde yazın: ana sayfa, hizmetler, projeler, blog, hakkımızda, iletişim vb. Her sayfa için kısa bir açıklama verin: orada hangi bilgiler yer alacak ve kullanıcı ne yapabilecek.
İşlevsel gereksinimler
İşlevleri genel ifadelerle değil, davranış olarak tanımlayın. "Arama olsun" yerine şunu yazın: "Kullanıcı ürünleri ada ve kategoriye göre arayabilir, sonuçları fiyata göre filtreleyebilir". Tipik işlevler:
- İletişim ve talep formları, nereye gönderildikleri.
- Kullanıcı kaydı, kullanıcı hesabı, roller ve yetkiler.
- Katalog, filtreler, sepet, ödeme, sipariş durumları.
- Çok dillilik: hangi diller ve hangi içerik çevrilecek.
- Yönetim paneli: çalışanlar neleri kendileri değiştirebilmeli.
Öncelikler
Her işlevi "mutlaka gerekli", "olsa iyi olur" ve "sonraki aşama" olarak işaretleyin. Bu, bütçe sınırlı olduğunda projeyi aşamalara bölmeyi sağlar.
Teknik gereksinimler, tasarım ve içerik
Entegrasyonlar ve teknik gereksinimler
Site tek başına çalışmayacaksa bunu baştan yazmak önemlidir. Entegrasyonlar genellikle projenin en çok zaman alan kısmıdır.
- Harici sistemler: CRM, ödeme sistemi, muhasebe programı, kargo hizmeti, e-posta gönderimi.
- Veri akışı: hangi veri, hangi yönde ve ne zaman aktarılıyor.
- Hosting ve alan adı: mevcut hosting mi kullanılacak, yoksa yenisi mi seçilecek; alan adı kimin adına kayıtlı.
- Güvenlik: HTTPS, yedekler, kişisel verilerin korunması.
- Performans ve uyumluluk: mobil cihazlarda doğru görünüm, desteklenen tarayıcılar, sayfaların yüklenme hızı.
- SEO temelleri: doğru URL yapısı, meta veriler, site haritası, eski siteden yönlendirmeler.
Tasarım ve içerik
Tasarım için marka materyallerinizi (logo, renkler, yazı tipleri, kurumsal kimlik kılavuzu) ekleyin ve beğendiğiniz ve beğenmediğiniz sitelerin örneklerini kısa açıklamalarla gösterin. "Bu sitenin navigasyonu anlaşılır" gibi somut bir yorum, "bu site güzel" ifadesinden çok daha faydalıdır.
İçerik ayrıca planlanmalıdır. Metinleri, fotoğrafları ve videoları kim hazırlayacak, hangi dillerde olacak ve ne zaman teslim edilecek? Uygulamada projelerin gecikmesinin sık görülen nedeni teknik iş değil, içeriğin zamanında hazır olmamasıdır.
İyi bir teknik şartname her sorunun cevabını vermez, ama hangi soruların hâlâ açık olduğunu ve bunları kimin, ne zaman yanıtlayacağını açıkça gösterir.
Aşamalar, teslim ve destek
Belgenin son bölümü projenin yönetimiyle ilgilidir:
- Aşamalar: prototip, tasarım, yazılım geliştirme, içeriğin yerleştirilmesi, test, yayına alma.
- Onay noktaları: her aşamanın sonucunu kim ve hangi süre içinde onaylıyor.
- Kabul kriterleri: hangi kontrollerden geçilmeli ve iş hangi durumda kabul edilmiş sayılır.
- Teslim edilecekler: yönetim paneline erişim, kaynak kod, dokümantasyon, çalışanlar için eğitim.
- Sonraki destek: garanti süresi, teknik bakım, güncellemeler ve yeni gereksinimlerin nasıl fiyatlandırılacağı.
Belgenin biçimi ve tipik hatalar
Kapsam ve biçim
Teknik şartnamenin uzunluğu projenin karmaşıklığına uygun olmalıdır. Birkaç sayfalık kurumsal bir site için bir iki sayfalık net bir belge yeterli olabilir. Müşteri hesabı, entegrasyonlar ve roller içeren bir platform için ise daha ayrıntılı bir tanım, bazen her işlev için ayrı bir kullanıcı hikâyesi gerekir.
Biçimden çok netlik önemlidir. Birkaç pratik öneri:
- Her gereksinime ayrı ayrı atıfta bulunulabilmesi için kısa cümleler ve numaralı listeler kullanın.
- Terimleri bir kez tanımlayın ve belge boyunca aynı anlamda kullanın.
- Mümkün olan yerlerde şema, prototip veya ekran taslağı ekleyin: basit bir çizim uzun bir açıklamadan daha çabuk anlaşılır.
- Belgenin sürümünü ve son değişiklik tarihini not edin.
Tipik hatalar
- Fazla genel ifadeler. "Modern, kullanışlı, hızlı bir site" bir gereksinim değil, bir istektir. Bunu ölçülebilir kriterlere dönüştürün.
- Sorunu değil, çözümü yazmak. "Açılır pencere olsun" yerine önce neyi başarmak istediğinizi açıklayın; belki daha iyi bir çözüm vardır.
- Entegrasyonları sonraya bırakmak. Projenin ortasında ortaya çıkan bir entegrasyon hem mimariyi hem de süreyi etkiler.
- İçeriği unutmak. Boş bir şablonla teslim edilen site işe yaramaz.
- Belgeyi bir kez yazıp unutmak. Güncel kalması için üzerinde anlaşılan değişiklikler belgeye eklenmelidir.
Sonuç
Teknik şartname projenin haritasıdır: amaç, kullanıcılar, işlevler, entegrasyonlar, içerik ve teslim koşulları tek bir belgede olduğunda bütçe ve süre öngörülebilir hale gelir, değişiklikler de yönetilebilir olur. Mükemmel bir belge yazmaya çalışmayın, ama onu net, somut ve güncel tutun. Henüz bir teknik şartnameniz yoksa ya da onu birlikte netleştirmek istiyorsanız, projenizi TRUE ile konuşun.
