بني نظام تسيير مبني على الأنطولوجيا انطلاقاً من متطلبات العمل باستعمال ontology-driven-dev

تقديم المشروع

ontology-driven-dev هي مجموعة ديال مهارات الذكاء الاصطناعي موجّهة لتطوير الأنظمة ديال الأعمال، وكتعتمد منهجية قوية من ثلاث مراحل بالترتيب: «استكشاف المتطلبات → نمذجة الأنطولوجيا → بناء التطبيق». تقدر تبدا بوصف واحد للعمل، ومن بعد التأكيد البشري فكل مرحلة، وتوصل لوثيقة مواصفات المتطلبات، وملفات YAML ديال النماذج السبعة، ونظام كامل قابل للتشغيل فالواجهة الأمامية والخلفية ديال المتصفح.

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

مرحلة استكشاف المتطلبات فيها ثمانية خطوات، وكل خطوة خاصها توقف وانتظار التأكيد البشري، وما يمكنش للـ Agent يدوز عليها بوحدو.

القدرات الأساسية وبنية المشروع

الخصائص الرئيسية

• تتبّع المتطلبات: كل وظيفة تقدر ترجع للبند المقابل ديالها فوثيقة مواصفات المتطلبات.
• دلالة موحّدة للنماذج السبعة: باستعمال YAML ديال M1 وM2 وM3 وM5 وM6 وM7 وMU لوصف الكيانات، والسلوكات، والقواعد، والأطراف، والمسارات، والاستعلامات والتقارير، وواجهة المستخدم.
• بوابة التأكيد البشري: المراحل من الصفر حتى للمرحلة السابعة فاستكشاف المتطلبات خاصها التأكيد البشري قبل الاستمرار.
• قاعدة تقنية مدمجة: code-paas كيوفّر أساس تطبيق موحّد مبني بـ Flask وSQLite وReact وTypeScript، وفيه تدبير النظام، ومحرك المسارات، وورشة العمل، وسجل الأنطولوجيا.
• تفاعل أصلي مع الذكاء الاصطناعي: التطبيقات المولّدة خاصها تتضمن مربع حوار ديال الذكاء الاصطناعي فالجهة اليمنى، ويدعم حقن سجل الأنطولوجيا، واستدعاء الأدوات، والاستجابة المتدفقة عبر SSE، وحدود الأمان الخاصة بـ SQL للقراءة فقط.
• التوافق مع أدوات متعددة: يمكن استعمالها مع WorkBuddy وClaude Code وCodex وCursor وAider وCline وأي Agent عام كيقدر يحمّل تعليمات المشروع.

المحتويات الرئيسية فالمستودع

• SKILL.md: كيعرف المنهجية، وخط الأنابيب ديال المراحل الثلاث، وقواعد التنفيذ اللي خاص احترامها.
• references/: فيها معايير كتابة المتطلبات، وإطار نمذجة الأنطولوجيا، وإرشادات التطوير من النموذج حتى للتنفيذ، والبنية التقنية الأصلية للذكاء الاصطناعي، ومعايير UI/UE.
• reference-example/: مثال كامل على تدبير تنفيذ عقود البيع، فيه وثيقة المتطلبات، وYAML ديال النماذج السبعة، وmanifest.json.
• techbase/: كود مصدر ديال code-paas قابل للنسخ والتوسيع، فيه الخلفية، والواجهة الأمامية، وأمثلة النماذج، وملفات الاعتماديات.

تحضير بيئة التشغيل

قبل البداية، تأكد باللي الجهاز فيه البيئة التالية:

• Python 3.10 أو نسخة أحدث.
• Node.js 18 أو نسخة أحدث.
• إمكانية الولوج للشبكة ملي كتثبت اعتماديات Python والواجهة الأمامية لأول مرة.

الخلفية كتستعمل Flask وSQLite، والواجهة الأمامية كتستعمل React وTypeScript وVite. المشروع خاضع لـ MIT License، وتقدر تستعملو وتعدلو وتعاود توزعو بحرية.

التثبيت فالأدوات ديال تطوير الذكاء الاصطناعي

التثبيت فـ Claude Code

Claude Code كيقدر يكتاشف بوحدو SKILL.md فدليل المهارات. تقدر تختار التثبيت على مستوى المستخدم باش يكون متاح فجميع المشاريع:

cp -r ontology-driven-dev ~/.claude/skills/ontology-driven-dev

وتقدر حتى تثبتو فالمشروع الحالي:

cp -r ontology-driven-dev .claude/skills/ontology-driven-dev

من بعد، Claude Code غادي يتعرف على المسار ويحمّلو اعتماداً على name وdescription الموجودين فـ frontmatter ديال المهارة.

التثبيت فـ WorkBuddy

أمر التثبيت على مستوى المستخدم هو:

cp -r ontology-driven-dev ~/.workbuddy/skills/ontology-driven-dev

إلا بغيتي تستعملو غير فمشروع واحد، نفّذ:

cp -r ontology-driven-dev <المشروع ديالك>/.workbuddy/skills/ontology-driven-dev

التثبيت فـ Codex

Codex ما عندوش سجل أصلي للمهارات، وهادي علاش خاصك أولاً تنسخ المهارة للمستودع:

mkdir -p .codex/skills
cp -r ontology-driven-dev .codex/skills/

ومن بعد زِد قاعدة التحميل فـ codex.md ولا AGENTS.md ديال المشروع:

ملي المستخدم يبغي يدير «تطوير موجّه بالأنطولوجيا، أو استكشاف المتطلبات، أو نمذجة الأنطولوجيا، أو النماذج السبعة، أو code-paas، أو تطبيق أصلي للذكاء الاصطناعي»، حمّل .codex/skills/ontology-driven-dev/SKILL.md وطبّق بصرامة مسار المراحل الثلاث وبوابات التأكيد البشري.

Codex غادي يحوّل التأكيد البشري لأسئلة تفاعلية ولا للموافقة. الصندوق المعزول اللي خدام فيه خاصو يكون مربوط بالشبكة باش يقدر ينفذ npm install وpip install.

الاستعمال مع Cursor أو Aider أو Cline

• Cursor: حط محتوى SKILL.md فقواعد المشروع ولا فـ .cursorrules.
• Cline وAider: لصق SKILL.md فبداية الجلسة، ولا طلب بشكل واضح من الـ Agent يحمّل المسار ديالو.
• الـ Agents الآخرين: دخّل هاد الملف فالسياق باعتبارو تعليمة للنظام ولا ذاكرة للمشروع.

المرحلة الأولى: استكشاف المتطلبات والتأكيد عليها

المرحلة الأولى كتعتمد على references/AI需求探索与确认提示词V9.0.md، وكتحوّل الوصف الأولي للعمل لوثيقة رسمية لمواصفات متطلبات البرمجية.

تقدر تدخل للـ Agent تعليمة بحال:

عاونّي نطوّر نظام لتدبير تنفيذ عقود البيع، خاصو يدبّر العقود، والتحصيلات، والتسليمات، والموافقات.

الـ Agent خاصو يتقدّم بالتتابع عبر المراحل الثمانية التالية:

1. الفهم العام.
2. الكائنات التجارية.
3. الوظائف والقواعد التجارية.
4. الربط بين الكائنات.
5. التنسيق الشامل من البداية للنهاية ومسار الموافقات.
6. الاستعلامات والإحصائيات والتقارير.
7. الأدوار والصلاحيات.
8. النموذج الأولي لواجهة المستخدم، ويمكن اختيارو حسب الحاجة.

من بعد نهاية كل مرحلة، خاص الـ Agent يطلب التأكيد بصيغة «الأسئلة، اقتراح الذكاء الاصطناعي، السبب، الخيارات الأخرى، الرد السريع»، ويوقف حتى تقرر. حتى المحتوى من النوع B الخاص بالمؤسسة خاصو يتسول عليه بوضوح، وما يمكنش الانتقال للمرحلة الموالية قبل التأكيد.

الناتج النهائي ديال هاد المرحلة هو:

<المجال التجاري>-需求规格说明书-V9.md

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

المرحلة الثانية: توليد YAML ديال النماذج السبعة

من بعد تأكيد المتطلبات، الـ Agent كيبني نموذج الأنطولوجيا اعتماداً على references/ontology_modeling_framework_v9.md والملحق C ديال وثيقة المتطلبات. فهاد الوقت، المدخلات ولات أساساً محدداً، وما خاصش يعاود يقسم المجال التجاري على نطاق واسع.

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

اعتماداً على وثيقة مواصفات المتطلبات هادي، دير نمذجة للأنطولوجيا، وخرج YAML ديال النماذج السبعة وmanifest.json.

المحتويات اللي كيتخرجو فدليل yaml/ هي:

• نموذج الكائنات M1: كيوصف الكائنات التجارية.
• نموذج السلوكات M2: كيوصف السلوكات التجارية.
• نموذج القواعد M3: كيوصف القواعد التجارية.
• نموذج الأطراف M5: كيوصف الأدوار والأطراف المرتبطة.
• نموذج المسارات M6: كيوصف المسارات التجارية.
• نموذج الاستعلامات والتقارير M7: كيوصف الاستعلامات والتقارير.
• نموذج واجهة المستخدم MU: كيوصف واجهة المستخدم.
• manifest.json: كيسجل لائحة النماذج.

من بعد إكمال النمذجة، خاص يتدار فحص للاتساق، ويغطي على الأقل قابلية تتبع المتطلبات، والعلاقة واحد لواحد بين M7 وM2، وواش الإحالات ديال M6 ما فيهاش دورات. إلا بان شي عدم اتساق، خاص يتصلح النموذج أولاً قبل الدخول لمرحلة بناء الكود.

المرحلة الثالثة: بناء نظام BS قابل للتشغيل

نسخ القاعدة التقنية code-paas

نسخ دليل techbase/ كامل من دليل المهارة للمشروع الحالي داخل code-app/:

cp -r <دليل جذر المهارة>/techbase/. <المشروع الحالي>/code-app/
cd <المشروع الحالي>/code-app/frontend && npm install
cd <المشروع الحالي>/code-app/backend && pip install -r requirements.txt

فالتطوير الفعلي، خاص تعوّض YAML التجريبي ديال النماذج السبعة فالقاعـدة التقنية بالنماذج اللي تولدات فالمرحلة الثانية.

التنفيذ حسب ترتيب عشر خطوات

1. كتب ولا رتّب YAML ديال النماذج السبعة.
2. ولّد DDL وجداول قاعدة البيانات.
3. سجّل قاموس البيانات.
4. نفّذ خدمات السلوكات والقواعد.
5. كتب بيانات البذر ديال الأدوار والصلاحيات.
6. ربط محرك المسارات.
7. ولّد القوائم والصفحات والمسارات.
8. نفّذ مربع حوار الذكاء الاصطناعي فالجهة اليمنى.
9. دير اختبار الربط الشامل بين الواجهة الأمامية والخلفية.
10. كمّل القبول اعتماداً على المتطلبات والنماذج.

مربع حوار الذكاء الاصطناعي فالجهة اليمنى مكوّن إجباري، وما خاصش يتحيد أثناء التطوير. خاصو يحترم حقن سجل الأنطولوجيا، واستدعاء الأدوات، والنقل المتدفق عبر SSE، وحدود الأمان الخاصة بـ SQL للقراءة فقط، حسب تعريف المشروع.

تشغيل الخلفية والواجهة الأمامية

شغّل خلفية Flask:

cd code-app/backend
pip install -r requirements.txt
python app.py

العنوان الافتراضي للولوج للخلفية هو http://localhost:5000.

حلّ طرفية أخرى وشغّل خادم تطوير الواجهة الأمامية:

cd code-app/frontend
npm install
npm run dev

العنوان الافتراضي للولوج للواجهة الأمامية هو http://localhost:5173. الحساب الافتراضي هو admin، وكلمة المرور الافتراضية هي admin123؛ وتقدر تلقى تفاصيل أكثر على تشغيل القاعدة التقنية فـ techbase/README.md.

طرق التشغيل الشائعة

حسب المدخلات والهدف الموجودين، تقدر تستعمل عبارات تشغيل مختلفة.

التطوير الكامل انطلاقاً من المتطلبات

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

نمذجة الأنطولوجيا فقط

اعتماداً على وثيقة مواصفات المتطلبات هادي، دير نمذجة للأنطولوجيا، وخرج M1 وM2 وM3 وM5 وM6 وM7 وMU وmanifest.json.

بناء التطبيق اعتماداً على النماذج الموجودة

اعتماداً على ملفات YAML ديال النماذج السبعة هادو، ولّد النظام باستعمال قاعدة code-paas، وكمل الربط بين الواجهة الأمامية والخلفية.

كلمات «التطوير الموجّه بالأنطولوجيا»، و«استكشاف المتطلبات»، و«نمذجة الأنطولوجيا»، و«النماذج السبعة»، و«code-paas»، و«التطبيق الأصلي للذكاء الاصطناعي»، و«تطوير أنظمة الأعمال» تقدر حتى تعاون الـ Agent باش يتعرف على المهارة.

اقتراحات للممارسة المتقدمة

ما تفوّتش البوابات البشرية

حتى إلا بان الطلب الأولي كامل، ما تطلبش من الـ Agent يولّد النظام كامل دفعة وحدة. التأكيد مرحلة بمرحلة كيقدر يبيّن بكري مشاكل حدود الكائنات، ونقط الموافقة، ونطاق الصلاحيات، ومعايير الإحصائيات.

اعتبر الملحق C حدوداً للنمذجة

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

عطي الأولوية لفحص الإحالات بين النماذج

قبل ما تبدا فبناء الكود، ركّز على التحقق من العلاقة بين M7 وM2، والعلاقات المرجعية ديال M6، وقابلية التتبّع من بنود المتطلبات حتى لعناصر النموذج. إلا دخلات الأخطاء ديال مستوى النموذج لقاعدة البيانات والواجهات والصفحات، غادي تزيد كلفة الربط والاختبار من بعد.

خلي المثال المرجعي الكامل للمقارنة

reference-example/ كيوفّر مثالاً عملياً كاملاً لتدبير تنفيذ عقود البيع. فالمرة اللولة اللي غادي تستعملو فيها، تقدر تقارنو مع مواصفات المتطلبات، وملفات YAML ديال النماذج السبعة، وmanifest.json، باش تفهم كيفاش كترتابط المخرجات بين المراحل المختلفة.

بدّل النموذج اللول، ومن بعد وسّع القاعدة التقنية

اللي كاين فـ techbase/models/ هو نماذج مثالّية. فالمشروع الفعلي، خاصك اللول تحط ملفات YAML ديال النماذج السبعة ديالك، ومن بعد توسّع خدمات الواجهة الخلفية، والصلاحيات، والمسارات، والقوائم والصفحات، باتباع خط الأنابيب ديال المراحل العشرة من النموذج حتى للتنفيذ. بهاد الطريقة كتتفادى تعديل كود الأعمال مباشرة على أساس بيانات المثال.

الخلاصة

ontology-driven-dev كيربط توضيح المتطلبات، ونمذجة الأنطولوجيا، وتنفيذ التطبيق فمسار تطوير واحد فيه بوابات تحكم بشرية. الاستعمال الصحيح ديالو كيتطلب الالتزام بهاد الترتيب: تأكيد المتطلبات أولاً، ومن بعد التحقق من انسجام النماذج السبعة، وفالأخير البناء والقبول اعتماداً على code-paas. بهاد الشكل، تقدر تستافد من الذكاء الاصطناعي باش ترفع نجاعة تطوير أنظمة الأعمال، مع الحفاظ على مصدر دلالي واضح وعلاقة تتبّع كاملة للمتطلبات.