Upload files to "common-mortakaz"

common-mortakaz/integration-1.md

@@ -0,0 +1,36 @@
+# اقتراح تكامل 1 — "جادّل" (منصة إدارة الصالات الرياضية) × غيمة
+
+**المصدر:** https://www.mortakaz.com/projects/6a68682c64ffff87848de097
+
+## وصف المنتج
+
+"جادّل" منصة سحابية متكاملة لإدارة الصالات الرياضية: تتبع الاشتراكات، مراقبة الأرباح، وتقديم تجربة احترافية للعملاء. هذا منتج SaaS B2B نموذجي يحتاج بنية تحتية موثوقة، قاعدة بيانات، ونسخاً احتياطية دائمة — لكنه على الأرجح فريق صغير/ناشئ لا يريد إدارة DevOps بنفسه.
+
+## كيف يتكامل مع ghaymah.systems
+
+1. **الاستضافة الأساسية:** نشر تطبيق "جادّل" (على الأغلب Node.js أو Laravel) مباشرة من GitHub على منصة الحاويات في غيمة، بدل إدارة خوادم يدوياً.
+2. **قاعدة بيانات:** استخدام PostgreSQL المُدارة من غيمة ($5/شهر) لتخزين بيانات الاشتراكات والأعضاء، مع نسخ احتياطي تلقائي يومي/كل ساعة حسب حساسية بيانات الدفع.
+3. **متجر التطبيقات:** إذا احتاج "جادّل" مكونات إضافية (n8n لأتمتة تذكير تجديد الاشتراك عبر واتساب مثلاً)، يمكن نشرها بنقرة واحدة من متجر تطبيقات غيمة بدل بناء تكامل من الصفر.
+4. **الدفع المحلي:** بما أن "جادّل" يستهدف صالات رياضية عربية (فوترة محلية بالجنيه/الريال)، استضافته على غيمة يعني أن الفريق نفسه يدفع فاتورة استضافته بالعملة المحلية بدون بطاقة ائتمان — يزيل عائقاً حقيقياً أمام رواد الأعمال العرب الذين قد لا يملكون بطاقات دولية.
+
+## رسم توضيحي للتكامل
+
+```mermaid
+flowchart LR
+    Owner["مالك الصالة / موظف الاستقبال"] --> App["تطبيق جادّل<br/>(حاوية على غيمة)"]
+    App --> DB[("PostgreSQL مُدارة<br/>اشتراكات + أعضاء")]
+    App --> Notify["n8n (متجر تطبيقات غيمة)<br/>تذكير تجديد عبر واتساب"]
+    DB --> Backup["نسخ احتياطي يومي (غيمة)"]
+```
+
+## القيمة المضافة للمستخدم النهائي
+
+- صاحب الصالة الرياضية يحصل على نظام موثوق بدون قلق تقني (SSL تلقائي، نسخ احتياطي، دعم عربي 24/7 عبر واتساب — نفس القناة التي يستخدمها أصلاً مع أعضائه).
+- تكلفة تشغيل منخفضة جداً ($1-8/شهر) تناسب صالة رياضية صغيرة/متوسطة بدل الاشتراك في SaaS عالمي مكلف بالدولار.
+- الفريق المطوّر لـ"جادّل" يركّز على المنتج (ميزات إدارة الصالة) بدل DevOps.
+
+## التحديات المحتملة
+
+- **حساسية بيانات الدفع:** يحتاج "جادّل" الالتزام بمعايير أمان بيانات الدفع (PCI-DSS إن تعامل مباشرة مع بطاقات) — قد يحتاج توضيحاً من غيمة حول نموذج المسؤولية المشتركة (Shared Responsibility Model) لضمان الالتزام.
+- **التوسع الموسمي:** صالات رياضية تشهد ذروة اشتراكات في مواسم معينة (بداية السنة، رمضان) — يحتاج التطبيق auto-scaling بسيط وليس خطة ثابتة فقط.
+- **الاعتماد على واتساب للتذكيرات:** التكامل مع واتساب بزنس API له تكلفة/حدود منفصلة عن غيمة نفسها، يجب توضيحها للعميل مسبقاً.