الملحق C - عقد القدرة المشترك
عقد القدرة المشترك هو الحد المشترك الذي يسمح لفرق مختلفة بالعمل قبل أن تكون الأجهزة النهائية متاحة. يصف الوظيفة، وليس تصريحًا غير محدود لاستخدام مورد.
C.Field - contract_id
معرف ثابت لعقد الوظيفة أو الملف.
C.Field - function
إجراء/نتيجة قابلة للقراءة من قبل الإنسان، مثل
locate_marks.
C.Field - input_schema
كائنات الإدخال ذات النسخ، وحدات القياس، النطاقات المسموح بها والملفات المطلوبة.
C.Field -
output_schema
نتيجة موثَّقة، مجالات الجودة، وحدات القياس، مراجع الأدلة وحالات الخطأ.
C.Field -
resource_target
HSIMC Resource أو فئة الهدف؛ يتم ربط النسخة الفعلية بشكل منفصل.
C.Field -
execution_mode
محاكاة / مرجع مادي / تم التسليم مادياً / تشغيلي.
C.Field - conditions
البيئة، الأدوات، المعايرة، المواد وظروف المتطلبات الأساسية.
C.Field -
authority_required
الحد الأدنى من الصلاحية المطلوبة لاكتشاف، قراءة، حجز، تكوين، تنفيذ، إيقاف، قبول أو إدارة.
C.Field -
effect_identity
خلاصة أو معرف يقفل التأثير المادي المقصود بشكل مستقل عن الاعتماديات قصيرة الأجل.
C.Field - operation_id
هوية ثابتة تُستخدم لإعادة المحاولة/إعادة القراءة لطلب التأثير المادي.
C.Field -
freshness_requirement
الحد الأقصى للعمر المقبول للملاحظات المستخدمة لتفويض أو تخطيط الإجراء.
C.Field -
resource_locking
الحجز، الإيجار، سلوك الانشغال/الصراع وقاعدة الإطلاق.
C.Field -
safety_boundary
الشروط التي يجب أن تظل محلية/حتمية ولا يمكن تفويضها إلى نموذج بعيد.
C.Field - acceptance
القياس، التفاوتات، الأدلة وخطوة قبول البشر/المنظمة.
C.Field - recovery
التوقف، نتيجة غير معروفة، شبكة معطلة وسلوك إعادة التشغيل.
C.Field - version
مراجع عقد، مُحول، خوارزمية، أجهزة/قائمة مواد، المعايرة ونسخ النشر.
C.Field - cost_time
الزمن المتوقع والفعلي، المواد، الطاقة وحقول التكلفة المالية.
C.Field - rights
المساهمة، إعادة الاستخدام، النسبة، السرية وقيود السحب.
C.1 مثال -
locate_marks
{
"contract_id": "hsimc.locate_marks.v0",
"function": "locate_marks",
"input": {"image_ref": "sha256:...", "marker_profile": "marker-profile-v3", "calibration_ref": null},
"target": {"resource_id": null, "mode": "simulation"},
"authority": {"subject": "bound-at-runtime", "scope": ["read_input", "run_observation"]},
"output": {"coordinate_space": "pixels", "marks": [], "quality": {}, "evidence_refs": []},
"limits": ["No millimetre conversion without calibration evidence", "Observation only; no machine motion or laser action"]
}يمكن أن يعمل نفس العقد ضد صور ثابتة، محاكي سحابي، كاميرا مرجعية عن بُعد، أو جهاز تم تسليمه. يتطلب كل هدف مُحوِّلًا وأدلة خاصة به.
C.2 قاعدة إعادة المحاولة والتأثير
يجب على إعادة المحاولة أن تعيد استخدام operation_id
الأصلي عندما يكون التأثير المادي المطلوب هو نفسه. إذا كانت النتيجة غير
معروفة، استفسر عن العملية الأصلية قبل إنشاء تأثير جديد. الاعتماديات
الجديدة أو رمز محدث لا تُشكل بمفردها عملاً ماديًا جديدًا.