कस्टम एडिटर

कुछ काम ऐसे होते हैं जो किसी भी पैनल में नहीं मिलते, क्योंकि वे सिर्फ़ आपके हैं: आपके आपूर्तिकर्ता के फ़ॉर्मूले से कीमतों की अपनी गणना, किसी बाहरी लेखा प्रणाली के साथ कैटलॉग का मिलान, “एक ही बार में बैच की विशेषताएँ भरें” वाली स्क्रीन। “कस्टम एडिटर” अनुभाग आपको ऐसा मिनी-एडिटर खुद लिखने (या बनवाने) और एडमिन पैनल के अंदर चलाने देता है — एक सैंडबॉक्स में, ठीक उन्हीं डेटा तक पहुँच के साथ जिनकी आपने अनुमति दी है।

खोलें: एडमिन पैनल → कस्टम एडिटर (admin.cenaly.com/custom-editors)। यह अनुभाग ऐप स्टोर में “कस्टम एडिटर (SDK)” कार्ड से चालू होता है — डिफ़ॉल्ट रूप से यह छिपा रहता है। पेज पर मौजूद “📌 साइडबार में” बटन इसे साइड मेन्यू में जोड़ देता है, जब इसकी ज़रूरत बार-बार पड़े।

यह कौन-सा अनुभाग है#

प्लगइन एक बिल्ड किया हुआ स्क्रिप्ट (index.js) और उसका विवरण (manifest.json) होता है। पैनल स्क्रिप्ट को आइसोलेटेड फ़्रेम में लोड करता है: उसके पास न आपके सेशन तक पहुँच होती है, न एडमिन पैनल के कोड तक, न नेटवर्क तक। डेटा से बात करने के लिए वह सिर्फ़ ब्रिज का इस्तेमाल कर सकता है — अनुमत अनुरोधों का एक सेट, जिनमें से हर एक दिए गए अधिकारों के हिसाब से जाँचा जाता है।

पेज इन ब्लॉकों से बना है:

खुला एडिटर पूरी स्क्रीन घेर लेता है, और पेज के पते में ?app=<पहचानकर्ता> जुड़ जाता है — ऐसा लिंक आप उस व्यक्ति के साथ साझा कर सकते हैं जिसके पास एक्सेस है।

चलाने के लिए क्या चाहिए#

चरण 1. तय करें कि एडिटर कौन लिखेगा#

तीन रास्ते हैं, और इनमें फ़र्क़ यह है कि कोड किसके पास रहता है:

तीनों ही मामलों में इंस्टॉल करना मालिक के ही हाथ में रहता है: ग्रांट वाला डेवलपर भी अपना कोड सिर्फ़ अपने डेवलपर मोड में चला सकता है, उसे खाते में इंस्टॉल नहीं कर सकता।

चरण 2. AI से डेवलपमेंट (वाइब-कोडिंग)#

“🤖 AI से डेवलपमेंट (वाइब-कोडिंग)” ब्लॉक चार चीज़ें देता है, ताकि काम किसी AI एजेंट (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”: यह “स्टॉक” अनुभाग के टैब में रहता है, उसी सैंडबॉक्स में और उन्हीं फ़िंगरप्रिंट जाँचों के साथ चलता है। इंस्टॉल किए गए एडिटर की सूची में बिल्ट-इन एक्सटेंशन नहीं आते।

एडिटर क्या कर सकता है और क्या नहीं#

तृतीय-पक्ष प्लगइन कार्ड पर चेतावनी से चिह्नित होते हैं: “सैंडबॉक्स में तृतीय-पक्ष ऐप — यह कभी पासवर्ड नहीं माँगता।” अगर प्लगइन पैनल का लॉगिन, भुगतान डेटा या SMS कोड माँगे — तो यह धोखाधड़ी है, एक्सटेंशन का काम नहीं।

सीमाएँ#

• यह अनुभाग डिफ़ॉल्ट रूप से बंद है और उन लोगों के लिए है जो कोड लिखते हैं (या लिखवाते हैं): आम मालिक के लिए यहाँ कोई काम नहीं है।
• देखने के अलावा सब कुछ — केवल खाते के मालिक के पास। कर्मचारी को हब केवल पढ़ने के लिए दिखता है; डेवलपर मोड — केवल सक्रिय ग्रांट के साथ।
• निजी GitHub रिपॉज़िटरी समर्थित नहीं हैं — रिपॉज़िटरी सार्वजनिक होनी चाहिए, इंस्टॉलेशन टैग से होता है।
• स्वतः अपडेट नहीं है: प्लगइन का अपडेट हमेशा मालिक शुरू करता है।
• दूसरों के प्लगइन का स्टोर नहीं है। तैयार एक्सटेंशन पैनल के ज़रिए प्रकाशित या बेचे नहीं जाते — स्रोत केवल आपकी फ़ाइल या आपकी रिपॉज़िटरी है।
• तीन स्लॉट हैं (अपना पेज, कैटलॉग बटन, वेयरहाउस टैब) — प्लगइन पैनल की किसी भी स्क्रीन में खुद को नहीं जोड़ सकता।
• ब्रिज गेस्ट, ऑर्डर, वित्त, कर्मचारी और बातचीत नहीं देता — अधिकारों से इसे बायपास नहीं किया जा सकता, ऐसे अनुरोध मौजूद ही नहीं हैं।
• «प्लगइन ने यह किया» जैसा अलग लॉग नहीं है। अधिकार कार्ड पर दिखते हैं, और कैटलॉग के बदलाव आइटम के सामान्य इतिहास में दर्ज होते हैं; अगर नियंत्रण चाहिए, तो उस प्लगइन से शुरू करें जिसे केवल पढ़ने का अधिकार दिया गया हो।
• तकनीकी सीमाएँ: बंडल 4 MB तक, मैनिफ़ेस्ट में 8 नेटवर्क पते तक, स्टोरेज की एक कुंजी पर 1 MB तक; सर्वर रन — 30 सेकंड तक और एक बार में 50 इंटरनेट कॉल तक।
• प्लगइन का डेटा आपके ब्रांड के क्लाउड में रहता है: cenaly.ru वाले खाते में सर्वर भाग की स्थिति रूसी कॉन्टूर में रहती है।

समस्या निवारण#

अक्सर पूछे जाने वाले प्रश्न#

क्या प्रोग्रामिंग आनी चाहिए?#

तैयार रिलीज़ इंस्टॉल करने के लिए — नहीं। रिलीज़ खुद पाने के लिए — हाँ: इसे डेवलपर या AI एजेंट «AI से डेवलपमेंट» ब्लॉक वाले हमारे टेम्पलेट से लिखता है। यह अनुभाग कोड का उपकरण है, «माउस» से बनाने वाला कंस्ट्रक्टर नहीं।

क्या कोई बाहरी प्लगइन मेरे ग्राहकों या आय को देख सकता है?#

नहीं। प्लगइन सैंडबॉक्स में चलता है और डेटा केवल ब्रिज के ज़रिए पाता है, और ब्रिज ठीक छह चीज़ें कर सकता है: कैटलॉग, कीमतें और स्टॉप-लिस्ट, वेयरहाउस की सूची, अपना स्टोरेज, अपने सर्वर भाग को कॉल और इंटरफ़ेस के एलिमेंट। गेस्ट, ऑर्डर, रसीदें, वित्त, कर्मचारी और बातचीत वहाँ सिद्धांत रूप में नहीं हैं। किसी खास प्लगइन को क्या-क्या अनुमति है, यह हमेशा उसके कार्ड पर «अधिकार» पंक्ति में दिखता है।

किसी ठेकेदार को डेवलपमेंट कैसे सौंपें और उसे पूरे खाते में न घुसने दें?#

उसके लिए कर्मचारी का खाता बनाएँ, फिर «डेवलपर एक्सेस» ब्लॉक में ग्रांट दें: केवल ज़रूरी अधिकार चुनें और अवधि तय करें (डिफ़ॉल्ट रूप से 14 दिन, अधिकतम 90)। उसे डेवलपर मोड मिलेगा और कुछ नहीं; प्लगइन की इंस्टॉलेशन फिर भी आपके पास ही रहेगी। ग्रांट एक बटन से रद्द हो जाता है।

जब लेखक नया संस्करण जारी करेगा, तो क्या प्लगइन खुद अपडेट हो जाएगा?#

नहीं। अपडेट मालिक शुरू करता है: «अपडेट जाँचें» → «… तक अपडेट करें»। इस तरह नया संस्करण इंसान की जानकारी के बिना खाते में नहीं आएगा — संस्करण के साथ माँगे जाने वाले अधिकार भी बदल सकते हैं।

प्लगइन अपनी सेटिंग्स और डेटा कहाँ रखता है?#

आपके खाते में, उसके आइडेंटिफ़ायर के तहत अलग स्टोरेज में (प्रति कुंजी 1 MB तक), और अगर वह उनका उपयोग करता है तो आपके कार्ड के कस्टम फ़ील्ड में — हर प्लगइन केवल अपना स्थान देखता है। cenaly.ru वाले खाते में सर्वर भाग और उसकी स्थिति रूसी कॉन्टूर में रहती है।

यह API और MCP से कैसे अलग है?#

डेवलपर्स के लिए API और अपने PBX का MCP तब चाहिए जब प्रोग्राम बाहर से काम करता हो: अपनी साइट, किसी और का अकाउंटिंग सिस्टम, AI एजेंट। कस्टम एडिटर — इसके उलट, पैनल के अंदर का इंटरफ़ेस: कर्मचारी उसे एडमिन के सामान्य पेज की तरह खोलता है और काम की विंडो से बाहर नहीं निकलता।

संबंधित अनुभाग#

• ऐप स्टोर — जहाँ अनुभाग और बिल्ट-इन एक्सटेंशन चालू होते हैं
• वेयरहाउस — वह टैब जिसमें «VetIS» जैसे एक्सटेंशन रहते हैं, और सामान की सूची
• कैटलॉग आयात — आइटम अपलोड करने का मानक तरीका, अगर काम केवल इतना ही हो
• अपने कोड पर स्टोरफ़्रंट (headless) — बाहरी साइट के लिए खुला डेटा कॉन्ट्रैक्ट
• अपने PBX का API और MCP और AI एजेंट के लिए Guest API — पैनल के अंदर नहीं, बाहर से काम
• कर्मचारी और शिफ्ट — डेवलपर के लिए खाता और भूमिकाएँ
• सुरक्षा और डेटा — डेटा कहाँ रहता है और किसकी उस तक पहुँच है
• सहायता — अगर प्लगइन संदिग्ध व्यवहार करे तो कहाँ लिखें