Vaka · Kendi ürünümüz
Ürün fikrini kapsam belgesine dönüştüren aracı yapay zekâ ekibimizle yaptık.
- Müşteri
- Pixenzo'nun kendi ürünü
- Hizmet
- Web uygulama geliştirme
- Durum
- İlk sürüm tamamlandı
- Ekip
Bora
Selin
Kaan
Murat
Kerem
Leyla

1. Özet
Uygulama yaptırmak isteyen çoğu kişi ne isteyeceğini netleştirmeden teklif istiyor; teklifler de kapsam olmadan karşılaştırılamıyor. Kapsam Sihirbazı bu boşluk için yapıldı: ürün fikrinizi 7 kısa adımda anlatırsınız, sonunda ilk sürümde neyin olacağını ve neyin olmayacağını yazan bir kapsam belgesini PDF olarak indirirsiniz.
Araç ücretsizdir, hesap istemez. Cevaplar yalnızca kullanıcının tarayıcısında kalır, hiçbir sunucuya gönderilmez. Aracı Pixenzo'nun yapay zekâ ekip üyeleri geliştirdi; araç çalışırken yapay zekâ kullanmaz, sorular ve belge şablonu sabittir. Kurucumuz Fatih Özpolat onay noktalarında devredeydi.
2. Stack
| Katman | Kullanılan |
|---|---|
| Arayüz | Preact 10, TypeScript, Vite |
| pdfmake (Türkçe karakterler için Inter fontu gömülü) | |
| Veri | Yalnızca tarayıcının yerel deposu; sunucu ve veritabanı yok |
| Test | Vitest (birim), Playwright ve axe (uçtan uca, erişilebilirlik), pdfjs (PDF metni) |
| Çalıştırma | Statik dosyalar; önizleme Docker ve nginx ile |
3. Özellikler
- Giriş, 7 soru adımı, özet ve bitiş ekranı. Verdiğiniz cevaba göre ek sorular açılır, gereksizleri gizlenir.
- Soruların çoğu seçmeli; isteğe bağlı olanlar atlanabilir. Yardım metinleri teknik terim bilmeyen biri için yazıldı.
- Cevaplar tarayıcıya kaydedilir; sayfayı kapatıp döndüğünüzde kaldığınız yerden devam edersiniz.
- Özet ekranından istediğiniz adıma dönüp cevabı değiştirebilirsiniz.
- PDF kapsam belgesi tarayıcıda üretilir: özet, sorun, hedef kullanıcılar, özellikler ve kapsam dışı kalanlar.
- Klavyeyle kullanılabilir, mobilde yapışkan eylem çubuğu var, dokunma hedefleri en az 44 piksel.






4. Süreç ve kalite
İş, Pixenzo'daki bütün işler gibi dört aşamada ilerledi ve her aşama bir devir belgesiyle bir sonrakine geçti:
- Ürün belgesi (PRD): Bora hedef kullanıcıyı, soruları, belge şablonunu ve 20 kabul senaryosunu yazdı.
- Tasarım: Selin ekranları, renk ve yazı kurallarını çıkardı; ana renk çiftleri WCAG AA kontrastını karşılıyor.
- Yazılım: Kaan'ın ekibi ürünü test yazarak geliştirdi; iş kuralları arayüzden ayrı ve birim testli.
- QA ve yayın: Murat'ın ekibi her teslimi ayrı inceledi; Kerem'in ekibi Docker önizlemesini ve güvenlik başlıklarını kurdu.
Kabul senaryolarının 20'sinin 20'si otomatik testle kapsanıyor; bunlar arasında "akış boyunca hiçbir ağ isteği yok" ve "PDF'te Türkçe karakterler doğru" senaryoları da var. Son teknik denetimde 55 birim ve 50 uçtan uca test geçti; kritik ya da yüksek önemde bulgu çıkmadı.
5. Ne öğrendik
Verinin tarayıcıdan hiç çıkmaması baştan karar olunca hem gizlilik metni kısaldı hem de "ağ isteği yok" bir test olarak yazılabildi. Kural koda değil teste bağlandığı için sonraki değişikliklerde de korunuyor.
Bir işin vaka olarak anlatılabilmesi için ölçüm noktaları baştan tanımlanmalı. Tamamlama denetimi, kullanıcıların aracı ne kadar sürede bitirdiğini ölçecek denemenin henüz yapılmadığını gösterdi; bu yüzden burada kullanım rakamı yok. Bir sonraki üründe ölçüm planı PRD'nin parçası olacak.