كوكوالا

Cookwala / For

لصانعي الأجهزة: الأفران والمواقد والطباخات متعددة الوظائف وروبوتات المطبخ والروبوتات البشرية

الجهاز الذي يطبّق كوكوالا يقرأ وصفة موقَّعة، ويفحص كل خطوة مقابل ما يستطيع فعله واستشعاره، ويرفض ما لا يستطيع التحقق منه قبل أن يسخن أي شيء، ويحافظ على حدود سلامته مهما قالت الوصفة أو الوكيل أو الشبكة. خمس نقاط نهاية، وثيقة قدرات واحدة، واختبارات عامة.

لماذا يهمّك

أنت تملك الجزء الصعب أصلًا: الحركة والتحكم بالحرارة والاستشعار. يمنحك كوكوالا طبقة المهمة فوق ذلك، مفتوحة وبلا رسوم: صيغة وصفات يمكن لآلة أن تخطط لها، أغلفة عمليات بنطاقات فيزيائية، سلّم مستشعرات لكل خطوة، حدود سلامة محلية لا يرفعها شيء، ورفض هو إجابة عادية لا خطأ. يحصل عملاؤك على كل المطابخ دون أن تكتب وصفة؛ ويحصل المنظّم على قصة سلامة يمكنه قراءتها؛ ويحصل فريق المبيعات على تقرير مطابقة موقَّع بدل ادعاء.

ما هو موجود اليوم: واجهة Core 0.2، منفّذ مرجعي يمكنك تشغيله بجانب جهازك، 51 متّجه مطابقة أساسيًا تشمل التشغيل الجاف للمنفّذ، صيغة تقرير موقَّع وأداة تحقق. وما ليس موجودًا: جهة اعتماد، اختبار عتاد، تطبيق ثانٍ. ستكون الأول، وسيتغيّر المعيار حيث تُثبت أنه مخطئ.

طرق المشاركة، من الخفيف إلى العميق

  1. خفيف. اكتب وثيقة قدرات لمنتج واحد وجرّب الوصفات التسع النموذجية عليها في المتصفح أو سطر الأوامر؛ اقرأ القسمين 3 و6 من Core 0.2 في أمسية.
  2. متوسط. طبّق نقاط النهاية الخمس على موزّع بجانب البرنامج الثابت، وشغّل مجموعات المنفّذ، وابدأ الموزّع المرجعي برمز دخول وقارن الإجابات على الشبكة.
  3. عميق. طبّق حزمة حدود السلامة على الجهاز، وقِس الإيقاف المحلي، وانشر تقرير مطابقة موقَّعًا، وافتح طلب دمج يدرجه في السجل، وأخبرنا بما يجب تغييره في Core 0.3.

أول نجاح في أقل من 15 دقيقة

أقل من 15 دقيقة، بلا عتاد: شغّل مجموعات المنفّذ، ثم ابدأ المنفّذ المرجعي مع تفعيل المصادقة وجرّب وصفة جافًا على وثيقة قدراتك.

git clone https://github.com/amado2k5/cookwala && cd cookwala && pip install -e sdk/python
python tools/run_conformance.py envelope
python tools/run_conformance.py dryrun
cp examples/capabilities/robot-arm.json my-device.json
cookwala dryrun examples/koshari.cookwala.json --device my-device.json --human-present
conformance: 14/14 passed · conformance: 7/7 passed · مقبول أو مرفوض مع الخطوة والسبب

المسار بعد ذلك

  1. اكتب وثيقة القدرات: العمليات، المستشعرات بدقّتها، السلامة (الشهادات، كشف الحضور، الإيقاف)
  2. جرّب الوصفات النموذجية جافًا؛ كل رفض يسمّي الخطوة والسبب
  3. طبّق POST /v1/executions وقراءة الحالة والإيقاف والاستئناف والسجل، مع GET /v1/capabilities و/v1/safety-limits
  4. شغّل مجموعات المنفّذ (envelope وdryrun وtransitions) وفحوص الشبكة في دليل الموزّع
  5. انشر تقرير مطابقة موقَّعًا؛ وحتى توجد خدمة سجل، يضيفه طلب دمج إلى ملف السجل
  6. لا شيء معتمد بعد: لا توجد جهة اعتماد، والتقرير يقول ما يثبته وما لا يثبته

مسارات أخرى