كيف بنينا YeloScale: منصة تجارة إلكترونية جاهزة لـ MCP في عصر البحث بالذكاء الاصطناعي

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

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

YeloScale مستودع موحّد يضم واجهة أمامية بـ React وVite، وخلفية SaaS بـ NestJS على Postgres، وبوابة توصيل بـ Fastify مع Prisma وعمّال BullMQ، وخدمات منفصلة للفواتير والصور. يتولّى Redis التخزين المؤقت وقوائم الانتظار. كل شيء يُشحن في حاويات Docker مع نشر blue/green حتى لا تقطع الإصدارات عمل التاجر أثناء موسم البيع.

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

التاجر لا يبني موقعًا إلكترونيًا. هو ينشر متجرًا، ويولّده YeloScale ممّا هو موجود أصلًا في مساحة العمل: المنتجات والمجموعات والأسعار والمخزون وقواعد التوصيل. يعيش المتجر على رابط yeloscale.shop أو نطاق خاص، ويعيد استخدام نفس السلة والدفع وتدفّق الدفع عند الاستلام في كل المتاجر.

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

معظم زواحف الذكاء الاصطناعي لا تنفّذ JavaScript. المتجر المعروض من جهة العميل غير مرئي لـ ChatGPT وClaude وPerplexity، وضعيف الأساس حتى بالنسبة لجوجل. لذلك يعرض YeloScale صفحات المتاجر العامة من جهة الخادم، بمحتوى HTML حقيقي وروابط نظيفة وبيانات منظّمة فوقها.

ينشر كل متجر بيانات JSON-LD من أنواع Store وProduct وOffer وCollectionPage وBreadcrumbList، وملف robots.txt وsitemap.xml خاصًا به، وملف llms.txt يلخّص المتجر لنماذج اللغة. ويتيح دليل متاجر عام مع بحث من جهة الخادم للناس، ولمساعدي الذكاء الاصطناعي، العثور على متجر يبيع منتجًا بعينه.

يمنح MCP، أي Model Context Protocol، وكيل الذكاء الاصطناعي قائمة أدوات معتمدة بمخططات وصلاحيات واضحة. ويوفّر YeloScale خادم MCP بعيدًا عبر Streamable HTTP على نقطة نهاية واحدة، محميًا برموز OAuth من مزوّد هوية خارجي، مع بيانات اكتشاف تتيح لعملاء MCP الاتصال دون شيفرة مخصصة.

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

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

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

يحصل التاجر على متجر إلكتروني حقيقي، وعلى الطلبات والدفع عند الاستلام في مكان واحد، وعلى شحنات تُرسل إلى أي شركة توصيل مدعومة، وعلى صفحات يمكن لجوجل ومساعدي الذكاء الاصطناعي قراءتها. كما يصبح عمله جاهزًا للوكلاء: فعندما يضيف وكيل مبيعات أو دعم بالذكاء الاصطناعي، يكون خادم MCP موجودًا مسبقًا بالصلاحيات الصحيحة.

بالنسبة لـ OHY Labs، YeloScale هو التطبيق المرجعي لما نعنيه بالبنية التحتية المتوافقة مع MCP. ونفس المنهج، أي منصة تكون مصدر الحقيقة، وواجهات عامة مولّدة، وطبقة MCP محدودة الصلاحيات، هو ما نقدّمه لمنصات عملائنا.