محلّل بنيوي ساكن مبني على محرّك Roslyn لاستخراج الشجرة التركيبية الكاملة لمشاريع ASP.NET Core MVC
يُحصي كل صنف وواجهة وتعداد ومفوّض وبنية مع تحليل الفجوات بين المشاريع
dotnet tool install --global MvcStructureInspector
اجتياز شامل لشجرة التركيب المجرّدة (AST) عبر محرّك Roslyn لاستخلاص فضاءات الأسماء، الأصناف، الواجهات، التعدادات، المفوّضات، البُنى، مع إحصاء دقيق للتوابع والخصائص والحقول
مقارنة بنيوية بين مشروعين لرصد الملفات المفقودة، التوابع المتباينة التوقيعات، وعناصر العرض (Razor Views) غير المتطابقة مع تقرير تفصيلي مُصنّف
فحص ومقارنة ملفات .csproj و .sln لتحديد فروقات أُطُر العمل المستهدفة، حزم NuGet، ومرجعيات المشاريع عبر الحلّ (Solution)
طبقة حماية تمنع الكتابة فوق الملفات التنفيذية والمصدرية (.exe, .dll, .cs, .wasm) مع ضمان الترقيم الزمني الفريد لكل تقرير للحفاظ على السجل التاريخي
الفتح الآلي للتقارير المُنتجة عبر المعامل --open أو الأمر الفرعي open لعرضها مباشرة في المحرّر الافتراضي للنظام
نظام ترقيم زمني تلقائي بصيغة (yyyyMMdd_HHmmss) يضمن عدم فقدان أي تقرير ويتيح المقارنة التتبعية بين عمليات الفحص المتعاقبة
يستقبل المحلّل مسار المشروع ويفهرس جميع ملفات .cs و .cshtml مع استبعاد المجلدات المولّدة آلياً (bin/, obj/, Migrations/)
يُمرَّر كل ملف إلى محرّك Roslyn الذي يولّد شجرة التركيب المجرّدة (AST) ويستخرج العقد النحوية: الأصناف، الواجهات، التعدادات، المفوّضات، البُنى
يُعاد بناء البيانات المستخرجة في شجرة نصية هرمية مع مؤشرات الفروع (├── / └──) وإحصاءات الأعضاء لكل كيان برمجي
mvc-inspect --path ./MyProject --out report.txtmvc-inspect --compare ./ProjectA --path ./ProjectB --out gap.txtmvc-inspect --compare ./ProjectA --path ./ProjectB --with-projmvc-inspect --path ./MyProject --openmvc-inspect open ./mvc-structure_20261205_143000.txt| المعامل | الوصف | النوع |
|---|---|---|
--path <dir> |
مسار الدليل الجذري للمشروع المراد تحليله | سلسلة نصية |
--out <file> |
مسار ملف الإخراج (اختياري — الافتراضي: ترقيم زمني تلقائي) | سلسلة نصية |
--compare <dir> |
مسار المشروع المرجعي لتحليل الفجوات (المشروع الأول في المقارنة) | سلسلة نصية |
--with-proj |
تضمين تحليل ملفات بيئة المشروع (.csproj) والحلّ (.sln) في المقارنة | راية منطقية |
--open |
فتح التقرير المُنتَج تلقائياً في المحرّر الافتراضي للنظام | راية منطقية |
--no-views |
استبعاد عناصر العرض (Razor Views) من عملية التحليل | راية منطقية |
--cs-only |
تقييد التحليل لملفات الشيفرة المصدرية C# فقط | راية منطقية |
--no-migrations |
استبعاد ملفات ترحيل قاعدة البيانات (Migrations) من نطاق الفحص | راية منطقية |
open <file> |
أمر فرعي لفتح ملف تقرير محدد مباشرة | أمر فرعي |
تحليل أمني ساكن يُنفَّذ تلقائياً على كل عملية دفع (Push) وأسبوعياً لاكتشاف الثغرات الأمنية المحتملة
57 حالة اختبار تغطي محرّكات التحليل وحارس الأمان ومحلّل ملفات المشروع — تُنفَّذ إلزامياً قبل كل عملية نشر
توليد تلقائي لقائمة مواد البرمجيات بمعيار CycloneDX مُرفقة مع كل إصدار لضمان الشفافية الكاملة للتبعيات
قائمة سوداء صارمة تمنع الكتابة إلى الامتدادات المحمية (.exe, .dll, .wasm, .cs, .csproj) لضمان نزاهة الشيفرة المصدرية
جميع تقارير الأمان والتحليل متاحة في تبويب الإصدارات بمستودع المشروع.
إضافة حارس أمان المخرجات (SecurityGuard)، مجموعة اختبارات شاملة (57 حالة اختبار)، وبنية التكامل المستمر والنشر المستمر (CI/CD) على GitHub Actions
دعم تحليل ومقارنة ملفات بيئة المشروع (.csproj) والحلّ (.sln) عبر المعامل --with-proj
إضافة المعامل --open والأمر الفرعي open <file> للعرض الديناميكي للتقارير
نظام الترقيم الزمني التلقائي لمنع الكتابة فوق السجلات السابقة والحفاظ على المسار التدقيقي
محرّك تحليل الفجوات بين المشاريع مع تقارير GAP التفصيلية المُصنّفة
الإصدار التأسيسي: محلّل الشجرة البنيوية النصية عبر محرّك Roslyn