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

# بنية المنصة

> كيف تترابط مكوّنات منصة OTO: واجهاتها الأربع، وكيف تدخل البيانات وتخرج، وما الذي يبقى منفصلًا، وأين تعمل المنصة، وكيف يمكنك توسيعها.

تشرح هذه الصفحة بنية المنصة كما ستتعامل معها: مكوّنات OTO، ومن أين تدخل البيانات ومن أين تخرج، وما الذي يبقى منفصلًا عن غيره. وهي موجّهة لمن يقيّم OTO أو يبني تكاملًا معها، وليست مخططًا هندسيًا داخليًا.

## أربع واجهات ومنصة واحدة

تعمل الواجهات كلها على البيانات نفسها، والفرق الوحيد هو من يستخدمها وعلى أي جهاز.

| الواجهة | من يستخدمها | الغرض |
| - | - | - |
| **لوحة التحكم** | فرق العمليات وخدمة العملاء والمالية والمشرفون | الطلبات والشحنات والمخزون والقواعد والإعدادات، أي المنصة كاملة. |
| **OTO PACK** | موظفو المستودعات والمتاجر عبر جهاز محمول | التجهيز والتغليف والإرسال والاستلام باستخدام الحاويات والباركود. راجع [إدارة المستودعات](https://docs.tryoto.com/ar/modules/warehouse-management/overview.md). |
| **OTO FLEX** | سائقوك عبر الجوال | المسارات واستلام الطلبات والتوصيل واثبات التسليم. راجع [OTO FLEX](https://docs.tryoto.com/ar/modules/oto-flex/overview.md). |
| **صفحات العملاء** | عملاؤك | صفحات تتبع الشحنة والإرجاع والتحقق من العنوان، على نطاقك وبعلامتك التجارية. راجع [الصفحات المخصّصة](https://docs.tryoto.com/ar/modules/customer-notification/branded-pages.md). |

وتعمل تحت الواجهات الأربع واجهة [REST API](https://docs.tryoto.com/ar/developers/overview.md) نفسها. ولا تملك لوحة التحكم أي امتياز خاص؛ فكل ما تفعله يمكن لأنظمتك أن تفعله أيضًا.

## كيف تدخل البيانات وتخرج؟

| الاتجاه | المصدر أو الوجهة |
| - | - |
| **الدخول** | **قنوات البيع**: طلبات تُزامَن لحظيًا من المتاجر الإلكترونية والأسواق الإلكترونية المربوطة. |
| | **API**: طلبات ومنتجات وكميات مخزون ترسلها أنظمتك. |
| | **لوحة التحكم**: إدخال الطلبات يدويًا والرفع الجماعي. |
| | **المسح الضوئي**: مسح الباركود عند الاستلام والتجهيز والتغليف والتوصيل. |
| **الخروج** | **شركات الشحن**: حجوزات الشحنات، مع عودة أحداث التتبع. |
| | **مزودو خدمات المراسلة**: الرسائل النصية والبريد الإلكتروني وواتساب عبر حساباتك. راجع [مزودو خدمات المراسلة](https://docs.tryoto.com/ar/integrations/messaging-providers.md). |
| | **قنوات البيع**: تحديث مستويات المخزون والحالات وروابط التتبع في القناة. |
| | **خدمات الويب هوك**: أحداث تُرسل إلى أنظمتك لحظة وقوعها. راجع [خدمات الويب هوك](https://docs.tryoto.com/ar/integrations/webhooks.md). |

## الطلب هو العمود الفقري

ما يجعل المنصة متماسكة من الناحية المعمارية هو أن الطلب **سجل واحد من إتمام الشراء حتى التسليم**. فالشحنات والصناديق وعمليات التجهيز والرسائل والمرتجعات والرسوم كلها ترتبط به، بدلًا من أن تُحفظ في أنظمة منفصلة.

> [!TIP]
>
> **لهذا يكون لكل سؤال جواب واحد**
>
> يستطيع التوجيه أن يوازن بين المسافة والمخزون لأنه يراهما في السجل نفسه. وتعرض صفحة تتبع الشحنة حالة موحّدة واحدة عبر أربع شركات شحن لأن الحالات كلها تُسجَّل على الطلب نفسه. ويرتبط المرتجع بعملية البيع الأصلية لأنه لم يتوقف عن كونه جزءًا من الطلب نفسه.
>
> كل ذلك سهل عندما يوجد سجل مشترك، وصعب فعلًا من دونه. وهذه هي الحجة المعمارية لاستخدام منصة عمليات واحدة بدلًا من مجموعة أدوات مربوطة ببعضها.

## ما الذي يبقى منفصلًا؟

قد يضم الحساب الواحد الكثير. هذه هي الحدود المهمة:

| الحد | ما الذي يفصله |
| - | - |
| **الحساب** | نشاطك التجاري. وهو الحد الخارجي الذي لا يتجاوزه شيء. |
| **العلامة التجارية** | الهويات التجارية داخل الحساب الواحد: الشعار واسم المرسِل وقوالب الرسائل وصفحة تتبع الشحنة. راجع [المفاهيم الأساسية](https://docs.tryoto.com/ar/get-started/core-concepts.md). |
| **المركز** | المخزون والموظفون والحاويات وطريقة التجهيز وساعات العمل لكل موقع. راجع [إدارة المراكز](https://docs.tryoto.com/ar/modules/hubs-management/overview.md). |
| **نطاق صلاحيات المستخدم** | المراكز التي يمكن للشخص العمل فيها، والشاشات والإجراءات المتاحة له. راجع [المستخدمون والأدوار والصلاحيات](https://docs.tryoto.com/ar/platform/users-roles-and-permissions.md). |
| **الحساب الفرعي** | لمشغّلي الأسواق الإلكترونية: كل بائع حساب مستقل تحت حساب رئيسي. راجع [الأسواق الإلكترونية](https://docs.tryoto.com/ar/integrations/marketplaces.md). |

## أين تعمل المنصة؟

| | |
| - | - |
| **الاستضافة** | بنية سحابية عامة مُدارة، فلا يوجد ما تحتاج إلى تثبيته أو تحديثه. |
| **موقع البيانات** | يُحدَّد عند الإعداد. **تتوفر الاستضافة داخل المملكة** للتجار الذين يتطلب عملهم بقاء بياناتهم في المملكة العربية السعودية. راجع [الأمان والامتثال](https://docs.tryoto.com/ar/platform/security-and-compliance.md). |
| **حماية الشبكة** | يعمل جدار حماية لتطبيقات الويب (WAF) أمام المنصة. |
| **الشهادات** | ISO 27001 وSOC 2 Type II، وكلتاهما لعام 2026. |

## البيئات

| البيئة | عنوان URL الأساسي | الوصف |
| - | - | - |
| **بيئة الإنتاج** | `https://api.tryoto.com` | طلبات حقيقية وشركات شحن حقيقية وفواتير حقيقية. |
| **بيئة الاختبار (Sandbox)** | `https://staging-api.tryoto.com` | المسارات وهياكل البيانات نفسها، مع شركات شحن تجريبية. ولها حساب خاص ورمز API خاص. |

> [!WARNING]
>
> **الخطر الحقيقي في الانتقال إلى الإنتاج لا في البناء**
>
> تختلف بيئة الاختبار عن بيئة الإنتاج في الأشياء التي تُكتب عادةً مباشرة في الكود: عقود شركات الشحن ورموز المراكز وأسماء العلامات التجارية وبيانات الاعتماد.
>
> احفظ كل القيم الخاصة بالبيئة في ملفات الإعداد منذ اليوم الأول. فالقيمة المكتوبة يدويًا داخل الطلب أثناء التطوير هي السبب الأشهر لمشكلات اليوم الأول بعد الإطلاق، ويمكن تجنّبها تمامًا.

## كيف يمكن توسيع المنصة؟

| نقطة التوسيع | ما الذي تتيحه |
| - | - |
| **القواعد** | التحكم في توجيه الطلبات واختيار شركة الشحن دون كتابة كود. راجع [توجيه الطلبات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-routing.md) و[أتمتة الشحن](https://docs.tryoto.com/ar/modules/shipping-management/shipping-automation.md). |
| **API** | تنفيذ كل ما تقوم به لوحة التحكم من أنظمتك مباشرة. |
| **خدمات الويب هوك** | تفاعل أنظمتك مع ما يحدث دون استعلام متكرر. |
| **أدوات الربط المخصّصة** | ربط تبنيه OTO على نقاط النهاية التي توفّرها، للأنظمة التي لا يتوفر لها ربط جاهز. راجع [أنظمة ERP](https://docs.tryoto.com/ar/integrations/erp-systems.md). |

## تصميم تكامل يعمل بشكل سليم

هناك ثلاث خصائص في النظام يجدر بك معرفتها قبل البناء عليه.

| | |
| - | - |
| **قد تتكرر الأحداث** | قد يُرسَل الويب هوك أكثر من مرة. لا تفترض أن كل حدث يصل مرة واحدة فقط، واجعل إعادة معالجته آمنة. |
| **قد تصل الأحداث بغير ترتيبها** | توقيت الشبكة لا يتبع تسلسل الحالات لديك. لا تُرجِع حالة الطلب إلى الوراء أبدًا لأن حدثًا أقدم وصل متأخرًا. |
| **تتحدّث القنوات بعد لحظات** | يحتاج المخزون والحالة إلى لحظات للوصول إلى قناة البيع. والفرق لبضع ثوانٍ يعني أن النظام يعمل، لا أنه متعطل. |

وتجد التفاصيل العملية، مثل استراتيجية إعادة المحاولة وتجديد الرمز والتحقق من التوقيع، في [الأخطاء وحدود الطلبات](https://docs.tryoto.com/ar/developers/errors-and-rate-limits.md) و[أحداث الويب هوك](https://docs.tryoto.com/ar/developers/webhook-events.md).

## إلى أين بعد ذلك؟

> **[المفاهيم الأساسية](https://docs.tryoto.com/ar/get-started/core-concepts.md)**
>
> المصطلحات التي تستخدمها هذه المكوّنات.

> **[المطورون](https://docs.tryoto.com/ar/developers/overview.md)**
>
> واجهة API التي يقوم عليها كل شيء.

> **[الأمان والامتثال](https://docs.tryoto.com/ar/platform/security-and-compliance.md)**
>
> الشهادات وموقع البيانات وضوابط الحماية.


## Related topics

- [إخطارات المنصة](https://docs.tryoto.com/ar/platform/announcements.md)
- [التعاون والإشعارات](https://docs.tryoto.com/ar/platform/collaboration-and-notifications.md)
- [المستخدمون والأدوار والصلاحيات](https://docs.tryoto.com/ar/platform/users-roles-and-permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.