الـ Blueprint: جعل أيّ منصّة قابلة للقراءة من الوكلاء

وحدة PrestaShop ليست غايةً بذاتها. إنّها التنفيذ الأوّل لنمطٍ قابل لإعادة الاستخدام: كيف نفتح أيّ منصّة تجارة إلكترونية لوكلاء الذكاء الاصطناعي، دون اختراع بروتوكول. نسمّيه الـ Blueprint.

المشكلة ليست البروتوكول، بل الاقتران

الإغراء، عند تنفيذ UCP أو MCP، هو ترميز كلّ شيء داخل الوحدة. والنتيجة: كودٌ للرمي، غير قابل للنقل. وعند المنصّة التالية (WooCommerce، أو واجهة Symfony، أو SaaS مغلق)، تبدأ من جديد.

يضع الـ Blueprint بنيةً مختلفة: نواة مفصولة + مُحوّلات، تدور حول صيغةٍ محوريّة.

AI agents
   ▲  discover /.well-known/ucp, then query
ADAPTERS (UCP REST · UCP MCP · later WebMCP, feeds)
   ▲  pure functions: Capability Graph → protocol surface
CAPABILITY GRAPH (versioned JSON Schema, neutral, unbranded)
   ▲  produced by introspection, through a PORT
PLATFORM (PrestaShop · Sylius · an API · a proxy)

الـ Capability Graph: الشيء الوحيد الذي تكتبه

يصف المحور «ما يستطيع هذا النظام كشفه» — منتجات، تشكيلات، أسعار عامّة، مخزون، لغات، عملات — بمعزلٍ عن أيّ بروتوكول. إنّه JSON Schema بإصدارات مُرقَّمة (versioned).

أيّ منصّة تستطيع إنتاج هذا الرسم ترث مجّانًا كلّ المُحوّلات. هذا هو العمل الوحيد الخاصّ بالمنصّة. أمّا الملفّ التعريفي، وربط UCP، وخادم MCP: فتُعاد كما هي.

ثلاثة أوضاع نشر، نواةٌ واحدة

• مُضمَّن (مُرمَّز): النواة داخل التطبيق، الذي يُنفّذ المنافذ (ports) بأصنافه. هذا هو وحدة PrestaShop.
• مكتبة: النواة كاعتماد Composer لتطبيقٍ قائم — مثلًا FondoukBundle لـ Sylius/Symfony. تنفيذٌ مرجعيّ ثانٍ يُثبت قابلية النقل.
• وسيط (Proxy): النواة أمام نظامٍ لا يمكن المساس به، موصولةً بواجهته، تكشف السطح الوكيليّ نيابةً عنه.

ما يجعل الوضعين 2 و3 ممكنيْن: النواة لا تعتمد على أيّ إطار عمل. من هنا الفصل الفيزيائي الصارم capability-core/ ↔ prestashop-module/.

الخطّ الأحمر

الـ Blueprint دليل عملٍ لتنفيذ المعايير القائمة، لا مواصفةً منافِسة. يوم يصف مفهومًا تُعرّفه UCP أو MCP سلفًا، نحذفه ونشير إلى مواصفتهما. تأتي السلطة من كونك أفضل تنفيذ، لا معيارًا إضافيًّا.

اقرأ الـ Blueprint

أربعة مُخرجات، مُستخرَجة من كودٍ حقيقيّ: مخطّط الـ Capability Graph، وعقد المُحوّل، ونمط الاكتشاف، وأوضاع النشر. نقطة الدخول: ARCHITECTURE.md. كلّ شيء مفتوح (MIT).

فريق فُندُق — Synapsea