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

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

გახსნა: ადმინ-პანელი → მორგებული რედაქტორები (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): თუ ფაილს მოგვიანებით ჩაანაცვლებენ, გაშვება დაიბლოკება და პანელი რედაქტორის ხელახლა დაყენებას მოგთხოვთ.

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

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

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

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

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

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

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

რას იძლევა გრანტი და რას არა:

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

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

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

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

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

ამჟამად ასეთი მოდული ერთია — „Mercury/VetIS“ რუსეთისთვის: ის „საწყობის“ განყოფილების ჩანართად ცხოვრობს, იმავე sandbox-ში და იმავე ანაბეჭდის შემოწმებებით სრულდება. დაყენებული რედაქტორების სიაში ჩაშენებული გაფართოებები არ ხვდება.

რა შეუძლია რედაქტორს და რა არა#

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

შეზღუდვები#

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

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

ხშირი კითხვები#

საჭიროა თუ არა პროგრამირების ცოდნა?#

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

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

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

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

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

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

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

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

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

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

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

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

• აპლიკაციების მაღაზია — სად ირთვება განყოფილება და ჩაშენებული გაფართოებები
• საწყობი — ჩანართი, რომელშიც „VetIS“-ის მსგავსი გაფართოებები ცხოვრობს, და საქონლის ცნობარი
• კატალოგის იმპორტი — პოზიციების ატვირთვის სტანდარტული გზა, თუ ამოცანა მხოლოდ ამაშია
• ვიტრინა საკუთარ კოდზე (headless) — ღია მონაცემთა კონტრაქტი გარე საიტისთვის
• API და საკუთარი ატს-ის MCP და Guest API ხელოვნური ინტელექტის აგენტებისთვის — მუშაობა გარედან და არა პანელის შიგნით
• თანამშრომლები და ცვლები — ანგარიში დეველოპერისთვის და როლები
• უსაფრთხოება და მონაცემები — სად ინახება მონაცემები და ვის აქვს მათზე წვდომა
• მხარდაჭერა — სად მიწეროთ, თუ პლაგინი საეჭვოდ იქცევა