Fərdi redaktorlar

Elə işlər var ki, heç bir paneldə yoxdur, çünki yalnız sizə aiddir: təchizatçının formuluna görə qiymətlərin öz hesablanması, kataloqun başqa uçot sistemi ilə tutuşdurulması, "partiyanın xüsusiyyətlərini bir keçiddə doldur" ekranı. "Fərdi redaktorlar" bölməsi belə bir mini-redaktoru özünüz yazmağa (və ya sifariş etməyə) və admin panelinin içində işə salmağa imkan verir — sandboxda, yalnız icazə verdiyiniz məlumatlara çıxışla.

Açmaq üçün: Admin panel → Fərdi redaktorlar (admin.cenaly.com/custom-editors). Bölmə tətbiq mağazasındakı "Fərdi redaktorlar (SDK)" kartı ilə aktivləşdirilir — standart olaraq gizlidir. Səhifənin özündəki "📌 Yan panelə" düyməsi onu tez-tez lazım olduqda yan menyuya çıxarır.

Bu hansı bölmədir#

Plugin yığılmış skript (index.js) və onun təsviridir (manifest.json). Panel skripti təcrid olunmuş freymdə yükləyir: onun nə sessiyanıza, nə admin panelinin koduna, nə də şəbəkəyə çıxışı yoxdur. Məlumatlarla yalnız körpü vasitəsilə danışa bilər — hər biri verilmiş hüquqlara görə yoxlanılan icazəli sorğular toplusu.

Səhifə bloklardan ibarətdir:

Açılmış redaktor bütün ekranı tutur, səhifənin ünvanı isə ?app=<identifikator> işarəsini alır — bu keçidi çıxışı olan şəxslə paylaşa bilərsiniz.

İşə salmaq üçün nə lazımdır#

Addım 1. Redaktoru kimin yazacağına qərar vermək#

Üç yol var və onlar kodu kimin saxlaması ilə fərqlənir:

Hər üç halda quraşdırma sahibin öhdəsində qalır: hətta qrantı olan developer də yalnız öz kodunu developer rejimində işə sala bilər, amma onu hesaba quraşdıra bilməz.

Addım 2. Süni intellektlə hazırlanma (vayb-kodinq)#

"🤖 Süni intellektlə hazırlanma (vayb-kodinq)" bloku tapşırığı süni intellekt agentinə (Claude Code, Cursor və bənzərlərinə) vermək və kontraktı sıfırdan izah etməmək üçün dörd şey təqdim edir:

1. "⬇️ Layihə şablonunu yüklə (zip)" — hazır plugin karkası: manifest, giriş nöqtəsi, kontrakt təsviri (GUIDE.en.md) və agent üçün təlimat. Arxiv birbaşa brauzerdə yığılır, xaricdən heç nə yükləmək lazım deyil.
2. "📋 Agent üçün promptu kopyala" — ingilis dilində tapşırıq mətni: şablondan başlamaq, bələdçi ilə tutuşdurmaq, nəticəni nə ilə yoxlamaq.
3. Agent üçün alətlər dəstinin konfiqurasiyası — onunla agent plaqini yığır, sandboxın lokal stend-kopyasını qaldırır, ekran görüntüləri və vəziyyət snapshotları çəkir, sonda isə relizi yığır: əl ilə quraşdırma üçün zip və ya GitHub-da reliz.
4. "⬇️ Kataloq snapshotını yüklə (test fiksturası)" — kateqoriyalarınız və maddələriniz fayl şəklində, ki agent uydurulmuş deyil, real məlumatlarda test etsin.

⚠️ Snapshotdan digər pluginlərin fərdi sahələri tamamilə çıxarılır: başqa genişlənmənin sizin kartlarınızda saxladığı məlumatlar fikstura ilə birlikdə hesabdan çıxmır.

Addım 3. Redaktoru quraşdırmaq#

Fayllardan. "Redaktor quraşdır" bloku: "Bundl (index.js)" və "Manifest (manifest.json)" seçin → "Yoxla və quraşdır". Panel əvvəlcə manifesti yoxlayır — identifikator, lokallaşdırılmış ad, versiya, minimum SDK versiyası, yerləşdirmə yerləri, hüquqlar və şəbəkə hostlarının siyahısı, — sonra isə konsenti göstərir: "Bu redaktor tələb edir:" və hüquqların siyahısı sadə dildə. Siz "Quraşdır" düyməsini basmayana qədər heç nə quraşdırılmır.

GitHub-dan. "GitHub-dan quraşdırma" bloku: "Repozitoriya (URL və ya owner/repo)" sahəsi, "Teq (boş = son reliz)" sahəsi və "Repozitoriyanı yoxla" düyməsi. Konvensiya sadədir: repozitoriyanın kökündə manifest.json, teqdə yığılmış dist/index.js, teq v{versiya} formasında. Manifest və bundl birbaşa brauzerinizdən çəkilir. Hər iki halda quraşdırma zamanı bundlun barmaq izi (sha256) hesablanır və yadda saxlanılır: fayl sonradan dəyişdirilərsə, işə salınma bloklanacaq və panel redaktoru yenidən quraşdırmağı tələb edəcək.

Hüquqlar və yerləşdirmə yerləri#

Hüquqları (onlara skoplar da deyilir) plagin manifestdə istəyir, siz isə quraşdırma zamanı təsdiqləyirsiniz. Tam siyahı budur, körpü bundan artıq heç nə edə bilmir:

Siyahıda heç olmayanı plagini heç bir parametrlə əldə edə bilməz: qonaqları və müştəriləri, sifarişləri, qəbzləri, maliyyəni, əməkdaşları, yazışmaları və zəngləri körpü vermir.

Yerləşdirmə yerləri (slotlar) — üç:

Developer rejimi və podratçıya giriş#

Developer rejimi («🛠️ Developer rejimi» bloku) plagini birbaşa sizin kompüterinizdən qoşur: «Bundle URL» sahəsi yalnız localhost / 127.0.0.1 ünvanlarını qəbul edir, yanında — «Manifest JSON», «Dev sessiyasını başlat» düyməsi. Bu zaman barmaq izi sabitlənmir və sessiya vərəq bağlanana qədər yaşayır; «Dev sessiyasını dayandır» onu dərhal söndürür.

Developerə qrantlar («👩‍💻 Developer girişi» bloku) yazan şəxs sahib olmadıqda lazımdır. Developer üçün adi əməkdaş hesabı yaradılır, sonra sahib qrant verir: «Developerin e-poçtu (onun staff-logini)», «İcazə verilən hüquqlar», «Qüvvədə olma müddəti (günlər)» və istəyə bağlı qeyd → «Giriş ver». İstənilən vaxt «Geri götür» düyməsi ilə ləğv etmək olar.

Qrant nə verir, nə vermir:

• verir — yalnız işarələdiyiniz hüquqlarla developer rejimini (standart müddət 14 gün, maksimum 90);
• hüquqlar kəsişmə ilə kəsilir: manifestin istədiyi və qrantla verilən; plagin artığını ala bilməz, hətta manifestdə istəsə də;
• vermir — plaginlərin quraşdırılması, işə salınması və silinməsi: bu sahibdə qalır.

Yeniləmə, işə salma və silmə#

Avtomatik yeniləmə qəsdən yoxdur: yad kodun yeni versiyası yeni barmaq izi və bəlkə də yeni hüquqlar deməkdir, ona görə yeniləmə həmişə sahibin şüurlu əməliyyatıdır.

Daxili genişlənmələr#

Bizim öz modullarımızın bir hissəsi eyni formatda paketlənib — bu, davranışdan görünür, lakin onları quraşdırmaq lazım deyil: onlar panellə birlikdə gəlir və bu bölmədə deyil, tətbiq mağazasında kartla işə salınır.

Hazırda belə modul birdir — Rusiya üçün «Mercury/VetIS»: o, «Anbar» bölməsinin vərəqində yaşayır, eyni sandboxda və eyni barmaq izi yoxlamaları ilə icra olunur. Daxili genişlənmələr quraşdırılmış redaktorlar siyahısına düşmür.

Redaktor nə edə bilər və nə edə bilməz#

Üçüncü tərəf plaginləri kartda xəbərdarlıqla işarələnir: «Sandboxda üçüncü tərəf tətbiqi — o, heç vaxt parol soruşmur». Əgər plagin paneldən login, ödəniş məlumatları və ya SMS kodu istəyirsə — bu genişlənmənin işi deyil, fırıldaqçılıqdır.

Məhdudiyyətlər#

• Bölmə standart olaraq söndürülüb və kod yazan (və ya onu sifariş edən) şəxslər üçün nəzərdə tutulub: adi sahibin burada işi yoxdur.
• Baxmaqdan başqa hər şey yalnız hesab sahibinin əlindədir. Əməkdaş hub-u yalnız oxuma rejimində görür; developer rejimi yalnız aktiv qrantla mümkündür.
• Şəxsi GitHub repozitoriyaları dəstəklənmir — repozitoriya açıq olmalıdır, quraşdırma teq üzrə aparılır.
• Avtomatik yeniləmə yoxdur: plaqinin yenilənməsini həmişə sahib başladır.
• Başqalarının plaqinləri üçün mağaza yoxdur. Hazır genişləndirmələr panel vasitəsilə dərc edilmir və satılmır — mənbə yalnız sizin faylınız və ya repozitoriyanızdır.
• Slotların sayı üçdür (öz səhifəsi, kataloq düyməsi, anbar vərəqi) — plaqin panelin istənilən ekranına yerləşə bilməz.
• Körpü qonaqları, sifarişləri, maliyyəni, əməkdaşları və yazışmaları ötürmür — bunu hüquqlarla aşmaq mümkün deyil, belə sorğular sadəcə mövcud deyil.
• “Plaqin filan işi görüb” kimi ayrıca jurnal yoxdur. Hüquqlar kartda görünür, kataloq düzəlişləri isə adi maddə tarixçəsinə düşür; nəzarət lazımdırsa, yalnız oxuma hüququ verilmiş plaqindən başlayın.
• Texniki hədlər: bundle 4 MB-a qədər, manifestdə 8 şəbəkə ünvanına qədər, hər saxlama açarı üçün 1 MB-a qədər; server icrası 30 saniyəyə və bir dəfəyə 50 internet müraciətinə qədər.
• Plaqinin məlumatları brendinizin buludunda qalır: cenaly.ru hesabında server hissəsinin vəziyyəti Rusiya konturunda saxlanılır.

Nasazlıqların aradan qaldırılması#

Tez-tez verilən suallar#

Proqramlaşdırma bilmək lazımdır?#

Hazır buraxılışı quraşdırmaq üçün — yox. Buraxılışın özünü əldə etmək üçün — bəli: onu developer və ya süni intellekt agenti “Süni intellektlə hazırlama” blokundakı şablonumuz üzrə yazır. Bölmə kod üçün alətdir, “siçanla” konstruktor deyil.

Başqasının plaqini müştərilərimi və ya gəlirimi görə bilərmi?#

Xeyr. Plaqin sandbox-da işləyir və məlumatları yalnız körpü vasitəsilə alır, körpü isə düz altı şey bacarır: kataloq, qiymətlər və stop-listlər, anbar məlumat kitabçası, öz saxlama yeri, öz server hissəsinin çağırılması və interfeys elementləri. Qonaqlar, sifarişlər, qəbzlər, maliyyə, əməkdaşlar və yazışmalar orada prinsipcə yoxdur. Konkret plaqinə nəyin icazə verildiyi həmişə onun kartındakı “Hüquqlar” sətrində görünür.

Hazırlanmanı podratçıya necə verməli və onu hesaba tam buraxmamalı?#

Ona əməkdaş uçotu yaradın, sonra “Developer girişi” blokunda qrant verin: yalnız lazımi hüquqları işarələyin və müddət təyin edin (standart olaraq 14 gün, maksimum 90). O, developer rejimi alacaq və başqa heç nə; plaqinin quraşdırılması yenə də sizin üzərinizdə qalacaq. Qrant bir düymə ilə ləğv edilir.

Müəllif yeni versiya buraxanda plaqin özü yenilənəcəkmi?#

Xeyr. Yeniləməni sahib başladır: “Yeniləmələri yoxla” → “... versiyasına yenilə”. Beləliklə, yeni versiya insanın xəbəri olmadan hesabda görünməyəcək — versiya ilə birlikdə tələb olunan hüquqlar da dəyişə bilər.

Plaqin öz parametrlərini və məlumatlarını harada saxlayır?#

Sizin hesabınızda, öz identifikatoru altında ayrı saxlama yerində (hər açar üçün 1 MB-a qədər), üstəlik, istifadə edirsə, kartlarınızın xüsusi sahələrində — hər plaqin yalnız öz məkanını görür. cenaly.ru hesabında server hissəsi və onun vəziyyəti Rusiya konturunda qalır.

Bunun API və MCP-dən fərqi nədir?#

Developerlər üçün API və öz ATS-niz üçün MCP proqram xaricdə işləyəndə lazımdır: öz saytınız, başqa uçot sistemi, süni intellekt agenti. Xüsusi redaktor isə əksinə, panelin içindəki interfeysdir: əməkdaş onu adi admin səhifəsi kimi açır və iş pəncərəsindən çıxmır.

Əlaqəli bölmələr#

• Tətbiq mağazası — bölmənin və daxili genişləndirmələrin aktivləşdirildiyi yer
• Anbar — “VetIS” kimi genişləndirmələrin yerləşdiyi vərəq və mal məlumat kitabçası
• Kataloq idxalı — vəzifə yalnız bundan ibarətdirsə, maddələrin yüklənməsinin standart yolu
• Öz kodunuzla vitrin (headless) — xarici sayt üçün açıq məlumat kontraktı
• Öz ATS-niz üçün API və MCP və Süni intellekt agentləri üçün Guest API — panelin içində deyil, xaricdə iş
• Əməkdaşlar və növbələr — developer üçün uçot və rollar
• Təhlükəsizlik və məlumatlar — məlumatların harada saxlandığı və onlara kimin çıxışı olduğu
• Dəstək — plaqin özünü şübhəli aparırsa, hara yazmalı