ai-security-battle/
├── database/                   # طبقة قاعدة البيانات
│   ├── schema.sql              # مخطط قاعدة البيانات
│   ├── db_config.py            # مدير قاعدة البيانات والمستودعات
│   ├── models.py               # نماذج البيانات
│   └── seed_data.py            # التهيئة ببيانات نموذجية
│
├── blue_team/                  # الفريق الأزرق (المدافعون)
│   ├── ml_models/              # نماذج التعلم الآلي للدفاع
│   ├── defenses/               # آليات الدفاع
│   ├── monitoring/             # أنظمة المراقبة
│   ├── api/                    # نقاط نهاية واجهة برمجة التطبيقات
│   └── blue_agent.py           # منسق الفريق الأزرق
│
├── red_team/                   # الفريق الأحمر (المهاجمون)
│   ├── attacks/                # تطبيقات الهجوم
│   ├── reconnaissance/         # الاستطلاع والمسح
│   ├── adaptation/             # التكيف الاستراتيجي
│   └── red_agent.py            # منسق الفريق الأحمر
│
├── battle_engine/              # تنسيق المعركة
│   ├── orchestrator.py         # وحدة التحكم الرئيسية في المعركة
│   ├── round_manager.py        # توقيت الجولة
│   ├── scoring_system.py       # تتبع النقاط
│   └── logger.py               # تسجيل الأحداث
│
├── shared/                     # الأدوات المشتركة
│   ├── config.py               # الإعدادات
│   ├── constants.py            # الثوابت والمحصورة
│   └── utils.py                # دوال مساعدة
│
├── results/                    # نتائج المعركة وسجلاتها
├── tests/                      # اختبارات الوحدة
├── docker/                     # إعدادات دوكر
├── requirements.txt            # تبعيات بايثون
├── setup.py                    # إعداد الحزمة
├── run_battle.py               # نقطة الدخول الرئيسية
└── README.md                   # هذا الملف

cd ai-security-battle

# إنشاء بيئة افتراضية (موصى به)
python -m venv venv
venv\Scripts\activate  # على ويندوز

# تثبيت التبعيات
pip install -r requirements.txt

python database/seed_data.py

# معركة قياسية (30 دقيقة، 10 جولات)
python run_battle.py

# معركة سريعة (10 دقائق، 5 جولات)
python run_battle.py --quick

# إعدادات مخصصة
python run_battle.py --rounds 8 --duration 20

# تهيئة قاعدة البيانات ثم التشغيل
python run_battle.py --init

pytest tests/ -v