كلية المجتمع بسيئون

قسم نظم المعلومات الإدارية

مشروع التخرج: نظام المساعد الذكي لإدارة المشاريع (SAPM)

مشروع تخرج تقني لنيل شهادة الدبلوم التقني العالي

نظام المساعد الذكي لإدارة المشاريع

Smart Assistant for Project Management (SAPM)

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

الباحث الرئيسي

إعداد الطالب الباحث:

مشهور عبدالله خميس عمره

تخصص نظم معلومات إدارية

المشرف الأكاديمي

تحت إشراف الدكتور القدير:

الدكتور محمد حسان

عضو هيئة التدريس بالكلية

٢٠٢٦ م / ١٤٤٨ هـ

بنية الربط المركزية

Odoo + n8n

عبر Evolution API

زمن الاستجابة الكلي

2.3 ثانية

فائق السرعة (Low-Latency)

دقة استخراج النوايا بالـ AI

95.3%

نموذج Gemini المتقدم

منظومة التحقق والأمان

ديناميكية آمنة

ربط أرقام الهواتف (Tokenless)

برهان المفهوم التفاعلي المدعوم بالذكاء الاصطناعي (Gemini Live)

محاكي المساعد الذكي لإدارة المشاريع

انقر على الأزرار أدناه لمحاكاة الأوامر السريعة، أو اكتب رسالة حرة باللغة العربية في صندوق الهاتف للتفاعل مباشرة مع الذكاء الاصطناعي الحقيقي من Google Gemini لتطبيق أفكار أودو وأتمتة n8n!

اختر رسالة لمحاكاة العملية أو اكتب بحرية:

المساعد الذكي (SAPM)

نشط الآن عبر Gemini API ✨

مرحباً بك يا بطل! 🚀

أنا المساعد الذكي لإدارة المشاريع (Odoo AI SAPM). أنا متصل بقاعدة بيانات Odoo 19 وسأقوم بمساعدتك في إدارة مهامك بمجرد الكتابة لي بالعامية الحرة! كيف يمكنني مساعدتك اليوم؟ 😊

12:00 م

محتوى وهيكل الأطروحة الأكاديمية

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

الفصل الأول

مقدمة البحث والإطار المنهجي العام

يقدم هذا الفصل استعراضاً شاملاً ومفصلاً للإطار العام لمشروع التخرج الموسوم بـ "نظام المساعد الذكي لإدارة المشاريع" (Smart Assistant for Project Management). يتناول هذا الفصل الخلفية التقنية للمشروع، وصياغة مشكلته بدقة، والأسباب الدافعة لتطويره، بالإضافة إلى الأهداف الاستراتيجية والأهمية التطبيقية والأكاديمية، والمنهجية المتبعة في التنفيذ.

1. تمهيد وخلفية البحث (Introduction)

يشهد العصر الحالي ثورة تكنولوجية متسارعة تقودها التحولات الرقمية الشاملة في بيئات العمل المؤسسية. لم تعد أنظمة تخطيط موارد المؤسسات (ERP) خياراً ترفيهياً، بل أصبحت العصب المركزي لإدارة العمليات، وبخاصة في قطاع إدارة المشاريع وتتبع المهام. ومن بين هذه الأنظمة، برزت منصة Odoo كواحدة من أكثر الحلول مرونة وقوة بفضل بنيتها البرمجية المفتوحة وقدرتها على التوسع.

ومع ذلك، تواجه المنظمات الحديثة تحدياً فجوة واجهة المستخدم (UI Friction)؛ حيث تتطلب أنظمة الـ ERP التقليدية من الموظفين والمديرين الدخول المستمر عبر المتصفحات أو التطبيقات المكتبية المعقدة لتحديث حالات المهام، وتدوين سجلات الوقت (Timesheets)، ومتابعة تسليمات المشاريع. هذه الخطوات الروتينية تؤدي غالباً إلى تراكم المهام غير المحدثة، وتأخر التقارير الفورية، وضياع الساعات الفعلية للعمل بسبب إرجاء التوثيق.

2. صياغة مشكلة البحث (Problem Statement)

تتمحور مشكلة البحث حول "ضعف كفاءة المتابعة الفورية والتحديث المستمر للمشاريع والمهام في الأنظمة المؤسسية نتيجة تعقيد واجهات المستخدم التقليدية، وصعوبة الوصول إليها أثناء التنقل". ويمكن تفكيك هذه المشكلة العامة إلى عدة نقاط فرعية وتحديات تقنية:

تأخر تحديث البيانات وفقدان الدقة الفورية: يميل الموظفون الميدانيون إلى تأجيل تحديث الحالات مما ينتج عنه بيانات غير دقيقة لا تعكس الواقع الفعلي للمشاريع.
تشتت الانتباه وارتفاع تكلفة التبديل السياقي (Context Switching): يتنقل الموظف باستمرار بين تطبيقات المحادثة (التي يتم فيها النقاش الفعلي للعمل) وبين نظام إدارة المشاريع لتوثيق ما تم نقاشه.
محدودية وجفاف أنظمة البوت التقليدية (Stateless Rigid Bots): تعتمد معظم برمجيات الرد الآلي في الواتساب على الكلمات المفتاحية الجامدة التي أصبحت تواجه قيوداً صارمة من سياسات شركة Meta.

أهداف البحث الرئيسية

تصميم وتطوير نظام مساعد ذكي متكامل لإدارة المشاريع يعمل كحلقة وصل مؤتمتة بين نظام Odoo 19 وتطبيق الواتساب عبر منصة n8n، لتمكين المستخدمين من تصفح وتحديث وإنشاء المشاريع والمهام وتتبع الوقت باستخدام تقنيات معالجة اللغة الطبيعية والتحقق الديناميكي.

دوافع تطوير المشروع

الانتشار الكاسح للواتساب كأداة يومية، النضج التقني لمنصات الأتمتة ذات الكود المنخفض مثل n8n، الطفرة الهائلة في النماذج اللغوية الكبيرة LLMs، والحاجة الملحة لتحسين كفاءة تتبع الوقت الضائع (Timesheets Accuracy).

منهجية التطوير الرشيق (Agile)

تم اعتماد منهجية التطوير الرشيق (Agile Software Development Methodology) متمثلة في دورتها التكرارية المكونة من: تحليل المتطلبات، التصميم المعماري، التنفيذ الفعلي وكتابة الأكواد، الفحص والاختبار الميداني، والتقييم النهائي والنشر.

توليد وتوسيع أكاديمي للفصل الأول (Gemini API)

الفصل الثاني

الإطار النظري والدراسات والأنظمة الشبيهة

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

1. منظومة Odoo 19 و n8n كبنية تحتية

تتميز منصة Odoo (وتحديداً الإصدار الأحدث Odoo 19) باعتمادها على بنية برمجية قائمة على الوحدات (Modular Architecture) تدار بلغة Python وقاعدة بيانات PostgreSQL. تكمن القوة الجوهرية لأودو في نموذج الـ ORM (Object-Relational Mapping) الخاص بها، والذي يسهّل التعامل مع الجداول البرمجية ككائنات (Objects).

على النقيض الآخر, تم اختيار منصة n8n في هذا المشروع لتكون العصب المركزي للتحكم (Orchestrator). وتتميز n8n بأنها منصة عادلة المصدر (Fair-code)، قابلة للاستضافة الذاتية (Self-hosted)، مما يضمن أمان البيانات بالكامل وعدم خروج معلومات المؤسسة الحساسة إلى خوادم خارجية.

2. معالجة اللغة الطبيعية والذاكرة السياقية

تعتبر بروتوكولات الـ Webhooks والـ HTTP بروتوكولات عديمة الحالة (Stateless)، مما يعني أن الذكاء الاصطناعي يتعامل مع كل رسالة تصل إليه كحدث منفصل تماماً دون أي معرفة بما دار في الرسائل السابقة. لبناء محادثة منهجية يتم حل هذه المشكلة بربط نود الـ AI Agent بذاكرة مستمرة (Chat Memory) تتخذ من رقم هاتف المرسل (chatId) مفتاحاً فريداً للجلسة.

مقارنة علمية تلخيصية بين الأنظمة التقليدية والنظام المقترح

معيار المقارنة	أنظمة الربط المكتبية (Slack/Teams)	بوتات الواتساب التقليدية (Keyword)	النظام المقترح (Odoo + n8n + AI)
قناة التواصل	تطبيقات مكتبية خاصة وخارجية	تطبيق الواتساب	تطبيق الواتساب (انتشار واسع)
نوع مدخلات المستخدم	واجهات رسومية وبطاقات جامدة	أرقام خيارات أو أزرار تفاعلية مقيدة	لغة طبيعية حرة (عامية وفصحى) + أرقام
مرونة الفهم الدلالي	معدومة (تعتمد على الضغط)	معدومة (تتطلب تطابقاً حرفياً للكلمات)	عالية جداً (بفضل معالجة الـ LLMs للنوايا)
تتبع الوقت (Timesheet)	يتطلب الدخول لقوائم التطبيق الداخلية	غير مدعوم أو معقد من خلال خطوات طويلة	فوري وفائق السهولة (أوامر بدء/إنهاء نصية)

توليد وتوسيع أكاديمي للفصل الثاني (Gemini API)

الفصل الثالث

تحليل وتصميم وهندسة المساعد الذكي

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

1. بنية وجداول قاعدة البيانات المخصصة

لتحقيق مصادقة ديناميكية دون كتابة كلمات مرور، ابتكرنا جدول مطابقة المستخدمين المخصص smart.assistant.user.map داخل Odoo 19. يقوم هذا الجدول بالربط برمجياً بين رقم هاتف الواتساب للمرسل والمستخدم الداخلي الحقيقي في أودو لنقل الصلاحيات برمجياً:

# هيكلية جدول التحقق smart.assistant.user.map

id: Integer (Primary Key)

phone_number: Char / String (Unique, Indexed)

user_id: Many2one (res.users) (Required)

active: Boolean (Default: True)

2. المتطلبات غير الوظيفية للأمان

تم تعطيل الحماية التقليدية (CSRF Protection) للمسارات المخصصة لـ n8n مع تأمينها بجدار حماية برمجي يعتمد بالكامل على رقم الهاتف. كما تم منع الذكاء الاصطناعي كلياً من الوصول لقاعدة البيانات بشكل خام لمنع حدوث "الهلوسة البرمجية" التي قد تؤدي لتلف السجلات أو اختراق الحقول الحساسة.

المخطط التتابعي البرمجي (Sequence Diagram) لتفاعل المساعد الذكي

العميل (WhatsApp) Evolution API n8n (Orchestrator) Odoo 19 Server

1. الموظف يرسل أمر نصي ─── "ابدأ الميقاتي للمهمة الأولى" ───▶ [Evolution API]

2. بوابة الواتساب تحول الحدث لـ JSON POST ───────────▶ [n8n Orchestrator]

3. n8n يستعلم من جدول التحقق بمطابقة الرقم ──────────▶ [Odoo 19 Server]

4. أودو يطابق رقم الهاتف ويسمح بنقل صلاحيات المستخدم ◀─── [Odoo 19 Server]

5. n8n يوجه الـ AI لاستدعاء API الميقاتي /start ────────▶ [Odoo 19 Server]

6. أودو يعدل حالة المهمة لـ In Progress ويفتح السجل ◀─── [Odoo 19 Server]

7. المساعد الذكي يرسل رسالة تأكيد نجاح العملية ◀───────── [الموظف على الواتساب]

توليد وتوسيع أكاديمي للفصل الثالث (Gemini API)

الفصل الرابع

التنفيذ الفعلي والمعمارية البرمجية للأكواد

التفصيل البرمجي للبيئة التشغيلية وحاوية Docker، والأكواد المصدرية الكاملة للمتحكمات البرمجية بلغة بايثون داخل Odoo 19 لتمكين الأتمتة الموجهة.

الكود المصدري البرمجي لـ Odoo Controller (Python)

controllers/main.py

# -*- coding: utf-8 -*-
import json
from odoo import http
from odoo.http import request

class ProjectAssistantController(http.Controller):

    def _json_response(self, data, status=200):
        headers = [('Content-Type', 'application/json')]
        return request.make_response(json.dumps(data, default=str), headers=headers, status=status)

    def _get_mapped_user(self, phone):
        if not phone: return False
        clean_phone = phone.replace('+', '').strip()
        mapping = request.env['smart.assistant.user.map'].sudo().search([
            ('phone_number', '=', clean_phone),
            ('active', '=', True)
        ], limit=1)
        return mapping.user_id if mapping else False

    # GET /api/projects
    @http.route('/api/projects', type='http', auth='public', methods=['GET'], csrf=False)
    def get_projects(self, **kwargs):
        phone = kwargs.get('phone')
        user = self._get_mapped_user(phone)
        if not user:
            return self._json_response({'error': 'Unauthorized'}, status=401)
        
        projects = request.env['project.project'].with_user(user).sudo().search([
            ('partner_id', '=', user.partner_id.id)
        ])
        data = [{'project_id': p.id, 'project_name': p.name} for p in projects]
        return self._json_response(data)

    # POST /api/tasks
    @http.route('/api/tasks', type='http', auth='public', methods=['POST'], csrf=False)
    def create_task(self, **kwargs):
        body = json.loads(request.httprequest.data)
        phone = body.get('phone')
        user = self._get_mapped_user(phone)
        if not user: return self._json_response({'error': 'Unauthorized'}, status=401)
        
        new_task = request.env['project.task'].with_user(user).sudo().create({
            'name': body.get('task_name'),
            'project_id': int(body.get('project_id')),
            'user_ids': [(4, user.id)]
        })
        return self._json_response({'task_id': new_task.id, 'task_name': new_task.name})

3. هندسة الـ System Prompt السيادي للـ AI

لضمان ثبات وموثوقية النموذج، تم حقن نود الذكاء الاصطناعي ببرومبت سيادي متكامل باللغة الإنجليزية (لتحقيق أعلى كفاءة فهم من Gemini) مع إلزامه التام بصياغة الردود النهائية باللغة العربية مع إيموجيز لتلائم شاشات الهواتف المحمولة. كما يتضمن قواعد صارمة لإدارة الحالة (State Management) والذاكرة السياقية لمنع كشف الـ IDs الخام للمستخدم.

4. الاستضافة الذاتية وعزل الحاويات (Docker)

تم استضافة كافة الخدمات (Odoo, n8n, Evolution API) على خادم محلي باستخدام حاويات Docker وعزلها بالكامل داخل شبكة داخلية آمنة (Docker Network Bridge)، مع تشفير قنوات الاتصال الخارجية عبر بروتوكول HTTPS وتأمين الـ Webhooks بمفاتيح API Key سرية لمنع هجمات حقن السجلات الضارة.

توليد وتوسيع أكاديمي للفصل الرابع (Gemini API)

الفصل الخامس

مرحلة الفحص والاختبار الميداني والتقييم

تقييم كمي ونوعي شامل لاستقرار كفاءة تداول البيانات، وزمن الاستجابة (Latency) ومعالجة الحالات الحرجة والاستثنائية للمساعد الذكي في بيئة العمل الحقيقية.

قياس زمن الانتقال (Latency)

متوسط زمن معالجة الرسالة الكلي بلغ 2.3 ثانية؛ مقسمة إلى 0.2 ث لنقل الـ Webhook، و 1.5 ث لمعالجة الـ AI (Gemini NLU)، و 0.4 ث لتنفيذ العمليات في أودو، و 0.2 ث لإعادة إرسال الرد للعميل على هاتف الواتساب.

دقة تصنيف النوايا (NLU)

تم فحص 200 رسالة حرة بلهجات متعددة (عامية وفصحى)، حيث سجل النموذج مقياس دقة (Precision) قدره 96.5%، ومقياس استدعاء (Recall) قدره 94.2%، بمعدل F1-Score إجمالي مستقر عند 95.3%.

تحدي Stateless Protocol

تجاوزنا انعدام الحالة في بروتول الواتساب عبر حقن ذاكرة الجلسات Buffer Chat Memory في n8n لربط رقم العميل بخيارات مرقمة، مما سمح للبوت بتذكر المشروع المفتوح وتنفيذ العمليات السياقية المتتالية بسلاسة.

سجل ومصفوفة حالات الفحص الميداني (Test Cases)

رقم الحالة	العملية المفحوصة	المدخلات (واتساب)	النتيجة المتوقعة	النتيجة الفعلية / الحالة
TC-01	التحقق من رقم مجهول	"مرحباً أريد فحص المهام"	إرجاع خطأ 401 Unauthorized ورسالة توجيهية للاعتذار	ناجحة (Pass)
TC-02	جلب المشاريع المفتوحة	"استعرض لي مشاريعي"	جلب المشاريع من أودو وعرضها قائمة مرقمة منسقة	ناجحة (Pass)
TC-03	إنشاء مهمة بالذكاء الاصطناعي	"أضف مهمة برمجة واجهة الدخول"	استخراج اسم المهمة وربطها بالـ ID النشط تلقائياً	ناجحة (Pass)
TC-04	تتبع الوقت (الميقاتي)	"ابدأ الميقاتي على المهمة الأولى"	تحويل حالة المهمة لـ In Progress وفتح سجل الساعات	ناجحة (Pass)

توليد وتوسيع أكاديمي للفصل الخامس (Gemini API)

الفصل السادس

الخاتمة، التوصيات، والآفاق التطويرية

يلخص هذا الفصل الختامي أبرز الاستنتاجات البرمجية والفنية التي تم الوصول إليها، ورسم خارطة الطريق لتوسعة المشروع ليكون تطبيقاً مؤسسياً شاملاً في سوق العمل.

1. خلاصة الاستنتاجات العلمية والتقنية

أثبتت الدراسة حتمية ونجاح معمارية الـ RESTful API والـ Middleware في تبسيط وتطويع الأنظمة المؤسسية الضخمة (Enterprise Systems) وتصفير الفجوة التشغيلية لدى الموظفين الميدانيين. استخدام n8n كبنية وسيطة وفر سرعة غير مسبوقة في تعديل وتطوير خطوط العمل دون المساس باستقرار خادم أودو الأساسي، كما أن توظيف النماذج اللغوية Gemini قد حل بشكل حاسم جمود واجهات المحادثة القديمة.

2. التوصيات الاستراتيجية للمؤسسات

حظر الصلاحيات المباشرة للـ AI: نوصي بشدة بتقييد الـ AI من خلال REST APIs محددة بدلاً من إتاحة استعلامات ORM مباشرة.
الاستضافة الذاتية (Self-Hosting): استضافة كافة حاويات المنظومة محلياً لضمان السيادة الكاملة على البيانات الحساسة.
استخدام كاش Redis للذاكرة السياقية: لضمان سرعة معالجة موازية لآلاف الموظفين بالتوازي.

الآفاق والتطويرات المستقبلية المخططة للمشروع

أولاً: تسجيل المهام صوتياً (Voice-to-Task)

تفعيل نود تحويل الصوت إلى نص (مثل OpenAI Whisper أو Gemini Voice) لتمكين المديرين من إرسال تسجيل صوتي بالعامية ليقوم النظام بتحليله وحقنه في أودو كمهام فورية مكتملة البيانات.

ثانياً: التنبؤ وإدارة المخاطر بالـ AI

دمج تحليلات تنبؤية تدرس إنتاجية الموظف وسجل الساعات لإرسال تنبيهات تلقائية للمدير على الواتساب في حال وجود مؤشرات لتأخر تسليم أي مهمة عن موعدها المحدد.

ثالثاً: تمديد موديولات أودو الأخرى

توسيع المساعد ليدعم تقديم طلبات الإجازات ومطالعة كشوف المرتبات (HR)، بالإضافة إلى جلب كميات المخازن وإنشاء أوامر البيع الفورية للمناديب الميدانيين (CRM).

توليد وتوسيع أكاديمي للفصل السادس (Gemini API)

بسم الله الرحمن الرحيم

"يَرْفَعِ اللَّهُ الَّذِينَ آمَنُوا مِنكُمْ وَالَّذِينَ أُوتُوا الْعِلْمَ دَرَجَاتٍ ۚ وَاللَّهُ بِمَا تَعْمَلُونَ خَبِيرٌ"

سورة المجادلة: آية 11

تقرير لجنة المناقشة والتقييم

نؤيد بأننا قرأنا هذا التقرير كأعضاء لجنة مناقشة وتقييم، وامتحنا الطالب الباحث في محتوياته، ونشهد بأنها كافية كتقرير لمشروع تخرج لنيل درجة الدبلوم التقني العالي في تخصص نظم المعلومات الإدارية.

رئيس اللجنة / الممتحن: .......................

المشرف العلمي والمناقش: الدكتور محمد حسان

عضو اللجنة المناقش: .......................

iii

الإهداء

إلى منارة الهدى ونور البشرية، معلمنا الأول وقائدنا، محمد صلى الله عليه وسلم.

إلى سرّ توفيقي، ونبع العطاء النقي الذي لا ينضب.. إلى من دعت لي في جوف الليل فأنار الله دربي.. (أمي الغالية).

إلى من غرس فيّ الطموح وعلمني الثبات، سندي وعزوتي ومن أستند عليه في كل حين.. (أبي العزيز).

إلى رفقاء الدرب والقلب، من شاركوني الأيام وساندوني خطوة بخطوة.. (إخوتي وأخواتي).

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

إلى من حملوا رسالة العلم وأضاؤوا لنا مسارات الفكر والتقنية.. (أساتذتي الأفاضل).

الشكر والتقدير

الحمد لله الذي بنعمته تتم الصالحات، وبفضله وتوفيقه تذلل العقبات، والصلاة والسلام على معلم البشرية الخير.

أتقدم بوافر الشكر والامتنان وعظيم التقدير إلى مشروفي الفاضل الدكتور (محمد حسان)، الذي كان لتوجيهاته السديدة ورؤيته التقنية والأكاديمية الأثر البالغ في إثراء هذا العمل وإخراجه بصورته المتكاملة.

كما يمتد الشكر والتقدير إلى عمادة كلية المجتمع بسيئون، وكافة أساتذتي الأفاضل في قسم نظم المعلومات الإدارية الذين غمرونا بعلمهم طيلة مسيرتنا الدراسية.

وختاماً، أتوجه ببالغ التقدير لأعضاء لجنة المناقشة والحكم الموقرين على وقتهم وجهدهم في تقييم هذا البحث وتصويب مساره بملاحظاتهم القيمة.

vii