#प्लगइन विकास का अवलोकन

NocoBase एक माइक्रोकर्नेल आर्किटेक्चर का उपयोग करता है, जहाँ कोर केवल प्लगइन के जीवनचक्र शेड्यूलिंग, निर्भरता प्रबंधन और बुनियादी क्षमताओं को समाहित करने के लिए जिम्मेदार है। सभी व्यावसायिक कार्य प्लगइन के रूप में प्रदान किए जाते हैं। इसलिए, प्लगइन की संगठनात्मक संरचना, जीवनचक्र और प्रबंधन के तरीके को समझना NocoBase को अपनी ज़रूरतों के हिसाब से बनाने (कस्टमाइज़ करने) का पहला कदम है।

#मुख्य अवधारणाएँ

• प्लग एंड प्ले (Plug and Play): प्लगइन को आवश्यकतानुसार इंस्टॉल, सक्षम या अक्षम किया जा सकता है, जिससे कोड में बदलाव किए बिना व्यावसायिक कार्यों को लचीले ढंग से जोड़ा जा सकता है।
• फुल-स्टैक इंटीग्रेशन (Full-stack Integration): प्लगइन में आमतौर पर सर्वर-साइड और क्लाइंट-साइड दोनों तरह के कार्यान्वयन शामिल होते हैं, जिससे डेटा लॉजिक और यूआई इंटरैक्शन के बीच निरंतरता सुनिश्चित होती है।

#प्लगइन की बुनियादी संरचना

प्रत्येक प्लगइन एक स्वतंत्र npm पैकेज होता है, जिसमें आमतौर पर निम्नलिखित डायरेक्टरी संरचना होती है:

plugin-hello/
├─ package.json          # प्लगइन का नाम, निर्भरताएँ और NocoBase प्लगइन मेटाडेटा
├─ client.js             # रनटाइम लोडिंग के लिए फ्रंटएंड बिल्ड आर्टिफैक्ट
├─ server.js             # रनटाइम लोडिंग के लिए सर्वर-साइड बिल्ड आर्टिफैक्ट
├─ src/
│  ├─ client/            # क्लाइंट-साइड सोर्स कोड, ब्लॉक, एक्शन, फ़ील्ड आदि रजिस्टर कर सकता है
│  └─ server/            # सर्वर-साइड सोर्स कोड, रिसोर्स, इवेंट, कमांड आदि रजिस्टर कर सकता है

#डायरेक्टरी कन्वेंशन और लोडिंग क्रम

NocoBase प्लगइन को लोड करने के लिए डिफ़ॉल्ट रूप से निम्नलिखित डायरेक्टरीज़ को स्कैन करता है:

my-nocobase-app/
├── packages/
│   └── plugins/          # विकास के अधीन प्लगइन (उच्चतम प्राथमिकता)
└── storage/
    └── plugins/          # संकलित प्लगइन, जैसे अपलोड किए गए या प्रकाशित प्लगइन

• packages/plugins: यह स्थानीय प्लगइन विकास के लिए उपयोग की जाने वाली डायरेक्टरी है, जो रीयल-टाइम संकलन और डीबगिंग का समर्थन करती है।
• storage/plugins: यह संकलित प्लगइन को संग्रहीत करती है, जैसे कि व्यावसायिक संस्करण या तीसरे पक्ष के प्लगइन।

#प्लगइन का जीवनचक्र और स्थितियाँ

एक प्लगइन आमतौर पर निम्नलिखित चरणों से गुजरता है:

1. बनाना (create): CLI के माध्यम से एक प्लगइन टेम्पलेट बनाएँ।
2. पुल करना (pull): प्लगइन पैकेज को स्थानीय रूप से डाउनलोड करें, लेकिन इसे अभी तक डेटाबेस में नहीं लिखा गया है।
3. सक्षम करना (enable): पहली बार सक्षम करने पर, यह "रजिस्टर + इनिशियलाइज़" करता है; बाद में सक्षम करने पर केवल लॉजिक लोड होता है।
4. अक्षम करना (disable): प्लगइन को चलने से रोकें।
5. हटाना (remove): सिस्टम से प्लगइन को पूरी तरह से हटा दें।

#CLI कमांड के उदाहरण

# 1. प्लगइन स्केलेटन बनाएँ
yarn pm create @my-project/plugin-hello

# 2. प्लगइन पैकेज पुल करें (डाउनलोड या लिंक)
yarn pm pull @my-project/plugin-hello

# 3. प्लगइन सक्षम करें (पहली बार सक्षम करने पर स्वतः इंस्टॉल हो जाता है)
yarn pm enable @my-project/plugin-hello

# 4. प्लगइन अक्षम करें
yarn pm disable @my-project/plugin-hello

# 5. प्लगइन हटाएँ
yarn pm remove @my-project/plugin-hello

#प्लगइन प्रबंधन इंटरफ़ेस

प्लगइन को सहजता से देखने और प्रबंधित करने के लिए ब्राउज़र में प्लगइन मैनेजर एक्सेस करें:

डिफ़ॉल्ट URL: http://localhost:13000/admin/settings/plugin-manager