الاستضافة الذاتية

نظام CRM باستضافة ذاتية في حاوية واحدة.

يأتي Revenue Engine في صورة Docker واحدة تخدم الواجهة البرمجية وتطبيق الويب. صِلها بقاعدة بيانات PostgreSQL فيصير لديك نظام CRM خاص بك.

ما تحتاج إليه.

  • PostgreSQL 13 أو أحدث، يُتصل به بدور قاعدة بيانات عادي (انظر أدناه).
  • مستضيف حاويات: Fly.io أو خادم افتراضي أو Kubernetes أو أي شيء يشغّل صورة Docker. الصورة مبنية لمعمارية linux/amd64.
  • HTTPS أمام التطبيق، فملف تعريف ارتباط الجلسة موسوم بـ Secure.
  • واختياريًا: SMTP للبريد، وتخزين متوافق مع S3 للمرفقات، ومفتاح Anthropic API لمساعد الذكاء الاصطناعي.

جرّبه على جهازك.

Docker Compose
git clone https://github.com/sirdab/revenue-engine.git
cd revenue-engine
cp .env.example .env    # then set SESSION_SECRET (openssl rand -hex 32)
docker compose --profile app up -d --build
# open http://localhost:8080 and create a workspace

ملف Compose هذا للتجربة لا للنشر: البريد يذهب إلى صندوق محلي بلا تسجيل دخول، والملفات تُخزَّن ببيانات اعتماد افتراضية. وعلى أجهزة Apple silicon ابنِ الصورة على جهاز amd64 أو استخدم pnpm dev بدلًا من ذلك.

القاعدة الوحيدة لقاعدة البيانات.

مساحات العمل يفصل بينها أمان مستوى الصفوف في PostgreSQL. المستخدمون الخارقون والأدوار التي لها BYPASSRLS يتجاوزونه كليًّا، ولذلك يجب أن يتصل التطبيق بدور عادي. والمستخدم الإداري في قواعد البيانات المُدارة غالبًا ليس دورًا عاديًّا.

SQL، بصلاحيات مدير قاعدة البيانات
CREATE ROLE crm_app LOGIN PASSWORD '<long random password>' NOSUPERUSER NOBYPASSRLS;
GRANT crm_app TO CURRENT_USER;
CREATE DATABASE crm OWNER crm_app;

اتصل بـ PostgreSQL مباشرة، لا عبر مجمّع اتصالات يعمل بنمط المعاملات مثل PgBouncer. التطبيق يَسِم كل اتصال بمساحة العمل طوال الجلسة، وتجميع المعاملات لا يحافظ على ذلك.

شغّله.

على أي مستضيف حاويات
docker build -t revenue-engine .
docker run -p 8080:8080 --env-file .env revenue-engine \
  sh -c "node dist/migrate.mjs && exec node --enable-source-maps dist/index.mjs"

الترحيلات داخل الصورة وتشغيلها آمن عند كل بدء. ويمكن لعدة حاويات أن تعمل معًا، لأن الحالة كلها في PostgreSQL.

المتغيّرالغرض منه
DATABASE_URLمطلوب. سلسلة الاتصال للدور العادي في قاعدة البيانات.
SESSION_SECRETمطلوب. سلسلة عشوائية طويلة توقّع ملف تعريف ارتباط الجلسة.
PORTمطلوب. المنفذ الذي يستمع عليه الخادم، والصورة تتوقع 8080.
APP_BASE_URLالعنوان العام، ويُستخدم في رسائل البريد ورسائل Slack والروابط الأساسية وخريطة الموقع.
SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, MAIL_FROMاختياري. البريد لاستعادة كلمة المرور والإشعارات.
S3_ENDPOINT, S3_BUCKET_NAME, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEYاختياري. تخزين متوافق مع S3 للمرفقات.
ANTHROPIC_API_KEYاختياري. يفعّل مساعد الذكاء الاصطناعي.

انشره على Fly.io.

  1. أنشئ قاعدة البيانات

    أنشئ مجموعة Managed Postgres، ثم قاعدة بيانات ومستخدمًا للتطبيق. استخدم العنوان المباشر للمجموعة لا عنوان المجمّع.

  2. أنشئ التطبيق وأسراره

    عيّن DATABASE_URL و SESSION_SECRET و APP_BASE_URL عبر fly secrets set.

  3. انشر

    الأمر fly deploy --remote-only يبني الصورة وينفّذ الترحيلات كأمر إصدار قبل تحديث أي جهاز.

الأوامر كلها بالترتيب في DEPLOY.md.

قبل أن تطلقه.

  • دور قاعدة البيانات ليس مستخدمًا خارقًا وليس له BYPASSRLS.
  • SESSION_SECRET طويل وعشوائي ومختلف في كل بيئة.
  • HTTPS أمام التطبيق، و APP_BASE_URL هو عنوانه العام.
  • النسخ الاحتياطي لقاعدة البيانات مفعَّل.
  • بيانات العرض التجريبية لا تُحمَّل أبدًا على قاعدة بيانات حقيقية: إنها تحذف كل مساحات العمل.
أسئلة

أسئلة عن الاستضافة الذاتية.

كم تكلّف تشغيله؟

البرنامج مجاني. لا تدفع إلا تكلفة الخادم وقاعدة البيانات التي تشغّله عليها.

هل يتوسّع لأكثر من خادم؟

نعم. الخادم لا يحتفظ بحالة خاصة به: شغّل عدة حاويات خلف موازن حمل وستتشارك قاعدة بيانات واحدة.

كيف تجري الترقيات؟

اسحب الصورة الجديدة وشغّلها. الترحيلات تُنفَّذ أولًا وتتخطى ما سبق تطبيقه.

هل أستطيع استخدام خدمة PostgreSQL مُدارة؟

نعم. أنشئ دور التطبيق كما هو مبيَّن أعلاه، واتصل مباشرة لا عبر مجمّع اتصالات بنمط المعاملات.

شغّل خط مبيعاتك.

أنشئ مساحة عمل في أقل من دقيقة، وادعُ فريقك متى شئت.