Helpdock
English التثبيت
جديدصدر Helpdock 1.0.1

مكتب الدعم كله. بتثبيت واحد.

نظام تذاكر، ومركز مساعدة، ودردشة مباشرة، وذكاء اصطناعي لا يجيب إلا من معرفتك. مفتوح المصدر. تستضيفه بنفسك. بالعربية والإنجليزية.

التثبيت عبر Docker شاهد فيديو الإصدار

مجاني برخصة AGPL-3.0Docker Composeتثبيت واحد لكل علاماتك

مساحة عمل التذاكر في Helpdock بالعربية، من اليمين إلى اليسار: قائمة التذاكر، وتذكرة بريد إلكتروني مع شارة اتفاقية مستوى الخدمة ومحرر الرد، وبطاقة جهة الاتصال مع تذاكرها السابقة مساحة عمل التذاكر نفسها بالإنجليزية، من اليسار إلى اليمين
مساحة عمل التذاكر، من لقطات الشاشة المرجعية لاختبارات Playwright في لوحة الإدارة.

كل محادثة. مكتب واحد. البريد الإلكتروني وWhatsApp وMessenger وInstagram وTelegram ونافذة الدردشة ونموذج الويب والواجهة البرمجية، كلها تصب في التذاكر نفسها، بالحالات واتفاقيات مستوى الخدمة والقواعد والإسناد نفسها.

  • البريد الإلكترونيIMAP أو خطاف ويب، والردود عبر SMTP الخاص بالعلامة
  • WhatsAppرقم العلامة، عبر Graph API من Meta
  • Messengerصفحة العلامة على Facebook
  • Instagramالحساب الاحترافي للعلامة
  • Telegramبوت العلامة
  • نافذة الدردشةمباشرة عبر WebSocket
  • نموذج الويبمستضاف على نطاق مركز المساعدة
  • REST APIPOST /api/v1/tickets

تربط كل علامة تجارية حساباتها الخاصة، ويعود الرد عبر القناة التي كتب منها العميل.

Helpdock 1.0 · 20 أكتوبر 2026

مستقر. ومختبَر قبل أن يصدر.

اكتملت كل مراحل خطة الإصدار 1.0. وقبل الإصدار: اختبار اختراق خارجي لنافذة الدردشة والواجهة البرمجية، واختبار حِمل، وجولة بقارئ الشاشة، وتجربة تثبيت مع ثلاثة مختبرين من خارج المشروع، وتمرين استعادة من نسخة احتياطية.

فيديو إصدار Helpdock 1.0: شاهده على X شاهد على X · 1:09
اقرأ الإعلان (بالإنجليزية) سجل التغييرات والحدود المعروفة (بالإنجليزية)

الإصدار 1.0.1 هو الأحدث. يربط الدخول عبر Google وGitHub بحساب المزوّد نفسه، ويرفض اختبار CAPTCHA حُلّ على موقع آخر، ويصلح النص مختلط الاتجاه في لوحة الإدارة العربية. تحدّث من 1.0.0؟ بعض حسابات الدخول عبر Google وGitHub يجب ربطها من جديد: اقرأ ملاحظات الإصدار (بالإنجليزية).

كل ما في الإصدار 1.0.

مركز مساعدة، ونافذة دردشة، واتفاقيات خدمة، وقواعد، وتقارير، وتسجيل دخول، في التثبيت نفسه.

مركز مساعدة على نطاق كل علامة تجارية.

مقالات بالعربية والإنجليزية، وبحث بكل لغة، وتقييم «هل كان هذا مفيدًا؟». مقالات عامة وداخلية، لتخدم المعرفة نفسها العملاء والموظفين.

الصورة: من لوحة تصميم مركز المساعدة، بالإنجليزية.

صفحة مقالة في مركز المساعدة بالإنجليزية: قائمة القسم، والمقالة مع جدول ونصيحة، وبطاقة «هل ما زلت بحاجة إلى مساعدة؟»

نافذة دردشة تبقى خفيفة.

مباشرة عبر WebSocket، مع هوية موقّعة اختيارية للمستخدمين المسجّلين. والسكربت الأول محصور في ميزانية 40 KB بعد الضغط.

الصورة: من لوحة تصميم نافذة الدردشة.

نافذة الدردشة بالعربية: إجابة من الذكاء الاصطناعي تستشهد بمقالة من مركز المساعدة، ثم تحويل إلى فريق الفوترة

دخول الموظفين، مع الدخول الموحد.

كلمات مرور بخوارزمية Argon2id تُفحص مقابل قائمة كلمات المرور المسرّبة، وعامل تحقق ثانٍ إلزامي للمسؤولين، وروابط دخول عبر البريد. ودخول موحد عبر SAML 2.0 وOpenID Connect، مع أدلة إعداد لـ:

  • Okta
  • Microsoft Entra ID
  • Google Workspace
  • Keycloak
شاشة دخول الموظفين بالعربية: البريد وكلمة المرور، ورابط دخول بالبريد، وزرا Google وGitHub، مع ملاحظة أن التحقق بخطوتين إلزامي في هذا التثبيت

اتفاقيات خدمة على ساعات عملك.

ساعات عمل مع العطلات والمناطق الزمنية. تتوقف العدّادات في الحالات التي تحددها للإيقاف. ويُرسل استبيان رضا العملاء عند إغلاق التذكرة.

القواعد والماكرو وطرق العرض.

قواعد سير عمل وقواعد زمنية مع تشغيل تجريبي وسجل تنفيذ. ماكرو بعناصر نائبة. طرق عرض محفوظة، ودمج وتقسيم، ومؤشر حين يفتح وكيلان التذكرة نفسها.

التقارير والواجهة البرمجية وخطافات الويب.

الحجم وأزمنة الاستجابة والالتزام باتفاقيات الخدمة ورضا العملاء وعبء العمل، مع التصدير إلى CSV. واجهة REST بمفاتيح محددة الصلاحيات ووثيقة OpenAPI. وخطافات ويب موقّعة بـ HMAC.

ذكاء اصطناعي مستند إلى معرفتك

يجيب من معرفتك. أو يسلّم المحادثة لفريقك.

يجيب المساعد العملاءَ ويساعد الموظفين من قاعدة معرفة العلامة نفسها. وحين لا تجيب عن السؤال، يجيب شخص من الفريق.

  1. معرفتك فقط.

    مقالات مركز المساعدة، وملفات PDF وDOCX، والمواقع المؤرشفة، وNotion وGoogle Drive. والإجابات الموجهة للزوار لا تقرأ إلا المعرفة العامة.

  2. مصادر مذكورة.

    تُحذف أي إشارة لا تقود إلى مستند استرجعه فعلًا.

  3. تسليم لا تخمين.

    حين لا تجيب قاعدة المعرفة، أو تقل الثقة عن الحد المضبوط للقناة، يتولى فريقك المحادثة.

  4. نص يدخل، ونص يخرج.

    لا يملك النموذج أي أدوات. تُخفى البيانات الشخصية ويعمل مرشّح لحقن التعليمات قبل كل استدعاء. ويُسجَّل كل استدعاء بتكلفته، وتحدّ الميزانيات إنفاق كل علامة.

اجتاز التقييم ثنائي اللغة قبل الإصدار 1.0.0 كل العتبات.

97.5%من الأسئلة القابلة للإجابة أُجيب عنها بشكل صحيح بالإنجليزية
94.6%من الأسئلة القابلة للإجابة أُجيب عنها بشكل صحيح بالعربية
100%من الأسئلة غير القابلة للإجابة سُلّمت للفريق، باللغتين
  • لم تُتّبع أي تعليمات محقونة
  • كل إشارة إلى مصدر قادت إلى مستند فعلي
  • كل إجابة بلغة السؤال

glm-4.6 للإجابة، وglm-5.1 للتحكيم، وbge-m3:567m للتضمين، في التشغيل 39322685646. هذا زوج مزوّدين واحد: قيّم النموذج الذي تختاره. وهناك أيضًا ردود مقترحة وملخصات وترجمة وفرز بالذكاء الاصطناعي وتفريغ الرسائل الصوتية. وكل أوضاع الذكاء الاصطناعي معطلة حتى يفعّلها مسؤول العلامة.

نافذة الدردشة بالإنجليزية، من اليسار إلى اليمين

ثنائي اللغة

العربية والإنجليزية. من الشاشة الأولى.

لوحة الإدارة ومركز المساعدة ونافذة الدردشة ورسائل البريد تأتي باللغتين، بتخطيطات من اليمين إلى اليسار.

  • انعكاس لا نسخة ثانية.التخطيطات مكتوبة بخصائص CSS المنطقية، فالواجهة العربية هي الشاشة نفسها معكوسة.
  • عائلة خطوط واحدة.صُمّم IBM Plex Sans وIBM Plex Sans Arabic معًا، فتتشارك الأسطر المختلطة الوزن والإيقاع.
  • النص المختلط يبقى مقروءًا.أرقام التذاكر وعناوين البريد والروابط داخل الجمل العربية تحتفظ باتجاهها من اليسار إلى اليمين.
  • مختبر باللغتين.اختبارات لقطات الشاشة في لوحة الإدارة وتقييم الذكاء الاصطناعي تعمل بالعربية كما بالإنجليزية.

صورة نافذة الدردشة من لوحة تصميمها. Read this page in English

علامات تجارية متعددة

تثبيت واحد. علامات كثيرة.

كل علاماتك التجارية تعمل من التثبيت نفسه، لكل منها واجهتها وبياناتها.

  • صناديقها وقنواتها الخاصة
  • مركز مساعدة على نطاقها الخاص، بشهادة يصدرها Caddy عند الطلب
  • مظهر نافذة الدردشة: اللون الأساسي ودرجة السطح واستدارة الزوايا والشعار وزر الإطلاق
  • معرفتها للذكاء الاصطناعي، بميزانيات يومية وشهرية
  • أقسام وفرق، مع فرض نطاق القسم في قاعدة البيانات
packages/db/drizzle/0036_telegram.sql
ALTER TABLE "telegram_bots" ENABLE ROW LEVEL SECURITY;
ALTER TABLE "telegram_bots" FORCE ROW LEVEL SECURITY;

CREATE POLICY "telegram_bots_tenant_select"
  ON "telegram_bots" FOR SELECT
  USING (brand_id = ANY (
    nullif(current_setting('app.brand_ids', true), '')::uuid[]
  ));
كل جدول خاص بالمستأجرين يحمل brand_id تحت سياسة أمان على مستوى الصفوف مفروضة مثل هذه، ويرفض الخادم العمل إن كان دوره في قاعدة البيانات قادرًا على تجاوزها. العزل بين العلامات تفرضه Postgres، لا شيفرة التطبيق وحدها.

الأمان

أمان يمكنك التحقق منه.

القواعد مكتوبة، والشيفرة مفتوحة، وكل صورة إصدار موقّعة.

أمان على مستوى الصفوف

كل جدول خاص بالمستأجرين تحت سياسة Postgres مفروضة حسب العلامة، مع نطاق القسم على بيانات التذاكر.

أسرار مشفّرة

AES-256-GCM بمفتاح رئيسي لا يُخزَّن في قاعدة البيانات، ولا تُعاد الأسرار بعد حفظها.

جلب محمي من SSRF

كل جلب لرابط يقدّمه مستخدم يمر عبر عميل واحد يحجب عناوين الجهاز المحلي والشبكات الخاصة وبيانات السحابة الوصفية، ويعيد التحقق عند كل إعادة توجيه.

رفع ملفات بحذر

يُفحص نوع الملف من بايتاته، ويُعاد ترميزه، ويُحفظ في حاوية خاصة، ويُقدَّم عبر روابط موقّعة قصيرة العمر.

OWASP ASVS المستوى 2

رُوجعت متطلبات ASVS 4.0.3 للمستوى 2 كلها، وعددها 258، واحدًا واحدًا مع الدليل، دون أي ثغرة مفتوحة.

صور موقّعة مع SBOM

كل صورة إصدار موقّعة دون مفاتيح مخزّنة عبر Cosign، ومنشورة مع SBOM بصيغة CycloneDX.

الصورة
ghcr.io/docker-hunterpedia/helpdock:1.0.1
المنصات
linux/amd64, linux/arm64
التوقيع
Cosign keyless, GitHub OIDC
SBOM
helpdock-1.0.1.cdx.json

اقرأ دليل الأمان ومراجعة ASVS وكيف تتحقق من توقيع الصورة (بالإنجليزية). أبلغ عن الثغرات بشكل خاص كما يصف SECURITY.md.

الانتقال

انتقل من Zendesk أو Freshdesk أو Zoho Desk.

معالج استيراد ثنائي اللغة ينقل سجلّك. ومطابق CSV يدوي يغطي أي أداة أخرى.

  1. الربط

    اختر المصدر واربط الحساب، أو ارفع ملف تصدير لمطابق CSV.

  2. المطابقة

    الأقسام والموظفون والحالات والأولويات والقنوات والوسوم والحقول المخصصة، مع إعدادات مسبقة محفوظة.

  3. التشغيل التجريبي

    قارن الأعداد المتوقعة وافحص الردود والملاحظات والكتّاب والتواريخ والملفات قبل كتابة أي شيء.

  4. الموافقة

    ابدأ التشغيل بعد مراجعته، وتابع سجله، وأوقفه مؤقتًا أو استأنفه.

السجل المستورد لا يرسل أي رسالة للعملاء، ولا يشغّل أي قاعدة أو إشعار أو مؤقت لاتفاقية الخدمة.

جرى التحقق من أدوات الاستيراد مقابل خوادم بديلة بُنيت من وثائق الواجهات البرمجية المنشورة لكل مزوّد، لا مقابل حسابات حقيقية. دليل الاستيراد (بالإنجليزية)

بدء سريع

ثبّت الإصدار 1.0.1 عبر Docker.

حزمة Docker Compose واحدة على خادم Linux خاص بك. تحتاج إلى:

  • Docker Engine مع إضافة Compose v2
  • 2 vCPU و4 GB من الذاكرة
  • اسمَي نطاق يشيران إلى الخادم: واحد للوحة الإدارة وآخر للواجهة البرمجية ونافذة الدردشة
  • المنفذين 80 و443 مفتوحين ليحصل Caddy على الشهادات
  • حاوية تخزين متوافقة مع S3 للمرفقات وصور المقالات
اقرأ دليل التثبيت مرجع الإعدادات

التوثيق متاح بالإنجليزية.

1. احصل على ملف Compose للإصدار 1.0.1 
git clone --depth 1 --branch v1.0.1 \
  https://github.com/Docker-Hunterpedia/Helpdock.git
cd Helpdock/docker
cp ../.env.example .env
openssl rand -base64 32   # the master key, for APP_MASTER_KEY

2. عدّل .env: اضبط HELPDOCK_VERSION=1.0.1 وعلى الأقل

APP_URLAPP_MASTER_KEYHELPDOCK_APP_PASSWORDDATABASE_URLPOSTGRES_PASSWORDDATABASE_MIGRATION_URLADMIN_HOSTAPI_HOSTACME_EMAILS3_*

3. شغّل الحزمة 
docker compose up -d
docker compose ps

4. افتح https://<ADMIN_HOST> وأكمل معالج التشغيل الأول. احفظ نسخة احتياطية من .env مع قاعدة البيانات: بدون APP_MASTER_KEY لا يمكن قراءة أي شيء مشفّر.

خارطة الطريق

ما بعد الإصدار 1.0.

إصدارات مقترحة من خطة 1.x. لم يبدأ العمل على أي منها بعد، وقد يتغير محتواها وترتيبها.

1.1

  • مساحة عمل الذكاء الاصطناعي. بيئة تجريب، واختبارات محفوظة، وقائمة مراجعة، وشخصيات، وفرز مشروط بالثقة.
  • إنتاجية صندوق الوارد. التأجيل، والتعديل الجماعي مع التراجع، ولوحة أوامر واختصارات لوحة المفاتيح.
  • خيارات الدخول. مفاتيح المرور، وحسابات Microsoft للعمل، واختبار CAPTCHA مدمج يعتمد إثبات العمل.
  • Helpdock كخادم MCP لعملاء الذكاء الاصطناعي الخارجيين.

1.2

  • إجراءات للذكاء الاصطناعي لا تغيّر شيئًا حتى يوافق عليها شخص.
  • تشغيل الاستضافة الذاتية. مثبّت موقّع بأمر واحد، ونسخ احتياطي واستعادة، وتنبيهات بالتحديثات.
  • أدوات استيراد أكثر مع التراجع. Help Scout وIntercom وGorgias وZammad وFront.
  • واجهات العملاء. محرر لتصميم البريد، وعدة نوافذ دردشة لكل علامة.

1.3

  • لغات أكثر، بدءًا بالواجهات الموجهة للعملاء، وترجمة دون لمس الشيفرة.
  • تطبيق إدارة قابل للتثبيت على الحاسوب والهاتف، مع إشعارات وشارة.

الخطة كاملة في المرحلة 5 من وثيقة متطلبات المنتج (بالإنجليزية).

أسئلة وأجوبة.

كم يكلّف؟

لا شيء. Helpdock برنامج حر برخصة GNU AGPL-3.0، بلا فئات مدفوعة ولا مفاتيح ترخيص. وإن عدّلته وأتحت نسختك المعدّلة للناس عبر الشبكة، تطلب منك الرخصة أن تتيح لهم مصدرها.

هل توجد نسخة مستضافة؟

لا. Helpdock للاستضافة الذاتية فقط: تشغّله على خادمك وتبقى بياناتك عندك. والنسخة المستضافة خارج أهداف إصدارات 1.x صراحةً.

ماذا أحتاج لتشغيله؟

خادم Linux عليه Docker Engine وإضافة Compose v2، و2 vCPU و4 GB من الذاكرة (ويحتاج ClamAV إن فعّلته 2 GB إضافية)، واسما نطاق، والمنفذان 80 و443، وحاوية متوافقة مع S3. وDocker Compose هي بيئة التشغيل المدعومة.

ما مزوّدو الذكاء الاصطناعي المدعومون؟

أي مزوّد يدعمه pi-ai، مثل OpenAI وAnthropic وGoogle وOpenRouter وGroq وMistral وxAI وDeepSeek، بمفتاح API أو باشتراك، أو أي خادم متوافق مع OpenAI مثل Ollama أو vLLM، فيمكن أن يعمل النموذج على أجهزتك.

هل يجب أن أستخدم الذكاء الاصطناعي؟

لا. كل أوضاع الذكاء الاصطناعي معطلة حتى يفعّلها مسؤول العلامة. ويعمل المكتب والقنوات ومركز المساعدة ونافذة الدردشة دونه.

ما اللغات المدعومة؟

العربية والإنجليزية، بتخطيطات من اليمين إلى اليسار، في لوحة الإدارة ومركز المساعدة ونافذة الدردشة ورسائل البريد. ولغات أخرى مقترحة للإصدار 1.3.

هل يمكنني نقل تذاكري من مكتب دعم آخر؟

نعم، من Zendesk وFreshdesk وZoho Desk بأدوات الاستيراد الخاصة بها، ومن أي أداة أخرى بمطابق CSV اليدوي. ابدأ بالتشغيل التجريبي: جرى التحقق من أدوات الاستيراد مقابل خوادم بديلة، لا حسابات حقيقية.

كيف أبلغ عن مشكلة أمنية؟

بشكل خاص، كما يصف SECURITY.md. لا تفتح بلاغًا عامًا من فضلك.

من يطوّره؟

يطوّر Oday Bakkour Helpdock علنًا على GitHub. والمساهمات مرحّب بها؛ ابدأ بـ CONTRIBUTING.md.

سؤال آخر؟ راسلنا على contact@oday-bakkour.com أو ابدأ نقاشًا على GitHub.

شغّل مكتب الدعم على خادمك.

ثبّت الإصدار 1.0.1 عبر Docker Compose، أو اقرأ التوثيق، أو ضع نجمة على المستودع لتتابع إصدارات 1.x.

التثبيت عبر Docker ضع نجمة على GitHub
اقرأ التوثيق