أمثلة الحاويات والعروض التوضيحية

0D Balance

مجموعة مشتركة من أرصدة الحوسبة أو وحدات الطاقة. تقوم المعاملات بخصم أو إضافة قيمة ثابتة من النقاط - لا توجد مراكز، فقط الكمية.

هذا المثال صغير عن عمد. يُظهر كيف تعمل الأرصدة الحتمية عندما يكون السؤال الوحيد هو “كم”، وليس “أين”. استخدمه كقالب لأي مورد مشترك يتطلب تدقيقًا صارمًا.

ما يظهره هذا

• كميات جبرية 0D (نقطة ثابتة)، بدون إحداثيات مكانية
• تعديلات التوازن الذري (مدين/دائن)
• إعادة تشغيل حتمية لتاريخ المعاملات
• تجمعات الموارد المشتركة متعددة الجهات الفاعلة

عمليات المثال

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 1001,
        "kind": { "type": "balance" },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "AddFungible",
      "args": {
        "class_id": 5001,
        "key": 1,
        "location": { "container_id": 1001, "kind": "balance" },
        "quantity": "100"
      }
    },
    {
      "op": "RemoveFungible",
      "args": {
        "class_id": 5001,
        "key": 1,
        "from": { "container_id": 1001, "kind": "balance" },
        "quantity": "50"
      }
    }
  ]
}

هذا ينشئ حاوية التوازن 1001، ويضيف 100 وحدة من class_id 5001 (energy_unit)، ثم يحرق 50 وحدة، مما يترك 50 في المسبح.

قبل

100

->

بعد

50

رسم توضيحي: قبل = 100 وحدة، بعد = 50 وحدة في الحاوية 1001 (energy_pool).

استخدم توازن 0D عندما يكون “كم” فقط هو المهم، وليس “أين” يتم الاحتفاظ به.

ضمان حتمي: تسلسلات متطابقة تنتج نتائج متطابقة.

سيناريو المثال: خدمة أو وكيل أتمتة يدير أرصدة الحوسبة لمجموعة. استدعاءات العمليات:

• check_balance() → استعلام عن الرصيد الحالي
• reserve_credits(job_id, amount) → خصم ذري
• release_credits(job_id) → استرداد عند إكمال الوظيفة

يطبق Asset Core قواعد التوازن التي تحددها—الحدود الدنيا، الحدود العليا، والأرصدة السلبية الاختيارية—مع سجل تدقيق كامل لكل معاملة ائتمانية.

0D Slots

تقوم الكيان بعرض 8 فتحة أدوات. تشغل أدوات مثل الكاميرا أو القابض فتحة واحدة بالضبط؛ الفتحات ليس لها هندسة - فقط مواقع مسماة.

تتعلق الفتحات بالخصوصية والنوايا، وليس بالإحداثيات. يوضح هذا المثال كيفية ضمان أن الفتحة إما مشغولة أو فارغة، دون وجود حالة وسيطة غامضة.

ما يظهره هذا

• مواقع منفصلة بدون علاقات هندسية
• إدارة الأدوات/المعدات مع حصرية الفتحات
• حالة المعدات الحتمية
• التموقع الدلالي (ليس إحداثيات مكانية)

عمليات المثال

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 2001,
        "kind": { "type": "slots", "count": 8 },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5201,
        "key": 1,
        "location": {
          "container_id": 2001,
          "kind": "slot",
          "slot_index": 3
        }
      }
    }
  ]
}

هذا ينشئ حاوية الفتحات 2001 ويضع class_id 5201 (camera_head) في slot_index 3.

1

2

3camera_head

4

5

6

7

8

رسم توضيحي: الفتحة 3 تحتوي على camera_head.

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

ضمان حتمي: تسلسلات متطابقة تنتج تكوينات فتحات متطابقة.

سيناريو المثال: وحدة تحكم الروبوت أو وكيل يدير 8 فتحات أدوات. استدعاءات التشغيل:

• list_equipped_tools() → استعلام عن المعدات الحالية
• equip_tool(slot_id, tool_name) → تعيين موضع ذري
• swap_tools(slot_a, slot_b) → تبادل معاملات

يطبق Asset Core حصرية الفتحات - لا أدوات وهمية، لا تجهيز مزدوج، وموثوقية كاملة لكل تغيير في المعدات.

1D شبكة

مسار ناقل مع المواقع 1..5. تقوم الأنظمة بوضع وتحريك الحزم على طول محور واحد؛ لا يمكن لعنصرين شغل نفس الموقع.

النقطة هنا هي التسلسل ومنع التصادم على طول محور واحد. إنها أبسط حالة مكانية حيث يكون الترتيب مهمًا ويجب رفض الحركات غير الصالحة بشكل حتمي.

ما يظهره هذا

• دلالات مكانية خطية (تحديد موضع أحادي المحور)
• كشف التصادم وحصرية الموقع
• عمليات النقل المتسلسلة
• ترتيب موضع الحركة والتحديد الحتمي

عمليات المثال

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 3001,
        "kind": {
          "type": "grid",
          "capacity": 5,
          "grid_width": null
        },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5301,
        "key": 1,
        "location": {
          "container_id": 3001,
          "kind": "grid_cell",
          "position": 3,
          "rotation": "none"
        }
      }
    }
  ]
}

هذا ينشئ حاوية شبكة 3001 مع 5 مواقع ويضع class_id 5301 (package_42) في الموقع 3.

1

2

P42

3

4

5

رسم توضيحي: يشير P42 إلى class_id 5301 (package_42) في الموضع 3.

استخدم شبكة أحادية البعد عندما تكون الترتيبات على طول مسار واحد مهمة ويجب منع الاصطدامات.

ضمان حتمي: تسلسلات متطابقة تنتج نتائج متطابقة.

سيناريو المثال: وحدة تحكم الناقل تدير حزامًا. استدعاءات التشغيل:

• get_item_position(item_id) → استعلام عن الموقع على الحزام
• move_item(item_id, target_position) → حركة آمنة ضد التصادم
• remove_item(item_id) → إزالة ذرية من الحزام

يمنع Asset Core الازدواجية في الإشغال، ويتتبع ترتيب العناصر، ويمكّن من إعادة تشغيل عمليات الناقل بدقة.

1D مستمر

سكة حديدية معايرة بدقة ميليمترية. تتحرك عربة الروبوت على محور مستمر باستخدام إحداثيات ثابتة.

الحاويات المستمرة هي نقاط ثابتة، وليست نقاط عائمة. هذا الاختيار يجعل إعادة التشغيل حتمية ويزيل انحراف التقريب عبر تسلسلات طويلة من الحركات.

ما يظهره هذا

• إحداثيات النقاط الثابتة مع تقريب حتمي
• وضع مؤكد الحدود على طول محور واحد
• فحوصات تصادم مستمرة للامتدادات المتداخلة
• دلالات الالتزام/إعادة التشغيل متطابقة مع الحاويات المنفصلة

عمليات المثال

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 4001,
        "kind": {
          "type": "continuous_line_1d",
          "min_x": 0,
          "max_x": 200000,
          "quantization_inv": 1000,
          "bucket_cell_size": 10000
        },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5401,
        "key": 1,
        "location": {
          "container_id": 4001,
          "kind": "continuous_1d",
          "coord": { "x": 25000 }
        }
      }
    }
  ]
}

هذا ينشئ حاوية continuous_line_1d 4001 ويضع class_id 5401 عند x=25.000 (quantization_inv=1000).

0.000

C

200.000

رسم توضيحي: C = carriage_A.

استخدم خطًا مستمرًا أحادي الأبعاد عندما يجب الحفاظ على المسافات الواقعية على طول محور واحد.

ضمان حتمي: تسلسلات متطابقة تنتج نتائج متطابقة.

سيناريو مثال: وحدة تحكم سكة حديدية خطية تدير محورًا واحدًا. استدعاءات التشغيل:

• get_carriage_position(carriage_id) → استعلام عن الإحداثيات الحالية
• move_carriage(carriage_id, target_x) → حركة آمنة ضد التصادم
• reserve_span(start_x, end_x) → تأمين نافذة سفر حصرية

يطبق Asset Core التوزيع الحتمي، ويمنع التداخل، ويوفر إعادة تشغيل دقيقة لحركة السكك الحديدية.

شبكة ثنائية الأبعاد

شبكة مستودع صغيرة (5×5). تشغل الروبوتات والحزم إحداثيات منفصلة؛ يتم تسلسل الحركات الملتزمة لمنع التصادمات.

هذا المثال يوضح تنسيق متعدد الجهات في شبكة مشتركة حيث كل موضع له سلطة. إنه نموذج جيد للمستودعات، وألواح المختبر، وتخطيطات اللوحات التكتيكية.

ما يظهره هذا

• دلالات الفضاء ثنائية الأبعاد (إحداثيات x, y)
• الكشف عن تصادم الكيانات المتعددة
• التوزيع والحركة المعتمدة على الإحداثيات
• حالة الشبكة الموثوقة لتنسيق متعدد الفاعلين

عمليات المثال

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 5001,
        "kind": {
          "type": "grid",
          "capacity": 25,
          "grid_width": 5
        },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5501,
        "key": 1,
        "location": {
          "container_id": 5001,
          "kind": "grid_cell",
          "position": 21,
          "rotation": "none"
        }
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5502,
        "key": 1,
        "location": {
          "container_id": 5001,
          "kind": "grid_cell",
          "position": 22,
          "rotation": "none"
        }
      }
    }
  ]
}

هذا ينشئ حاوية شبكة 5×5 برقم 5001 ويضع class_id 5501 (robot_A) في الموضع 21 و class_id 5502 (package_12) في الموضع 22.

R

P

رسم توضيحي: R = class_id 5501 (robot_A)، P = class_id 5502 (package_12).

استخدم شبكة ثنائية الأبعاد عندما تحتاج الأنظمة إلى تنسيق مشترك، ووعي بالجوار، وحركة آمنة من التصادم.

ضمان حتمي: تسلسلات متطابقة تنتج حالات عالمية متطابقة.

سيناريو المثال: عدة عوامل مستقلة (روبوتات، خدمات، أو وكلاء) تتنقل في أرضية مستودع مشتركة. استدعاءات العملية:

• get_robot_position(robot_id) → استعلام عن الإحداثيات الحالية
• plan_path(start, goal) → إيجاد مسار مع مراعاة التصادم
• move_robot(robot_id, target_coords) → حركة ذرية، آمنة من التصادم

يوفر Asset Core حالة مكانية موثوقة—لا توجد مواقع شبحية، لا تصادمات، وتاريخ تنسيق كامل عبر جميع المشاركين.

2D مستمر

خلية عمل محدودة لروبوتات الالتقاط والتوصيل. تستخدم التوزيعات إحداثيات ثابتة للنقاط x/y مع دوران حتمي بالميلي درجات.

الاستمرارية في الأبعاد الثنائية هي حيث تكون الهندسة الحتمية الأكثر أهمية. يبرز هذا المثال كيف أن إحداثيات النقاط الثابتة وقواعد الدوران تحافظ على دقة إعادة التشغيل، حتى في خلايا العمل الكثيفة.

ما يظهره هذا

• إحداثيات ثابتة النقطة x/y مع تحديد كمي صريح
• فحوصات تصادم المستطيل الموجه (OBB)
• أماكن محددة بالحدود، حركات، وتدويرات
• إعادة تشغيل حتمية لخطط حركة متعددة الفاعلين

عمليات المثال

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 6001,
        "kind": {
          "type": "continuous_grid_2d",
          "min_x": 0,
          "min_y": 0,
          "max_x": 200000,
          "max_y": 120000,
          "quantization_inv": 1000,
          "bucket_cell_size": 10000
        },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5601,
        "key": 1,
        "location": {
          "container_id": 6001,
          "kind": "continuous_2d",
          "coord": { "x": 25000, "y": 40000 },
          "rotation_millideg": 0
        }
      }
    },
    {
      "op": "AddInstance",
      "args": {
        "class_id": 5602,
        "key": 1,
        "location": {
          "container_id": 6001,
          "kind": "continuous_2d",
          "coord": { "x": 110000, "y": 30000 },
          "rotation_millideg": 90000
        }
      }
    }
  ]
}

هذا ينشئ حاوية continuous_grid_2d رقم 6001، ويضع class_id 5601 (gripper_A) في (25.000، 40.000)، ويضع class_id 5602 (part_17) في (110.000، 30.000).

x

y

G

P

مفتاح الرسم البياني: G = class_id 5601 (gripper_A)، P = class_id 5602 (part_17).

استخدم حاوية مستمرة ثنائية الأبعاد عندما يجب الحفاظ على الإحداثيات الفيزيائية والدوران.

ضمان حتمي: تسلسلات متطابقة تنتج حالات عالمية متطابقة.

سيناريو المثال: منظم روبوت يقوم بتنسيق عمليات الالتقاط في خلية عمل مشتركة. استدعاءات العملية:

• preflight_commit(pick_plan) → التحقق من التسلسل دون تغيير
• commit(pick_plan) → تنفيذ مرة واحدة بعد نجاح الفحص المسبق
• read_workcell_region(bounds) → استعلام عن المواقع القريبة لفحص التصادمات

يضمن Asset Core أن تظل عمليات ما قبل الطيران والتزام العمليات متزامنة مع الحفاظ على مسار تدقيق حتمي.

النقل العالمي

تعمل عمليات Asset Core بشكل متسق عبر أنواع الحاويات. تنطبق نفس القواعد النحوية سواء عند النقل بين الأرصدة أو الفتحات أو الشبكات—مما يوضح نموذج التشغيل العالمي.

هذا القسم مفيد عندما تحتاج إلى شرح النظام لأصحاب المصلحة الذين يفترضون وجود واجهات برمجة تطبيقات منفصلة لكل نوع من أنواع الحاويات. النقطة هي أن العمليات تظل مستقرة بينما تتغير الهندسة.

ما يظهره هذا

• دلالات تشغيل موحدة عبر الأبعاد
• انتقالات الحالة عبر الحاويات
• سجل التزام متسق لعمليات العمل متعددة الحاويات
• تحويلات حالة العالم القابلة للتكوين

مثال: التوازن → نقل الشبكة ثنائية الأبعاد

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 7001,
        "kind": { "type": "balance" },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "CreateContainer",
      "args": {
        "container_id": 7002,
        "kind": {
          "type": "grid",
          "capacity": 25,
          "grid_width": 5
        },
        "owner": null,
        "policies": null
      }
    },
    {
      "op": "MoveFungible",
      "args": {
        "class_id": 5701,
        "key": 1,
        "quantity": "1",
        "from": { "container_id": 7001, "kind": "balance" },
        "to": {
          "container_id": 7002,
          "kind": "grid_cell",
          "position": 13,
          "rotation": "none"
        }
      }
    }
  ]
}

هذا ينقل الكمية لـ class_id 5701 (widget) من حاوية الرصيد 7001 إلى موضع شبكة في الحاوية 7002—نفس قواعد العملية، أنواع حاويات مختلفة.

نفس القواعد النحوية (class_id، المواقع، الكميات) عبر أنواع الحاويات؛ ترتيب حتمي يربط كلا التغييرين بسجل التزام واحد.

سيناريو المثال: وحدة تحكم العمل تنقل الأجزاء من مجموعة (0D توازن) إلى مواقع التجميع (2D شبكة). استدعاءات العملية:

• check_parts_available() → استعلام الرصيد
• reserve_and_place(part_type, grid_coords) → عملية ذرية عبر الحاويات

يلتزم Asset Core بتطبيق كلا التغييرين بشكل ذري—لا يوجد مخزون وهمي، لا أجزاء مفقودة، وسجل تدقيق موحد عبر أنواع الحاويات.

تعلم المزيد

للحصول على تفاصيل تقنية، راجع Basics لمعمارية وأنواع الحاويات، أو Docs للحصول على وثائق تقنية أعمق. للحصول على سير عمل شامل مع مكالمات حقيقية وسجلات، راجع Robotic Arm Continuous scenario.