İnceleme Kriterleri
Herkese açık bir uygulama markette yayınlanmadan önce T-SOFT tarafından incelenir. İnceleme ekibi uygulamanızı bir test mağazasına kurar, mağaza sahibinin yaşayacağı yolu baştan sona yürür ve bu sayfadaki başlıklara tek tek bakar.
Bu sayfa incelemede neye bakıldığını ve göndermeden önce kendi kendinize uygulayabileceğiniz kontrol listesini içerir. Kriterlerin amacı tek: mağaza sahibi uygulamanızı kurduğunda güvenle, hızla ve yardım istemeden işe başlayabilmeli.
Hangi uygulamalar incelenir
Partner panelinde uygulamanın Dağıtım sekmesindeki tür, incelemenin kapsamını belirler:
| Tür | Kim kurabilir | İnceleme |
|---|---|---|
| Geliştirme | Yalnız organizasyonunuzun test mağazaları | Yok |
| Özel | Seçtiğiniz mağazalar (en fazla 50), paylaştığınız linkle | Yalnız vitrin eklentisinin güvenlik kontrolü |
| Herkese açık | Tüm T-SOFT mağazaları, marketten | Bu sayfadaki kriterlerin tamamı |
İnceleme süreci
Market sayfasını doldurun
Partner panelinde uygulamanın Market sayfası sekmesini doldurun. Kısa açıklama, ayrıntılı tanıtım, ikon ve en az bir ekran görüntüsü olmadan uygulama gönderilemez. Uygulama sırrı oluşturulmuşsa ağ izin listesi de gerekir. Gizlilik webhook'ları için privacy_url ve her hassas kapsamın gerekçesi de zorunludur. Bu maddeler sunucu tarafından kontrol edilir. Ayrıntı: Market sayfası.
Kontrol listesini uygulayın
Bu sayfanın sonundaki kontrol listesini kendi test mağazanızda baştan sona yürüyün.
Markete gönderin
Dağıtım sekmesinde Herkese açık türünü seçip Markete gönder'e basın. Gönderirken T-Soft ekibine not ekle alanına uygulamanın nasıl denenebileceğini yazın. Ayrıntı: İnceleyiciye not.
Sonucu bekleyin
Uygulamanın durumu İncelemede olur. Bu sürede mevcut türü geçerli kalır; başvuruyu Geri çek ile geri alabilirsiniz.
| Sonuç | Ne olur |
|---|---|
| Onaylandı | Uygulama markette listelenir ve tüm mağazalar kurabilir. |
| Reddedildi | Düzeltilmesi gereken maddeler başvurunun altında listelenir. Maddeleri giderip yeniden gönderirsiniz; açık madde kalmışken yeni gönderim yapılamaz. |
Yayından sonra
Yayındaki uygulamada yaptığınız değişikliklerin bir kısmı yeniden incelemeye gider. İnceleme sürerken yayındaki hâli aynen kalır.
| Değişiklik | Ne olur |
|---|---|
| Market sayfası (metin, ikon, ekran görüntüsü) | Değişiklikler incelemede olarak bekler, onaydan sonra yayına girer |
| Yeni kapsam | İncelemeye gider; onaydan sonra mağaza sahipleri İzinleri onayla bağlantısını görür |
Vitrin eklentisinin yeni sürümü (tsoft app deploy) | Her sürüm incelemeye gider; onaylanana kadar mağazalarda önceki sürüm çalışır |
Otomatik güvenlik kontrolü
İnceleyici başvuruyu açtığında T-SOFT, uygulamanın adreslerini ve uç noktalarını otomatik denetler. Adreslerin https olduğuna, sahte imzalı kaldırma ve gizlilik bildirimlerinin reddedildiğine, ağ izin listesine, hassas kapsam gerekçelerine ve privacy_url'e bakar. Bu maddelerden biri kalırsa başvuru onaylanamaz. Oturum token'ı ve frame-ancestors kontrolleri inceleyiciye gösterilir ama tek başına onayı engellemez.
Aynı kontrolü göndermeden önce kendiniz çalıştırın: tsoft app security check. CI'da her yayından sonra çalıştırmak, incelemede çıkacak sorunu önceden gösterir.
Kabul edilmeyen uygulamalar
Aşağıdaki uygulamalar, teknik olarak kusursuz olsalar bile markette yayınlanmaz:
| Uygulama türü | Neden |
|---|---|
| Yalnızca dış bir siteye bağlantı veren uygulamalar | Mağaza sahibine panel içinde değer sunmaz |
| Uygulama ücretini T-SOFT market dışında alan uygulamalar | Bkz. Ücretlendirme |
| Mağaza sahibinin haberi olmadan vitrinin görünümünü ya da ödeme akışını değiştiren uygulamalar | Mağaza ve müşteri güvenliği |
| Mağaza verisini, uygulamanın amacı dışında toplayan ya da üçüncü taraflara aktaran uygulamalar | Bkz. Veri ve gizlilik |
| Müşteri yorumu, puanı ya da satış sayısı üreten veya değiştiren uygulamalar | Mağaza müşterilerini yanıltır |
| Kurulumdan sonra çalışmak için T-SOFT ekibinin elle müdahalesini gerektiren uygulamalar | Kurulum self-servis olmalıdır |
Kurulum ve yetkilendirme
Mağaza sahibi markette Yükle'ye bastığı andan uygulamanızın ilk ekranına kadar geçen yol kesintisiz olmalıdır.
| Kural | Beklenen |
|---|---|
| Yetkilendirme hemen başlar | Kurulumdan önce ya da sonra ayrı bir kayıt, giriş veya form ekranı yoktur |
| Kurulum kodu takas edilir | code sunucuda takas edilir; dönen store_id, oturum token'ındaki store_id ile karşılaştırılır |
| Mağaza bilgisi elle istenmez | Mağaza adresi, API kullanıcısı, şifre ya da token mağaza sahibinden istenmez; hepsi kurulumdan gelir |
| Kurulum sonrası uygulamaya düşer | Onaydan sonra mağaza sahibi uygulamanızın arayüzüne gelir; boş sayfa, 404 ya da genel bir "teşekkürler" ekranına değil |
| Sırlar sunucuda kalır | Uygulama sırrı ve mağazaya özel istemci bilgisi tarayıcıya, loga ya da repoya yazılmaz |
| API'ye bilinen ağdan çıkılır | Uygulamanın token aldığı ve API çağırdığı sunucular ağ izin listesinde bildirilmiştir |
| Yeniden kurulum çalışır | Kaldırılıp tekrar kurulan uygulama hata vermeden baştan kurulur |
| İzin güncellemesi çalışır | Yeni kapsam eklendiğinde İzinleri onayla akışı yeni kurulum koduyla sorunsuz tamamlanır |
Bkz. OAuth Akışı
Onboarding
Kurulumdan sonraki ilk birkaç dakika, uygulamanın kullanılıp kullanılmayacağını belirler. İnceleyici uygulamanızı ilk kez gören bir mağaza sahibi gibi kullanır ve dokümantasyon okumadan işe başlayıp başlayamadığına bakar.
| Kriter | Beklenen |
|---|---|
| Karşılama | İlk açılışta uygulamanın ne yaptığı bir iki cümleyle anlatılır ve tek bir net sonraki adım gösterilir |
| Kısa kurulum | Zorunlu ayarlar az sayıda adımda tamamlanır; ilerleme görünür (örn. "2/3 adım") |
| Akıllı varsayılanlar | Mağazadan okunabilen bilgi (dil, para birimi, iletişim bilgisi) tekrar sorulmaz; ayarlar makul varsayılanlarla gelir |
| İlk değer | Mağaza sahibi kurulumu bitirdiğinde uygulamanın çalıştığını görür: ilk senkron, ilk rapor, vitrinde görünen blok gibi |
| Boş durumlar | Henüz veri yokken boş tablo yerine ne olacağını ve ne yapılması gerektiğini anlatan bir ekran gösterilir |
| Uzun işlemler | İçe aktarma, senkron gibi işlemler arka planda yürür; ilerleme ve bitiş bildirilir, sayfa donmaz |
| Durum göstergesi | Uygulama çalışıyor mu, bağlantı sağlıklı mı, son senkron ne zaman yapıldı, mağaza sahibi tek bakışta görür |
| Hata mesajları | Hatalar mağaza sahibinin anlayacağı dilde ve ne yapması gerektiğiyle birlikte gösterilir; ham hata kodu ya da stack trace gösterilmez |
| Yardım | Yardım dokümanına ve destek kanalına uygulama içinden tek tıkla ulaşılır |
| Dil | Arayüz Türkçedir; metinlerde yazım ve tutarlılık hatası yoktur |
| Kurulum talimatıyla uyum | Market sayfasındaki Kurulum talimatı ile uygulamanın ilk ekranları aynı adımları anlatır |
| Deneme süresi | Deneme süresi varsa bitiş tarihi ve sonrasında ne olacağı uygulama içinde açıkça gösterilir |
Kapsamlar
Uygulama yalnızca gerçekten kullandığı kapsamları ister.
| Kural | Beklenen |
|---|---|
| En az kapsam | Kullanılmayan kapsam istenmez; write_ gerekmiyorsa read_ istenir |
| Gerekçe | Her kapsamı hangi özelliğin kullandığı inceleyiciye yazılan notta anlatılır |
| Hassas kapsamlar | Hassas işaretli her kapsamın gerekçesi kayıtta yazılıdır (20–500 karakter). Gerekçesi olmayan hassas kapsamla uygulama markete gönderilemez ve yayındaki uygulamaya eklenemez (422). Gerekçe inceleyiciye ve onay ekranında mağaza sahibine gösterilir; zayıf gerekçeli kapsamın çıkarılması istenir |
| Kapsam hatası | Onaylanmamış bir kapsamın ucuna istek atıldığında (403) uygulama çökmez, mağaza sahibini İzinleri onayla adımına yönlendirir |
Bkz. Kapsamlar
Panele gömülü uygulamalar
app_url tanımlı uygulamalar panelin bir parçası gibi davranmalıdır.
| Kural | Beklenen |
|---|---|
| Oturum token'ı doğrulanır | Her istekte token sunucuda ES256 ile doğrulanır; iss, aud ve süresi kontrol edilir |
| Çereze dayanılmaz | Oturum, iframe'de engellenebilen üçüncü taraf çerezine değil token'a dayanır |
| Yalnızca panelde gömülür | Yanıtlarda frame-ancestors başlığı gönderilir |
| Panelden çıkarılmaz | Uygulamanın ana işlevi iframe içinde çalışır; mağaza sahibi yeni sekmeye ya da dış siteye zorlanmaz |
| Panel köprüsü kullanılır | Bildirim, onay penceresi, ürün seçici ve gezinme için @tekrom/tsoft-app-gate kullanılır; alert() / confirm() kullanılmaz |
| Yükseklik doğru | autoResize() ile iframe içeriğe göre boyutlanır; çift kaydırma çubuğu oluşmaz |
| Gezinme korunur | Uygulama içi yollar navigate.app() ile panel adresine yansır; sayfa yenilendiğinde aynı ekran açılır |
| Mobil | Panel mobilde açıldığında uygulama kullanılabilir kalır; yatay kaydırma oluşmaz |
Bkz. Panele Gömülü Uygulamalar
Vitrin eklentisi
Vitrine betik ya da blok ekleyen uygulamalarda her sürüm incelenir. Paket yüklenirken otomatik kontrollerden geçer; bazı uyarılar inceleyicinin önüne ayrıca düşer.
| Kural | Beklenen |
|---|---|
| Sır yok | Pakette ya da ayar şemasında API anahtarı, token gibi sır benzeri değer yoktur; sırlar sunucunuzda kalır |
| Dış adresler gerekçeli | Betiğin istek attığı her dış alan adı uygulamanın işlevi için gereklidir; yeni bir alan adı eklenen sürüm ayrıca incelenir |
| Mağaza kontrolünde | Bloklar mağaza sahibi tema editöründe yerleştirene kadar vitrinde hiçbir şey değiştirmez |
| Rıza | Ziyaretçi verisi ya da piksel olayı gönderen betikler vitrin olaylarının rıza kurallarına uyar; rıza yokken reklam platformuna olay gönderilmez |
| Sayfa hızı | Betikler asenkron yüklenir ve mağazanın sayfa hızını belirgin şekilde düşürmez |
| Hatasız | Betik, uygulama sunucusu erişilemez olduğunda bile vitrinde konsol hatası üretmez ve sayfayı bozmaz |
| Sürüm notu | Her sürüm, neyin değiştiğini anlatan bir sürüm notuyla gönderilir |
Bkz. Vitrin Blokları · Vitrin Olayları · CLI ile Geliştirme
Kaldırma
| Kural | Beklenen |
|---|---|
| Kaldırma bildirimi işlenir | uninstall_url tanımlıdır; gelen token doğrulanır ve event alanının app.uninstalled olduğu kontrol edilir |
| Hızlı yanıt | Bildirime 10 saniye içinde 2xx dönülür; ağır işler kuyruğa alınır |
| İşlem durur | Kaldırılan mağaza için zamanlanmış işler, senkronlar ve dış sistemlere gönderimler durur |
Bkz. Webhooks
Veri ve gizlilik
Uygulamanız mağazanın ve mağaza müşterilerinin verisini işler. Bu verinin sorumluluğu sizdedir; KVKK kapsamındaki yükümlülükleriniz geçerlidir.
| Kural | Beklenen |
|---|---|
| Gizlilik webhook'ları | privacy_url tanımlıdır (herkese açık uygulamada zorunlu); shop.redact, customers.redact ve customers.data_request olayları doğrulanıp işlenir |
| Silme süresi | Silme ve veri talebinin yanıtı, bildirimden sonraki 15 gün içinde tamamlanır; aynı olay tekrar geldiğinde hata vermez |
| Gizlilik politikası | Herkese açık bir gizlilik politikası vardır; hangi verinin, ne amaçla, nerede ve ne kadar süre saklandığını anlatır |
| Amaçla sınırlı | Veri yalnızca uygulamanın market sayfasında anlatılan işlevi için kullanılır |
| Kişisel veri en azda | Müşteri adı, e-posta, telefon, adres gibi kişisel veri yalnızca işlev gerektiriyorsa saklanır |
| Güvenli saklama | Mağazaya özel istemci bilgisi ve kişisel veri şifreli saklanır; tüm trafik https:// üzerindendir |
| Üçüncü taraflar | Veri bir üçüncü tarafa (yapay zekâ servisi, analitik, e-posta servisi gibi) aktarılıyorsa gizlilik politikasında ve market sayfasında belirtilir |
Ücretlendirme
| Kural | Beklenen |
|---|---|
| Market üzerinden | Ücretli uygulamaların ücreti T-SOFT market üzerinden alınır; uygulama içinde ayrıca kart bilgisi, havale ya da başka bir ödeme istenmez |
| Market sayfasıyla tutarlı | Uygulama içinde anlatılan fiyat, plan ve deneme süresi market sayfasındakiyle birebir aynıdır |
| Gizli ücret yok | Ek ücret, zorunlu üyelik ya da dış serviste ücretli hesap gerekiyorsa market sayfasında açıkça belirtilir |
| Ücretsiz dürüst | "Ücretsiz" olarak sunulan uygulama, temel işlevi için ödeme duvarı göstermez |
Kalite ve performans
| Kriter | Beklenen |
|---|---|
| Hata yok | Kurulum, onboarding ve ana işlevler sırasında 4xx/5xx yanıtı, boş ekran ya da sonsuz yükleme yoktur |
| Konsol temiz | Tarayıcı konsolunda hata yoktur; console.log kalıntısı temizlenmiştir |
| Hızlı açılış | Gömülü uygulamanın ilk ekranı hızlı açılır; hedef LCP ≤ 2,5 sn, CLS ≤ 0,1, INP ≤ 200 ms |
| API kullanımı | Admin API'ye gereksiz yoğun istek atılmaz; toplu işler sayfalanır, 429 yanıtında Retry-After kadar beklenip yeniden denenir (Hız sınırları) |
| Kararlılık | Uygulama sunucusu erişilemez olduğunda panel ya da vitrin bozulmaz |
Market sayfası
Market sayfası, mağaza sahibinin uygulamanızla ilk karşılaştığı yerdir. Gerçeği anlatmalı ve vaat ettiğini uygulama yapmalıdır. Alanlar partner panelinde uygulamanın Market sayfası sekmesinde doldurulur.
| Alan | Zorunlu | Beklenen |
|---|---|---|
| Uygulama adı | Evet | Kısa ve uygulamaya özgü; "T-SOFT" adını ya da başka bir markayı izinsiz içermez |
| Kısa açıklama | Evet | Uygulamanın mağazaya ne kazandırdığını tek cümlede anlatır (en fazla 500 karakter) |
| Ayrıntılı tanıtım | Evet | Ne yaptığı, öne çıkan özellikleri, kimler için uygun olduğu; gereksinimler ve sınırlamalar dürüstçe yazılır, "en iyi", "1 numara" gibi kanıtsız iddialar yoktur |
| İkon | Evet | 1200 × 1200 px, metinsiz; market ve panelde logo yerine görünür |
| Ekran görüntüleri | En az 1 | JPG, PNG ya da WEBP, en fazla 2 MB; uygulamanın gerçek arayüzünü gösterir. 3–6 adet, 1600 × 900 px önerilir |
| Kategori | Uygulamanın asıl işlevine uygun kategori | |
| Kurulum talimatı | Kurulumdan sonra mağaza sahibinin yapması gerekenler | |
| Tanıtım videosu | 1920 × 1080 MP4, 6–12 sn, sessiz döngü, en fazla 20 MB | |
| Web sitesi | Çalışan bir https:// adresi; destek ve gizlilik politikasına buradan ulaşılabilir |
Destek
| Kural | Beklenen |
|---|---|
| Destek kanalı | E-posta ya da destek formu market sayfasında ve uygulama içinde yer alır |
| Yanıt süresi | Mağaza sahibi taleplerine makul sürede (iş günü içinde) dönülür |
| Acil iletişim | T-SOFT'un kritik bir sorunda (güvenlik, veri, kesinti) ulaşabileceği bir teknik iletişim kişisi bildirilir |
| Sürüm notu | Davranışı değiştiren güncellemeler mağaza sahibine duyurulur |
İnceleyiciye not
Markete gönder sırasında yazdığınız not inceleyicinin başlangıç noktasıdır. Eksik not, incelemeyi uzatır ya da düzeltme talebiyle döner.
| Notta olmalı | Neden |
|---|---|
| Test adımları | İnceleyicinin ana işlevi nasıl deneyeceği, adım adım |
| Kapsam gerekçeleri | Kapsamların hangi özellikte kullanıldığı; hassas kapsamların kısa gerekçesi ayrıca kayıtta yazılıdır |
| Dış servis test hesabı | Uygulama bir dış servise (kargo, ERP, pazaryeri) bağlanıyorsa inceleyicinin kullanacağı test hesabı |
| Kurulum videosu | Kurulumdan ilk değere kadar olan akışın kısa ekran kaydının bağlantısı |
| Teknik iletişim kişisi | Acil durumlar için |
Gönderim öncesi kontrol listesi
| ☑ | Kriter |
|---|---|
| ☐ | Kurulumda ayrı kayıt, giriş ya da mağaza bilgisi istenmiyor |
| ☐ | Kurulum kodu sunucuda takas ediliyor, store_id eşleşmesi kontrol ediliyor |
| ☐ | Kurulumdan sonra mağaza sahibi doğrudan uygulamanın ilk ekranına düşüyor |
| ☐ | İlk ekran ne yapıldığını anlatıyor ve tek bir sonraki adım gösteriyor |
| ☐ | Zorunlu ayarlar birkaç adımda bitiyor, mağazadan okunabilen bilgi sorulmuyor |
| ☐ | Kurulum bitince uygulamanın çalıştığı görülüyor (ilk değer) |
| ☐ | Boş durumlar, uzun işlemler ve hata mesajları anlaşılır |
| ☐ | Yalnızca kullanılan kapsamlar isteniyor; her hassas kapsamın gerekçesi kayıtta yazılı |
| ☐ | Eksik kapsam (403) durumunda uygulama çökmüyor |
| ☐ | Ağ izin listesinde uygulamanın tüm çıkış IP'leri ya da ASN'leri var |
| ☐ | Oturum token'ı her istekte sunucuda doğrulanıyor, oturum çereze dayanmıyor |
| ☐ | frame-ancestors başlığı gönderiliyor |
| ☐ | Bildirim, onay ve gezinme için panel köprüsü kullanılıyor |
| ☐ | Vitrin eklentisinde sır yok, dış adresler gerekçeli, rıza kurallarına uyuluyor |
| ☐ | uninstall_url tanımlı; bildirim doğrulanıyor ve 10 saniye içinde yanıtlanıyor |
| ☐ | privacy_url tanımlı; shop.redact, customers.redact ve customers.data_request 15 gün içinde işleniyor |
| ☐ | Kaldırılıp yeniden kurulduğunda uygulama sorunsuz çalışıyor |
| ☐ | Gizlilik politikası yayında |
| ☐ | Uygulama içinde ayrıca ödeme istenmiyor, ek ücretler market sayfasında yazıyor |
| ☐ | Konsolda hata yok, ana akışlarda 4xx/5xx yanıtı yok |
| ☐ | Market sayfasında kısa açıklama, ayrıntılı tanıtım, metinsiz ikon ve ekran görüntüleri hazır |
| ☐ | Destek kanalı ve teknik iletişim kişisi belli |
| ☐ | İnceleyiciye not: test adımları ve gerekirse dış servis test hesabı yazıldı |
| ☐ | tsoft app security check yayını engelleyen madde göstermiyor |