მორგებული რედაქტორები

ზოგჯერ გჭირდებათ სამუშაო, რომელიც არცერთ პანელში არ არის, რადგან მხოლოდ თქვენ გეხებათ: ფასების გადათვლა მომწოდებლის ფორმულით, კატალოგის შედარება სხვა სააღრიცხვო სისტემასთან, ეკრანი „პარტიის მახასიათებლების შევსება ერთ გავლაზე“. განყოფილება „მორგებული რედაქტორები“ საშუალებას გაძლევთ ასეთი მცირე რედაქტორი თავად დაწეროთ (ან შეუკვეთოთ) და გაუშვათ ადმინისტრირების პანელის შიგნით — იზოლირებულ გარემოში, ზუსტად იმ მონაცემებზე წვდომით, რომლებზეც ნებართვა გაეცით.

გახსნა: ადმინისტრირების პანელი → მორგებული რედაქტორები (admin.cenaly.ge/custom-editors). განყოფილება ირთვება ბარათით „მორგებული რედაქტორები (SDK)“ აპლიკაციების მაღაზიაში — ნაგულისხმევად ის დამალულია. თავად გვერდზე ღილაკი „📌 გვერდით მენიუში“ მას გვერდით მენიუში ამატებს, როცა ხშირად გჭირდებათ.

რა არის ეს განყოფილება#

პლაგინი არის აწყობილი სკრიპტი (index.js) და მისი აღწერა (manifest.json). პანელი სკრიპტს იზოლირებულ frame-ში ტვირთავს: მას არც თქვენს სესიაზე, არც ადმინისტრაციული პანელის კოდზე და არც ქსელზე წვდომა აქვს. მონაცემებთან საუბარი მხოლოდ ხიდით შეუძლია — დაშვებული მოთხოვნების ნაკრებით, რომელთაგან თითოეული გაცემული უფლებებით მოწმდება.

გვერდი ბლოკებისგან შედგება:

ღია რედაქტორი მთელ ეკრანს იკავებს, მისამართს კი ემატება ?app=<идентификатор> — ასეთი ბმული შეგიძლიათ გაუზიაროთ ადამიანს, რომელსაც წვდომა აქვს.

რა გჭირდებათ დასაწყებად#

ნაბიჯი 1. გადაწყვიტეთ, ვინ დაწერს რედაქტორს#

სამი გზა არსებობს და ისინი განსხვავდება იმით, თუ ვინ ფლობს კოდს:

სამივე შემთხვევაში დაყენება მფლობელის პასუხისმგებლობად რჩება: გრანტის მქონე დეველოპერსაც შეუძლია საკუთარი კოდის გაშვება მხოლოდ საკუთარ დეველოპერის რეჟიმში, თუმცა ანგარიშზე მისი დაყენება არ შეუძლია.

ნაბიჯი 2. AI-ით განვითარება (vibe-coding)#

„🤖 AI-ით განვითარება (vibe-coding)“ ბლოკი ოთხ რამეს გაძლევთ, რათა ამოცანა AI-აგენტს (Claude Code, Cursor და მსგავსებს) გადასცეთ და კონტრაქტი თავიდან არ აუხსნათ:

1. „⬇️ პროექტის შაბლონის ჩამოტვირთვა (zip)“ — პლაგინის მზა კარკასი: მანიფესტი, შესვლის წერტილი, კონტრაქტის აღწერა (GUIDE.en.md) და აგენტის ინსტრუქცია. არქივი პირდაპირ ბრაუზერში იქმნება, გარედან არაფრის ჩამოტვირთვა არ არის საჭირო.
2. „📋 აგენტისთვის prompt-ის კოპირება“ — ინგლისური დავალების ტექსტი: დაიწყოს შაბლონიდან, შეადაროს გიდს და შედეგი შესაბამისი შემოწმებებით დაადასტუროს.
3. აგენტის ინსტრუმენტების ნაკრების კონფიგურაცია — აგენტი ამით ააწყობს პლაგინს, გაუშვებს sandbox-ის ლოკალურ ასლს, გადაიღებს სქრინშოტებსა და მდგომარეობის კადრებს და ბოლოს ააწყობს რელიზს: zip ხელით დასაყენებლად ან GitHub-ის რელიზი.
4. „⬇️ კატალოგის snapshot-ის ჩამოტვირთვა (სატესტო fixture)“ — თქვენი კატეგორიები და პოზიციები ფაილად, რათა აგენტმა გამოგონილზე კი არა, რეალურ მონაცემებზე გამოცადოს.

⚠️ snapshot-იდან სხვა პლაგინების custom ველები მთლიანად იჭრება: რასაც უცხო გაფართოება თქვენს ბარათებზე ინახავს, fixture-თან ერთად ანგარიშს არ ტოვებს.

ნაბიჯი 3. რედაქტორის დაყენება#

ფაილებიდან. „რედაქტორის დაყენების“ ბლოკში აირჩიეთ „ბანდლი (index.js)“ და „მანიფესტი (manifest.json)“ → „შემოწმება და დაყენება“. პანელი ჯერ მანიფესტს ამოწმებს — იდენტიფიკატორს, ლოკალიზებულ სახელს, ვერსიას, SDK-ის მინიმალურ ვერსიას, განთავსების ადგილებს, უფლებებსა და ქსელური ჰოსტების სიას — შემდეგ კი აჩვენებს თანხმობას: „ეს რედაქტორი ითხოვს:“ და უფლებების სიას ადამიანური ენით. სანამ „დაყენებას“ არ დააჭერთ, არაფერი ყენდება.

GitHub-დან. „GitHub-დან დაყენების“ ბლოკში არის ველი „რეპოზიტორია (URL ან owner/repo)“, ველი „ტეგი (ცარიელი = ბოლო რელიზი)“ და ღილაკი „რეპოზიტორიის შემოწმება“. მარტივი კონვენციაა: manifest.json რეპოზიტორიის ძირში, აწყობილი dist/index.js ტეგში, ტეგის სახე v{версия}. მანიფესტი და ბანდლი პირდაპირ თქვენი ბრაუზერიდან მოიზიდება. ორივე შემთხვევაში დაყენებისას ბანდლის ანაბეჭდი (sha256) ითვლება და ინახება: თუ ფაილს შემდეგ შეცვლიან, გაშვება დაიბლოკება და პანელი რედაქტორის ხელახლა დაყენებას მოგთხოვთ.

უფლებები და განთავსების ადგილები#

უფლებებს (მათ სქოუპებსაც უწოდებენ) პლაგინი მანიფესტში ითხოვს, თქვენ კი ინსტალაციისას ადასტურებთ. სრული სია ასეთია — ხიდს მეტი შესაძლებლობა არ აქვს:

რაც სიაში საერთოდ არ არის, პლაგინი ვერ მიიღებს ვერანაირი პარამეტრით: სტუმრებსა და კლიენტებს, შეკვეთებს, ჩეკებს, ფინანსებს, თანამშრომლებს, მიმოწერასა და ზარებს ხიდი არ გადასცემს.

განთავსების ადგილები (სლოტები) სამია:

დეველოპერის რეჟიმი და კონტრაქტორის წვდომა#

დეველოპერის რეჟიმი (ბლოკი „🛠️ დეველოპერის რეჟიმი“) პლაგინს უშუალოდ თქვენი კომპიუტერიდან ტვირთავს: ველი „ბანდლის URL“ მხოლოდ localhost / 127.0.0.1 მისამართებს იღებს, გვერდითაა „მანიფესტის JSON“ და ღილაკი „dev-სესიის გაშვება“. ამ დროს ანაბეჭდი არ ფიქსირდება, სესია კი ჩანართის დახურვამდე მოქმედებს; „dev-სესიის შეჩერება“ მას მაშინვე თიშავს.

დეველოპერისთვის წვდომის მინიჭება (ბლოკი „👩‍💻 დეველოპერის წვდომა“) საჭიროა, როცა კოდს მფლობელი არ წერს. დეველოპერს ექმნება ჩვეულებრივი თანამშრომლის ანგარიში, შემდეგ კი მფლობელი ანიჭებს წვდომას: „დეველოპერის ელფოსტა (მისი staff-ლოგინი)“, „ნებადართული უფლებები“, „მოქმედების ვადა (დღეებში)“ და არასავალდებულო შენიშვნა → „წვდომის მინიჭება“. წვდომის გაუქმება ნებისმიერ დროს შეგიძლიათ ღილაკით „გაუქმება“.

რას იძლევა მინიჭებული წვდომა და რას — არა:

• იძლევა — მხოლოდ დეველოპერის რეჟიმს თქვენ მიერ მონიშნული უფლებებით (ნაგულისხმევი ვადაა 14 დღე, მაქსიმუმი — 90);
• უფლებები იზღუდება თანაკვეთით: რასაც მანიფესტი ითხოვს და რაც მინიჭებულია; პლაგინი დამატებით უფლებებს ვერ მიიღებს, თუნდაც მანიფესტში მოითხოვოს;
• არ იძლევა — პლაგინების დაყენებას, ჩართვასა და წაშლას: ეს მფლობელის უფლებად რჩება.

განახლება, ჩართვა და წაშლა#

ავტომატური განახლება განზრახ არ არსებობს: სხვისი კოდის ახალი ვერსია ახალი ანაბეჭდი და შესაძლოა ახალი უფლებებია, ამიტომ განახლება ყოველთვის მფლობელის გააზრებული მოქმედებაა.

ჩაშენებული გაფართოებები#

ჩვენი საკუთარი მოდულების ნაწილი იმავე ფორმატშია შეფუთული — ეს ქცევით ჩანს, მაგრამ მათი დაყენება საჭირო არ არის: ისინი პანელთან ერთად მოდის და ირთვება ბარათით აპლიკაციების მაღაზიაში და არა ამ განყოფილებაში.

ამჟამად ასეთი მოდული ერთია — „Меркурий/ВетИС“ რუსეთისთვის: ის „საწყობის“ განყოფილების ჩანართია, სრულდება იმავე იზოლირებულ გარემოში და ანაბეჭდის იმავე შემოწმებებით. დაყენებული რედაქტორების სიაში ჩაშენებული გაფართოებები არ ხვდება.

რისი გაკეთება შეუძლია რედაქტორს და რისი — არა#

მესამე მხარის პლაგინებს ბარათზე გაფრთხილება აქვთ: „მესამე მხარის აპლიკაცია sandbox-ში — ის არასოდეს ითხოვს პაროლს.“ თუ პლაგინი პანელის ლოგინს, გადახდის მონაცემებს ან SMS-ის კოდს ითხოვს — ეს თაღლითობაა და არა გაფართოების მუშაობა.

შეზღუდვები#

• განყოფილება ნაგულისხმევად გამორთულია და განკუთვნილია მათთვის, ვინც კოდს წერს (ან მის დაწერას უკვეთავს): ჩვეულებრივ მფლობელს აქ საქმე არ აქვს.
• ნახვის გარდა ყველაფერი მხოლოდ ანგარიშის მფლობელისთვისაა. თანამშრომელი ცენტრს მხოლოდ კითხვის რეჟიმში ხედავს; დეველოპერის რეჟიმი — მხოლოდ მოქმედი ნებართვით.
• კერძო GitHub რეპოზიტორიები მხარდაჭერილი არ არის — რეპოზიტორია საჯარო უნდა იყოს, დაყენება ტეგით ხდება.
• ავტომატური განახლება არ არის: პლაგინის განახლებას ყოველთვის მფლობელი იწყებს.
• სხვების პლაგინების მაღაზია არ არის. მზა გაფართოებები პანელით არ ქვეყნდება და არ იყიდება — წყაროა მხოლოდ თქვენი ფაილი ან თქვენი რეპოზიტორია.
• სამი ჩასმის ადგილია (საკუთარი გვერდი, კატალოგის ღილაკი, საწყობის ჩანართი) — პლაგინი პანელის ნებისმიერ ეკრანში ვერ ჩაშენდება.
• ხიდი არ გასცემს სტუმრებს, შეკვეთებს, ფინანსებს, თანამშრომლებსა და მიმოწერას — ამის უფლებებით გვერდის ავლა შეუძლებელია, ასეთი მოთხოვნები უბრალოდ არ არსებობს.
• ცალკე ჟურნალი „პლაგინმა ეს გააკეთა“ არ არის. უფლებები ბარათზე ჩანს, კატალოგის ცვლილებები კი პოზიციების ჩვეულებრივ ისტორიაში ხვდება; თუ კონტროლი გჭირდებათ, დაიწყეთ პლაგინით, რომელსაც მხოლოდ კითხვის უფლება აქვს.
• ტექნიკური ზღვრები: პაკეტი 4 მბ-მდე, მანიფესტში 8-მდე ქსელური მისამართი, საცავის ერთ გასაღებზე 1 მბ-მდე; სერვერული გაშვება — 30 წამამდე და ერთ ჯერზე ინტერნეტში 50-მდე მიმართვა.
• პლაგინის მონაცემები თქვენი ბრენდის ღრუბელში რჩება: cenaly.ru-ზე ანგარიშის სერვერული ნაწილის მდგომარეობა რუსეთის გარემოში ინახება.

პრობლემების აღმოფხვრა#

ხშირად დასმული კითხვები#

პროგრამირება უნდა ვიცოდე?#

მზა რელიზის დასაყენებლად — არა. თავად რელიზის მისაღებად — დიახ: მას დეველოპერი ან AI-აგენტი წერს „AI-ით განვითარების“ ბლოკის ჩვენი შაბლონით. განყოფილება კოდის ინსტრუმენტია და არა „თაგვით“ კონსტრუქტორი.

შეუძლია უცხო პლაგინს ჩემი კლიენტების ან შემოსავლის ნახვა?#

არა. პლაგინი sandbox-ში მუშაობს და მონაცემებს მხოლოდ ხიდით იღებს, ხიდმა კი ზუსტად ექვსი რამ იცის: კატალოგი, ფასები და stop-list-ები, საწყობის ცნობარი, საკუთარი საცავი, საკუთარი სერვერული ნაწილის გამოძახება და ინტერფეისის ელემენტები. სტუმრები, შეკვეთები, ჩეკები, ფინანსები, თანამშრომლები და მიმოწერა იქ პრინციპში არ არის. კონკრეტულად რა არის ნებადართული პლაგინისთვის, ყოველთვის ჩანს მის ბარათში „უფლებების“ სტრიქონში.

როგორ გადავაბარო დეველოპერი კონტრაქტორს და ანგარიშში მთლიანად არ შევუშვა?#

შეუქმენით მას თანამშრომლის ანგარიში, შემდეგ კი ბლოკში „დეველოპერის წვდომა“ გაუცით გრანტი: მონიშნეთ მხოლოდ საჭირო უფლებები და მიუთითეთ ვადა (ნაგულისხმევად 14 დღე, მაქსიმუმ 90). ის მიიღებს დეველოპერის რეჟიმს და სხვას არაფერს; პლაგინის ინსტალაცია მაინც თქვენ დაგრჩებათ. გრანტი ერთი ღილაკით უქმდება.

განახლდება პლაგინი თვითონ, როცა ავტორი ახალ ვერსიას გამოუშვებს?#

არა. განახლებას მფლობელი იწყებს: „განახლებების შემოწმება“ → „განახლება …-მდე“. ასე ახალი ვერსია ადამიანის ცოდნის გარეშე ანგარიშში არ გამოჩნდება — ვერსიასთან ერთად მოთხოვნილი უფლებებიც შეიძლება შეცვლილიყო.

სად ინახავს პლაგინი თავის პარამეტრებსა და მონაცემებს?#

თქვენს ანგარიშში, ცალკე საცავში მისი იდენტიფიკატორის ქვეშ (გასაღებზე 1 მბ-მდე), და, თუ იყენებს, თქვენი ბარათების კასტომურ ველებში — თითოეული პლაგინი მხოლოდ საკუთარ სივრცეს ხედავს. cenaly.ru-ზე ანგარიშის სერვერული ნაწილი და მისი მდგომარეობა რუსულ კონტურში რჩება.

რით განსხვავდება ეს API-სა და MCP-სგან?#

API დეველოპერებისთვის და MCP საკუთარი სატელეფონო სადგურისთვის საჭიროა, როცა პროგრამა გარედან მუშაობს: საკუთარი საიტი, სხვისი სააღრიცხვო სისტემა, AI-აგენტი. კასტომური რედაქტორი კი პირიქით, პანელის შიდა ინტერფეისია: თანამშრომელი მას ადმინისტრაციის ჩვეულებრივ გვერდად ხსნის და სამუშაო ფანჯრიდან არ გადის.

დაკავშირებული განყოფილებები#

• აპლიკაციების მაღაზია — სადაც ირთვება განყოფილება და ჩაშენებული გაფართოებები
• საწყობი — ჩანართი, სადაც ცხოვრობს ისეთი გაფართოებები, როგორიცაა «ВетИС», და საქონლის ცნობარი
• კატალოგის იმპორტი — სტანდარტული გზა პოზიციების ასატვირთად, თუ ამოცანა მხოლოდ ესაა
• ვიტრინა საკუთარ კოდზე (headless) — მონაცემთა ღია კონტრაქტი გარე საიტისთვის
• საკუთარი PBX-ის API და MCP და Guest API AI-აგენტებისთვის — მუშაობა პანელის გარედან
• თანამშრომლები და ცვლები — დეველოპერის ანგარიში და როლები
• უსაფრთხოება და მონაცემები — სად ინახება მონაცემები და ვის აქვს მათზე წვდომა
• მხარდაჭერა — სად მოგვწეროთ, თუ პლაგინი საეჭვოდ იქცევა