انتقل إلى المحتوى الرئيسي

أوامر التطبيقات

أوامر لإنشاء وتطوير ونشر تطبيقات Qumra.

نظرة عامة​

الأمرالوصف
qumra app initإنشاء تطبيق Qumra جديد
qumra app devتشغيل بيئة التطوير
qumra app deployنشر التطبيق إلى الإنتاج

qumra app init​

إنشاء تطبيق Qumra جديد مع القالب الأولي.

الاستخدام​

qumra app init

الخطوات التفاعلية​

  1. اسم التطبيق: أدخل اسمًا لتطبيقك (أحرف وأرقام وشرطات فقط)
  2. المنظمة: اختر منظمتك من القائمة
  3. التبعيات: اختر ما إذا كنت تريد تثبيت تبعيات npm تلقائيًا

ماذا يحدث​

  • ينشئ التطبيق على Qumra Cloud
  • يستنسخ القالب الأولي من GitHub
  • يحفظ التكوين في .qumra/qumra.config.json
  • يثبت تبعيات npm اختياريًا

مثال​

$ qumra app init

? Enter app name: my-store-app
? Select organization: My Company
? Install dependencies? Yes

✅ App created successfully!

📁 Created: my-store-app/
📝 Config: .qumra/qumra.config.json

Next steps:
  cd my-store-app
  qumra app dev

qumra app dev​

تشغيل بيئة التطوير مع إعادة التحميل المباشر والنفق.

الاستخدام​

qumra app dev

المتطلبات​

يجب تشغيله من داخل مجلد تطبيق تم تهيئته (مع .qumra/qumra.config.json).

الخطوات التفاعلية​

  1. متجر التطوير: اختر متجرًا موجودًا أو أنشئ متجرًا جديدًا للتطوير

الميزات​

  • نفق تلقائي: ينشئ نفقًا آمنًا باستخدام Cloudflare للوصول الخارجي
  • لوحة تحكم مباشرة: واجهة طرفية تفاعلية تعرض الروابط والسجلات
  • إعادة التحميل الساخن: يزامن التغييرات تلقائيًا أثناء التطوير
  • تهجيرات قاعدة البيانات: يشغل تهجيرات Prisma تلقائيًا

اختصارات لوحة المفاتيح في لوحة التحكم​

المفتاحالإجراء
qإنهاء خادم التطوير
pفتح رابط المعاينة
oفتح رابط المتجر

متغيرات البيئة​

يضبط خادم التطوير متغيرات البيئة هذه:

المتغيرالوصف
QUMRA_APP_URLرابط نفق تطبيقك
QUMRA_API_KEYمفتاح API لـ Qumra Cloud
QUMRA_API_SECRETسر API للمصادقة
PORTمنفذ الخادم المحلي

مثال​

$ qumra app dev

? Select dev store: my-test-store

🚀 Development server started!

📡 Local URL    → http://localhost:3000
🌍 Tunnel URL   → https://abc123.trycloudflare.com
🏪 Store URL    → https://my-test-store.qumra.store
📦 Install URL  → https://app.qumra.cloud/install/...

Press 'q' to quit, 'p' for preview, 'o' to open store

qumra app deploy​

نشر تطبيقك إلى الإنتاج.

الاستخدام​

qumra app deploy

المتطلبات​

  • يجب تشغيله من داخل مجلد تطبيق تم تهيئته
  • يجب أن يوجد ملف manifest للتطبيق (qumra.app.json)

App Manifest​

يجب أن يتضمن qumra.app.json:

{
  "name": "My App",
  "production_url": "https://my-app.example.com",
  "embedded": true,
  "scopes": ["read_products", "write_orders"],
  "webhooks": [
    {
      "topic": "orders/create",
      "address": "/webhooks/orders"
    }
  ]
}

مثال​

$ qumra app deploy

📦 Deploying app...

✅ App deployed successfully!

🌍 Production URL: https://my-app.example.com
📱 App ID: abc123xyz

التكوين​

.qumra/qumra.config.json​

يتم إنشاؤه تلقائيًا بواسطة qumra app init:

{
  "appId": "unique-app-id",
  "clientId": "client-id-for-oauth",
  "devStore": "selected-dev-store"
}

نصائح​

سير عمل التطوير
  1. شغّل qumra app init لإنشاء تطبيقك
  2. استخدم qumra app dev أثناء التطوير
  3. انشر باستخدام qumra app deploy عندما تكون جاهزًا
استكشاف الأخطاء
  • إذا فشل النفق، تحقق من اتصالك بالإنترنت
  • تأكد من عدم استخدام عملية أخرى للمنافذ المطلوبة
  • شغّل qumra user login إذا حصلت على أخطاء مصادقة