كل ما يلزمك للنشر — باختصار.
هذا دليل مختصر للمشغّل. أما التوثيق المرجعي الكامل، فيصلك مع الكود داخل مجلد `/docs`.
الأقسام
7الأقسام01
متطلبات النظام
Momentfy يعمل كتطبيق Node.js + PostgreSQL. أي VPS متواضع أو استضافة Node مُدارة تكفي.
- بيئة التشغيل
- Node.js 20 LTS أو أحدث
- قاعدة البيانات
- PostgreSQL 14 أو أحدث
- الذاكرة
- 2 جيجا حد أدنى · 4 جيجا موصى به
- المعالج
- 2 vCPU موصى به
- التخزين
- 20 جيجا + حجم الملفات المرفوعة
- ملفات
- قرص محلي أو أي حاوية تخزين متوافقة مع S3
- SSL
- مطلوب لـ ZATCA و PWA والإشعارات
02
تكلفة الاستضافة النموذجية
الاستضافة الذاتية تعني أنك تملك فاتورة الخادم. التكاليف الشهرية الواقعية تقع في هذه الشرائح:
- مشغّل فردي
- ≈ 5–10$ / شهر (VPS صغير)
- 3–5 فروع
- ≈ 15–30$ / شهر (VPS 2GB + Postgres مُدار)
- موزع SaaS
- ≈ 40–120$ / شهر (PG مخصص + S3 + CDN)
03
النشر
الكود يأتي مع Dockerfile و docker-compose.yml ومعالج تثبيت من المتصفح. يمكنك النشر بدون Docker إن فضّلت.
- Docker Compose — أمر واحد، يشمل Postgres
- Node.js عارٍ — clone ثم npm ci ثم npm run build، شغّل بـ PM2 أو systemd
- Hetzner / DigitalOcean / Railway — أدلة جاهزة خطوة بخطوة في /docs
- macOS / Windows للتطوير المحلي — مدعومة جاهزة
- Postgres مُدار (Supabase / Neon / RDS) — يُوصَل عبر DATABASE_URL
04
المستودع والتحديثات
عند الشراء نضيفك إلى منظمة GitHub خاصة بمقعد ترخيص باسمك. كل إصدار يأتي كـ tag — اسحب، هاجر البيانات، أعد التشغيل.
- دعوة مستودع GitHub خاص تصل بريدك خلال دقائق
- الإصدارات تتبع semver · الـ migrations مشمولة في كل tag
- ملاحظات إصدار + دليل ترقية مع كل إصدار رئيسي
- إذا كنت تفضّل ZIP بدل git، أرشيفات موقّعة متاحة أيضاً
05
وضع فردي أو متعدد الحسابات
اضبط APP_MODE=single-tenant لعملك الخاص. اضبط multi-tenant لإعادة البيع أو خدمة العملاء ببوابات مُخصصة.
- فردي → بدون فحوصات اشتراك، حساب واحد لكل تثبيت
- متعدد → توجيه بالـ slug، لوحة إدارة عليا، هوية وإضافات لكل حساب
- بدّل بين الوضعين متى شئت — بلا تعديل مخطط
06
النسخ الاحتياطي والتعافي
الاستضافة الذاتية تعني أن النسخ الاحتياطي مسؤوليتك. الكود يأتي بمهمة نسخ يومية لكنك تختار أين تذهب.
- pg_dump يومي عبر مهمة مجدولة (مضمّن)
- الملفات المرفوعة على S3 → استخدم versioning أو lifecycle rules
- نوصي: نسخة خارج الموقع (S3 أو Backblaze أو NAS)
- اختبار الاستعادة موثّق في docs/restore.md
07
الترخيص باختصار
ملخص ببنود الترخيص. راجع /portal/legal للنص الرسمي الكامل.
- يمكنك نشره لعملك الخاص أو لعملائك المباشرين
- يمكنك تعديل أي سطر وإبقاء التعديلات خاصة بك
- لا يمكنك إعادة بيع الكود المصدري لمطورين آخرين
- لا يمكنك إزالة أو إخفاء ترويسة الترخيص في المستودع
- الترخيص لكل كيان مشغّل — كل كيان قانوني يحتاج ترخيصه الخاص
جاهز؟
اشترِ الكود وابدأ من مستودعك مباشرة.
أطلق منصتك بسرعتك، وبشروطك.
ادفع مرة واحدة، انشر الكود على خادمك، اضبط نموذجك التجاري كما يناسبك — واحتفظ بكامل إيراداتك دون وسيط.