Кастомты редакторлар
Кейде ешбір панельде жоқ жұмыс болады, өйткені ол тек сіздікі: жеткізушінің формуласы бойынша бағаларды қайта есептеу, каталогты бөгде есеп жүйесімен салыстыру, «партияның сипаттамаларын бір өтуде толтыру» экраны. «Кастомты редакторлар» бөлімі осындай шағын редакторды өзіңіз жазуға (немесе тапсырыс беруге) және админканың ішінде іске қосуға мүмкіндік береді — құмсалғышта, тек сіз рұқсат берген деректерге қолжетімділікпен.
Ашу: Әкімші панелі → Кастомты редакторлар (admin.cenaly.com/custom-editors). Бөлім қолданбалар дүкеніндегі «Кастомты редакторлар (SDK)» карточкасымен қосылады — әдепкі бойынша ол жасырылған. Сол беттегі «📌 Сайдбарға» түймесі ол жиі қажет болғанда оны бүйір мәзірге шығарады.
Бұл қандай бөлім#
Плагин — бұл жинақталған скрипт (index.js) және оның сипаттамасы (manifest.json). Панель скриптті оқшауланған фреймге жүктейді: оның сіздің сессияңызға да, админка кодына да, желіге де қолжетімділігі жоқ. Ол деректермен тек көпір арқылы сөйлесе алады — рұқсат етілген сұраулар жиынтығы, олардың әрқайсысы берілген құқықтар бойынша тексеріледі.
Бет блоктардан тұрады:
| Блок | Онда не бар |
|---|---|
| Орнатылған редакторлар | плагинге арналған карточка: атауы, «Нұсқа», «Құқықтар», «Орналастыру», «Рұқсат етілген желілік хосттар», «Жаңартылды», дереккөз (репозиторий және тег сілтеме түрінде). Әрекеттер: «Ашу», «Қосу» / «Өшіру», жаңартуларды тексеру, «Жою» |
| Редакторды орнату | дискідегі файлдардан орнату |
| GitHub-тан орнату | жария репозиторий мекенжайы және тег бойынша орнату |
| 🤖 Жасанды интеллектпен әзірлеу (вайб-кодинг) | жоба үлгісі, ЖИ-агентке арналған промпт және каталогтың тестілік деректер ретіндегі суреттемесі |
| 👩💻 Әзірлеушіге қолжетімділік | мердігерге әзірлеуші режиміне уақытша гранттар |
| 🛠️ Әзірлеуші режимі | плагинді орнатпай-ақ тікелей компьютеріңізден іске қосу |
Ашық редактор бүкіл экранды алады, ал беттің мекенжайы ?app=<идентификатор> белгісін алады — бұл сілтемені қолжетімділігі бар адаммен бөлісуге болады.
Іске қосу үшін не қажет#
| Не | Не үшін |
|---|---|
| Қолданбалар дүкеніндегі «Кастомты редакторлар (SDK)» карточкасы | бөлім тар бағытты және әдепкі бойынша өшірулі |
| Сіз — тіркелгі иесі | плагиндерді орнату, қосу, жою және гранттар беру тек иесіне ғана мүмкін; қызметкерлер тізімді тек оқу үшін көреді |
Жинақталған плагин: index.js + manifest.json |
не сіздікі, не әзірлеушіден, не жария GitHub-репозиторийіндегі релиз |
| Әзірлеу үшін — әзірлеушіге қызметкер тіркелгісі | әзірлеуші режимі оның жұмыс логинінің e-mail-ы бойынша беріледі |
1-қадам. Редакторды кім жазатынын шешу#
Үш жол бар және олар кодты кім ұстайтынымен ерекшеленеді:
| Жол | Кімге жарайды | Қалай |
|---|---|---|
| Біздің үлгі бойынша ЖИ-агент | тапсырманы сөзбен түсіндіруге дайын ие | «Жасанды интеллектпен әзірлеу» блогы: үлгі + промпт → агент релизді жинайды → сіз оны орнатасыз |
| Өз немесе жалдамалы әзірлеуші | мердігері немесе командада әзірлеушісі бар | оған әзірлеуші режиміне грант беріңіз, ол тірі тіркелгіде жазып, жөндейді, сіз дайын релизді орнатасыз |
| GitHub-тағы дайын релиз | плагин әлдеқашан жазылған (сізбен немесе сіз үшін) | «GitHub-тан орнату»: репозиторий мекенжайы және тег |
Барлық үш жағдайда да орнату иесінде қалады: тіпті гранты бар әзірлеуші де өз кодын тек өзінің әзірлеуші режимінде іске қоса алады, бірақ оны тіркелгіге орната алмайды.
2-қадам. Жасанды интеллектпен әзірлеу (вайб-кодинг)#
«🤖 Жасанды интеллектпен әзірлеу (вайб-кодинг)» блогы тапсырманы ЖИ-агентке (Claude Code, Cursor және ұқсастарына) беру және оған контрактіні нөлден түсіндірмеу үшін төрт нәрсе береді:
- «⬇️ Жоба үлгісін жүктеу (zip)» — дайын плагин қаңқасы: манифест, кіру нүктесі, контракт сипаттамасы (
GUIDE.en.md) және агентке арналған нұсқаулық. Мұрағат тікелей браузерде жиналады, сыртқы ештеңе жүктеудің қажеті жоқ. - «📋 Агентке арналған промптты көшіру» — ағылшын тіліндегі тапсырма мәтіні: үлгіден бастау, гидпен салыстыру, нәтижені немен тексеру.
- Агентке арналған құралдар жинағының конфигурациясы — онымен агент плагинді жинайды, құмсалғыштың жергілікті стенд-көшірмесін көтереді, скриншоттар мен күй суреттемелерін жасайды, ал соңында релизді жинайды: қолмен орнатуға арналған zip немесе GitHub-тағы релиз.
- «⬇️ Каталог суреттемесін жүктеу (тестілік фикстура)» — сіздің санаттарыңыз бен элементтеріңіз файл түрінде, агент ойдан шығарылған деректерде емес, нақты деректерде тестілеуі үшін.
⚠️ Суреттемеден басқа плагиндердің кастомты өрістері толығымен қиылып тасталады: бөгде кеңейтім сіздің карточкаларыңызда сақтайтын деректер фикстурамен бірге тіркелгіден кетпейді.
3-қадам. Редакторды орнату#
Файлдардан. «Редакторды орнату» блогы: «Бандл (index.js)» және «Манифест (manifest.json)» таңдаңыз → «Тексеру және орнату». Панель алдымен манифесті тексереді — идентификатор, локализацияланған атау, нұсқа, SDK-нің ең төменгі нұсқасы, орналастыру орындары, құқықтар және желілік хосттар тізімі, — содан кейін консентті көрсетеді: «Бұл редактор сұрайды:» және құқықтар тізімі адам тілінде. Сіз «Орнату» түймесін баспайынша, ештеңе орнатылмайды.
GitHub-тан. «GitHub-тан орнату» блогы: «Репозиторий (URL немесе owner/repo)» өрісі, «Тег (бос = соңғы релиз)» өрісі және «Репозиторийді тексеру» түймесі. Конвенция қарапайым: репозиторий түбірінде manifest.json, тегте жинақталған dist/index.js, тег v{нұсқа} түрінде. Манифест пен бандл тікелей сіздің браузеріңізден тартылады. Екі жағдайда да орнату кезінде бандлдың ізтаңбасы (sha256) есептеліп, есте сақталады: егер файл кейін ауыстырылса, іске қосу бұғатталады және панель редакторды қайта орнатуды сұрайды.
Құқықтар мен орналастыру орындары#
Құқықтарды (оларды скоуптар деп те атайды) плагин манифестте сұрайды, ал сіз орнату кезінде растайсыз. Толық тізім — мынау, көпір одан басқа ештеңе істей алмайды:
| Құқық | Не ашылады |
|---|---|
| Каталогты оқу | санаттар, элементтер, сипаттамалар және карточкалардың кастомты өрістері |
| Каталог элементтерін жасау және өзгерту | элементтерді жасау және түзету, партияны импорттау, өз өрістері мен сипаттама анықтамалары |
| Бағаларды, қолжетімділікті және филиалдар бойынша стоп-парақтарды өзгерту | филиал мәзіріндегі панель жасайтынның бәрі |
| Тауарлардың қоймалық анықтамалығын оқу | қойманың номенклатурасын оқу |
| Өз баптауларын сіздің қоймаңызда сақтау | плагиннің өз кілттері сіздің тіркелгіңізде (бір кілтке 1 МБ дейін) |
| Кеңейтімнің серверлік бөлігі | плагин кодын біздің серверде шақыру — оның интернетке шығудың жалғыз жолы |
Тізімде мүлде жоқ нәрсені плагин ешбір баптаумен ала алмайды: қонақтар мен клиенттерді, тапсырыстарды, чектерді, қаржыны, қызметкерлерді, хат-хабарлар мен қоңырауларды көпір бермейді.
Орналастыру орындары (слоттар) — үшеу:
| Слот | Қайда пайда болады |
|---|---|
| Өз беті | «Кастомты редакторлар» бөлімінің ішіндегі тармақ, бүкіл экранға ашылады |
| Каталог бетіндегі батырма | каталог элементтерінің жанындағы құрал |
| «Қойма» бөлімінің қойындысы | плагин қойманың қойындысы ретінде салынады — біздің «ВетИС» кіріктірілген кеңейтімі осылай қапталған |
Әзірлеуші режимі және мердігерге қатынау#
Әзірлеуші режимі («🛠️ Әзірлеуші режимі» блогы) плагинді сіздің компьютеріңізден тікелей қосады: «Бандл URL» өрісі тек localhost / 127.0.0.1 мекенжайларын қабылдайды, жанында — «Манифест JSON», «Dev-сессияны іске қосу» батырмасы. Бұл ретте саусақ ізі пиннингке алынбайды, ал сессия қойынды жабылғанша тұрады; «Dev-сессияны тоқтату» оны бірден өшіреді.
Әзірлеушіге гранттар («👩💻 Әзірлеушіге қатынау» блогы) иесі емес адам жазғанда қажет. Әзірлеушіге кәдімгі қызметкер тіркелгісі ашылады, содан кейін иесі грант береді: «Әзірлеушінің email-ы (оның staff-логині)», «Рұқсат етілген құқықтар», «Қолданылу мерзімі (күн)» және міндетті емес жазба → «Қатынау беру». «Қайтарып алу» батырмасымен кез келген сәтте қайтарып алуға болады.
Грант не береді, не бермейді:
- береді — сіз белгілеген құқықтармен тек әзірлеуші режимін (әдепкі мерзім 14 күн, максимум 90);
- құқықтар қиылысу арқылы қысқарады: манифест сұрайтын және грант берген нәрсе; артығын плагин манифестте сұраса да алмайды;
- бермейді — плагиндерді орнату, қосу және жою: бұл иесінде қалады.
Жаңарту, қосу және жою#
| Әрекет | Қалай |
|---|---|
| Ашу | карточкадағы «Ашу» батырмасы (немесе ?app=… сілтемесі) |
| Уақытша өшіру | «Өшіру» — плагин орнатылған күйде қалады, бірақ орындалмайды және өз орындарында көрсетілмейді |
| Жаңарту | GitHub-тан келген плагиндерде — «Жаңартуларды тексеру», содан кейін «… нұсқасына жаңарту»; нұсқа жаңа болса, панель «Соңғы нұсқа орнатылған» дейді. Файлдардан келген плагиндер қайта орнату арқылы жаңарады |
| Жою | Растаумен «Жою»: баптаулар мен тармақ алынады, жүктелген релиздер қоймада қалады |
Автожаңарту әдейі жоқ: бөтен кодтың жаңа нұсқасы — жаңа саусақ ізі және, мүмкін, жаңа құқықтар, сондықтан жаңарту әрқашан иесінің саналы әрекеті.
Кіріктірілген кеңейтімдер#
Біздің кейбір модульдеріміз сол форматта қапталған — бұл мінез-құлқынан көрінеді, бірақ оларды орнатудың қажеті жоқ: олар панельмен бірге келеді және осы бөлімде емес, қолданбалар дүкеніндегі карточкамен қосылады.
Қазір мұндай модуль біреу — Ресейге арналған «Меркурий/ВетИС»: ол «Қойма» бөлімінің қойындысында тұрады, сол песочницада және сол саусақ ізін тексерулермен орындалады. Кіріктірілген кеңейтімдер орнатылған редакторлар тізіміне кірмейді.
Редактор не істей алады және не істей алмайды#
| Істей алады | Істей алмайды |
|---|---|
| Берілген құқықтар шегінде каталогты оқу және өзгерту | сіздің құпиясөзіңізді білу немесе сіздің сессияңызды пайдалану |
| Өз интерфейсін, хабарламаларын және растау сұрауларын көрсету | айналасындағы админканың кодын немесе деректерін ашу |
| Панельдің тума элемент редакторын ашу | плагин терезесінен тікелей интернетке шығу |
| Өз баптауларын сіздің тіркелгіңізде сақтау | сіздің карточкаларыңыздағы басқа плагиннің деректерін көру |
| Интернетке серверлік бөлік арқылы шығу — және тек манифестте тізілген https-мекенжайларға (олар сегізден көп емес) | файл ауыстырылғаннан кейін орындалу: саусақ ізінің сәйкессіздігі іске қосуды бұғаттайды |
Үшінші тарап плагиндері карточкада ескертумен белгіленеді: «Песочницадағы үшінші тарап қолданбасы — ол құпиясөзді ешқашан сұрамайды». Егер плагин панельдің логинін, төлем деректерін немесе SMS кодын сұраса — бұл кеңейтімнің жұмысы емес, алаяқтық.
Шектеулер#
- Бөлім әдепкі бойынша өшірулі және код жазатындарға (немесе оны тапсырыспен жасататындарға) арналған: қатардағы иеге мұнда істейтін ештеңе жоқ.
- Қараудан басқаның бәрі — тек тіркелгі иесінде. Қызметкер хабты тек оқу режимінде көреді; әзірлеуші режимі — тек белсенді грантпен.
- Жеке GitHub-репозиторийлер қолдау көрсетілмейді — репозиторий жария болуы керек, орнату тег бойынша жүреді.
- Автоматты жаңарту жоқ: плагинді жаңартуды әрқашан ие іске қосады.
- Бөгде плагиндер дүкені жоқ. Дайын кеңейтімдер панель арқылы жарияланбайды және сатылмайды — дереккөз тек сіздің файлыңыз немесе сіздің репозиторийіңіз.
- Ұяшық үшеу (өз беті, каталог түймесі, қойма қойындысы) — плагин панельдің кез келген экранына ене алмайды.
- Көпір қонақтарды, тапсырыстарды, қаржыны, қызметкерлерді және хат алмасуды бермейді — мұны құқықтармен айналып өту мүмкін емес, мұндай сұраулар жай жоқ.
- «Плагин мынаны істеді» деген жеке журнал жоқ. Құқықтар карточкада көрінеді, ал каталогтағы түзетулер элементтердің әдеттегі тарихына түседі; бақылау керек болса, тек оқу құқығы берілген плагиннен бастаңыз.
- Техникалық шектер: бандл 4 МБ дейін, манифестте 8 желілік мекенжайға дейін, бір сақтау кілтіне 1 МБ дейін; серверлік жүгірту — 30 секундқа дейін және бір уақытта интернетке 50 өтінішке дейін.
- Плагин деректері сіздің брендіңіздің бұлтында қалады:
cenaly.ruтіркелгісінде серверлік бөліктің күйі ресейлік контурда жатыр.
Ақаулықтарды жою#
| Симптом | Тексеріңіз |
|---|---|
| Мәзірде бөлім жоқ | қолданбалар дүкенінде «Кастомные редакторы (SDK)» карточкасы қосылған ба; бөлім «📌 В сайдбар» түймесімен шығарылған ба |
| Қызметкер орнату түймелерін көрмейді | бұл солай ойластырылған: орнату, жою және гранттар — тек тіркелгі иесінде |
| «Бандл в хранилище не совпадает с установленным отпечатком. Запуск заблокирован» | орнатылғаннан кейін плагин файлы ауыстырылған — жаңа ізді жазу үшін редакторды қайта орнатыңыз |
| «Редактор не запустился вовремя (нет connect() за 10 с)» | плагин байланысқа шықпады: оның кодында қате бар немесе дұрыс емес файл жиналған |
| «Не удалось загрузить бандл редактора» | релиз қолжетімсіз немесе файл бүлінген — қайта орнатыңыз |
?app=… сілтемесімен өткенде «Редактор не найден или выключен» |
плагин жойылған немесе карточкада өшірілген |
| «Не удалось получить редактор из GitHub» | репозиторий жеке, түбірінде manifest.json жоқ, тегте dist/index.js жоқ немесе тег v{версия} конвенциясы бойынша аталмаған |
| «Допустимы только адреса localhost / 127.0.0.1» | әзірлеуші режимі сыртқы мекенжайларды әдейі қабылдамайды — жинақты жергілікті жерде көтеріңіз |
| Плагин қажетті деректерді көрмейді | карточкадағы «Права» бөлімін салыстырыңыз; гранты бар әзірлеушінің құқықтары қосымша грантпен қиылысу арқылы қысқартылады |
| Плагин бөгде сервиске жүгіне алмайды | песочницадан тікелей желі жоқ: жүгіну серверлік бөлік арқылы жасалады, ал мекенжай манифестте болуы керек |
| «Редактор сообщает о несохранённых изменениях. Закрыть всё равно?» | плагиннің өзі черновик туралы хабарлады — жаппас бұрын ондағы жұмысты сақтаңыз |
Жиі қойылатын сұрақтар#
Бағдарламалауды білу керек пе?#
Дайын релизді орнату үшін — жоқ. Релиздің өзін алу үшін — иә: оны әзірлеуші немесе ИИ-агент «Разработка с ИИ» блогындағы біздің үлгі бойынша жазады. Бөлім — кодқа арналған құрал, «тінтуірмен» жасалатын конструктор емес.
Бөгде плагин менің клиенттерімді немесе түсімімді көре ала ма?#
Жоқ. Плагин песочницада жұмыс істейді және деректерді тек көпір арқылы алады, ал көпір дәл алты нәрсені ғана істей алады: каталог, бағалар мен стоп-парақтар, қойма анықтамалығы, өз сақтауы, өз серверлік бөлігін шақыру және интерфейс элементтері. Қонақтар, тапсырыстар, чектер, қаржы, қызметкерлер және хат алмасу онда түбегейлі жоқ. Нақты бір плагинге не рұқсат етілгені әрқашан оның карточкасындағы «Права» жолында көрінеді.
Әзірлеуді мердігерге қалай беріп, оны тіркелгіге толық кіргізбеуге болады?#
Оған қызметкер тіркелгісін жасаңыз, содан кейін «Доступ разработчика» блогында грант беріңіз: тек қажетті құқықтарды белгілеп, мерзімін қойыңыз (әдепкі бойынша 14 күн, максимум 90). Ол әзірлеуші режимін алады, басқа ештеңе емес; плагинді орнату бәрібір сізде қалады. Грант бір түймемен қайтарып алынады.
Автор жаңа нұсқасын шығарғанда плагин өзі жаңара ма?#
Жоқ. Жаңартуды ие іске қосады: «Проверить обновления» → «Обновить до …». Осылайша жаңа нұсқа адамның білімінен тыс тіркелгіде пайда болмайды — нұсқамен бірге сұралатын құқықтар да өзгеруі мүмкін.
Плагин өз баптаулары мен деректерін қайда сақтайды?#
Сіздің тіркелгіңізде, оның идентификаторының астындағы жеке сақтауда (бір кілтке 1 МБ дейін), сонымен қатар, егер ол оларды пайдаланса, карточкаларыңыздың кастомды өрістерінде — әр плагин тек өз кеңістігін көреді. cenaly.ru тіркелгісінде серверлік бөлік және оның күйі ресейлік контурда қалады.
Бұл API және MCP-тен несімен ерекшеленеді?#
Әзірлеушілерге арналған API және өз АТС-іңіздің MCP бағдарлама сыртта жұмыс істегенде керек: өз сайтыңыз, бөгде есеп жүйесі, ИИ-агент. Кастомды редактор — керісінше, панельдің ішіндегі интерфейс: қызметкер оны әдеттегі админка беті ретінде ашады және жұмыс терезесінен шықпайды.
Байланысты бөлімдер#
- Қолданбалар дүкені — бөлім мен кіріктірілген кеңейтімдер қосылатын жер
- Қойма — «ВетИС» сияқты кеңейтімдер тұратын қойынды және тауарлар анықтамалығы
- Каталогты импорттау — міндет тек осы болса, элементтерді жүктеудің штаттық жолы
- Өз кодыңыздағы витрина (headless) — сыртқы сайтқа арналған ашық деректер контракты
- Өз АТС-іңіздің API және MCP және ИИ-агенттерге арналған Guest API — панельдің ішінде емес, сыртта жұмыс істеу
- Қызметкерлер мен ауысымдар — әзірлеушіге арналған тіркелгі және рөлдер
- Қауіпсіздік және деректер — деректер қайда сақталады және кімнің оларға қолы бар
- Қолдау — плагин күдікті әрекет етсе, қайда жазу керек