#003 — Requirements | المتطلبات
في هندسة البرمجيات، أحد أكبر الأخطاء هو أن تبدأ في كتابة الكود قبل أن تعرف بدقة ما الذي يجب أن تبنيه ولماذا.
قد يكون لديك فريق ممتاز، وتقنيات حديثة، وكود نظيف، لكن إذا كانت المتطلبات غير واضحة فقد ينتهي بك الأمر إلى بناء نظام ممتاز تقنيًا... لكنه لا يحل المشكلة الحقيقية.
هنا تأتي أهمية Requirements.
المتطلبات هي الجسر بين احتياج المستخدم وبين النظام الذي سنبنيه. ومن خلالها نفهم المشكلة، واحتياجات أصحاب المصلحة، والوظائف المطلوبة، والقيود التي يجب أن يعمل النظام ضمنها.
المتطلبات الواضحة تساعد الفريق على اتخاذ قرارات أفضل في التصميم والتطوير، تقلل إعادة العمل والتكاليف، وتوفر أساسًا واضحًا للاختبار والتحقق من أن المنتج النهائي يحقق الهدف المطلوب.
ولهذا قبل أن تسأل:
كيف سنبني النظام؟
اسأل أولًا:
ماذا نحتاج أن نبني؟ ولماذا؟
فالهدف في هندسة البرمجيات ليس كتابة أكبر قدر من الكود، بل بناء الحل الصحيح للمشكلة الصحيحة.
في هذا الكاروسيل شرحت مفهوم Requirements، مصادر المتطلبات، أهميتها، وما الذي يمكن أن يحدث عندما يبدأ المشروع بمتطلبات غامضة.
السؤال للنقاش:
أيهما أخطر برأيك: تنفيذ Requirement بطريقة خاطئة، أم تنفيذ Requirement لم يكن مطلوبًا من الأساس؟
المنشور القادم #004 — Functional Requirements
وسنتحدث عن كيفية تحديد ما الذي يجب أن يفعله النظام.
م. طارق العمري
Software Engineer | Backend Developer
#SoftwareEngineering #Requirements #RequirementsEngineering #SoftwareDevelopment #SoftwareEngineer #SystemAnalysis #SystemDesign #BackendDevelopment #Programming #SoftwareArchitecture #هندسة_البرمجيات #تحليل_النظم #تطوير_البرمجيات #برمجة
في هندسة البرمجيات، أحد أكبر الأخطاء هو أن تبدأ في كتابة الكود قبل أن تعرف بدقة ما الذي يجب أن تبنيه ولماذا.
قد يكون لديك فريق ممتاز، وتقنيات حديثة، وكود نظيف، لكن إذا كانت المتطلبات غير واضحة فقد ينتهي بك الأمر إلى بناء نظام ممتاز تقنيًا... لكنه لا يحل المشكلة الحقيقية.
هنا تأتي أهمية Requirements.
المتطلبات هي الجسر بين احتياج المستخدم وبين النظام الذي سنبنيه. ومن خلالها نفهم المشكلة، واحتياجات أصحاب المصلحة، والوظائف المطلوبة، والقيود التي يجب أن يعمل النظام ضمنها.
المتطلبات الواضحة تساعد الفريق على اتخاذ قرارات أفضل في التصميم والتطوير، تقلل إعادة العمل والتكاليف، وتوفر أساسًا واضحًا للاختبار والتحقق من أن المنتج النهائي يحقق الهدف المطلوب.
ولهذا قبل أن تسأل:
كيف سنبني النظام؟
اسأل أولًا:
ماذا نحتاج أن نبني؟ ولماذا؟
فالهدف في هندسة البرمجيات ليس كتابة أكبر قدر من الكود، بل بناء الحل الصحيح للمشكلة الصحيحة.
في هذا الكاروسيل شرحت مفهوم Requirements، مصادر المتطلبات، أهميتها، وما الذي يمكن أن يحدث عندما يبدأ المشروع بمتطلبات غامضة.
السؤال للنقاش:
أيهما أخطر برأيك: تنفيذ Requirement بطريقة خاطئة، أم تنفيذ Requirement لم يكن مطلوبًا من الأساس؟
المنشور القادم #004 — Functional Requirements
وسنتحدث عن كيفية تحديد ما الذي يجب أن يفعله النظام.
م. طارق العمري
Software Engineer | Backend Developer
#SoftwareEngineering #Requirements #RequirementsEngineering #SoftwareDevelopment #SoftwareEngineer #SystemAnalysis #SystemDesign #BackendDevelopment #Programming #SoftwareArchitecture #هندسة_البرمجيات #تحليل_النظم #تطوير_البرمجيات #برمجة
ما هو Freebuff CLI؟
أداة Freebuff CLI هي "وكيل برمجي" (AI Coding Agent) مدعوم بالذكاء الاصطناعي، يعمل مباشرة من خلال موجه الأوامر (Terminal). صُممت هذه الأداة لتكون بديلاً مجانياً بالكامل لأدوات البرمجة المدفوعة مثل Cursor، و Claude Code، و Devin، و Codex.
تعتمد الأداة على نموذج تمويل مبتكر عبر عرض إعلانات نصية بسيطة أثناء الاستخدام، مما يوفر للمطورين بيئة عمل مجانية تماماً دون الحاجة إلى اشتراكات شهرية، أو مفاتيح (API Keys)، أو إدخال بطاقات ائتمانية.
أبرز المميزات
نماذج ذكاء اصطناعي متطورة: تتيح الأداة الوصول إلى نماذج قوية ومجانية مثل DeepSeek V4 Pro/Flash، و GPT-5.6 Luna، و MiniMax M3، و MiMo V2.5.
هيكلية الوكلاء المتعددين (Multi-agent): بدلاً من الاعتماد على نموذج واحد لمعالجة كل شيء، تستخدم الأداة وكلاء متخصصين؛ أحدهم للبحث وفهم ملفات المشروع، وآخر للتخطيط، وآخر لتعديل الكود، وآخر للمراجعة.
تنفيذ المهام المستقل: الأداة قادرة على استكشاف ملفات المشروع بشكل مستقل، واقتراح التعديلات، وكتابة الأكواد، بل وتستطيع أيضاً تشغيل أوامر الفحص والاختبار (Tests) لضمان عمل الكود المُضاف.
دعم الأنظمة: تعمل بسلاسة على أنظمة Windows، و macOS، و Linux.
كيفية التثبيت والتشغيل
بما أن الأداة موجهة لبيئات التطوير، فهي تتطلب وجود بيئة
Bash
طريقة الاستخدام:
افتح موجه الأوامر (Terminal) وتوجه إلى مجلد مشروعك (سواء كان مشروعاً جديداً أو قائماً بالفعل):
Bash
قم بتشغيل الأداة عبر الأمر:
Bash
اكتب طلبك البرمجي أو التعديل الذي تريده باللغة الطبيعية (مثلاً: "قم ببناء نظام تسجيل دخول" أو "حل مشكلة الأخطاء في ملف قاعدة البيانات")، وستقوم الأداة بقراءة الملفات ذات الصلة وإجراء التعديلات المطلوبة تلقائياً.
أداة Freebuff CLI هي "وكيل برمجي" (AI Coding Agent) مدعوم بالذكاء الاصطناعي، يعمل مباشرة من خلال موجه الأوامر (Terminal). صُممت هذه الأداة لتكون بديلاً مجانياً بالكامل لأدوات البرمجة المدفوعة مثل Cursor، و Claude Code، و Devin، و Codex.
تعتمد الأداة على نموذج تمويل مبتكر عبر عرض إعلانات نصية بسيطة أثناء الاستخدام، مما يوفر للمطورين بيئة عمل مجانية تماماً دون الحاجة إلى اشتراكات شهرية، أو مفاتيح (API Keys)، أو إدخال بطاقات ائتمانية.
أبرز المميزات
نماذج ذكاء اصطناعي متطورة: تتيح الأداة الوصول إلى نماذج قوية ومجانية مثل DeepSeek V4 Pro/Flash، و GPT-5.6 Luna، و MiniMax M3، و MiMo V2.5.
هيكلية الوكلاء المتعددين (Multi-agent): بدلاً من الاعتماد على نموذج واحد لمعالجة كل شيء، تستخدم الأداة وكلاء متخصصين؛ أحدهم للبحث وفهم ملفات المشروع، وآخر للتخطيط، وآخر لتعديل الكود، وآخر للمراجعة.
تنفيذ المهام المستقل: الأداة قادرة على استكشاف ملفات المشروع بشكل مستقل، واقتراح التعديلات، وكتابة الأكواد، بل وتستطيع أيضاً تشغيل أوامر الفحص والاختبار (Tests) لضمان عمل الكود المُضاف.
دعم الأنظمة: تعمل بسلاسة على أنظمة Windows، و macOS، و Linux.
كيفية التثبيت والتشغيل
بما أن الأداة موجهة لبيئات التطوير، فهي تتطلب وجود بيئة
Node.js (إصدار 18 أو أحدث). يتم تثبيت الأداة على جهازك بشكل شامل (Globally) عبر مدير الحزم npm باستخدام الأمر التالي:Bash
npm install -g freebuff
طريقة الاستخدام:
افتح موجه الأوامر (Terminal) وتوجه إلى مجلد مشروعك (سواء كان مشروعاً جديداً أو قائماً بالفعل):
Bash
cd your-project
قم بتشغيل الأداة عبر الأمر:
Bash
freebuff
اكتب طلبك البرمجي أو التعديل الذي تريده باللغة الطبيعية (مثلاً: "قم ببناء نظام تسجيل دخول" أو "حل مشكلة الأخطاء في ملف قاعدة البيانات")، وستقوم الأداة بقراءة الملفات ذات الصلة وإجراء التعديلات المطلوبة تلقائياً.
IBB Business Database
https://github.com/tareq-alomari/ibb-business-database
هو مستودع يهدف إلى بناء قاعدة تحليل شاملة ومنظمة لجميع المؤسسات والمحلات التجارية والخدمية في محافظة إب، في اليمن ويمكن تطويره وتوسيعة ليشمل جميع محافظات الجمهورية
يعتمد المشروع على هيكل قطاعي موحد يضم 22 قطاعًا رئيسيًا وأكثر من 150 مجالًا فرعيًا، مما يسهل عملية البحث والتحليل ك هندسة برمجيات
وأيضاّ مستودع غني بالافكار سوى لمشاريع التخرج او لمشاريع سوق عمل
تم تخطيط و تصميم هذا المستودع ليكون مرجع للمهندسين والمطورين والباحثين والجهات الحكومية والخاصة، مع إمكانية إضافة قطاعات ومجالات جديدة مستقبلًا دون التأثير على بنية قاعدة البيانات.
الهيكل القطاعي
القطاعات الرئيسية (22 قطاعًا)
# القطاع المجالات الفرعية
01 الصحة المستشفيات، المراكز الطبية، العيادات، المختبرات، الصيدليات، مراكز الأشعة، العلاج الطبيعي، البصريات، الأسنان، الإسعاف
02 التعليم الجامعات، الكليات، المدارس الحكومية، المدارس الأهلية، المعاهد، مراكز التدريب، الحضانات، رياض الأطفال، مراكز اللغات
03 التجارة والتجزئة السوبرماركت، البقالات، الهايبر ماركت، محلات الملابس، الأحذية، الحقائب، العطور، مستحضرات التجميل، الألعاب، الهدايا
04 الأغذية والمشروبات المطاعم، الكافتيريات، المقاهي، المخابز، الحلويات، العصائر، محامص البن، البهارات، المياه
05 التقنية والاتصالات شركات البرمجيات، محلات الكمبيوتر، الهواتف، صيانة الأجهزة، الشبكات، الإنترنت، كاميرات المراقبة، الطابعات
06 المال والأعمال البنوك، شركات الصرافة، التمويل الأصغر، المحاسبة، التدقيق، التأمين، الاستشارات
07 العقارات والإنشاءات المكاتب العقارية، المقاولات، مواد البناء، الديكور، الألمنيوم، الزجاج، النجارة، الحدادة
08 النقل والمواصلات مكاتب السفر، النقل الداخلي، النقل بين المحافظات، الشحن، التخليص، تأجير السيارات
09 السيارات معارض السيارات، الورش، الكهرباء، السمكرة، الدهان، الإطارات، البطاريات، الزيوت، قطع الغيار
10 الزراعة والثروة الحيوانية المشاتل، البذور، الأسمدة، المبيدات، المعدات الزراعية، العسل، الأعلاف، البيطرة
11 الصناعة والإنتاج المصانع، الورش الصناعية، الصناعات الغذائية، البلاستيك، الأثاث، المنسوجات
12 الخدمات المهنية المحاماة، الهندسة، الاستشارات، الترجمة، التصميم، التصوير، الطباعة
13 الخدمات المنزلية التنظيف، مكافحة الحشرات، الغسيل، صيانة المنازل، الكهرباء، السباكة، التكييف
14 التجميل والعناية الشخصية صالونات الحلاقة، صالونات التجميل، مراكز العناية بالبشرة، النوادي الصحية، المساج
15 السياحة والضيافة الفنادق، الشقق الفندقية، المنتجعات، الاستراحات، قاعات المناسبات
16 المنظمات والجمعيات الجمعيات الخيرية، المنظمات المحلية، المنظمات الدولية، المؤسسات التنموية
17 الجهات الحكومية الوزارات، المكاتب التنفيذية، المحاكم، الشرطة، البلديات، المرافق العامة
18 الإعلام والإعلان الصحف، الإذاعات، وكالات الإعلان، التسويق الرقمي، الإنتاج الإعلامي
19 الرياضة والترفيه الأندية الرياضية، الصالات الرياضية، الملاعب، مراكز الألعاب، الحدائق
20 الطاقة والمرافق محطات الوقود، الغاز، الطاقة الشمسية، الكهرباء، المياه
21 الأسواق الشعبية الأسواق العامة، أسواق الجملة، أسواق الخضار، أسواق المواشي، الأسواق الموسمية
22 الحرف والصناعات التقليدية الخياطة، التطريز، الفخار، النجارة التقليدية، صياغة الذهب، الصناعات اليدوية
مراحل التحليل (22 مرحلة)
كل مجال فرعي في قاعدة البيانات يحتوي على هيكل تحليل متكامل مكون من 22 مرحلة:
# المرحلة الوصف
01 Project Discovery فهم المشروع، المشكلة، الحل، SWOT, PESTLE
02 Research بحث في جميع المصادر الممكنة
03 Business Analysis تحليل الأعمال والخدمات
04 Market Analysis تحليل السوق والمنافسين
05 Competitor Analysis تحليل المنافسين الرئيسيين
06 Stakeholders تحديد أصحاب المصلحة
07 User Research بناء Personas احترافية
08 Functional Analysis المتطلبات الوظيفية
09 Non-Functional Requirements المتطلبات غير الوظيفية
10 Information Architecture هيكل المعلومات
11 UX تجربة المستخدم
12 UI Design تصميم الواجهات
13 Database Design تصميم قاعدة البيانات
14 API Design تصميم API
15 Software Architecture بنية البرمجيات
16 Technical Stack التقنيات المقترحة
17 Security تحليل الأمان
18 SEO استراتيجية تحسين محركات البحث
19 Dashboard لوحة التحكم
20 Project Planning تخطيط المشروع
21 Documentation التوثيق
22 Final Deliverables المخرجات النهائية
ملاحظة : المستودع في وضع التطوير
نرحب بمساهماتكم في:
إضافة بيانات جديدة للمجالات الفرعية
إكمال تحليلات المجالات
اقتراح قطاعات أو مجالات جديدة
تحسين هيكل البيانات
للاستفسارات والاقتراحات، يرجى التواصل عبر:
https://github.com/tareq-alomari/ibb-business-database
هو مستودع يهدف إلى بناء قاعدة تحليل شاملة ومنظمة لجميع المؤسسات والمحلات التجارية والخدمية في محافظة إب، في اليمن ويمكن تطويره وتوسيعة ليشمل جميع محافظات الجمهورية
يعتمد المشروع على هيكل قطاعي موحد يضم 22 قطاعًا رئيسيًا وأكثر من 150 مجالًا فرعيًا، مما يسهل عملية البحث والتحليل ك هندسة برمجيات
وأيضاّ مستودع غني بالافكار سوى لمشاريع التخرج او لمشاريع سوق عمل
تم تخطيط و تصميم هذا المستودع ليكون مرجع للمهندسين والمطورين والباحثين والجهات الحكومية والخاصة، مع إمكانية إضافة قطاعات ومجالات جديدة مستقبلًا دون التأثير على بنية قاعدة البيانات.
الهيكل القطاعي
القطاعات الرئيسية (22 قطاعًا)
# القطاع المجالات الفرعية
01 الصحة المستشفيات، المراكز الطبية، العيادات، المختبرات، الصيدليات، مراكز الأشعة، العلاج الطبيعي، البصريات، الأسنان، الإسعاف
02 التعليم الجامعات، الكليات، المدارس الحكومية، المدارس الأهلية، المعاهد، مراكز التدريب، الحضانات، رياض الأطفال، مراكز اللغات
03 التجارة والتجزئة السوبرماركت، البقالات، الهايبر ماركت، محلات الملابس، الأحذية، الحقائب، العطور، مستحضرات التجميل، الألعاب، الهدايا
04 الأغذية والمشروبات المطاعم، الكافتيريات، المقاهي، المخابز، الحلويات، العصائر، محامص البن، البهارات، المياه
05 التقنية والاتصالات شركات البرمجيات، محلات الكمبيوتر، الهواتف، صيانة الأجهزة، الشبكات، الإنترنت، كاميرات المراقبة، الطابعات
06 المال والأعمال البنوك، شركات الصرافة، التمويل الأصغر، المحاسبة، التدقيق، التأمين، الاستشارات
07 العقارات والإنشاءات المكاتب العقارية، المقاولات، مواد البناء، الديكور، الألمنيوم، الزجاج، النجارة، الحدادة
08 النقل والمواصلات مكاتب السفر، النقل الداخلي، النقل بين المحافظات، الشحن، التخليص، تأجير السيارات
09 السيارات معارض السيارات، الورش، الكهرباء، السمكرة، الدهان، الإطارات، البطاريات، الزيوت، قطع الغيار
10 الزراعة والثروة الحيوانية المشاتل، البذور، الأسمدة، المبيدات، المعدات الزراعية، العسل، الأعلاف، البيطرة
11 الصناعة والإنتاج المصانع، الورش الصناعية، الصناعات الغذائية، البلاستيك، الأثاث، المنسوجات
12 الخدمات المهنية المحاماة، الهندسة، الاستشارات، الترجمة، التصميم، التصوير، الطباعة
13 الخدمات المنزلية التنظيف، مكافحة الحشرات، الغسيل، صيانة المنازل، الكهرباء، السباكة، التكييف
14 التجميل والعناية الشخصية صالونات الحلاقة، صالونات التجميل، مراكز العناية بالبشرة، النوادي الصحية، المساج
15 السياحة والضيافة الفنادق، الشقق الفندقية، المنتجعات، الاستراحات، قاعات المناسبات
16 المنظمات والجمعيات الجمعيات الخيرية، المنظمات المحلية، المنظمات الدولية، المؤسسات التنموية
17 الجهات الحكومية الوزارات، المكاتب التنفيذية، المحاكم، الشرطة، البلديات، المرافق العامة
18 الإعلام والإعلان الصحف، الإذاعات، وكالات الإعلان، التسويق الرقمي، الإنتاج الإعلامي
19 الرياضة والترفيه الأندية الرياضية، الصالات الرياضية، الملاعب، مراكز الألعاب، الحدائق
20 الطاقة والمرافق محطات الوقود، الغاز، الطاقة الشمسية، الكهرباء، المياه
21 الأسواق الشعبية الأسواق العامة، أسواق الجملة، أسواق الخضار، أسواق المواشي، الأسواق الموسمية
22 الحرف والصناعات التقليدية الخياطة، التطريز، الفخار، النجارة التقليدية، صياغة الذهب، الصناعات اليدوية
مراحل التحليل (22 مرحلة)
كل مجال فرعي في قاعدة البيانات يحتوي على هيكل تحليل متكامل مكون من 22 مرحلة:
# المرحلة الوصف
01 Project Discovery فهم المشروع، المشكلة، الحل، SWOT, PESTLE
02 Research بحث في جميع المصادر الممكنة
03 Business Analysis تحليل الأعمال والخدمات
04 Market Analysis تحليل السوق والمنافسين
05 Competitor Analysis تحليل المنافسين الرئيسيين
06 Stakeholders تحديد أصحاب المصلحة
07 User Research بناء Personas احترافية
08 Functional Analysis المتطلبات الوظيفية
09 Non-Functional Requirements المتطلبات غير الوظيفية
10 Information Architecture هيكل المعلومات
11 UX تجربة المستخدم
12 UI Design تصميم الواجهات
13 Database Design تصميم قاعدة البيانات
14 API Design تصميم API
15 Software Architecture بنية البرمجيات
16 Technical Stack التقنيات المقترحة
17 Security تحليل الأمان
18 SEO استراتيجية تحسين محركات البحث
19 Dashboard لوحة التحكم
20 Project Planning تخطيط المشروع
21 Documentation التوثيق
22 Final Deliverables المخرجات النهائية
ملاحظة : المستودع في وضع التطوير
نرحب بمساهماتكم في:
إضافة بيانات جديدة للمجالات الفرعية
إكمال تحليلات المجالات
اقتراح قطاعات أو مجالات جديدة
تحسين هيكل البيانات
للاستفسارات والاقتراحات، يرجى التواصل عبر:
البريد الإلكتروني: [tareq.software.devloper@gmail.com]
+967715299909
محافظة إب - اليمن 🇾🇪
Software Engineer: Tareq Al-Omari - طارق العمري
#DemoSoft
#IBBBusinessDatabase
#DemoSoft
#TareqAlOmari
#SoftwareEngineering
#SoftwareEngineer
#هندسة_البرمجيات
#مهندس_برمجيات
#تحليل_الأنظمة
#SystemAnalysis
#BusinessAnalysis
#تحليل_الأعمال
#RequirementsEngineering
#SoftwareArchitecture
#DatabaseDesign
#تصميم_قواعد_البيانات
#API_Design
#UXDesign
#UIDesign
#ProjectPlanning
#ProjectDiscovery
#MarketAnalysis
#تحليل_السوق
#DataAnalysis
#قواعد_البيانات
#مشاريع_برمجية
#مشاريع_تخرج
#أفكار_مشاريع
#مشاريع_تقنية
#InformationTechnology
#تقنية_المعلومات
#DigitalTransformation
#التحول_الرقمي
#OpenSource
#اليمن
#Yemen
#إب
#Ibb
#مبرمجين_اليمن
#مهندسين_اليمن
#التقنية_في_اليمن
+967715299909
محافظة إب - اليمن 🇾🇪
Software Engineer: Tareq Al-Omari - طارق العمري
#DemoSoft
#IBBBusinessDatabase
#DemoSoft
#TareqAlOmari
#SoftwareEngineering
#SoftwareEngineer
#هندسة_البرمجيات
#مهندس_برمجيات
#تحليل_الأنظمة
#SystemAnalysis
#BusinessAnalysis
#تحليل_الأعمال
#RequirementsEngineering
#SoftwareArchitecture
#DatabaseDesign
#تصميم_قواعد_البيانات
#API_Design
#UXDesign
#UIDesign
#ProjectPlanning
#ProjectDiscovery
#MarketAnalysis
#تحليل_السوق
#DataAnalysis
#قواعد_البيانات
#مشاريع_برمجية
#مشاريع_تخرج
#أفكار_مشاريع
#مشاريع_تقنية
#InformationTechnology
#تقنية_المعلومات
#DigitalTransformation
#التحول_الرقمي
#OpenSource
#اليمن
#Yemen
#إب
#Ibb
#مبرمجين_اليمن
#مهندسين_اليمن
#التقنية_في_اليمن