Կաստոմ խմբագրիչներ

Լինում է աշխատանք, որը ոչ մի պանելում չկա, որովհետև այն միայն ձերն է՝ գների ձեր վերահաշվարկը մատակարարի բանաձևով, կատալոգի համադրումը ուրիշ հաշվառման համակարգի հետ, «մեկ անցումով լրացնել խմբաքանակի բնութագրերը» էկրանը։ «Կաստոմ խմբագրիչներ» բաժինը թույլ է տալիս ինքներդ գրել այդպիսի մինի-խմբագրիչ (կամ պատվիրել այն) և գործարկել ադմինկայի ներսում՝ ավազարկղում, միայն այն տվյալների հասանելիությամբ, որոնք դուք թույլատրել եք։

Բացել՝ Ադմին-պանել → Կաստոմ խմբագրիչներ (admin.cenaly.com/custom-editors)։ Բաժինը միանում է «Կաստոմ խմբագրիչներ (SDK)» քարտով հավելվածների խանութում՝ լռելյայն այն թաքցված է։ «📌 Կողային վահանակում» կոճակը հենց էջում այն դուրս է բերում կողային ընտրացանկ, երբ այն հաճախ է պետք։

Ինչ է այս բաժինը#

Փլագինը հավաքված սկրիպտ է (index.js) և դրա նկարագրությունը (manifest.json)։ Պանելը սկրիպտը բեռնում է մեկուսացված ֆրեյմում. այն հասանելիություն չունի ոչ ձեր սեսիային, ոչ ադմինկայի կոդին, ոչ ցանցին։ Տվյալների հետ այն կարող է խոսել միայն կամրջի միջոցով՝ թույլատրված հարցումների հավաքածու, որոնցից յուրաքանչյուրը ստուգվում է տրված իրավունքներով։

Էջը բաղկացած է բլոկներից.

Բացված խմբագրիչը զբաղեցնում է ամբողջ էկրանը, իսկ էջի հասցեն ստանում է ?app=<նույնացուցիչ> նշումը՝ այդպիսի հղումով կարող եք կիսվել նրա հետ, ով հասանելիություն ունի։

Ինչ է պետք գործարկելու համար#

Քայլ 1. Որոշել, թե ով կգրի խմբագրիչը#

Ուղիներ երեքն են, և դրանք տարբերվում են նրանով, թե ով է պահում կոդը.

Բոլոր երեք դեպքերում տեղադրումը մնում է սեփականատիրոջը. նույնիսկ գրանտով մշակողը կարող է միայն գործարկել իր կոդը մշակողի ռեժիմում, բայց ոչ տեղադրել այն հաշվում։

Քայլ 2. Մշակում ԻԲ-ով (վայբ-կոդինգ)#

«🤖 Մշակում ԻԲ-ով (վայբ-կոդինգ)» բլոկը տալիս է չորս բան, որպեսզի խնդիրը հանձնեք ԻԲ-գործակալին (Claude Code, Cursor և նմաններին) և զրոյից չբացատրեք նրան պայմանագիրը.

1. «⬇️ Ներբեռնել նախագծի ձևանմուշը (zip)»՝ փլագինի պատրաստի կմախք՝ մանիֆեստ, մուտքի կետ, պայմանագրի նկարագրություն (GUIDE.en.md) և հրահանգ գործակալի համար։ Արխիվը հավաքվում է ուղիղ բրաուզերում, արտաքին ոչինչ ներբեռնել պետք չէ։
2. «📋 Պատճենել պրոմպտը գործակալի համար»՝ առաջադրանքի տեքստը անգլերենով. սկսել ձևանմուշից, համադրվել ուղեցույցի հետ, ինչով ստուգել արդյունքը։
3. Գործակալի գործիքների հավաքածուի կոնֆիգուրացիա՝ դրա հետ գործակալը հավաքում է փլագինը, բարձրացնում է ավազարկղի տեղական ստենդ-պատճենը, անում է սքրինշոթներ և վիճակի սնապշոթներ, իսկ վերջում հավաքում է թողարկումը՝ zip ձեռքով տեղադրման համար կամ թողարկում GitHub-ում։
4. «⬇️ Ներբեռնել կատալոգի սնապշոթը (թեստային ֆիքստուրա)»՝ ձեր կատեգորիաները և ապրանքները ֆայլով, որպեսզի գործակալը թեստավորի իրական տվյալների վրա, ոչ թե հորինված։

⚠️ Սնապշոթից ամբողջությամբ կտրվում են այլ փլագինների կաստոմ դաշտերը. տվյալները, որոնք ուրիշ ընդլայնումը պահում է ձեր քարտերի վրա, ֆիքստուրայի հետ միասին դուրս չեն գալիս հաշվից։

Քայլ 3. Տեղադրել խմբագրիչը#

Ֆայլերից։ «Տեղադրել խմբագրիչ» բլոկ՝ ընտրեք «Բանդլ (index.js)» և «Մանիֆեստ (manifest.json)» → «Ստուգել և տեղադրել»։ Պանելը նախ ստուգում է մանիֆեստը՝ նույնացուցիչ, տեղայնացված անուն, տարբերակ, SDK-ի նվազագույն տարբերակ, տեղաբաշխման վայրեր, իրավունքներ և ցանցային հոսթերի ցանկ, այնուհետև ցույց է տալիս համաձայնությունը. «Այս խմբագրիչը հայցում է.» և իրավունքների ցանկը մարդկային լեզվով։ Քանի դեռ չեք սեղմել «Տեղադրել», ոչինչ չի տեղադրվում։

GitHub-ից։ «Տեղադրում GitHub-ից» բլոկ՝ «Ռեպոզիտորիա (URL կամ owner/repo)» դաշտ, «Թեգ (դատարկ = վերջին թողարկում)» դաշտ և «Ստուգել ռեպոզիտորիան» կոճակ։ Կոնվենցիան պարզ է. manifest.json ռեպոզիտորիայի արմատում, հավաքված dist/index.js թեգում, թեգը՝ v{տարբերակ} տեսքով։ Մանիֆեստը և բանդլը քաշվում են ուղիղ ձեր բրաուզերից։ Երկու դեպքում էլ տեղադրման ժամանակ հաշվվում և հիշվում է բանդլի մատնահետքը (sha256). եթե ֆայլը հետո փոխարինվի, գործարկումը կարգելափակվի, և պանելը կխնդրի վերատեղադրել խմբագրիչը։

Իրավունքներ և տեղաբաշխման վայրեր#

Իրավունքները (դրանք նաև անվանում են scope-ներ) plugin-ը հայցում է manifest-ում, իսկ Դուք հաստատում եք տեղադրման ժամանակ։ Ամբողջական ցանկը՝ ահա այն, ավելին Կամուրջը ոչինչ չի կարող.

Ինչ ցանկում ընդհանրապես չկա՝ այն plugin-ը ոչ մի կարգավորումով չի ստանա. հյուրերին և հաճախորդներին, պատվերները, հաշիվները, ֆինանսները, աշխատակիցներին, նամակագրություններն ու զանգերը Կամուրջը չի տրամադրում։

Տեղաբաշխման վայրերը (սլոթները)՝ երեքը.

Մշակողի ռեժիմ և հասանելիություն կապալառուին#

Մշակողի ռեժիմը («🛠️ Մշակողի ռեժիմ» բլոկը) plugin-ը ուղիղ Ձեր համակարգչից է միացնում. «URL բանդլի» դաշտը ընդունում է միայն localhost / 127.0.0.1 հասցեներ, կողքին՝ «JSON մանիֆեստ», «Գործարկել dev-սեսիան» կոճակը։ Այս դեպքում մատնահետքը չի ամրացվում, և սեսիան ապրում է մինչև ներդիրի փակվելը. «Կանգնեցնել dev-սեսիան» անմիջապես անջատում է այն։

Գրանտներ մշակողին («👩‍💻 Մշակողի հասանելիություն» բլոկը) անհրաժեշտ են, երբ գրում է ոչ թե սեփականատերը։ Մշակողի համար ստեղծվում է սովորական աշխատակցի հաշիվ, այնուհետև սեփականատերը տրամադրում է գրանտ՝ «Մշակողի email (նրա staff-լոգինը)», «Թույլատրված իրավունքներ», «Գործողության ժամկետ (օր)» և ոչ պարտադիր նշում → «Տրամադրել հասանելիություն»։ Հետ կանչել կարելի է ցանկացած պահի «Հետ կանչել» կոճակով։

Ինչ է տալիս գրանտը, և ինչ՝ ոչ.

• տալիս է՝ միայն մշակողի ռեժիմը Ձեր նշած իրավունքներով (լռելյայն ժամկետը՝ 14 օր, առավելագույնը՝ 90);
• իրավունքները կտրվում են հատման սկզբունքով. ինչ հայցում է manifest-ը և ինչ տրված է գրանտով. ավելորդը plugin-ը չի ստանա, նույնիսկ եթե հայցի manifest-ում;
• չի տալիս՝ plugin-ների տեղադրում, միացում և հեռացում. դա մնում է սեփականատիրոջը։

Թարմացում, միացում և հեռացում#

Ինքնաթարմացում դիտավորյալ չկա. ուրիշի կոդի նոր տարբերակը նոր մատնահետք է և, հնարավոր է, նոր իրավունքներ, ուստի թարմացումը միշտ սեփականատիրոջ գիտակցված գործողությունն է։

Ներկառուցված ընդլայնումներ#

Մեր սեփական մոդուլների մի մասը փաթեթավորված է նույն ձևաչափով. դա երևում է վարքից, բայց դրանք տեղադրել պետք չէ. դրանք գալիս են պանելի հետ և միանում են քարտով հավելվածների խանութում, ոչ թե այս բաժնում։

Այժմ այդպիսի մոդուլը մեկն է՝ «Mercury/VetIS»-ը Ռուսաստանի համար. այն ապրում է «Պահեստ» բաժնի ներդիրով, կատարվում է նույն ավազարկղում և նույն մատնահետքի ստուգումներով։ Տեղադրված խմբագիրների ցանկում ներկառուցված ընդլայնումները չեն հայտնվում։

Ինչ խմբագիրը կարող է և ինչ՝ ոչ#

Երրորդ կողմի plugin-ները քարտի վրա նշվում են զգուշացմամբ. «Երրորդ կողմի հավելված ավազարկղում. այն երբեք գաղտնաբառ չի հարցնում»։ Եթե plugin-ը խնդրում է պանելի լոգին, վճարային տվյալներ կամ SMS-ից կոդ՝ դա խարդախություն է, ոչ թե ընդլայնման աշխատանք։

Սահմանափակումներ#

• Բաժինը լռելյայն անջատված է և նախատեսված է նրանց համար, ովքեր կոդ են գրում (կամ պատվիրում են այն). շարքային սեփականատիրոջը այստեղ անելիք չկա։
• Ամեն ինչ, բացի դիտումից, հասանելի է միայն հաշվի սեփականատիրոջը։ Աշխատակիցը տեսնում է հաբը read-only ռեժիմով. մշակողի ռեժիմը՝ միայն ակտիվ գրանտով։
• Մասնավոր GitHub-պահոցները չեն աջակցվում՝ պահոցը պետք է լինի հանրային, տեղադրումը կատարվում է թեգով։
• Ինքնաշխատ թարմացում չկա. հավելվածի թարմացումը միշտ գործարկում է սեփականատերը։
• Ուրիշների հավելվածների խանութ չկա։ Պատրաստի ընդլայնումները չեն հրապարակվում և չեն վաճառվում պանելի միջոցով՝ աղբյուրը միայն ձեր ֆայլն է կամ ձեր պահոցը։
• Սլոթերը երեքն են (սեփական էջ, կատալոգի կոճակ, պահեստի ներդիր)՝ պանելի կամայական էկրանին հավելվածը չի կարող ներկառուցվել։
• Կամուրջը չի տրամադրում հյուրեր, պատվերներ, ֆինանսներ, աշխատակիցներ և նամակագրություններ՝ դա հնարավոր չէ շրջանցել իրավունքներով, նման հարցումներ պարզապես գոյություն չունեն։
• «Հավելվածը արեց այսինչ բանը» առանձին մատյան չկա։ Իրավունքները երևում են քարտի վրա, իսկ կատալոգի փոփոխությունները հայտնվում են ապրանքների սովորական պատմության մեջ. եթե վերահսկողություն է պետք, սկսեք հավելվածից, որին տրված է միայն ընթերցում։
• Տեխնիկական սահմանաչափեր. բանդլը՝ մինչև 4 ՄԲ, մինչև 8 ցանցային հասցե մանիֆեստում, մինչև 1 ՄԲ մեկ պահոցի բանալու համար. սերվերային աշխատանքը՝ մինչև 30 վայրկյան և մինչև 50 ինտերնետ դիմում միաժամանակ։
• Հավելվածի տվյալները մնում են ձեր բրենդի ամպում. cenaly.ru-ի հաշվի դեպքում սերվերային մասի վիճակը գտնվում է ռուսական կոնտուրում։

Անսարքությունների վերացում#

Հաճախ տրվող հարցեր#

Պե՞տք է արդյոք ծրագրավորել իմանալ։#

Պատրաստի թողարկում տեղադրելու համար՝ ոչ։ Իսկ թողարկումը ստանալու համար՝ այո. այն գրում է մշակողը կամ ԻԻ-գործակալը մեր ձևանմուշով՝ «Մշակում ԻԻ-ով» բլոկից։ Բաժինը կոդի գործիք է, ոչ թե «մկնիկով» կոնստրուկտոր։

Կարո՞ղ է ուրիշի հավելվածը տեսնել իմ հաճախորդներին կամ հասույթը։#

Ոչ։ Հավելվածն աշխատում է ավազարկղում և տվյալներ ստանում է միայն կամրջի միջոցով, իսկ կամուրջը կարող է ուղիղ վեց բան՝ կատալոգ, գներ և ստոպ-ցուցակներ, պահեստի տեղեկատու, սեփական պահոց, սեփական սերվերային մասի կանչ և ինտերֆեյսի տարրեր։ Հյուրեր, պատվերներ, հաշիվներ, ֆինանսներ, աշխատակիցներ և նամակագրություններ այնտեղ սկզբունքորեն չկան։ Թե կոնկրետ ինչ է թույլատրված տվյալ հավելվածին, միշտ երևում է նրա քարտի «Իրավունքներ» տողում։

Ինչպե՞ս մշակումը հանձնել կապալառուին և նրան ամբողջությամբ հաշիվ չթողնել։#

Ստեղծեք նրա համար աշխատակցի հաշիվ, ապա տվեք գրանտ «Մշակողի հասանելիություն» բլոկում. նշեք միայն անհրաժեշտ իրավունքները և սահմանեք ժամկետ (լռելյայն՝ 14 օր, առավելագույնը՝ 90)։ Նա կստանա մշակողի ռեժիմ և ուրիշ ոչինչ. հավելվածի տեղադրումը միևնույն է կմնա ձեզ մոտ։ Գրանտը հետ է կանչվում մեկ կոճակով։

Կթարմացվի՞ հավելվածն ինքնաշխատ, երբ հեղինակը թողարկի նոր տարբերակ։#

Ոչ։ Թարմացումը գործարկում է սեփականատերը՝ «Ստուգել թարմացումները» → «Թարմացնել մինչև …»։ Այսպես նոր տարբերակը չի հայտնվի հաշվում առանց մարդու իմացության. տարբերակի հետ կարող են փոխվել նաև պահանջվող իրավունքները։

Որտե՞ղ է հավելվածը պահում իր կարգավորումներն ու տվյալները։#

Ձեր հաշվում՝ առանձին պահոցում իր նույնացուցիչի ներքո (մինչև 1 ՄԲ մեկ բանալու համար), գումարած, եթե դրանք օգտագործում է, ձեր քարտերի կաստոմ դաշտերում. յուրաքանչյուր հավելված տեսնում է միայն իր տարածությունը։ cenaly.ru-ի հաշվի դեպքում սերվերային մասը և դրա վիճակը մնում են ռուսական կոնտուրում։

Ինչո՞վ է սա տարբերվում API-ից և MCP-ից։#

API մշակողների համար և MCP սեփական ԱՏՀ-ի անհրաժեշտ են, երբ ծրագիրն աշխատում է դրսից. սեփական կայք, ուրիշի հաշվառման համակարգ, ԻԻ-գործակալ։ Կաստոմ խմբագրիչը, ընդհակառակը, ինտերֆեյս է պանելի ներսում. աշխատակիցը բացում է այն որպես ադմինկայի սովորական էջ և դուրս չի գալիս աշխատանքային պատուհանից։

Կապակցված բաժիններ#

• Հավելվածների խանութ — որտեղ միացվում է բաժինը և ներկառուցված ընդլայնումները
• Պահեստ — ներդիրը, որտեղ ապրում են «VetIS»-ի նման ընդլայնումները, և ապրանքների տեղեկատուն
• Կատալոգի ներմուծում — ապրանքների բեռնման ստանդարտ ուղին, եթե խնդիրը միայն դրանում է
• Ցուցափեղկ սեփական կոդով (headless) — բաց տվյալների պայմանագիր արտաքին կայքի համար
• API և MCP սեփական ԱՏՀ-ի և Guest API ԻԻ-գործակալների համար — աշխատանք դրսից, ոչ թե պանելի ներսում
• Աշխատակիցներ և հերթափոխեր — հաշիվ մշակողի համար և դերեր
• Անվտանգություն և տվյալներ — որտեղ են պահվում տվյալները և ով ունի դրանց հասանելիություն
• Աջակցություն — ուր գրել, եթե հավելվածը կասկածելի է պահում