Özel editörler
Bazı işler hiçbir panelde yoktur, çünkü yalnızca size özgüdür: tedarikçi formülüne göre fiyatları kendinize özgü bir şekilde yeniden hesaplama, kataloğun başka bir muhasebe sistemiyle karşılaştırılması, "bir partinin özelliklerini tek seferde 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.ge/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 sabitle" 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:
| Blok | İçeriği |
|---|---|
| Yüklü editörler | eklenti başına kart: ad, "Sürüm", "İzinler", "Yerleşim", "İzin verilen ağ ana bilgisayarları", "Güncellendi", kaynak (bağlantı olarak depo ve etiket). Eylemler: "Aç", "Etkinleştir" / "Devre dışı bırak", güncellemeleri denetle, "Kaldır" |
| Editör yükle | diskteki dosyalardan yükleme |
| GitHub'dan kurulum | herkese açık depo adresi ve etikete göre yükleme |
| 🤖 Yapay zekâ ile geliştir (vibe coding) | proje şablonu, yapay zekâ ajanı için istem ve test verisi olarak katalog anlık görüntüsü |
| 👩💻 Geliştirici erişimi | yükleniciye geliştirici modu için geçici yetkiler |
| 🛠️ Geliştirici modu | eklentiyi yüklemeden doğrudan bilgisayarınızdan çalıştırma |
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#
| Ne | Neden |
|---|---|
| Uygulama mağazasındaki "Özel editörler (SDK)" kartı | bölüm niş bir bölümdür ve varsayılan olarak kapalıdır |
| Siz — hesap sahibi | eklentileri yüklemek, etkinleştirmek, silmek ve yetki vermek yalnızca hesap sahibinin yapabileceği işlerdir; çalışanlar listeyi yalnızca okuma olarak görür |
Derlenmiş eklenti: index.js + manifest.json |
ya sizin, ya geliştiricinin, ya da herkese açık bir GitHub deposundaki sürüm |
| Geliştirme için — geliştirici için çalışan hesabı | geliştirici modu, çalışan girişinin e-postasına göre verilir |
Adım 1. Editörü kimin yazacağına karar vermek#
Üç yol var ve bunlar kodu kimin hazırladığına göre ayrılır:
| Yol | Kime uygun | Nasıl |
|---|---|---|
| Bizim şablonumuza göre yapay zekâ ajanı | görevi sözcüklerle açıklamaya hazır hesap sahibi | "Yapay zekâ ile geliştirme" bloğu: şablon + istem → ajan sürümü derler → siz yüklersiniz |
| Ekibinizden veya dışarıdan bir geliştirici | bir yüklenici ya da ekipte geliştirici varsa | ona geliştirici modu yetkisi verin, canlı hesapta yazıp hata ayıklar, siz hazır sürümü yüklersiniz |
| GitHub'dan hazır sürüm | eklenti zaten yazılmışsa (sizin tarafınızdan veya sizin için) | "GitHub'dan kurulum": depo adresi ve etiket |
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ştir (vibe coding)#
"🤖 Yapay zekâ ile geliştir (vibe coding)" bloğu, görevi bir yapay zekâ ajanına (Claude Code, Cursor ve benzerleri) vermek ve ona teknik arayüz kurallarını sıfırdan açıklamamak için dört şey sunar:
- "⬇️ Proje şablonunu indir (zip)" — hazır eklenti iskeleti: manifest, giriş noktası, teknik arayüz açıklaması (
GUIDE.en.md) ve ajan için yönerge. Arşiv doğrudan tarayıcıda oluşturulur, dışarıdan hiçbir şey indirmeye gerek yoktur. - "📋 Ajan promptunu kopyala" — İngilizce görev metni: şablondan başla, kılavuza göre denetle, sonucu neyle sına.
- Ajan için araç kümesi yapılandırması — bununla ajan eklentiyi derler, korumalı alanı taklit eden yerel bir test ortamı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.
- "⬇️ Katalog anlık görüntüsünü indir (test fixture)" — kategorileriniz ve ürünleriniz dosya olarak, böylece ajan 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 → "İncele 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 kurulum" bloğu: "Depo (URL veya owner/repo)" alanı, "Tag (boş = son sürüm)" alanı ve "Depoyu kontrol et" 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 manifestte istenir, siz de kurulum sırasında onaylarsınız. Tam liste aşağıdadır; köprü bundan fazlasını yapamaz:
| Yetki | Neye erişim sağlar |
|---|---|
| Kataloğu okuma | kategoriler, ürünler, özellikler ve kartların özel alanları |
| Katalog öğeleri oluşturma ve düzenleme | ürün oluşturma ve düzenleme, parti içe aktarma, kendi alanları ve özellik tanımları |
| Şubelere göre fiyat, stok durumu ve stop listelerini değiştirme | şube menüsündeki panelin yaptığının aynısı |
| Envanter ürün rehberini okuma | depo ürün listesini okuma |
| Kendi ayarlarını deponuzda saklama | hesabınızdaki eklentiye ait anahtarlar (anahtar başına en fazla 1 MB) |
| Eklentinin sunucu tarafı | eklenti kodunun bizim sunucumuzda çağrılması — eklentinin internete çıkmasının tek yolu |
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:
| Yuva | Nerede görünür |
|---|---|
| Bu bölümde kendi sayfası | "Özel editörler" bölümü içinde bir öğe, tam ekran açılır |
| Katalog sayfasında düğme | ürün kataloğunun yanındaki araç |
| "Depo" bölümü sekmesi | eklenti depo sekmesi olarak çizilir — yerleşik "VetIS" uzantımız bu şekilde paketlenmiştir |
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 "Manifest JSON" ve "Dev oturumu başlat" düğmesi bulunur. Bu durumda parmak izi sabitlenmez ve oturum sekme kapanana kadar sürer; "Dev 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ştirici e-postası (personel girişi)", "İzin verilen yetkiler", "Geçerlilik (gün)" ve isteğe bağlı not → "Erişim ver". İzin her an "İptal et" 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: manifestin istediği ve izinle verilen; eklenti manifestte istese bile fazlasını alamaz;
- sağlamaz — eklenti kurma, etkinleştirme ve silme: bunlar sahibinde kalır.
Güncelleme, açma ve silme#
| İşlem | Nasıl |
|---|---|
| Aç | karttaki "Aç" düğmesi (veya ?app=… bağlantısı) |
| Geçici olarak kapat | "Devre dışı bırak" — eklenti kurulu kalır ancak çalışmaz ve yerlerinde görünmez |
| Güncelle | GitHub'dan gelen eklentilerde — "Güncellemeleri kontrol et" ve ardından "Şu sürüme güncelle: …"; sürüm güncelse panel "Güncel" der. Dosyalardan gelen eklentiler yeniden kurularak güncellenir |
| Sil | onaylı "Kaldır": ayarlar ve öğe kaldırılır, yüklenen sürümler depolama alanında kalır |
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 yer alır, 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ı#
| Yapabilir | Yapamaz |
|---|---|
| Verilen yetkiler kapsamında kataloğu okumak ve değiştirmek | parolanızı öğrenmek veya oturumunuzu kullanmak |
| Kendi arayüzünü, bildirimlerini ve onay isteklerini göstermek | çevresindeki yönetim panelinin kodunu veya verilerini açmak |
| Panelin kendi öğe düzenleyicisini açmak | eklenti penceresinden doğrudan internete bağlanmak |
| Kendi ayarlarını hesabınızda saklamak | kartlarınızdaki başka bir eklentinin verilerini görmek |
| İnternete sunucu tarafı üzerinden çıkmak — ve yalnızca manifestte listelenen https adreslerine (en fazla sekiz adet) | dosya değiştirildikten sonra çalışmak: parmak izi uyuşmazlığı başlatmayı engeller |
Üçüncü taraf eklentiler kartta bir uyarıyla işaretlenir: "Sandbox içinde üçüncü taraf uygulama — asla parolanızı 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 değişiklikleri öğelerin normal geçmişine kaydedilir; 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#
| Belirti | Şunu kontrol edin |
|---|---|
| Menüde bölüm yok | uygulama mağazasında "Özel editörler (SDK)" kartının açık olup olmadığını; bölümün "📌 Kenar çubuğuna sabitle" düğmesiyle eklenip eklenmediğini |
| Çalışan kurulum düğmelerini göremiyor | bu şekilde tasarlandı: kurulum, silme ve yetkiler yalnızca hesap sahibine aittir |
| "Depodaki paket, yüklü parmak iziyle eşleşmiyor. Çalıştırma engellendi" | eklenti dosyası kurulumdan sonra değiştirilmiş — yeni parmak izini kaydetmek için editörü yeniden kurun |
| "Editör zamanında başlamadı (10 sn içinde connect() yok)" | eklenti bağlantı kuramadı: kodunda hata var veya yanlış dosya derlenmiş |
| "Editör paketi yüklenemedi" | sürüm kullanılamıyor veya dosya bozuk — yeniden kurun |
?app=… bağlantısına gidildiğinde "Editör bulunamadı veya devre dışı" |
eklenti silinmiş veya kart üzerinde kapatılmış |
| "Editör GitHub'dan alınamadı" | depo özel, kökte manifest.json yok, etikette dist/index.js yok veya etiket v{sürüm} kuralına göre adlandırılmamış |
| "Yalnızca localhost / 127.0.0.1 adreslerine izin verilir" | geliştirici modu kasıtlı olarak harici adresleri kabul etmez — derlemeyi yerel olarak çalıştırın |
| Eklenti gerekli verileri göremiyor | kart üzerindeki "İzinler"i kontrol edin; geliştiricinin erişimi, ayrıca kendisine verilmiş geçici iznin kapsamıyla sınırlıdır |
| Eklenti başka bir hizmete erişemiyor | korumalı alandan doğrudan ağ erişimi yoktur: erişim sunucu tarafı üzerinden yapılır ve adres manifestte bulunmalıdır |
| "Editör kaydedilmemiş değişiklikler bildiriyor. Yine de kapatılsın mı?" | eklenti bir taslak olduğunu bildirdi — kapatmadan önce çalışmanızı eklenti içinde kaydedin |
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â ajanı yazar. Bölüm, kod için bir araçtır, fareyle düzenleme yapılan bir oluşturucu 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 ürün kataloğu, 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 "İzinler" satırında görünür.
Dışarıdan bir geliştiriciye tüm hesabı açmadan nasıl iş verebilirim?#
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" → "Şu sürüme 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â ajanı. Ö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ıştığı pencereden ayrılmaz.
İ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 kataloğu
- 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ğı