مقدمة
في نظام Odoo، تمثّل النماذج القالب الذي تُبنى عليه البيانات في قاعدة المعلومات. كل عنصر عمل تتعامل معه — من طلبات البيع إلى الفواتير وحتى الاستفسارات — يُخزّن في نموذج منظّم يحدّد حقوله وعلاقاته.
فهم النماذج أمر حاسم للمطوّرين والاستشاريين الوظيفيين على حد سواء. النماذج هي قلب بنية بيانات Odoo: هي التي تحدد الحقول، الربط بين السجلات، والقواعد التي تحكم منطق العمل.
المقال يركّز على نموذج crm.lead لأنه المحرّك الأساسي لأنابيب المبيعات داخل قسم CRM في Odoo. سواء كنت تبني إضافات مخصّصة، توصل أنظمة خارجية، أو تضبط سير عمل المبيعات، ستجد نفسك تعمل مع هذا النموذج كثيراً.
ما هو نموذج crm.lead
نموذج crm.lead يمثّل السجلات التي تتعلّق بالعملاء المحتملين والفرص. هو المكان المركزي لحفظ معلومات أنابيب المبيعات، ويُستخدم لسجل واحد ليشمل كلّاً من الاستفسارات المبكرة والصفقات المؤهلة.
هذا النموذج جزء أساسي من تطبيق CRM في Odoo. وحدات أخرى مثل التسويق أو الموقع قد تضيف امتدادات أو تشير إليه. عندما يملأ زائر نموذج تواصل على الموقع، أو يفتح مندوب مبيعات فرصة، أو تُحوّل صفقة إلى عميل فعلي — فذلك يتم عبر crm.lead.
تعتمد بنية النموذج على ميكانيكية الوراثة في Odoo، بحيث تُعرف الوحدة الأساسية البناء الأساسي، ووحدات إضافية تضيف حقولاً أو سلوكيات دون إعادة كتابة الأساس. بهذه الطريقة يمكن لكل إضافة أن تمدّد الوظائف المطلوبة بأمان.
الحقول الأساسية في النموذج
فيما يلي أهم الحقول التي ستتعامل معها في crm.lead؛ معرفتك بها تُسهّل ضبط المتابعة والتقارير وتكامل الأنظمة.
1. name
نوع الحقل: نص قصير. يظهر كعنوان السجل في القوائم ولوحة كانبان. يُستخدم لتسمية الاستفسار أو الفرصة—مثل "طلب من الموقع" أو "عرض لشركة كذا"—ليكون مرجعاً سريعاً للمستخدم.
2. contact_name
نوع الحقل: نص قصير. اسم شخص الاتصال عندما لم تُنشأ بعد بطاقة شريك (res.partner). عند تحويل الاستفسار إلى عميل، يُنقل هذا الاسم غالباً إلى سجل الشريك.
3. email_from
نوع الحقل: نص قصير. البريد الإلكتروني الأساسي للlead. يُستخدم للتواصل المسبق ويُساعد في عمليات البحث والدمج لتجنّب التكرار.
4. phone
نوع الحقل: نص قصير. رقم الهاتف الثابت أو الرئيسي المسجّل على السجل. يظهر في نماذج المتابعة ويُستخدم لتسجيل المكالمات والأنشطة.
5. mobile
نوع الحقل: نص قصير. رقم الجوال. يُستخدم للرسائل القصيرة أو التواصل العاجل في حال اختلف عن الرقم الرئيسي.
6. partner_id
نوع الحقل: Many2one إلى res.partner. علاقة تربط السجل ببطاقة جهة الاتصال أو الشركة عندما تُؤهّل الصفقة أو تُحوّل إلى عميل. قبل التحويل يكون هذا الحقل فارغاً.
7. user_id
نوع الحقل: Many2one إلى res.users. مندوب المبيعات المسؤول عن المتابعة. يُستخدم للتعيين، التقارير، وجدولة الأنشطة ويظهر في لوحات الأداء الشخصية.
8. team_id
نوع الحقل: Many2one إلى crm.team. فريق المبيعات الذي ينتمي إليه السجل. يساعد في توزيع السجلات وفق قواعد مثل round-robin وإعداد تقارير حسب الفريق.
9. stage_id
نوع الحقل: Many2one إلى crm.stage. المرحلة الحالية في قمع المبيعات—جديدة، مؤهّلة، عرض، تفاوض، فازت، خسرت—وتبديل المراحل يُشغّل أتمتة وتقارير.
10. type
نوع الحقل: قائمة اختيار. يبيّن إن كان السجل استفساراً أولياً أو فرصة مؤهّلة. لهذا الفرق أثر على الرؤى والإجراءات المتاحة والافتراضات التقاريرية.
11. expected_revenue
نوع الحقل: عدد عشري. قيمة العائد المتوقعة في حال فوز الصفقة. تُستخدم في حساب قيمة الأنابيب والتوقّعات وغالباً تُستنتج من المبلغ والاحتمالية.
12. probability
نوع الحقل: عدد عشري. احتمال الفوز بنسبة مئوية. يدخل في حساب الأنابيب المرجّحة ويمكن أن يُحدّد يدوياً أو يعتمد على المرحلة.
13. company_id
نوع الحقل: Many2one إلى res.company. مفيد في بيئات متعددة الشركات لتحديد ملكية السجل وتأثيره على الرؤية والعملة.
14. description
نوع الحقل: نص طويل. ملاحظات وصفية عن الاستفسار أو الفرصة—خلاصات اجتماعات، سياق العميل، تعليمات المتابعة التي يحتاجها الفريق.
15. create_date
نوع الحقل: تاريخ-زمن. وقت وتاريخ إنشاء السجل تلقائياً. مهم لقياس عمر الاستفسار وتحليل زمن التحويل.
16. write_date
نوع الحقل: تاريخ-زمن. وقت آخر تعديل للسجل، يُسجّل تلقائياً لتتبع آخر تحديثات الحالة.
17. date_open
نوع الحقل: تاريخ-زمن. وقت تخصيص السجل لأول مرة لمستخدم؛ يظهر عند ملء user_id ويُستخدم لقياس زمن التواصل الأول.
18. date_closed
نوع الحقل: تاريخ-زمن. وقت إغلاق السجل (فوز أو خسارة). يُستخدم لتحليل دورات المبيعات وزمن التحويل.
19. date_deadline
نوع الحقل: تاريخ. تاريخ الإغلاق المتوقع للفرصة؛ يُستخدم في التخطيط والتنبؤ ومتابعة المهل.
20. active
نوع الحقل: منطقي. علامة الأرشفة. عندما تكون False يُخفي السجل في العرض الافتراضي بدلاً من حذفه نهائياً.
21. street, street2, city, zip
نوع الحقول: نصوص. حقول العنوان الأساسية؛ تُملأ عند توفر عنوان قبل التحويل وتُنسخ إلى سجل الشريك بعد التحويل.
22. country_id
نوع الحقل: Many2one إلى res.country. البلد المسجّل—مفيد لتقسيم الأرصدة حسب مناطق وإعداد تنسيقات العناوين.
23. state_id
نوع الحقل: Many2one إلى res.country.state. المحافظة أو الولاية؛ عادةً تُفلتر القيم تبعاً للبلد المختار.
24. source_id
نوع الحقل: Many2one إلى utm.source. مصدر الاستفسار: موقع، إحالة، حملة إعلانية... حقل مهم لتتبّع أداء التسويق.
25. campaign_id
نوع الحقل: Many2one إلى utm.campaign. ربط السجل بحملة تسويقية محددة لتحليل العائد على الاستثمار.
26. activity_ids
نوع الحقل: One2many إلى mail.activity. أنشطة المبيعات المجدولة—مكالمات، اجتماعات، مهام—وتدفع سلوك التذكيرات.
27. color
نوع الحقل: عدد صحيح. فهرس اللون لعرض كانبان أو القوائم بحيث تُميّز السجلات بصرياً حسب أولويات أو معايير مخصصة.
28. message_ids
نوع الحقل: One2many إلى mail.message. سجل المراسلات الداخلية والخارجية—المحادثات، الرسائل، الملاحظات—الموجودة في الشات لتعزيز سياق المتابعة.
كيف يُستخدم هذا النموذج في سير العمل التجاري
1. التقاط الاستفسارات من الموقع
عند تعبئة زائر لنموذج تواصل على موقع Odoo، يُنشأ سجل crm.lead جديد ويُحمّل البريد والاسم والمضمون من الحقول المرسلة. يظهر السجل فوراً في لوحة المبيعات ليقوم الفريق بالمتابعة.
2. تأهيل وتحويل الاستفسارات
المندوبون ينقلون السجلات عبر المراحل. عند التأهيل يُغيّرون النوع إلى "فرصة" ويحددون العائد المتوقع؛ وعند إغلاق الصفقة بنجاح يُحوّل النظام السجل إلى عميل عبر إنشاء أو ربط res.partner وربما إنشاء طلب بيع.
3. تقارير أنابيب المبيعات
المديرون يبنون تقارير على بيانات crm.lead—القيمة المتوقعة والاحتمالية والمرحلة تُشكّل الأنابيب المرجّحة. التصفية بحسب المندوب أو الفريق تكشف أداء كل طرف.
4. قياس أثر التسويق
حقلا source_id و campaign_id يربطان السجل بحملات التسويق أو الوسائل المكتسبة. عند استقبال زيارات مع UTM يتعبأ المصدر تلقائياً ليُستخدم لاحقاً في قياس فعالية الإعلانات والبريد.
5. إدارة الأنشطة والمتابعة
المندوبون يحددون أنشطة مرتبطة بكل lead. تُخزن هذه المهام في activity_ids، وتستخدم تواريخ الاستحقاق لعرض "النشاط التالي" وتذكير الفريق بالمتابعة.
كيف يطوّر المطوّرون هذا النموذج
المطوّرون يوسّعون crm.lead بعدة أساليب داخل Odoo، والوراثة النمطية في النماذج هي الأسلوب الأكثر شيوعاً.
وراثة النموذج
استخدم _inherit = 'crm.lead' لإضافة حقول أو تغيير سلوك. بهذه الطريقة تبقي تعديلاتك في وحدة منفصلة، ما يسهل صيانتها والتحديث عليها دون العبث بالنواة.
إضافة حقول
أضف الحقول الجديدة في نموذجك الموروث مع اختيار النوع المناسب: Char، Many2one، Boolean، Integer، Text، Selection. أمثلة شائعة: مصدر داخلي، اهتمامات المنتج، أو قطاع النشاط. فكّر أيضاً في جعل بعض الحقول معتمدة على الشركة في بيئات متعددة الشركات.
امتدادات بايثون
أعد تعريف create أو write أو action_convert لإضافة منطق مخصّص، مع استدعاء super() للحفاظ على السلوك الأصلي. استخدم مزايا api مثل @api.depends و @api.onchange للحسابات الآنية وسلوك واجهة المستخدم، لكن كن حذراً عند التعامل مع تغيّر المراحل ومنطق التحويل.
Odoo Studio
تتيح Odoo Studio إضافة حقول بسرعة دون كتابة كود—حل ممتاز للتعديلات البسيطة. لكن للمنطق المعقّد أو قواعد الأتمتة طويلة الأمد، يُفضّل بناء وحدة مخصّصة قابلة للصيانة والتحديث.
أفضل الممارسات
- اضبط مراحل القمع لتتماشى مع عملية المبيعات داخل شركتك؛ ويمكن الفصل بين تتابعات المراحل للاستفسارات مقابل الفرص إذا تطلّب الأمر.
- افعل تعبئة source_id و campaign_id من UTM على نماذج الموقع حتى تحصل على نسب تتبع دقيقة لحملات التسويق.
- استخدم team_id لتوزيع السجلات باتّباع قواعد جولة التناوب أو توزيع المناطق. اضبط قواعد التعيين داخل crm.team.
- عند ربط أنظمة خارجية، استعمل واجهات XML-RPC أو JSON-RPC. نموذج crm.lead متاح بالكامل؛ احفظ مُعرفات النظام الخارجي في حقل مرجعي مخصّص للمزامنة الآمنة.
- لمجالاتك الخاصة، استعمل بادئة x_ أو بادئة اسم الوحدة لحقل جديد لتجنب تضارب الأسماء مع تحديثات Odoo المستقبلية.
الأخطاء الشائعة
- إنشاء سجلات مكررة بدل البحث بالبريد الإلكتروني. نفّذ تحقق للتطابق باستخدام email_normalized أو قواعد دمج قبل أن تنشئ سجلّاً جديداً.
- خلط المفاهيم بين type و stage_id. النوع يحدّد ما إذا كان السجل استفساراً أو فرصة، بينما المرحلة توضح موقعه داخل القمع—كلاهما يؤثر على التقارير والسلوك.
- نسيان تعيين user_id أو team_id. السجلات غير المعينة تضيع في النظام؛ فعّل التعيين التلقائي أو ضع قواعد وضعيّة للتعيين اليدوي.
- استبدال منطق التحويل دون استدعاء super(). طريقة action_convert تؤدي وظائف مهمة—وسّعها بدلاً من استبدالها كليةً.
- إضافة حقول مطلوبة دون قيم افتراضية. هذا سيؤدّي إلى فشل سجلات قائمة عند ترقية أو تثبيت الوحدة إن لم تتعرّض لتهيئة بيانات مناسبة.
خاتمة
نموذج crm.lead هو حجر الأساس في CRM داخل Odoo: يخزّن الاستفسارات والفرص ويحرّك تقارير وأنابيب المبيعات. الإحاطة بحقول النموذج وكيف تُمدّد الوحدات الأخرى له تُسهّل الضبط، التخصيص، والتكامل.
سواءً كنت مستشاراً وظيفياً يصمم خرائط عملية المبيعات أو مطوّراً يبني وحدات CRM مخصّصة، الفهم الجيّد لـ crm.lead يوفر وقتك ويقلّل الأخطاء.
هل تحتاج مساعدة في تنفيذ Odoo؟
شركة Dasolo تدعم الشركات في تنفيذ وتخصيص وتحسين Odoo، مع تركيز خاص على تكاملات API وتطوير الوحدات. فريقنا يمتلك خبرة عميقة في بنية بيانات Odoo ونماذج مثل crm.lead.
إذا رغبت بمساعدة في تطبيق Odoo أو بناء وحدات CRM مخصّصة أو تكاملات، نحن جاهزون لدعم مشروعك. احجز عرضاً توضيحياً لمناقشة مشروعك.