عن المشروع

يوفّر هذا المستودع نظامًا بيئيًا لعملاء متعددي اللغات لواجهة برمجة تطبيقات Katana Manufacturing ERP، بما في ذلك عملاء Python وTypeScript بالإضافة إلى خادم Model Context Protocol (MCP) تجريبي. يتم إنشاء جميع العملاء من مواصفات OpenAPI 3.1.0 وتتميز بإعادة محاولة تلقائية، ومعالجة تحديد المعدل، وترقيم صفحات ذكي. يدعم عميل Python العمليات المتزامنة وغير المتزامنة مع أمان كامل للأنواع عبر Pydantic، بينما عميل TypeScript غير متزامن فقط مع أمان كامل للأنواع ودعم للمتصفح. يغلّف خادم MCP مجموعة فرعية منسقة من الأدوات عالية المستوى (بحث، تعديل، تنفيذ، تحقق) ويتضمن أزواج معاينة/تطبيق لعمليات الكتابة، مما يتيح التكامل مع مساعدي الذكاء الاصطناعي مثل Claude وCursor. التكوين مرن عبر متغيرات البيئة أو ملفات .env أو معلمات مباشرة. المشروع منظم كـ monorepo مع توثيق مشترك، وسجلات قرارات معمارية، ونظام بناء موحد باستخدام uv. يشمل التطوير خطافات ما قبل الالتزام، والتزامات تقليدية للإصدارات الآلية، واختبارات شاملة.