T-SOFT/Uygulama Geliştirme/İnceleme Kriterleri

İ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ürKim kurabilirİnceleme
GeliştirmeYalnız organizasyonunuzun test mağazalarıYok
ÖzelSeçtiğiniz mağazalar (en fazla 50), paylaştığınız linkleYalnız vitrin eklentisinin güvenlik kontrolü
Herkese açıkTüm T-SOFT mağazaları, markettenBu sayfadaki kriterlerin tamamı
Herkese açık olarak onaylanan bir uygulama bir daha özel ya da geliştirme türüne dönemez. Markete göndermeden önce uygulamayı bir süre özel olarak birkaç mağazada çalıştırmak, incelemede çıkacak sorunları önceden yakalamanın en kolay yoludur.

İ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.
ReddedildiDü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şiklikNe 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
En sık red nedenleri: kurulumdan sonra boş ya da hata veren ilk ekran, zayıf gerekçeli hassas kapsamlar (gerekçesiz olanlar gönderilemez), gizlilik webhook'larının işlenmemesi ve market sayfasındaki fiyatın ya da vaadin uygulamayla uyuşmaması.

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 uygulamalarMağaza sahibine panel içinde değer sunmaz
Uygulama ücretini T-SOFT market dışında alan uygulamalarBkz. Ücretlendirme
Mağaza sahibinin haberi olmadan vitrinin görünümünü ya da ödeme akışını değiştiren uygulamalarMağaza ve müşteri güvenliği
Mağaza verisini, uygulamanın amacı dışında toplayan ya da üçüncü taraflara aktaran uygulamalarBkz. Veri ve gizlilik
Müşteri yorumu, puanı ya da satış sayısı üreten veya değiştiren uygulamalarMağaza müşterilerini yanıltır
Kurulumdan sonra çalışmak için T-SOFT ekibinin elle müdahalesini gerektiren uygulamalarKurulum 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.

KuralBeklenen
Yetkilendirme hemen başlarKurulumdan önce ya da sonra ayrı bir kayıt, giriş veya form ekranı yoktur
Kurulum kodu takas edilircode sunucuda takas edilir; dönen store_id, oturum token'ındaki store_id ile karşılaştırılır
Mağaza bilgisi elle istenmezMağaza adresi, API kullanıcısı, şifre ya da token mağaza sahibinden istenmez; hepsi kurulumdan gelir
Kurulum sonrası uygulamaya düşerOnaydan 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ırUygulama sırrı ve mağazaya özel istemci bilgisi tarayıcıya, loga ya da repoya yazılmaz
API'ye bilinen ağdan çıkılırUygulamanın token aldığı ve API çağırdığı sunucular ağ izin listesinde bildirilmiştir
Yeniden kurulum çalışırKaldırılıp tekrar kurulan uygulama hata vermeden baştan kurulur
İzin güncellemesi çalışırYeni kapsam eklendiğinde İzinleri onayla akışı yeni kurulum koduyla sorunsuz tamamlanır
Kurulumda mağaza sahibinden web servis kullanıcısı ya da şifre istemek eski yöntemdir ve incelemeden geçmez. Bkz. Eski Kurulumdan Geçiş.

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.

KriterBeklenen
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 kurulumZorunlu ayarlar az sayıda adımda tamamlanır; ilerleme görünür (örn. "2/3 adım")
Akıllı varsayılanlarMağazadan okunabilen bilgi (dil, para birimi, iletişim bilgisi) tekrar sorulmaz; ayarlar makul varsayılanlarla gelir
İlk değerMağaza sahibi kurulumu bitirdiğinde uygulamanın çalıştığını görür: ilk senkron, ilk rapor, vitrinde görünen blok gibi
Boş durumlarHenü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östergesiUygulama ç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ımYardım dokümanına ve destek kanalına uygulama içinden tek tıkla ulaşılır
DilArayüz Türkçedir; metinlerde yazım ve tutarlılık hatası yoktur
Kurulum talimatıyla uyumMarket sayfasındaki Kurulum talimatı ile uygulamanın ilk ekranları aynı adımları anlatır
Deneme süresiDeneme süresi varsa bitiş tarihi ve sonrasında ne olacağı uygulama içinde açıkça gösterilir
Kendi uygulamanızı hiç görmemiş birine kurdurun ve hiçbir şey söylemeden izleyin. Takıldığı her yer, inceleyicinin de takılacağı yerdir.

Kapsamlar

Uygulama yalnızca gerçekten kullandığı kapsamları ister.

KuralBeklenen
En az kapsamKullanılmayan kapsam istenmez; write_ gerekmiyorsa read_ istenir
GerekçeHer kapsamı hangi özelliğin kullandığı inceleyiciye yazılan notta anlatılır
Hassas kapsamlarHassas 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.

KuralBeklenen
Oturum token'ı doğrulanırHer istekte token sunucuda ES256 ile doğrulanır; iss, aud ve süresi kontrol edilir
Çereze dayanılmazOturum, iframe'de engellenebilen üçüncü taraf çerezine değil token'a dayanır
Yalnızca panelde gömülürYanıtlarda frame-ancestors başlığı gönderilir
Panelden çıkarılmazUygulamanı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ırBildirim, onay penceresi, ürün seçici ve gezinme için @tekrom/tsoft-app-gate kullanılır; alert() / confirm() kullanılmaz
Yükseklik doğruautoResize() ile iframe içeriğe göre boyutlanır; çift kaydırma çubuğu oluşmaz
Gezinme korunurUygulama içi yollar navigate.app() ile panel adresine yansır; sayfa yenilendiğinde aynı ekran açılır
MobilPanel 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.

KuralBeklenen
Sır yokPakette ya da ayar şemasında API anahtarı, token gibi sır benzeri değer yoktur; sırlar sunucunuzda kalır
Dış adresler gerekçeliBetiğ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ündeBloklar mağaza sahibi tema editöründe yerleştirene kadar vitrinde hiçbir şey değiştirmez
RızaZiyaretç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ızBetik, uygulama sunucusu erişilemez olduğunda bile vitrinde konsol hatası üretmez ve sayfayı bozmaz
Sürüm notuHer 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

KuralBeklenen
Kaldırma bildirimi işleniruninstall_url tanımlıdır; gelen token doğrulanır ve event alanının app.uninstalled olduğu kontrol edilir
Hızlı yanıtBildirime 10 saniye içinde 2xx dönülür; ağır işler kuyruğa alınır
İşlem dururKaldı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.

KuralBeklenen
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üresiSilme 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 azdaMüşteri adı, e-posta, telefon, adres gibi kişisel veri yalnızca işlev gerektiriyorsa saklanır
Güvenli saklamaMağazaya özel istemci bilgisi ve kişisel veri şifreli saklanır; tüm trafik https:// üzerindendir
Üçüncü taraflarVeri bir üçüncü tarafa (yapay zekâ servisi, analitik, e-posta servisi gibi) aktarılıyorsa gizlilik politikasında ve market sayfasında belirtilir

Bkz. Gizlilik webhook'ları

Ücretlendirme

KuralBeklenen
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 yokEk ü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

KriterBeklenen
Hata yokKurulum, onboarding ve ana işlevler sırasında 4xx/5xx yanıtı, boş ekran ya da sonsuz yükleme yoktur
Konsol temizTarayı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ıkUygulama 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.

AlanZorunluBeklenen
Uygulama adıEvetKısa ve uygulamaya özgü; "T-SOFT" adını ya da başka bir markayı izinsiz içermez
Kısa açıklamaEvetUygulamanın mağazaya ne kazandırdığını tek cümlede anlatır (en fazla 500 karakter)
Ayrıntılı tanıtımEvetNe 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
İkonEvet1200 × 1200 px, metinsiz; market ve panelde logo yerine görünür
Ekran görüntüleriEn az 1JPG, PNG ya da WEBP, en fazla 2 MB; uygulamanın gerçek arayüzünü gösterir. 3–6 adet, 1600 × 900 px önerilir
KategoriUygulamanın asıl işlevine uygun kategori
Kurulum talimatıKurulumdan sonra mağaza sahibinin yapması gerekenler
Tanıtım videosu1920 × 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
Zorunlu maddeler (kısa açıklama, ayrıntılı tanıtım, ikon, ekran görüntüsü; sırrı olan uygulamada ağ izin listesi) eksikse Markete gönder sunucu tarafından reddedilir. Diğer satırlar incelemede değerlendirilir.

Destek

KuralBeklenen
Destek kanalıE-posta ya da destek formu market sayfasında ve uygulama içinde yer alır
Yanıt süresiMağaza sahibi taleplerine makul sürede (iş günü içinde) dönülür
Acil iletişimT-SOFT'un kritik bir sorunda (güvenlik, veri, kesinti) ulaşabileceği bir teknik iletişim kişisi bildirilir
Sürüm notuDavranışı 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çeleriKapsamları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 videosuKurulumdan ilk değere kadar olan akışın kısa ekran kaydının bağlantısı
Teknik iletişim kişisiAcil 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

Sıradaki adım