Özel editörler

Bazı işler hiçbir panelde yoktur, çünkü yalnızca size özgüdür: tedarikçi formülüne göre kendi fiyat yeniden hesaplamanız, kataloğun başka bir muhasebe sistemiyle karşılaştırılması, "parti özelliklerini tek geçişte doldur" ekranı. "Özel editörler" bölümü böyle bir mini editörü kendiniz yazmanıza (veya yazdırmanıza) ve yönetim panelinin içinde çalıştırmanıza olanak tanır — bir korumalı alanda, yalnızca izin verdiğiniz verilere erişimle.

Açmak için: Yönetim paneli → Özel editörler (admin.cenaly.com/custom-editors). Bölüm, uygulama mağazasındaki "Özel editörler (SDK)" kartıyla açılır — varsayılan olarak gizlidir. Sayfanın kendisindeki "📌 Kenar çubuğuna" düğmesi, sık ihtiyaç duyulduğunda onu yan menüye taşır.

Bu bölüm nedir#

Eklenti, derlenmiş bir betik (index.js) ve onun tanımıdır (manifest.json). Panel betiği yalıtılmış bir çerçevede yükler: ne oturumunuza, ne yönetim panelinin koduna, ne de ağa erişimi vardır. Verilerle yalnızca köprü üzerinden konuşabilir — her biri verilen yetkilere göre denetlenen izinli istekler kümesi.

Sayfa şu bloklardan oluşur:

Açık editör tüm ekranı kaplar ve sayfanın adresi ?app=<tanımlayıcı> işaretini alır — bu bağlantı, erişimi olan biriyle paylaşılabilir.

Başlatmak için ne gerekir#

Adım 1. Editörü kimin yazacağına karar vermek#

Üç yol var ve bunlar kodu kimin tuttuğuyla ayrılır:

Her üç durumda da yükleme hesap sahibinde kalır: yetkisi olan bir geliştirici bile kendi kodunu yalnızca geliştirici modunda çalıştırabilir, ancak onu hesaba yükleyemez.

Adım 2. Yapay zekâ ile geliştirme (vibe coding)#

"🤖 Yapay zekâ ile geliştirme (vibe coding)" bloğu, görevi bir yapay zekâ aracısına (Claude Code, Cursor ve benzerleri) vermek ve ona sözleşmeyi sıfırdan açıklamamak için dört şey sunar:

1. "⬇️ Proje şablonunu indir (zip)" — hazır eklenti iskeleti: manifest, giriş noktası, sözleşme açıklaması (GUIDE.en.md) ve aracı için yönerge. Arşiv doğrudan tarayıcıda oluşturulur, dışarıdan hiçbir şey indirmeye gerek yoktur.
2. "📋 Aracı için istemi kopyala" — İngilizce görev metni: şablondan başla, kılavuza göre denetle, sonucu neyle sına.
3. Aracı için araç kümesi yapılandırması — bununla aracı eklentiyi derler, korumalı alanın yerel bir kopya tezgâhını kurar, ekran görüntüleri ve durum anlık görüntüleri alır, sonunda sürümü derler: elle yükleme için zip ya da GitHub'da sürüm.
4. "⬇️ Katalog anlık görüntüsünü indir (test fikstürü)" — kategorileriniz ve ürünleriniz dosya olarak, böylece aracı uydurma verilerle değil gerçek verilerle test eder.

⚠️ Anlık görüntüden diğer eklentilerin özel alanları tamamen çıkarılır: başka bir uzantının kartlarınızda sakladığı veriler, fikstürle birlikte hesaptan çıkmaz.

Adım 3. Editörü yüklemek#

Dosyalardan. "Editör yükle" bloğu: "Paket (index.js)" ve "Manifest (manifest.json)" seçin → "Denetle ve yükle". Panel önce manifesti denetler — tanımlayıcı, yerelleştirilmiş ad, sürüm, en düşük SDK sürümü, yerleşimler, yetkiler ve ağ ana makineleri listesi — ardından onayı gösterir: "Bu editör şunları istiyor:" ve yetkilerin sade bir dille listesi. "Yükle" düğmesine basmadığınız sürece hiçbir şey yüklenmez.

GitHub'dan. "GitHub'dan yükleme" bloğu: "Depo (URL veya owner/repo)" alanı, "Etiket (boş = son sürüm)" alanı ve "Depoyu denetle" düğmesi. Kural basittir: deponun kökünde manifest.json, etikette derlenmiş dist/index.js, etiket v{sürüm} biçiminde. Manifest ve paket doğrudan tarayıcınızdan çekilir. Her iki durumda da yükleme sırasında paketin parmak izi (sha256) hesaplanır ve hatırlanır: dosya sonradan değiştirilirse çalıştırma engellenir ve panel editörü yeniden yüklemenizi ister.

Yetkiler ve yerleşim yerleri#

Yetkiler (bunlara kapsam da denir) eklenti tarafından manifestoda istenir, siz de kurulum sırasında onaylarsınız. Tam liste aşağıdadır; köprü bundan fazlasını yapamaz:

Listede hiç bulunmayan bir şeye eklenti hiçbir ayarla erişemez: misafirler ve müşteriler, siparişler, fişler, finans, çalışanlar, yazışmalar ve aramalar köprü tarafından verilmez.

Yerleşim yerleri (yuvalar) üç tanedir:

Geliştirici modu ve yükleniciye erişim#

Geliştirici modu ("🛠️ Geliştirici modu" bloğu) eklentiyi doğrudan bilgisayarınızdan bağlar: "Paket URL'si" alanı yalnızca localhost / 127.0.0.1 adreslerini kabul eder, yanında "Manifesto JSON'u" ve "Geliştirme oturumunu başlat" düğmesi bulunur. Bu durumda parmak izi sabitlenmez ve oturum sekme kapanana kadar sürer; "Geliştirme oturumunu durdur" ise oturumu hemen kapatır.

Geliştiriciye verilen izinler ("👩‍💻 Geliştirici erişimi" bloğu) yazılımı sahibi yazmadığında gereklidir. Geliştirici için normal bir çalışan hesabı açılır, ardından sahibi izni verir: "Geliştiricinin e-postası (personel girişi)", "İzin verilen yetkiler", "Geçerlilik süresi (gün)" ve isteğe bağlı not → "Erişim ver". İzin her an "Geri al" düğmesiyle iptal edilebilir.

İznin sağladıkları ve sağlamadıkları:

• sağlar — yalnızca işaretlediğiniz yetkilerle geliştirici modunu (varsayılan süre 14 gün, en fazla 90);
• yetkiler kesişimle sınırlanır: manifestonun istediği ve izinle verilen; eklenti manifestoda istese bile fazlasını alamaz;
• sağlamaz — eklenti kurma, açma ve silme: bunlar sahibinde kalır.

Güncelleme, açma ve silme#

Otomatik güncelleme bilinçli olarak yoktur: başkasının kodunun yeni sürümü yeni bir parmak izi ve belki de yeni yetkiler demektir, bu nedenle güncelleme her zaman sahibin bilinçli bir eylemidir.

Yerleşik uzantılar#

Kendi modüllerimizin bir kısmı aynı biçimde paketlenmiştir — bu davranıştan anlaşılır, ancak bunları kurmak gerekmez: panel ile birlikte gelirler ve bu bölümde değil, uygulama mağazasındaki kartla açılırlar.

Şu anda böyle bir modül var — Rusya için "Mercury/VetIS": depo bölümünde sekme olarak yaşar, aynı korumalı alanda ve aynı parmak izi kontrolleriyle çalışır. Yerleşik uzantılar kurulu editörler listesine girmez.

Editörün yapabildikleri ve yapamadıkları#

Üçüncü taraf eklentiler kartta bir uyarıyla işaretlenir: "Korumalı alanda üçüncü taraf uygulama — parolayı asla sormaz." Eklenti panel girişi, ödeme bilgisi veya SMS kodu istiyorsa bu uzantının çalışması değil, dolandırıcılıktır.

Sınırlamalar#

• Bölüm varsayılan olarak kapalıdır ve kod yazanlara (ya da kod yazdıranlara) yöneliktir: sıradan bir işletme sahibinin burada yapacak bir işi yoktur.
• Görüntüleme dışındaki her şey yalnızca hesap sahibine aittir. Çalışan merkezi salt okunur görür; geliştirici modu yalnızca geçerli bir yetkiyle açılır.
• Özel GitHub depoları desteklenmez — depo herkese açık olmalıdır, kurulum etikete göre yapılır.
• Otomatik güncelleme yoktur: eklenti güncellemesini her zaman hesap sahibi başlatır.
• Başkalarının eklentileri için mağaza yoktur. Hazır uzantılar panel üzerinden yayımlanmaz ve satılmaz — kaynak yalnızca sizin dosyanız veya sizin deponuzdur.
• Üç yuva vardır (kendi sayfası, katalog düğmesi, depo sekmesi) — eklenti panelin rastgele bir ekranına yerleşemez.
• Köprü misafirleri, siparişleri, finans verilerini, çalışanları ve yazışmaları vermez — bu, yetkilerle aşılamaz, bu tür istekler zaten mevcut değildir.
• "Eklenti şunu yaptı" şeklinde ayrı bir günlük yoktur. Yetkiler kart üzerinde görünür ve katalog düzenlemeleri olağan ürün geçmişine işlenir; kontrol istiyorsanız yalnızca okuma yetkisi verilmiş bir eklentiyle başlayın.
• Teknik üst sınırlar: paket 4 MB'a kadar, manifestte 8 ağ adresine kadar, depolama anahtarı başına 1 MB'a kadar; sunucu çalıştırması 30 saniyeye ve tek seferde 50 internet çağrısına kadar.
• Eklenti verileri markanızın bulutunda kalır: cenaly.ru üzerindeki bir hesapta sunucu tarafının durumu Rusya altyapısında bulunur.

Sorun giderme#

Sık sorulan sorular#

Programlama bilmek gerekiyor mu?#

Hazır bir sürümü kurmak için hayır. Sürümün kendisini elde etmek için evet: bunu bir geliştirici veya "Yapay zekâ ile geliştirme" bloğundaki şablonumuza göre bir yapay zekâ aracısı yazar. Bölüm, kod için bir araçtır, "fareyle" kullanılan bir kurucu değildir.

Başkasının eklentisi müşterilerimi veya gelirimi görebilir mi?#

Hayır. Eklenti korumalı alanda çalışır ve verileri yalnızca köprü üzerinden alır; köprü tam olarak altı şey yapabilir: katalog, fiyatlar ve stok dışı listeleri, depo kılavuzu, kendi depolaması, kendi sunucu tarafını çağırma ve arayüz öğeleri. Misafirler, siparişler, fişler, finans verileri, çalışanlar ve yazışmalar orada hiç yoktur. Belirli bir eklentiye tam olarak neyin izinli olduğu her zaman kartındaki "Yetkiler" satırında görünür.

Geliştirmeyi bir yükleniciye nasıl veririm ve onu hesabın tamamına sokmadan nasıl yaparım?#

Ona bir çalışan hesabı açın, ardından "Geliştirici erişimi" bloğunda bir yetki verin: yalnızca gerekli yetkileri işaretleyin ve bir süre belirleyin (varsayılan 14 gün, en fazla 90). Geliştirici modunu ve başka hiçbir şeyi almaz; eklenti kurulumu yine size ait olur. Yetki tek düğmeyle geri alınır.

Yazar yeni bir sürüm yayımladığında eklenti kendi kendine güncellenir mi?#

Hayır. Güncellemeyi hesap sahibi başlatır: "Güncellemeleri kontrol et" → "Şuna güncelle …". Böylece yeni sürüm, bir kişinin haberi olmadan hesapta görünmez — sürümle birlikte istenen yetkiler de değişmiş olabilir.

Eklenti ayarlarını ve verilerini nerede saklar?#

Hesabınızda, kendi tanımlayıcısı altındaki ayrı bir depolamada (anahtar başına 1 MB'a kadar) ve ayrıca kullanıyorsa kartlarınızın özel alanlarında — her eklenti yalnızca kendi alanını görür. cenaly.ru üzerindeki bir hesapta sunucu tarafı ve durumu Rusya altyapısında kalır.

Bunun API ve MCP'den farkı nedir?#

Geliştiriciler için API ve kendi santraliniz için MCP, program dışarıda çalıştığında gereklidir: kendi siteniz, başka bir hesap sistemi, yapay zekâ aracısı. Özel editör ise tam tersine panelin içindeki arayüzdür: çalışan onu normal bir yönetim sayfası gibi açar ve çalışma penceresinden çıkmaz.

İlgili bölümler#

• Uygulama mağazası — bölümün ve yerleşik uzantıların açıldığı yer
• Depo — "VetIS" gibi uzantıların bulunduğu sekme ve ürün kılavuzu
• Katalog içe aktarma — görev yalnızca bundan ibaretse ürünleri yüklemenin standart yolu
• Kendi kodunuzla vitrin (headless) — harici site için açık veri sözleşmesi
• Kendi santraliniz için API ve MCP ve Yapay zekâ aracıları için Guest API — panelin içinde değil, dışarıda çalışma
• Çalışanlar ve vardiyalar — geliştirici için hesap ve roller
• Güvenlik ve veriler — verilerin nerede saklandığı ve bunlara kimin erişebildiği
• Destek — eklenti şüpheli davranıyorsa nereye yazılacağı