سوق التطبيقات في ڤاريونس: التثبيت والشراء والفتح والإزالة لكل تطبيق
سوق التطبيقات هو بوابة التاجر إلى أحد عشر تطبيقاً أصلياً داخل اللوحة: يعرض قسماً للتطبيقات المثبتة وقسماً للاكتشاف، وكل بطاقة تحمل زر تثبيت أو شراء وتفعيل أو فتح مع زر إزالة، ويُحسم توفر كل تطبيق حسب خطة الاشتراك.
آخر تحقق: 2026-09-19
يُدار سوق التطبيقات من مسار /dashboard/apps، وهو صفحة واحدة بمكوّن AppsPage من حزمة features/dashboard-apps. وتنقسم الصفحة إلى بطاقتين كبيرتين: الأولى «التطبيقات المثبتة» وتعرض ما فعّله التاجر حالياً مع وصف لكل تطبيق، والثانية «سوق التطبيقات» وتعرض بقية الكتالوج القابل للتثبيت. وعندما لا يوجد شيء مثبت تظهر حالة فارغة بعنوان «لم يتم تثبيت أي تطبيقات حتى الآن» وتوجيه لتصفح السوق أدناه.
كل تطبيق في الكتالوج له بطاقة موحدة: أيقونة دائرية (واتساب بأيقونة مخصصة، والذكاء الاصطناعي بشارة AI، والبقية بصورة)، والاسم المترجم حسب اللغة، واسم المطور، والوصف المختصر بسطرين، وشارة سعر (مجاني أو مبلغ شهري بالعملة)، وشارة «مميز» للتطبيقات المروّجة. وفي التذييل يتبدل الزر حسب الحالة: زر تثبيت بأيقونة تنزيل للتطبيق الجديد، وزر شراء وتفعيل بأيقونة سلة للمدفوع، وزر فتح للتطبيق المثبت الذي له مسار، وزر تكوين لمن لا مسار له، وأيقونة سلة مهملات حمراء للإزالة.
الفلوهات الثلاثة تمر عبر طبقة appsApi في الواجهة: التثبيت يستدعي POST /api/apps/install ثم يحدّث القائمة ويجلب الملف الشخصي من جديد مع تنبيه نجاح، والشراء يستدعي POST /api/apps/purchase بمفتاح عدم تكرار ثم التفعيل ثلاثين يوماً، والإزالة تستدعي POST /api/apps/uninstall. وإذا أرجع الخادم needsPurchase أثناء التثبيت تتحول الواجهة تلقائياً إلى مسار الشراء. وكل عملية تعرض تنبيه تحميل ثم نجاح أو خطأ بالعربية أو الإنجليزية حسب لغة اللوحة.
مصدر الحقيقة الوحيد للكتالوج هو مصفوفة APPS_CATALOG في lib/server/apps/catalog.js: أحد عشر إدخالاً بمعرف واسم ووصف وفئة ومطور وتقييم وسعر ومسار ونوع فوترة ومفتاح أيقونة وتسميات عربية وإنجليزية وحالة تفعيل افتراضية. والمسارات المحمية مسجلة في APP_GATED_PATHS، فلا يفتح مسار تطبيق غير مثبت. ويضيف planAppAccess.js لكل تطبيق وضع الخطة: included للمتاح مجاناً، وpaid للمدفوع بسعر شهري وعملة، وdisabled للمحجوب عن الخطة فيُخفى من السوق ويُرفض تثبيته برسالة «هذا التطبيق غير متاح في باقتك».
التطبيقات الأحد عشر هي: أتمتة واتساب (/dashboard/whatsapp)، والذكاء الاصطناعي (/dashboard/ai-usage)، وصانع رموز QR (/dashboard/qr-maker)، وشجرة الروابط (/dashboard/linktree)، واختصار الروابط (/dashboard/link-shortener)، والمهام (/dashboard/todo)، والتقويم (/dashboard/calendar)، والإيرادات (/dashboard/revenue-command-center)، والمحاسبة (/dashboard/finance)، والتسويق بالعمولة (/dashboard/affiliate)، ومزامنة الكتالوج (/dashboard/catalog-sync). وتُحل التطبيقات المفعّلة للطلبات عبر resolveEnabledApps التي تقرأ الحقول المخزنة لكل متجر وتعيد الكتالوج الكامل مع أعلام التثبيت لصفحة السوق.
خطوات الإعداد في ڤاريونس
افتح سوق التطبيقات
من لوحة التحكم ادخل إلى /dashboard/apps. ستجد عنوان «التطبيقات والتكاملات» مع بطاقة التطبيقات المثبتة وبطاقة سوق التطبيقات.
ثبّت تطبيقاً مجانياً
في بطاقة التطبيق اضغط زر تثبيت. تُرسل الواجهة POST /api/apps/install، وبعد النجاح ينتقل التطبيق إلى قسم المثبتة ويُحدَّث ملفك الشخصي.
اشترِ وفعّل تطبيقاً مدفوعاً
للتطبيق المدفوع اضغط زر شراء وتفعيل. يُرسل POST /api/apps/purchase بمفتاح عدم تكرار، ويُفعَّل التطبيق ثلاثين يوماً مع عرض تاريخ الانتهاء على البطاقة.
افتح التطبيق المثبت
بعد التثبيت اضغط زر فتح لينقلك المتصفح إلى مسار التطبيق (مثل /dashboard/whatsapp). وزر تكوين يظهر لمن لا مسار مباشر له.
أزل تطبيقاً لا تحتاجه
اضغط أيقونة سلة المهملات على البطاقة. تُرسل الواجهة POST /api/apps/uninstall ويعود التطبيق إلى السوق مع تحديث الملف الشخصي.
أسئلة شائعة
أين أجد التطبيقات في لوحة تحكم ڤاريونس؟
من مسار /dashboard/apps بعنوان «التطبيقات والتكاملات»: قسم علوي للمثبتة وقسم سفلي للسوق، وكل تطبيق يُفتح من مساره الخاص بعد التثبيت.
كم عدد التطبيقات المتاحة؟
أحد عشر تطبيقاً أصلياً من Vareons: واتساب، والذكاء الاصطناعي، وصانع QR، وشجرة الروابط، واختصار الروابط، والمهام، والتقويم، والإيرادات، والمحاسبة، والعمولة، ومزامنة الكتالوج.
هل التثبيت مجاني؟
التثبيت مجاني للتطبيقات المشمولة في خطتك عبر زر تثبيت، بينما التطبيقات المدفوعة تستخدم زر شراء وتفعيل بفترة ثلاثين يوماً وتاريخ انتهاء ظاهر.
ماذا يعني أن التطبيق غير متاح في باقتي؟
يعني أن وضع التطبيق disabled لخطتك: يُخفى من السوق ويُرفض تثبيته برسالة تنبيه. راجع خطة اشتراكك أو تواصل مع الدعم للترقية.
ماذا يحدث عند الضغط على إزالة التطبيق؟
يُرسل POST /api/apps/uninstall فيخرج التطبيق من قسم المثبتة ويعود إلى السوق، ويُحدَّث ملفك الشخصي. ولا يحذف ذلك بيانات متجرك الأساسية.
هل أرى تاريخ انتهاء التطبيق المدفوع؟
نعم، بطاقة التطبيق المثبت تعرض «ينتهي في:» مع التاريخ المترجم حسب لغة اللوحة عندما يكون للتطبيق اشتراك.
استكشاف الأخطاء
1) إذا فشل تحميل التطبيقات، حدّث الصفحة وتأكد من تسجيل الدخول؛ رسالة «فشل تحميل التطبيقات» تعني تعذر GET /api/apps. 2) إذا ظهر «غير متاح في باقتك»، فالتطبيق بوضع disabled لخطتك الحالية. 3) إذا طُلب الشراء أثناء التثبيت، فالتطبيق مدفوع: أكمل زر شراء وتفعيل. 4) إذا لم ينتقل التطبيق للمثبتة بعد النجاح، حدّث الصفحة؛ القائمة تُجلب من الخادم مع الملف الشخصي. 5) زر فتح لا يعمل إلا للتطبيق المثبت الذي له مسار مسجل في الكتالوج.
حدود مهمة
• الكتالوج حالياً أحد عشر تطبيقاً أصلياً من Vareons دون متجر مطورين خارجيين. • التقييمات والمراجعات في البطاقات قيم عرض افتراضية وليست سوق تقييمات حياً. • الأوضاع المدفوعة تُفعَّل لثلاثين يوماً لكل عملية شراء. • إزالة التطبيق تُعطّل الوصول لمساره المحمي لكنها لا تمسح سجلات الأنشطة السابقة.