> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# البنية المعمارية

> كيف تُنمذج ميني أب كرزون وتُنفَّذ وتُراجَع.

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
flowchart TB
  subgraph Platform["Karzoun platform"]
    MP[Marketplace]
    AE[Automation engine]
    DB[Dashboard apps]
    MA[MiniApps runtime]
    DEF[(MiniApp definition)]
    MP --> MA
    AE --> MA
    DB --> MA
    DEF --> MA
  end

  subgraph Provider["Your service"]
    API[REST / GraphQL API]
    WH[Webhook sender]
  end

  MA <-->|OAuth / API calls| API
  WH -->|POST /miniapps/ns/webhooks| MA
```

ميني أب هو **مستند JSON واحد** تؤلّفه وتقدّمه إلى كرزون. بعد المراجعة والموافقة، تستضيف كرزون التعريف وتشغّله وقت التشغيل. لا تنشر خوادم أو قواعد بيانات على بنيتنا التحتية.

يعلن المستند عن:

* **المصادقة** — كيف يربط المستأجرون حساباتهم (OAuth 2.0 أو مفتاح API)
* **الإجراءات** — استدعاءات API التي يمكن للمستخدمين والأتمتة تشغيلها
* **المشغّلات** — الأحداث التي تظهر في منشئ الأتمتة
* **الويب هوك** — كيف تُتحقَّق أحداث المزوّد الواردة وتُحلَّل
* **المزامنة** (اختياري) — الاستيراد الجماعي ومزامنة التجارة في الوقت الفعلي لمنصات التجارة الإلكترونية
* **المصادر** — قوائم منسدلة مدعومة بـ RPC في نماذج الإجراءات

تفسّر كرزون المستند وقت التشغيل. السلوك مُعلَن في JSON — بدون كود خادم مخصص من جانبك.

## وثائق ذات صلة

* [ويب هوك المستأجر](/ar/developers/guides/webhooks) — ويب هوك صادرة على مستوى مساحة العمل (منفصلة عن ويب هوك ميني أب الواردة)
* [برنامج الشركاء](/ar/partners) — تكاملات العلامة البيضاء والتجارة المضمّنة


## Related topics

- [MiniApps](/ar/miniapps/index.md)
- [المزامنة](/ar/miniapps/guides/sync.md)
- [MCP المستضاف (/mcp)](/ar/mcp-server/setup/hosted.md)
- [ارسال رسالة](/ar/help-center/guides/automations/nodes/doc-1918969.md)
- [انواع الرسائل المدعومة في كرزون](/ar/help-center/guides/automations/nodes/doc-1920222.md)