تعذر جلب الكتالوج المحفوظ. يمكنك متابعة استعراض البيانات التجريبية وإعادة المحاولة.
توثيق API والتشغيل
دليل للمطورين لتشغيل المشروع وفهم التخزين والواجهات المتاحة.
ما الذي يعمل في هذه البيئة؟
تعمل الواجهة على React وVite، والمصادقة والمساعد على GenMB. تُنفذ الخلفية بوظائف المنصة، وتُحفظ البيانات في تخزين المفتاح والقيمة المدمج، وليس قاعدة SQL. تعمل الخلفية بوظائف GenMB، وليس بخادم Express مستقل.
استدعاءات وظائف GenMB المتاحة
catalog: {action:"health"}حالة التخزين — لا تدعي اتصالًا بموفر خارجي.catalog: {action:"list", collection:"brands"}الشركات المحفوظة؛ مرشح q.catalog: {action:"list", collection:"services"}الخدمات؛ مرشحات q وbrandId وcategory وstatus داخل filters.catalog: {action:"list", collection:"devices"}الموديلات؛ مرشحات q وbrandId داخل filters.استخدم window.genmb.fn.invoke("catalog", body) للاستدعاءات أعلاه. عمليات الإدارة والطلبات تُنفذ عبر وظائف catalog وorders وresolveRole مع فحص الصلاحيات على الخادم؛ لا توجد مسارات Express داخل المعاينة.
تشغيل محلي
npm install npm run dev npm run build npm run test:server
المصادقة والتخزين المدمجان يعملان في GenMB. خارج المنصة تظهر واجهة الاستعراض، ولا تُحفظ عمليات تتطلب SDK غير متوفر. راجع README لتوثيق وظائف المنصة وإعدادها.
إعداد حماية الطلبات
تُشفّر سجلات الطلبات الإدارية قبل حفظها. قبل استقبال طلبات حقيقية، أضف السر الخادمي ORDER_ENCRYPTION_KEY من 64 رمز hex عشوائي إلى Secrets؛ راجع أمر التوليد في README. لا تضع هذا السر في الواجهة، ولا تغيّره دون خطة ترحيل للطلبات القديمة. في غيابه يظل الاستعراض متاحًا ويظهر خطأ واضح عند الإرسال بدل نجاح غير حقيقي.
التخزين والاستضافة
يحفظ التطبيق بياناته حاليًا في التخزين المدمج. قاعدة بيانات مُدارة ميزة Pro؛ يمكنك الترقية أو ربط مشروع Supabase خاص بك مجانًا من لوحة Database. لا ينتقل التطبيق إلى موفر آخر تلقائيًا.
يمكن نشر الواجهة الثابتة مجانًا. خدمات Render المجانية قد تدخل السكون، ولا تدعم أقراصًا دائمة؛ لا تحفظ سجلات العملاء في ملفاتها المحلية. حسابات الموظفين تحتاج خطة GenMB مدفوعة، والمساعد يخضع لحدود استخدام الخطة.
ربط API خارجي
أضف الاتصال في functions/ بعد مراجعة وثائق الموفر. خزّن المفاتيح في Secrets، تحقق من الصلاحية والتوافق وسجل نتيجة الاتصال. جميع الأدوات الخارجية حاليًا غير مربوطة؛ المساعد يستخدم الذكاء الاصطناعي المدمج ولا ينفذ صيانة فعلية.
هل الموقع ينفذ تفليشًا تلقائيًا؟
لا. ينظم الطلبات ويعرض الكتالوج؛ التنفيذ الفني أو الاتصال بالأدوات يتطلب إعدادًا حقيقيًا منفصلًا.