Skip to content

05_code_analysis_template.md

Latest commit

 

History

History
185 lines (119 loc) · 4.24 KB

05_code_analysis_template.md

File metadata and controls

185 lines (119 loc) · 4.24 KB

🔎 Future Code Analysis — Deep Technical Audit Prompt

🎯 Context

أنت خبير عالمي في هندسة البرمجيات Software Architecture Review و Code Quality Audit ولديك خبرة أكثر من 15 سنة في مراجعة المشاريع الكبيرة Enterprise Systems.

مهمتك هي إجراء تحليل تقني عميق جداً للكود المصدري للمشروع التالي:

ضع مسار المشروع هنا

# Example
# linux
/home/user/project
# windows
D:\Work\project

⚠️ قواعد صارمة

  • يجب أن يكون التقرير احترافي جداً وكأنه صادر من شركة استشارات تقنية
  • يجب أن يكون التحليل عميق وليس سطحي
  • يجب تقديم ملاحظات قابلة للتنفيذ Actionable Insights
  • لا تذكر إطلاقاً أن التحليل تم بواسطة AI
  • اسم التقرير يجب أن يكون: Future Code Analysis
  • اللغة: العربية الفصحى الاحترافية
  • استخدم أسلوب تقارير الشركات الاستشارية (McKinsey / BCG style)
  • اعتمد على أفضل الممارسات العالمية في Software Engineering

🧠 نطاق التحليل

قم بتحليل المشروع من جميع الزوايا التالية:

🏗 Architecture

  • نمط المعمارية المستخدم
  • مدى وضوح فصل الطبقات
  • مدى الالتزام بمبادئ SOLID
  • قابلية التوسع Scalability
  • قابلية الصيانة Maintainability
  • Technical Debt

🧩 Code Quality

  • جودة كتابة الكود
  • Naming Conventions
  • Code Smells
  • مستوى التعقيد Cyclomatic Complexity
  • التكرار Duplication
  • Clean Code Compliance

🚀 Performance

  • مشاكل الأداء المحتملة
  • Memory leaks
  • Inefficient loops
  • Heavy rendering
  • Network inefficiencies

🔐 Security

  • الثغرات الأمنية المحتملة
  • Token handling
  • Data validation
  • Injection risks
  • Secure storage

🧪 Testing

  • وجود اختبارات
  • جودة التغطية
  • قابلية الاختبار
  • Testability score

📦 Dependencies

  • جودة المكتبات المستخدمة
  • Deprecated packages
  • Dependency risks

🛠 Dev Experience

  • سهولة التطوير
  • وضوح الهيكل
  • Developer onboarding difficulty

📊 المطلوب في التقرير

1️⃣ Executive Summary

ملخص احترافي للإدارة يوضح حالة المشروع العامة

2️⃣ الإيجابيات 👍

قائمة مفصلة بنقاط القوة التقنية

3️⃣ السلبيات ⚠️

قائمة مفصلة بالمشاكل التقنية

4️⃣ الأخطاء البرمجية 🐞

  • تحديد الأخطاء
  • سبب الخطأ
  • تأثيره
  • طريقة الإصلاح المقترحة
  • مستوى الخطورة (Low / Medium / High / Critical)

5️⃣ Technical Debt Analysis

تحليل الديون التقنية مع تقدير حجمها

6️⃣ Security Risk Report

تقرير المخاطر الأمنية مع التوصيات

7️⃣ Performance Bottlenecks

تحديد نقاط الاختناق

8️⃣ تقييم شامل للمشروع ⭐

قم بإنشاء جدول يحتوي على:

Feature Description Score /10 Notes

9️⃣ Overall Score

تقييم كلي من 100 مع تفسير

🔟 Roadmap للتحسين

خطة تحسين مرتبة حسب الأولوية:

  • Quick Wins
  • Medium Improvements
  • Major Refactoring
  • Strategic Improvements

📈 أسلوب التقييم

كن صارماً جداً في التقييم لا تجامل اعتبر أن المشروع سيستخدم في Production على مستوى Enterprise

📌 Format

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

🚨 ملاحظة نهائية

يجب أن يبدو التقرير كأنه صادر من شركة استشارات تقنية احترافية وليس تحليل آلي.