🇬🇧 English Version: Read the original article in English here.

سياق بدون هدر: استعلام اعتماديات أبيكس عبر Graphify بدقة جراحية 🎯⚡

الجزء الرابع من سلسلة “مطور APEX المدعوم بالذكاء الاصطناعي”.

⚡ الخلاصة في كلمتين (TL;DR)

لما تروح مكتبة أبحاث جامعية عشان تدور على مرجع عن الفخار الروماني، أنت أكيد مش عايز أمين المكتبة يزق لك 20 ترولي تقيل عليهم 500 كتاب ويدلقهم فوق مكتبك! أنت عايز كارت الفهرس الصغير اللي يقولك: “الممر رقم 4، الرف ب، الكتاب رقم 12”.

البرمجة مع الذكاء الاصطناعي نفس الشيء بالظبط: إنك تسحب فولدرات كاملة أو نصوص Packages عملاقة في شات الـ AI، ده المقابل الرقمي لدلق 20 ترولي كتب على مكتبك. بيكركب ذاكرة النموذج، وينفخ فاتورة التوكنز، وبيطلع أخطاء كارثية وغير متوقعة.

باستخدام أداة Graphify (أو أي أداة استعلام جراف بنيتها لمشروعك)، الـ Agent بيسأل الجراف المعماري مباشرة—ويسحب الـ 10 نودز (Nodes) اللي محتاجهم بالمللي في أقل من 25 ميلي ثانية. هنا هنشوف إزاي هندسة السياق بدون هدر (Zero-Waste Context) بتشتغل على أرض الواقع.

📚 ورطة ترولي الكتب: التكلفة الحقيقية للبحث العشوائي بالـ Grep

تعالوا نشوف إيه اللي بيحصل في جلسة برمجة عادية مع الـ AI من غير Knowledge Graph بالتفصيل:

أنت بتسأل الـ AI بتاعك:

“لما العميل يدوس على زرار ‘تأكيد الطلب’ في صفحة 12، كود الخصم بيتراجع فين، وأنهي جداول بتتعدل بالظبط؟”

شوف بقى الـ AI وهو بيغرق في شبر مية:

البحث الهمجي بالـ Grep: الـ Agent يشغل أمر grep -rn "DISCOUNT" . على المستودع كله من أوله لآخره.
كومة القش من النتائج الكاذبة (False Positives): يلاقي 142 سطر متفرقين في 28 ملف: سكربتات قديمة اتلغت، كومنتات من 3 سنين، ملفات تيست، وجداول فواتير ملهاش علاقة بالموضوع!
دلق التوكنز في الشات: يسحب 10 ملفات من دول في الـ Context Window، ويحرق 35,000 توكن قبل ما يكتب سطر كود واحد!
استنتاج وهمي وهبد صريح: من كتر الكومنتات القديمة والدوشة، الموديل يفترض بالغلط إن الخصم بيتحسب بكود جافاسكريبت على المتصفح، ويفوت تماماً الـ Package الحقيقية في الداتابيز!

تعالوا نقارن ده بـ Agent معاه أدوات استعلام الجراف:

graphify path "BTN_SUBMIT_ORDER" "ORDERS"

في 18 ميلي ثانية بس، الجراف بيرد عليه:

مسار مؤكد (4 خطوات):
[زرار: BTN_SUBMIT_ORDER]
  └── triggers ──> [Process: PROC_SAVE_ORDER]
        └── calls ──> [Package: PKG_CHECKOUT.PROCESS_ORDER]
              └── writes ──> [جدول: ORDERS]

الـ Agent دلوقتي معاه حقيقة هندسية مؤكدة 100% في 42 توكن بس! مفيش رغي، مفيش نتائج مزيفة، وصفر تخمين.

🎯 الأنماط التلاتة الأساسية لاستعلام الجراف

أثناء بناء وتعديل تطبيقات Oracle APEX، وكيل البرمجة بالذكاء الاصطناعي بيحتاج 3 أنواع رئيسية من الرؤية المعمارية:

1. استكشاف الجيران المحيطين (`graphify query`)

لما الـ Agent يطلب منه تعديل صفحة معينة، مش محتاج يعرف أي حاجة عن الـ 79 صفحة التانيين. هو محتاج بس يفهم المكونات المباشرة اللي عايشة في نفس الصفحة:

graphify query "Page_12" --depth 1

النتيجة:
- Page_12 (صفحة: "Order Checkout")
  ├── Region_CustomerInfo (منطقة)
  │   ├── P12_CUSTOMER_NAME (حقل نص)
  │   └── P12_CUSTOMER_EMAIL (حقل إيميل)
  └── Region_CartSummary (منطقة)
      ├── P12_CART_TOTAL (حقل رقم)
      ├── BTN_APPLY_DISCOUNT (زرار) ──[TRIGGERS]──> PROC_APPLY_PROMO
      └── BTN_SUBMIT_ORDER (زرار)   ──[TRIGGERS]──> PROC_SAVE_ORDER

في أقل من 80 توكن، الـ Agent عرف:

المناطق (Regions) اللي موجودة في الصفحة.
الحقول التابعة لكل منطقة.
الزراير والـ Processes المرتبطة بيها.

2. تتبع مسار تدفق البيانات (`graphify path`)

في أنظمة أبيكس للمؤسسات، دوسة الزرار بتشغل Process، والـ Process بتنادي Package، والـ Package بتكتب في جدول داتابيز.

عشان تعرف الداتا بتسافر إزاي من شاشة المتصفح لحد قرص التخزين، أمر graphify path بيكشف لك مسار السلسلة بالكامل:

graphify path "BTN_APPLY_DISCOUNT" "DISCOUNT_LOGS"

المسار بالكامل:
[BTN_APPLY_DISCOUNT] 
  ──[TRIGGERS]──> [PROC_APPLY_PROMO] 
  ──[CALLS]──> [PKG_PROMO.VALIDATE_CODE] 
  ──[WRITES]──> [DISCOUNT_LOGS]

الـ Agent بيشوف فوراً إن PKG_PROMO.VALIDATE_CODE بتسجل محاولات الخصم في جدول DISCOUNT_LOGS. مش محتاج يخمن ولا يسألك اللوجات دي بتروح فين.

3. تحليل نطاق التأثير والتوابع (`graphify callers`)

أرعب لحظة في شغل قواعد البيانات هي لما تيجي تعدل جدول مشترك أو تغير باراميتر في Package شغالة في كل حتة:

“لو عدلت شكل دالة PKG_CUSTOMER_API.GET_BALANCE، إيه اللي هيفرقع في وشنا؟”

من غير جراف، يا إما هتقعد تشغل كويريهات معقدة على جدول ALL_DEPENDENCIES، أو تدعي ربنا إن مفيش شاشة تبوظ في الـ Production! مع Graphify، الـ Agent بيكتب سطر واحد:

graphify callers "PKG_CUSTOMER_API.GET_BALANCE"

الشاشات والبرامج اللي بتنادي PKG_CUSTOMER_API.GET_BALANCE:
├── صفحة 04 (لوحة تحكم العميل) ──> Region_BalanceSummary
├── صفحة 12 (شاشة الشراء)       ──> Process_CheckCreditLimit
└── باكيدج الفواتير PKG_INVOICING.GENERATE_MONTHLY

في ثواني معدودة، الـ Agent بيطلع لك تقرير أثر كامل (Blast Radius Report) وعارف بالظبط إيه الشاشات اللي لازم يختبرها قبل ما يرفع الكود!

⚡ لغة الأرقام الحقيقية: بالجراف ضد من غير جراف

تعالوا نقارن مهمة تعديل حقيقية تمت بالطريقتين:

المقياس	البحث النصي الهمجي (Grep)	الاستعلام الذكي بالجراف	الفرق
الملفات المسحوبة في الـ Prompt	8 – 15 ملف كاملين	ملف واحد مستهدف + كود الجراف	85% ملفات أقل
التوكنز المستهلكة	28,000 – 45,000 توكن	650 – 1,200 توكن	توفير 97% من التوكنز
وقت التنفيذ	35 – 50 ثانية انتظار	3 – 5 ثواني بس	أسرع 10 مرات
دقة الكود المقترح	~65% (أسماء أعمدة وهمية)	~98% (علاقات AST موثقة)	كود جاهز للـ Production

🛠️ إزاي تضيف استعلام الجراف لدورة شغلك؟

تقدر تبدأ تطبق الفكر ده في أي مشروع:

أداة CLI خفيفة بلغة Python: سكربت صغير (~60 سطر) بيحمل جراف الـ AST ويوفر أوامر سريعة في التيرمينال: --query و --path و --callers.
تسجيلها كـ Agent Tools: في أدوات الـ AI الحديثة (Cursor, Antigravity, MCP Servers)، سجل الأوامر دي كـ أدوات يقدر الـ Agent يناديها تلقائياً بدل ما يقرأ الملفات عمال على بطال.
تثبيت سقف التوكنز تحت 1000 توكن: علم الـ Agent بتاعك يسأل الجراف الأول عشان يحدد الملفات اللي محتاجها بالظبط قبل ما يسحب أي كود.

[!TIP]

📦 عايز أدوات الجراف جاهزة للاستخدام؟

مستودع APEX Project Template بيجي ومعاه تكامل Graphify جاهز بالاختصارات وتعليمات الـ Agents. تقدر تاخد السكربتات وتطبقها في مشروعك الحالي فوراً!

🚀 إيه اللي مستنينا في الجزء الخامس؟

دلوقتي بعد ما الـ Agent بتاعنا بقى يقدر يتنقل بين اعتماديات التطبيق بدقة جراحية، بيظهر سؤال أمان في غاية الأهمية:

هو الـ AI مسموح له يكتب كود فين، وممنوع يقرب من إيه؟

لو سبت الـ AI في فولدر عايم من غير حواجز أمان، ممكن بحسن نية يمسح ملفات الـ DDL النظيفة، أو يعدل في سكربتات migrations قديمة، أو يرفع ملفات تجارب في الـ Git.

في الجزء الخامس (“عزل المعمل النظيف: ليه سورس كودك، ومرايات الداتابيز، وتجارب الـ AI مستحيل يختلطوا؟”)، هنتعرف على حدود الفولدرات الأربعة المعقمة اللي بتحافظ على داتابيز الـ Production بتاعتك آمنة وبتخليك تشتغل بقمة راحة البال!

استنونا في الجزء الخامس! 🧼✨

كتبه: أحمد شريف (Ahmed Sherif).