Growthkit mewayz

مجموعة أدوات النمو في Mewayz

إضافة GrowthKit هي دليل نمو واعٍ بالمرحلة مع خط أنابيب CRM وتتبّع الأهداف، للشركاء والموزّعين بعلامة بيضاء والمستأجرين.

Mewayz- الوحدة الأصلية — لا Mewayz المنبع. التوثيق مؤلف من مصدر الحزمة في packages/mewayz/GrowthKit/.

رابط العرض التجريبي

مقدمة

يحوّل GrowthKit السؤال المجرد "كيف يمكنني تنمية أعمالي Mewayz؟" في قائمة مرجعية يومية ملموسة. عند التسجيل، يقوم المشغل بتشغيل لمرة واحدة معالج الذي يلتقط هدف الإيرادات والعملة وملاحظات الجمهور وقنوات التواصل وهدف النشاط الأسبوعي. ومن تلك الإجابات، يختار GrowthKit دليل اللعب لمرحلة الإيرادات الحالية للمشغّل — من "فارغ" (لا عملاء محتملون بعد) وصولاً إلى "التشغيل" (إيرادات مستدامة).

كل يوم، اليوم يُبرز العرض الإجراءات الثلاثة التالية التي ينبغي أن يتخذها المشغّل. وكلما وضعوا علامة على الخطوات كمكتملة، يقدّم GrowthKit تقدّمهم و(في النهاية) يخرّجهم إلى دليل المرحلة التالية. أداة مدمجة خط الأنابيب يتتبع العرض العملاء المحتملين عبر الحالات (جديد ← تم التواصل ← عرض توضيحي ← اقتراح ← فوز/خسارة) بحيث يغذّي نشاط مبيعات المشغّل لوحة التحكم نفسها.

كيفية تمكين هذه الوحدة

يوفّر GrowthKit دائم التشغيل لأي مستأجر مُثبَّت لديه الحزمة. لا يوجد مفتاح تبديل "إضافة GrowthKit" داخل الإضافات؛ فالوحدة محكومة بمفتاح growthkit البرمجيات الوسيطة التي تتحقق ببساطة مما إذا كان المشغّل قد أكمل المعالج.

لتمكين GrowthKit على مستوى علامة الميزة، عيّن في .env:

GROWTHKIT_ENABLED=true
GROWTHKIT_CURRENCY=USD

بعد تفعيل علامة الميزة، نمُّ يظهر في الشريط الجانبي لكل مشغّل مصادَق عليه.

المعالج (إعداد التشغيل الأول)

عندما يزور مشغّل لأول مرة /grow، يكتشف GrowthKit أنه ليس لديهم seller_goals صف بعد، ويعيد توجيههم إلى المعالج في /grow/wizard.

يلتقط المعالج:

• الإيراد المستهدف — الرقم الذي تحاول بلوغه (مثلًا 5,000)
• العملة المستهدفة - الافتراضات ل GROWTHKIT_CURRENCY قيمة المتغيّر البيئي
• التاريخ المستهدف — عندما تريد تحقيقه
• الإيرادات الأساسية — أين أنت اليوم (الافتراضي 0)
• هدف الإجراء الأسبوعي — كم عدد إجراءات النمو أسبوعيًا التي

الالتزام بها (الافتراضي 5)

• ملاحظة للجمهور — وصف نصي حر قصير لمن تبيع له

إلى (مثل "عيادات أسنان صغيرة في الاتحاد الأوروبي")

• القنوات — تحديد متعدد من: البريد الإلكتروني، واتساب، لينكدإن،

هاتف، شخصيًا

انقر حفظ الهدف لإجراء عملية الإدراج أو التحديث (upsert) لـ seller_goals صف (واحد لكل بائع — تؤدي إعادة إرسال المعالج إلى تحديث الهدف الموجود بدلاً من إنشاء نسخة مكررة).

عرض اليوم — دليل اللعب اليومي

• انتقل إلى النمو ← اليوم (أو فقط /grow).
• تنقسم الصفحة إلى ثلاثة أقسام:

1. رأس دليل العمل النشط — يعرض اسم دليل اللعب الخاص بك،

المرحلة الحالية، وشريط تقدّم دائري (% من الخطوات المكتملة).

2. الخطوات الثلاث التالية — الخطوات الثلاث الأعلى أولوية التي لديك

لم تُعلَّم كمكتملة بعد. لكل خطوة عنوان، ونص، وقالب/رابط اختياري، و وضع علامة منجز الزر.

3. بطاقات مؤشرات الأداء الرئيسية — عدد خطوط الأنابيب، العروض التوضيحية لهذه الفترة، المغلقة

الصفقات، الإيرادات المحققة. تأتي الأرقام من seller_leads ودفتر أستاذ المحفظة.

• النقر وضع علامة منجز طلبات POST إلى /grow/step/done مع الخطوة

المعرّف؛ تنتقل الصفحة إلى الدفعة التالية.

عرض خط الأنابيب - إدارة علاقات العملاء الرائدة

• انتقل إلى النمو → خط الأنابيب (/grow/pipeline).
• تعرض القائمة كل عميل محتمل أضفته مع: الاسم، الشركة،

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

• انقر + عميل محتمل جديد لإضافة صف. مطلوب: الاسم + الحالة.

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

حالات العملاء المحتملين

يوفّر GrowthKit الحالات التالية:

• جديد — أُضيف للتو؛ لا تواصل بعد
• تم التواصل — تم التواصل مرة واحدة على الأقل
• تجريبي — عرض توضيحي مجدول أو مُنفّذ
• عرض — تم إرسال العرض
• تم الفوز — مغلق؛ closed_at و closed_value تُختَم تلقائيًا
• خاسر — مُغلق-خاسر

تحرير عميل محتمل

• انقر على أي صف لفتح درج التعديل.
• تحديث الحالة إلى won يختم تلقائيًا closed_at و

closed_value الحقول. (قم بتعيين القيمة أولاً - يقرأها النظام على أنها الإيرادات المحققة.)

• ال next_followup_at الحقل هو ما يقود "المتابعة"

التذكيرات في قسم مؤشرات الأداء الرئيسية بعرض اليوم.

حدود مستوى الخطة

يفرض GrowthKit حد العملاء المحتملين في الفئة المجانية من أصل 10 عملاء محتملين عبر config('growthkit.plan_gates.pipeline_max_free'). المشغلون في الخطة المدفوعة ليس لديهم حد أقصى.

بلوغ الحد الأقصى يُعيد رمز خطأ 422 في نموذج “إنشاء عميل محتمل” مع رسالة واضحة “قم بترقية خطتك لإضافة المزيد من العملاء المحتملين”.

أدلّة العمل (كيف يتم اختيارها)

تعيش أدلة الإجراءات في playbooks جدول، مع الخطوات في playbook_steps. يُوسَم كل دليل عمل بـ:

• seller_type — شريك، أو موزّع، أو مستأجر
• stage — فارغ، التنقيب، أول بيع، التوسّع، التشغيل

البذرة الافتراضية (TenantPlaybookSeeder) يأتي مع خمسة أدلّة عمل لمراحل المستأجرين. الـ AdapterResolver يقرأ seller_type (من حسابهم) والمرحلة الحالية (المحسوبة من تقدّمهم عبر الـ playbooks السابقة) ويختار الصحيح.

لا يبدّل المشغّلون أدلة العمل يدويًا حاليًا — إذ يرقّيهم GrowthKit تلقائيًا. لفرض دليل عمل مختلف، يمكن للمشرف حذف دليل المشغّل seller_step_progress الصفوف مباشرة عبر قاعدة البيانات.

جداول قاعدة البيانات

تضيف الحزمة خمسة جداول:

• playbooks — تعريفات الدليل (المعرّف المختصر، نوع البائع، المرحلة،

name وtarget_days وغيرهما)

• playbook_steps — خطوات مرتّبة لكل دليل عمل (slug، العنوان، النص،

النوع، حمولة اختيارية)

• seller_step_progress — يتتبع الخطوات التي أنجزها كل مشغّل

مُعلّم كمنجز

• seller_leads — صفوف خط أنابيب العملاء المحتملين (واحد لكل عميل محتمل، مقصور على

البائع)

• seller_goals — صف واحد لكل بائع؛ الهدف المسجَّل بواسطة الـ

معالج

الأذونات

تستخدم GrowthKit فلاتر الملكية بدلاً من أذونات Spatie — تفرض وحدات التحكّم أن المشغّل يمكنه فقط رؤية وتحرير خطواته وعملائه المحتملين الخاصين به. يُطلَق خطأ 403 إذا حاول مستخدم وضع علامة «منجز» على خطوة لا تنتمي إلى دليله النشط.

ملاحظات المشغّل

• يعمل المعالج مرة واحدة لكل بائع. تؤدي إعادة الإرسال إلى تحديث

صف موجود.

• عند اكتمال دليل تشغيل مرحلة ما، يتخرّج المُشغّل؛

لا يوجد زر يدوي "انتقل إلى دليل العمل التالي".

• تُخزَّن اختيارات القنوات في المعالج كمصفوفة JSON على

seller_goals.channels للاستخدام من قِبل التنبيهات والتذكيرات اللاحقة.

• GrowthKit هي دائم التشغيل عند تعيين علامة البيئة — لا

تفعيل الإضافات لكل مستأجر.