افزونهٔ کرسی چیست
افزونه سامانهٔ جدایی است که از کرسی می‌خواند، رکوردهای نوع‌دار خودش را مستقیم در کرسی می‌نویسد و در نوع‌های خود کرسی (پرونده، تصمیم، اقدام، حافظه) فقط پیشنهاد و منبع می‌گذارد. اپ افزونه داخل پوستهٔ کرسی و در iframe اجرا می‌شود و با دسترسی همان شخصی کار می‌کند که پشت صفحه است. پول با MU است: هر افزونه در هر سازمان کیف پول جدای خودش را دارد، پلن‌هایش را خودش تعریف می‌کند و مصرفش را با API کرسی کم می‌کند.
کد افزونه هرگز داخل پردازه‌های کرسی یا باندل پنل اجرا نمی‌شود.
چهار چیزی که افزونه دارد
| چیست | |
|---|---|
| رکوردهای خودش | نوع‌هایی که با JSON Schema در manifest اعلام می‌کند (record_types). کرسی آن‌ها را با دید، audit و نسخه نگه می‌دارد، کرسیار آن‌ها را با دید همان شخص می‌خواند، و بعد از حذف افزونه فقط‌خواندنی سر جایشان می‌مانند. |
| پیشنهاد در رکوردهای کرسی | ساختن اقدام، تغییر پرونده، پیشنهاد تصمیم، رویداد تقویم (proposals). اعمال پیشنهاد با کلیک یک شخص است، یا با قاعدهٔ تأیید خودکاری که سازمان برای نوع‌های کم‌خطر گذاشته است. |
| اپ داخل پوستهٔ کرسی | اپ کامل با تب‌های خودش (ui.app) و پنل کنار پرونده، جلسه و سند یا ویجت میزکار (ui.panels)، همه در iframe و با Bridge کرسی. |
| پلن با MU | خدمت‌هایی که برایشان MU کم می‌کند (services) و پلن‌هایی که می‌فروشد (plans)، با نرخ هر خدمت در هر پلن. خرید فقط از درگاه کرسی است. |
انواع افزونه
| نوع | چه می‌کند | نمونه |
|---|---|---|
intake_connector | پیام یا سند را به‌عنوان منبع وارد کرسی می‌کند | ایمیل، ربات بله |
insight_module | از کرسی می‌خواند و پیشنهاد یا بینش برمی‌گرداند | «ایمیل به تعهد» |
tool_module | به کرسیار ابزار می‌دهد | جست‌وجو در CRM |
app_module | اپ کامل با رکوردهای خودش | CRM |
knowledge_pack | کدی اجرا نمی‌کند | مهارت‌ها، قالب صورت‌جلسه |
یک افزونه می‌تواند چند نقش با هم داشته باشد. نوع اصلی‌اش عمق بازبینی را تعیین می‌کند، نه اینکه چه کاری مجاز است.
چرخهٔ عمر: از ساخت تا نصب
- ساخت. manifest را می‌نویسید و افزونه را روی یک سازمان آزمایشی در حالت توسعه نصب می‌کنید. این نصب فقط برای حساب‌های توسعه‌دهندهٔ همان ناشر دیده می‌شود و بازبینی لازم ندارد.
- ارسال. در همین پرتال با کلید ناشر وارد می‌شوید و نسخه را می‌فرستید: manifest، سطح بازبینی درخواستی و یادداشتی برای بازبین. نسخه با وضعیت «ارسال‌شده» در کاتالوگ کرسی ثبت می‌شود.
- بازبینی کرسی. تیم کرسی نسخه را برمی‌دارد («در حال بازبینی») و تأیید یا رد می‌کند، با یادداشت. سطح‌ها: انجمنی (بررسی خودکار manifest، scopeها و ابزارها)، تأییدشده (آزمون کارکردی روی سازمان‌های آزمایشی و بازبینی خروج داده؛ برای اجرای
instanceهمیشه لازم است) و خصوصی (فقط برای یک سازمان). - انتشار در instanceها. نسخهٔ تأییدشده امضا می‌شود و Control Plane خودکار آن را به instanceهای سازگار می‌فرستد؛ سازگار یعنی نسخهٔ
plugin_apiآن instance در بازهٔ manifest باشد. وضعیت «منتشرشده» می‌شود. - نصب سازمان. ادمین سازمان در فروشگاه افزونه‌ها دسترسی‌ها و خروج داده را می‌بیند، پلن را می‌خرد و تأیید می‌کند. بعد همه چیز خودکار ساخته می‌شود و افزونه با
POST {base_url}/korsi/lifecycleخبردار می‌شود.
وضعیت هر نسخه را در صفحهٔ افزونه‌های من دنبال کنید.
به‌روزرسانی، تعلیق، پس‌گرفتن
- اصلاح همیشه نسخهٔ تازه است؛ نسخهٔ ارسال‌شده ویرایش نمی‌شود.
- نسخهٔ تازه‌ای که scope، نوع رکورد، موضوع رویداد، ابزار یا مقصد خروجی تازه بخواهد، نصب‌ها را به «منتظر تأیید دوباره» می‌برد.
- تیم کرسی می‌تواند افزونه را روی کل ناوگان متوقف کند یا نسخه را پس بگیرد؛ دلیلش در صفحهٔ همان نسخه می‌آید.
محل اجرا
runtime.placement | کجا | دادهٔ سازمان |
|---|---|---|
external | سرور ناشر | با رضایت صریح ادمین بیرون می‌رود؛ خروج داده «اعلام‌شده» است |
instance | کنار instance، روی سرور کرسی | فقط به مقصدهای اعلام‌شده در runtime.egress؛ همیشه «تأییدشده» |
none | کدی اجرا نمی‌شود | بستهٔ دانش |
اصل‌هایی که کرسی اعمال می‌کند
- افزونه هرگز بیشتر از شخص نمی‌بیند. دسترسی مؤثر اشتراک permission شخص یا حساب نصب، scopeهای تأییدشدهٔ نصب و سقف سطح اپ‌هاست.
- کرسی وسط می‌نشیند. هر جا افزونه به کرسیار، رویداد یا داده می‌رسد، از دروازهٔ کرسی می‌گذرد.
- کارت تأیید همیشه در رابط خود کرسی کشیده می‌شود، هرگز داخل iframe افزونه.
- رکوردها مال سازمان می‌مانند، حتی بعد از حذف افزونه.