Upload folder using huggingface_hub

.env.example

@@ -0,0 +1,178 @@
+# إعدادات بيئة نظام الحارس التلقائي
+# Auto Guardian System Environment Configuration
+# ==============================================
+
+# IMPORTANT: هذا ملف نموذجي. انسخه إلى .env وأضف قيمك الفعلية.
+# cp .env.example .env
+
+# ===============================
+# إعدادات الوضع العام
+# ===============================
+
+# وضع التشغيل: development, testing, production
+mode: development
+
+# مستوى التسجيل: DEBUG, INFO, WARNING, ERROR, CRITICAL
+log_level: INFO
+
+# المنطقة الزمنية (استخدم تنسيق tzdata)
+timezone: UTC
+
+# ===============================
+# إعدادات API والخادم
+# ===============================
+
+# عنوان واجهة برمجة التطبيقات
+api_host: "0.0.0.0"
+api_port: 8000
+
+# مفتاح سري لتوقيع الرموز (تغييره في الإنتاج!)
+secret_key: "your-super-secret-key-change-this-in-production"
+
+# فترة انتهاء رمز JWT (بالساعات)
+jwt_expiration_hours: 24
+
+# تفعيل HTTPS في الإنتاج
+use_https: false
+
+# مسار ملف الشهادة (للإنتاج فقط)
+ssl_cert: ""
+ssl_key: ""
+
+# ===============================
+# إعدادات المراقبة
+# ===============================
+
+# تفعيل المراقبة
+monitoring_enabled: true
+
+# الفاصل الزمني للفحص (بالثواني)
+scan_interval: 5
+
+# مصادر السجلات للمراقبة (مفصولة بفواصل)
+log_sources:
+  - /var/log/auth.log
+  - /var/log/syslog
+
+# تفعيل الفحص العميق
+deep_scan: false
+
+# ===============================
+# إعدادات الحظر
+# ===============================
+
+# تفعيل الحظر التلقائي
+blocking_enabled: true
+
+# عدد المحاولات قبل الحظر
+block_threshold: 5
+
+# الفترة الزمنية للمحاولات (بالثواني)
+block_timewindow: 60
+
+# تفعيل IPTables للحظر
+use_iptables: true
+
+# تفعيل الجدار الناري (firewalld)
+use_firewalld: false
+
+# قائمة العناوكات المسموح بها (لا تُحظر)
+whitelist_ips: []
+
+# قائمة العناوكات المحظورة دائماً
+blacklist_ips: []
+
+# ===============================
+# إعدادات الإشعارات
+# ===============================
+
+# تفعيل الإشعارات
+notifications_enabled: true
+
+# ---- Slack ----
+slack_enabled: false
+slack_webhook_url: ""
+slack_channel: "security-alerts"
+slack_username: "Auto-Guardian"
+slack_icon_emoji: ":shield:"
+
+# ---- Discord ----
+discord_enabled: false
+discord_webhook_url: ""
+discord_username: "Auto-Guardian"
+
+# ---- البريد الإلكتروني ----
+email_enabled: false
+email_smtp_host: "smtp.gmail.com"
+email_smtp_port: 587
+email_use_tls: true
+email_username: ""
+email_password: ""
+email_from: "noreply@autoguardian.local"
+email_to: []
+
+# ===============================
+# إعدادات Prometheus
+# ===============================
+
+# تفعيل Prometheus
+prometheus_enabled: true
+
+# منفذ Prometheus
+prometheus_port: 9090
+
+# تفعيل مسار /metrics
+prometheus_metrics_path: "/metrics"
+
+# ===============================
+# إعدادات التخزين
+# ===============================
+
+# مسار مجلد السجلات
+log_path: "logs/"
+
+# مسار مجلد البيانات
+data_path: "data/"
+
+# تفعيل قاعدة البيانات
+database_enabled: false
+database_url: "sqlite:///data/autoguardian.db"
+
+# ===============================
+# إعدادات الأمان
+# ===============================
+
+# تفعيل التحقق من التحديثات الأمنية
+security_checks: true
+
+# فترة التحقق من التحديثات (بالساعات)
+security_check_interval: 24
+
+# تفعيل تسجيل جميع الإجراءات
+audit_logging: true
+
+# مسار ملف سجل التدقيق
+audit_log_path: "logs/audit.log"
+
+# ===============================
+# إعدادات Docker
+# ===============================
+
+# اسم الحاوية في Docker
+docker_container_name: "auto-guardian-system"
+
+# الشبكة في Docker
+docker_network: "security-network"
+
+# ===============================
+# إعدادات خارجية (اختياري)
+# ===============================
+
+# Cloudflare API (لحظر العناوكات على الحافة)
+cloudflare_enabled: false
+cloudflare_api_token: ""
+cloudflare_zone_id: ""
+
+#바이러스 보호 API
+virustotal_enabled: false
+virustotal_api_key: ""

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,60 @@
+---
+name: "\U0001F41B الإبلاغ عن خطأ"
+about: الإبلاغ عن خطأ أو مشكلة في نظام الحارس التلقائي
+title: "[BUG] "
+labels: "bug"
+assignees: ""
+---
+
+## وصف المشكلة
+
+[وصف واضح ومختصر للمشكلة. ما الذي حدث؟ ما كان يجب أن يحدث؟]
+
+## خطوات إعادة الإنتاج
+
+يرجى تقديم خطوات واضحة ومحددة لإعادة إنتاج المشكلة:
+
+1. [الخطوة الأولى]
+2. [الخطوة الثانية]
+3. [الخطوة الثالثة]
+...
+
+## السلوك المتوقع
+
+[وصف لما كنت تتوقع أن يحدث]
+
+## السلوك الفعلي
+
+[وصف لما حدث فعلاً]
+
+## بيئة التشغيل
+
+يرجى تحديد بيئتك:
+
+- **نظام التشغيل:** [مثل: Ubuntu 20.04 LTS / Debian 11 / CentOS 8]
+- **إصدار Python:** [مثل: Python 3.9.0]
+- **إصدار النظام:** [مثل: v1.2.0]
+- **طريقة التثبيت:** [Docker / PIP / Git]
+- **إعدادات مخصصة:** [إن وُجدت]
+
+## لقطات الشاشة أو السجلات
+
+[إذا كانت هناك لقطات شاشة أو سجلات ذات صلة، يرجى إرفاقها هنا]
+
+```
+[أضف السجلات هنا إن كانت مفيدة]
+```
+
+## معلومات إضافية
+
+[أي معلومات إضافية قد تكون مفيدة لتشخيص المشكلة، مثل:]
+- الأوامر التي استخدمتها
+- التغييرات الأخيرة التي أجريتها
+- معلومات أخرى ذات صلة
+
+---
+
+**قبل إرسال التقرير:**
+- [ ] تأكد من أن المشكلة لم تُبلَّغ من قبل (ابحث في Issues الموجودة)
+- [ ] جرب تحديث النظام إلى أحدث إصدار
+- [ ] راجع التوثيق للتأكد من أنك تستخدم النظام بشكل صحيح

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,40 @@
+---
+name: "\U0001F4A1 طلب ميزة"
+about: اقتراح ميزة جديدة أو تحسين لنظام الحارس التلقائي
+title: "[FEATURE] "
+labels: "enhancement"
+assignees: ""
+---
+
+## وصف الميزة المقترحة
+
+[وصف واضح ومختصر للميزة التي تقترحها. ما الذي يجب أن يفعله النظام؟]
+
+## المشكلة التي تحلها هذه الميزة
+
+[كيف ستساعد هذه الميزة المستخدمين؟ ما هي المشكلة التي تحلها؟]
+
+## الحل المقترح
+
+[وصف لكيفية تنفيذ الميزة المقترحة إن أمكن. يمكنك إضافة:]
+- واجهة المستخدم المقترحة
+- التغييرات التقنية المطلوبة
+- أي API endpoints جديدة إن وُجدت
+
+## البدائل المدروسة
+
+[هل فكرت في طرق بديلة لتنفيذ هذه الميزة؟ ما هي إيجابيات وسلبيات كل طريقة؟]
+
+## معلومات إضافية
+
+[أي موارد، أمثلة، أو مراجع ذات صلة:]
+- المشاريع المماثلة التي تحتوي على هذه الميزة
+- وثائق ذات صلة
+- أي أفكار أخرى
+
+---
+
+**قبل إرسال طلب الميزة:**
+- [ ] تأكد من أن الميزة لم تُطلب من قبل (ابحث في Issues الموجودة)
+- [ ] فكر فيما إذا كانت الميزة تتوافق مع أهداف المشروع
+- [ ] كن مستعداً لمناقشة التفاصيل والمقايضات

.github/ISSUE_TEMPLATE/security_report.md

@@ -0,0 +1,63 @@
+---
+name: "\U0001F512 الإبلاغ عن ثغرة أمنية"
+about: الإبلاغ عن ثغرة أمنية أو مشكلة أمان في نظام الحارس التلقائي
+title: "[SECURITY] "
+labels: "security"
+assignees: ""
+---
+
+## وصف الثغرة
+
+[وصف واضح ومختصر للثغرة الأمنية المكتشفة. لا تكشف التفاصيل التقنية الكاملة هنا.]
+
+## نوع الثغرة
+
+[حدد نوع الثغرة:]
+- [ ] تنفيذ كود عن بُعد (RCE)
+- [ ] رفع امتيازات
+- [ ] تجاوز المصادقة
+- [ ] حقن SQL
+- [ ] Cross-Site Scripting (XSS)
+- [ ] حقن أوامر
+- [ ] كشف معلومات حساسة
+- [ ] أخرى: __________
+
+## مستوى الخطورة
+
+[تقديرك لمستوى خطورة الثغرة:]
+- [ ] حرجة - يمكن استغلالها بسهولة ولها تأثير كبير
+- [ ] عالية - يمكن استغلالها ولها تأثير كبير
+- [ ] متوسطة - يصعب استغلالها أو لها تأثير محدود
+- [ ] منخفضة - يصعب استغلالها ولها تأثير محدود جداً
+
+## خطوات إعادة الإنتاج
+
+1. [الخطوة الأولى]
+2. [الخطوة الثانية]
+3. [...]
+
+(لا تكشف تفاصيل الاستغلال الكاملة هنا)
+
+## التأثير المحتمل
+
+[ما هو التأثير المحتمل لهذه الثغرة؟]
+
+## معلومات إضافية
+
+[أي معلومات إضافية قد تكون مفيدة:]
+- بيئة الاختبار
+- أدوات المستخدم
+- إصدارات البرامج ذات الصلة
+
+---
+
+## للاتصال المباشر
+
+للإبلاغ عن الثغرات بشكل خاص، يرجى الاتصال مباشرة:
+
+- **البريد الإلكتروني:** security@autoguardian.local
+- **مستوى الاستجابة:** نعد بالرد خلال 48 ساعة
+
+---
+
+**ملاحظة:** نتبع مبدأ الإبلاغ المسؤول. لن نتخذ أي إجراء قانوني ضد الباحثين الأمنيين الذين يبلغون عن الثغرات بشكل مسؤول وفقاً لسياسة الأمن الخاصة بنا.

.github/pull_request_template.md

@@ -0,0 +1,68 @@
+## وصف التغييرات
+
+[وصف موجز وواضح لما يفعله طلب الدمج هذا. ما هي التغييرات التي أجريتها؟]
+
+## نوع التغيير
+
+- [ ] **إصلاح خطأ (Bug Fix)** - إصلاح مشكلة في الكود الموجود
+- [ ] **ميزة جديدة (New Feature)** - إضافة وظيفة جديدة
+- [ ] **تحسين (Enhancement)** - تحسين أو توسيع ميزة موجودة
+- [ ] **تغيير في التوثيق (Documentation)** - تغييرات في التوثيق فقط
+- [ ] **إعادة هيكلة (Refactoring)** - تغيير في بنية الكود دون تغيير الوظيفة
+- [ ] **اختبارات (Tests)** - إضافة أو تعديل اختبارات
+- [ ] **بناء (Build)** - تغييرات في أدوات البناء أو التكوين
+- [ ] **أخرى:** ____________
+
+## التحقق من الصحة
+
+قبل إرسال طلب الدمج، يرجى التأكد من:
+
+- [ ] **الاختبارات:** اجتازت جميع الاختبارات الموجودة (`pytest` يمر بنجاح)
+- [ ] **الاختبارات الجديدة:** أضفت اختبارات للوظائف الجديدة (إن وُجدت)
+- [ ] **جودة الكود:** التزمت بمعايير كتابة الكود (`black`, `flake8`, `isort`)
+- [ ] **التوثيق:** حدّثت التوثيق إذا قمت بتغيير واجهة برمجة التطبيقات
+- [ ] **التعارضات:** لا توجد تعارضات مع الفرع الرئيسي
+- [ ] **الفحص:** اجتاز فحص GitHub Actions بنجاح
+
+## الحالات المُختبرة
+
+[اشرح الحالات التي اختبرتها يدوياً:]
+- [ ] الحالة الأولى: [...]
+- [ ] الحالة الثانية: [...]
+- [ ] ...
+
+## لقطات الشاشة
+
+[إذا كانت التغييرات مرئية (واجهة مستخدم، رسومات، إلخ)، أضف لقطات شاشة توضح قبل وبعد:]
+
+## قائمة المهام المنجزة
+
+- [ ] المهمة الأولى المنجزة
+- [ ] المهمة الثانية المنجزة
+- [ ] ...
+
+## المراجع ذات الصلة
+
+[أي مراجع ذات صلة:]
+- Issues ذات صلة: #123, #456
+- Pull Requests ذات صلة: #789
+- وثائق ذات صلة: [...]
+- مناقشات: [...]
+
+## معلومات إضافية
+
+[أي معلومات إضافية قد تكون مفيدة للمراجعين:]
+
+---
+
+## للتواصل
+
+- **البريد الإلكتروني:** [بريدك الإلكتروني]
+- **GitHub:** [@اسم_المستخدم]
+
+---
+
+**قبل إرسال طلب الدمج:**
+- [ ] تأكد من أن عنوان الطلب واضح ومختصر
+- [ ] راجع طلب الدمج للتأكد من أنه يحتوي على جميع المعلومات اللازمة
+- [ ] تأكد من أن الكود يتبع معايير المشروع

.gitignore

@@ -0,0 +1,307 @@
+# إعدادات استبعاد Git
+# Git Ignore Configuration for Auto Guardian System
+# ==================================================
+
+# ===============================
+# Python
+# ===============================
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments
+venv/
+ENV/
+env/
+.venv/
+env.bak/
+venv.bak/
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+coveragereport/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env.local
+.env.*.local
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# ===============================
+# IDEs and Editors
+# ===============================
+
+# VS Code
+.vscode/
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+# JetBrains
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# Vim
+[._]*.s[a-w][a-z]
+[._]swa
+*.un~
+
+# Emacs
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# ===============================
+# OS Files
+# ===============================
+
+# macOS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Linux
+.nfs*
+*~
+
+# Windows
+Thumbs.db:encryptable
+ehthumbs.db
+*.lnk
+
+# ===============================
+# Logs and Data
+# ===============================
+
+*.log
+logs/
+*.log.*
+*.sqlite3
+*.db
+*.sqlite3-journal
+
+# Session data
+*.session.vim
+
+# Temporary files
+*.tmp
+*.bak
+*.backup
+*~
+\#*\#
+._*
+
+# Backup files
+*.bak
+*.backup
+*~
+.*.swp
+*.swo
+
+# ===============================
+# Security
+# ===============================
+
+*.pem
+*.key
+*.crt
+*.pub
+!public.pem
+
+# SSH
+~/.ssh/id_rsa
+~/.ssh/id_rsa.pub
+~/.ssh/known_hosts
+
+# GPG
+~/.gnupg/
+
+# Secrets
+secrets.json
+credentials.json
+token.json
+
+# ===============================
+# Testing
+# ===============================
+
+.pytest_cache/
+.hypothesis/
+.coverage.*
+htmlcov/
+
+# Test data
+tests/data/*
+!tests/data/.gitkeep
+
+# ===============================
+# Build
+# ===============================
+
+build/
+dist/
+*.egg-info/
+*.whl
+*.pyz
+*.tar.gz
+
+# Docker
+.docker/
+
+# ===============================
+# Documentation
+# ===============================
+
+docs/_build/
+docs/.doctrees/
+
+# Translation
+locale/
+
+# ===============================
+# Temporary
+# ===============================
+
+.temp/
+tmp/
+temp/
+*.temp
+*.tmp
+
+# Cache
+.cache/
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+
+# ===============================
+# Third-party
+# ===============================
+
+node_modules/
+bower_components/

CHANGELOG.md

@@ -0,0 +1,199 @@
+# سجل التغييرات
+
+<div align="center">
+
+![Auto Guardian System](assets/banner.svg)
+
+**نظام ذكي لحماية الخوادم من التهديدات الإلكترونية**
+
+</div>
+
+---
+
+## مقدمة
+
+ملف سجل التغييرات هذا يوثق جميع الإصدارات والتحديثات الرئيسية لنظام الحارس التلقائي. يُرجى قراءة هذا الملف بانتظام للاطلاع على جديد المشروع والتحسينات المضافة.
+
+نتبع تنسيق [Keep a Changelog](https://keepachangelog.com/) الموصى به لمشاريع مفتوحة المصدر.
+
+---
+
+## جدول المحتويات
+
+- [الإصدار 1.3.0 - التطوير النشط](#الإصدار-130---التطوير-النشط)
+- [الإصدار 1.2.0 - تكامل المنصات](#الإصدار-120---تكامل-المنصات)
+- [الإصدار 1.1.0 - تحسين الأداء](#الإصدار-110---تحسين-الأداء)
+- [الإصدار 1.0.0 - الإطلاق الأولي](#الإصدار-100---الإطلاق-الأولي)
+- [غير مُصدر](#غير-مُصدر)
+
+---
+
+## الإصدار 1.3.0 - التطوير النشط
+
+**تاريخ الإصدار:** قيد التطوير
+
+### المضاف
+
+- دعم Docker Compose للنشر السريع
+- إضافة ملف Makefile لتسهيل مهام التطوير
+- دعم تنسيق CodeQL للفحص الأمني المتقدم
+- إضافة ملف .editorconfig للتنسيق المتسق
+- دعم اللغة الإنجليزية (i18n)
+- إضافة نظام المقاييس Prometheus
+- لوحة مراقبة تفاعلية للمراحل الأربع
+- أمثلة عملية لحالات الاستخدام المختلفة
+
+### المُحسّن
+
+- تحديث التوثيق الشامل مع رسومات توضيحية
+- تحسين هيكل ملف README.md
+- إضافة قسم المساهمة المجتمعية
+- إضافة خارطة طريق مستقبلية
+- تحسين أمثلة الكود والتوثيق التقني
+
+### المُصحح
+
+- إصلاح مشكلة عرض المخططات على الشاشات الصغيرة
+- تحسين التوافق مع GitHub Pages
+
+### الأمان
+
+- إضافة ملف SECURITY.md لسياسة الإبلاغ عن الثغرات
+- تحديث مدونة السلوك
+
+---
+
+## الإصدار 1.2.0 - تكامل المنصات
+
+**تاريخ الإصدار:** 2024-10-15
+
+### المضاف
+
+- دعم إشعارات Slack المتكامل
+- دعم إشعارات Discord عبر Webhooks
+- نظام تنبيهات متعدد المنصات
+- قابلية تخصيص محتوى الإشعارات
+- دعم الرموز التعبيرية في الإشعارات
+
+### المُحسّن
+
+- تحسين سرعة إرسال الإشعارات بنسبة 60%
+- إضافة قوالب رسائل جاهزة
+- تحسين معالجة الأخطاء في نظام الإشعارات
+- إضافة خيارات التخصيص المتقدمة
+
+### المُصحح
+
+- إصلاح مشكلة الاتصال بـ Slack Webhooks
+- حل مشكلة تأخر إشعارات Discord
+- إصلاح مشكلة الأحرف العربية في الإشعارات
+
+---
+
+## الإصدار 1.1.0 - تحسين الأداء
+
+**تاريخ الإصدار:** 2024-09-28
+
+### المضاف
+
+- وضع الفحص المُحسّن لاستخدام أقل للذاكرة
+- دعم التخزين المؤقت للنتائج
+- وضع التشغيل الليلي لتوفير الموارد
+- نظام التقارير الدورية الآلي
+
+### المُحسّن
+
+- تحسين استهلاك الذاكرة بنسبة 40%
+- تسريع عملية الفحص بنسبة 35%
+- تحسين دقة اكتشاف التهديدات
+- تقليل الإيجابيات الكاذبة بنسبة 25%
+
+### المُصحح
+
+- إصلاح تسرب الذاكرة في وضع التشغيل الطويل
+- حل مشكلة التحديث في الوقت الفعلي
+- إصلاح مشكلة قراءة السجلات المشفرة
+
+---
+
+## الإصدار 1.0.0 - الإطلاق الأولي
+
+**تاريخ الإصدار:** 2024-09-01
+
+### المضاف
+
+- نظام المراقبة اللحظية للسجلات
+- محلل أنماط التهديدات المتقدم
+- التكامل مع IPTables للحظر التلقائي
+- دعم بروتوكول SSH لمراقبة الاختراقات
+- دعم اكتشاف المسح الضوئي للمنافذ
+- نظام تنبيهات عبر Webhooks
+- واجهة سطر أوامر سهلة الاستخدام
+- ملف README.md التوثيقي
+- رخصة MIT مفتوحة المصدر
+
+### المميزات الرئيسية
+
+- ✅ مراقبة 24/7 لسجلات النظام
+- ✅ كشف تلقائي للتهديدات
+- ✅ حظر فوري للعناوات المشبوهة
+- ✅ إشعارات فورية عبر Slack/Discord
+- ✅ دعم متعدد للغات البرمجة
+- ✅ بوابة جودة للكود
+
+### التقنيات المدعومة
+
+| اللغة | الأدوات المدعومة |
+|-------|------------------|
+| Python | Flake8, Pylint, Black |
+| JavaScript/TypeScript | ESLint, Prettier |
+| YAML | Custom parser |
+| Java | Checkstyle (قريباً) |
+| Go | golint (قريباً) |
+| Rust | clippy (قريباً) |
+
+---
+
+## غير مُصدر
+
+### قيد التطوير
+
+- [ ] دعم إشعارات البريد الإلكتروني (SMTP)
+- [ ] لوحة ويب لإدارة العناورات المحظورة
+- [ ] دعم Docker للنشر السريع
+- [ ] إدارة قائمة السماح (Whitelist)
+- [ ] تكامل مع Cloudflare
+- [ ] تقارير أمان دورية
+- [ ] وضع التعلم الآلي للتهديدات الجديدة
+- [ ] واجهة REST API
+- [ ] دعم IPv6 الكامل
+- [ ] اختبارات أداء متقدمة
+
+---
+
+## كيفية المساهمة
+
+إذا كنت تريد المساهمة في تطوير المشروع، يمكنك:
+
+1. استنساخ المستودر وإنشاء فرع جديد
+2. إضافة ميزات أو إصلاح أخطاء
+3. تحديث هذا الملف بالشكل المناسب
+4. إرسال طلب دمج للمراجعة
+
+راجع ملف [CONTRIBUTING.md](CONTRIBUTING.md) للمزيد من التفاصيل.
+
+---
+
+## إخلاء المسؤولية
+
+نظام الحارس التلقائي يُقدم "كما هو" دون أي ضمانات. المستخدم مسؤول عن اختبار النظام في بيئة آمنة قبل نشره على الإنتاج.
+
+---
+
+<div align="center">
+
+**صُنع بـ ❤️ بواسطة عبد الإله عثمان غويث**
+
+*آخر تحديث: 2024-10-13*
+
+</div>

CODE_OF_CONDUCT.md

@@ -0,0 +1,265 @@
+# مدونة سلوك المجتمع
+
+<div align="center">
+
+![Auto Guardian System](assets/banner.svg)
+
+**نظام ذكي لحماية الخوادم من التهديدات الإلكترونية**
+
+</div>
+
+---
+
+## مقدمة
+
+نرحب بجميع الأفراد الذين يشاركون في مجتمعات نظام الحارس التلقائي سواء كانوا مطورين أو مستخدمين أو مساهمين أو زواراً. ملتزمون بتوفير بيئة مرحبية وآمنة للجميع، بغض النظر عن العمر أو الهوية أو الخبرة.
+
+هذا المستند يوضح توقعاتنا السلوكية والآداب التي يجب على جميع المشاركين الالتزام بها. إذا لم توافق على هذه المدونة، نأسف لإبلاغك بأنك لا تستطيع المشاركة في مجتمعاتنا.
+
+---
+
+## قيمنا
+
+نؤمن بأن مجتمعاً متنوعاً ومتشملاً يُنتج برمجيات أفضل وأكثر أماناً. نلتزم بقيم الاحترام المتبادل والتعاون البنّاء والتعلم المستمر والتطوير المفتوح. نرحب بوجهات النظر المختلفة ونعتبرها ثروة حقيقية تُثري المشروع وتُحسّنه.
+
+نهدف لخلق بيئة يشعر فيها الجميع بالأمان للمساهمة والإبداع والتعلم. نشجع على طرح الأسئلة والمشاركة في النقاشات وتقديم الآراء المختلفة حتى لو كانت مخالفة للرأي السائد. الاحترام لا يعني الموافقة، بل يعني التعامل بلباقة مع الاختلافات.
+
+---
+
+## معايير السلوك
+
+### السلوك المتوقع
+
+نشجع ونُقدّر السلوكيات التالية من جميع المشاركين:
+
+**الاحترام واللطف:**
+
+التعامل مع الآخرين بلطف واحترام في جميع التفاعلات. استخدام لغة welcome ومرحبة في النقاشات. الاعتراف بجهل الآخرين وتوجيههم بلطف دون السخرية أو الازدراء. الرد على الأسئلة والأسئلة الجديدة بصبر وود.
+
+**الانفتاح والتشمل:**
+
+الانفتاح على الأفكار والآراء الجديدة المختلفة عن أفكارك. الترحيب بالمساهمين الجدد ومساعدتهم على البدء. تقديم النقد بشكل بناء ومفيد. الاعتراف بجهود الآخرين وتقديرها.
+
+**المسؤولية والمصداقية:**
+
+الالتزام بالوعود والالتزامات المتفق عليها. الاعتراف بالأخطاء وتعلم منها. طلب المساعدة عند الحاجة دون خجل. مشاركة المعرفة مع الآخرين بشكل سخي.
+
+**التركيز على الهدف:**
+
+الانتباه للموضوع الأساسي في النقاشات. تقديم معلومات دقيقة ومفيدة. البقاء هادئاً في حالات الاختلاف. السعي للحلول بدلاً من إلقاء اللوم.
+
+### السلوك غير المقبول
+
+السلوكيات التالية غير مقبولة في مجتمعاتنا:
+
+**التحرش والتمييز:**
+
+التحرش يشمل التعليقات اللفظية أو المكتوبة المتعلقة بالجنس أو التوجه الجنسي أو الهوية أو الإعاقة أو المظهر الجسدي أو العرق أو الدين. التمييز على أي أساس مرفوض تماماً. لا مكان للتحرش أو التمييز في مجتمعنا.
+
+**الهجمات الشخصية والشتم:**
+
+الهجمات الشخصية والشتائم لا مكان لها في نقاشاتنا. لا يجوز إهانة الآخرين أو السخرية منهم أو مضايقتهم. النقد يجب أن يكون لل الأفكار لا للأشخاص. تجنب استخدام لغة عدوانية أو هجومية.
+
+**الإعلانات غير المرغوبة:**
+
+نشر محتوى غير مرغوب فيه مثل الإعلانات أو المواد التجارية أو رسائل السبام غير مسموح به. لا يجوز نشر روابط لمواقع خبيثة أو محتوى غير أخلاقي. الترويج للمنتجات يجب أن يكون في القنوات المخصصة.
+
+**انتهاك الخصوصية:**
+
+نشر معلومات شخصية للآخرين دون إذنهم غير مسموح. مشاركة بيانات حساسة أو أسرار. تصوير أو تسجيل المحادثات بدون موافقة.
+
+---
+
+## المسؤوليات
+
+### مسؤوليات المشرفين
+
+المشرفين على القنوات والمسودات مسؤولون عن:
+
+**تطبيق المدونة:**
+
+تطبيق هذه المدونة بشكل عادل ومتسق على جميع ال��شاركين. اتخاذ إجراءات فورية عند الإبلاغ عن سلوك غير مقبول. الحفاظ على سجلات للإجراءات المتخذة.
+
+**الدعم والإرشاد:**
+
+توجيه المشاركين الجدد حول قواعد المجتمع. تقديم الدعم للمتضررين من السلوك غير المقبول. الإجابة على الأسئلة وتوضيح الغموض.
+
+**اتخاذ القرارات:**
+
+تقييم البلاغات واتخاذ قرارات مناسبة. استشارة الفريق الأكبر في الحالات المعقدة. البقاء موضوعيين وتجنب التحيز.
+
+### مسؤوليات المشاركين
+
+جميع المشاركين مسؤولون عن:
+
+- الالتزام بهذه المدونة في جميع التفاعلات
+- الإبلاغ عن السلوك غير المقبول عند witnessed
+- التعاون مع المشرفين في التحقيقات
+- احترام قرارات المشرفين
+
+---
+
+## نطاق التطبيق
+
+هذه المدونة تنطبق على جميع مساحات المشروع:
+
+**مساحات GitHub:**
+
+- جميع المستودرات والـ Issues و Pull Requests
+- التعليقات على الـ Issues و PRs
+- النقاشات (Discussions)
+- Wiki
+
+**قنوات التواصل:**
+
+- منتديات النقاش والمحادثات
+- البريد الإلكتروني المتعلق بالمشروع
+- قنوات Discord أو Slack المخصصة
+- وسائل التواصل الاجتماعي
+
+**الفعاليات:**
+
+- المؤتمرات واللقاءات المادية
+- ورش العمل والدورات
+- الفعاليات الافتراضية
+
+**التمثيل:**
+
+حتى خارج المساحات الرسمية، إذا كان الشخص يمثل المشروع، يتوقع منه الالتزام بهذه المدونة.
+
+---
+
+## الإبلاغ عن المخالفات
+
+### كيفية الإبلاغ
+
+إذا witnessت أو experienced سلوكاً لا يتوافق مع هذه المدونة، يُرجى الإبلاغ عنه فوراً:
+
+**الخيار 1: الإبلاغ للمشرف مباشرة**
+
+إذا كنت في قناة تواصل، تواصل مع أحد المشرفين مباشرة عبر رسالة خاصة. المشرفون يظهرون بأدوار أو علامات مميزة في القنوات.
+
+**الخيار 2: فتح Issue**
+
+في GitHub، يمكنك فتح Issue جديد في مستودع المشروع مع وضع علامة "Kind: community-health" لوصف الموقف.
+
+**الخيار 3: البريد الإلكتروني**
+
+إرسال بريد إلكتروني لمشرف المشروع على:
+
+```
+support@autoguardian.local
+```
+
+### ماذا يجب أن يتضمن البلاغ
+
+للمساعدة في التحقيق السريع، يُفضل أن يتضمن البلاغ:
+
+- وصف واضح للسلوك المخالف
+- السياق الذي حدث فيه السلوك (الرابط، القناة، التاريخ)
+- الهوية أو أسماء الأشخاص المعنيين
+- أي أدلة متاحة (لقطات شاشة، سجلات)
+- معلومات الاتصال الخاصة بك (اختياري)
+
+### السرية والخصوصية
+
+نأخذ البلاغات بجدية تامة. جميع البلاغات ستُعامل بسرية تامة. لن نكشف هوية المُبلّغ لأي شخص خارج فريق التحقيق. الانتقام من المُبلّغين ممنوع تماماً وسيُعتبر انتهاكاً منفصلاً لهذه المدونة.
+
+---
+
+## إجراءات التطبيق
+
+### المستوى الأول: التنبيه
+
+عند ملاحظة سلوك غير مقبول لأول مرة:
+
+- مشرف يتواصل مع الشخص بشكل خاص
+- توضيح المخالفة بلباقة
+- طلب التوقف عن السلوك
+- تسجيل الحادثة
+
+### المستوى الثاني: التحذير
+
+إذا استمر السلوك أو كان أكثر خطورة:
+
+- تحذير رسمي مكتوب
+- تعليق مؤقت من المشاركة
+- فترة مراجعة (عادةً أسبوع)
+- توثيق كامل للحادثة
+
+### المستوى الثالث: الحظر
+
+في حالات السلوك الشديد الخطورة أو المتكرر:
+
+- حظر دائم من جميع قنوات المشروع
+- رفض Pull Requests و Issues
+- إبلاغ المؤسسات ذات الصلة إذا لزم الأمر
+- نشر ملخص الحادثة (بدون أسماء) إذا كان ذلك مفيداً للسلامة
+
+---
+
+## الاستثناءات
+
+هناك استثناءات محدودة لهذه المدونة:
+
+**الاستثناء الأول: التوازن**
+
+قد نتجنب اتخاذ إجراءات ضد سلوك يحمي التوازن في المناقشات، مثل نقد مشروع أو منتج بشكل مشروع أو الإشارة إلى أخطاء فعلية في عمل شخص ما.
+
+**الاست��ناء الثاني: الخصوصية**
+
+نحترم خصوصية الأفراد، لذا قد نتجنب بعض الإجراءات إذا كانت ستُعرّض شخصاً للخطر.
+
+**الاستثناء الثالث: التوظيف**
+
+نوفر مساحة للتوظيف والنقاشات المهنية المتعلقة بالأمن السيبراني، حتى لو تضمنت محتوى تقنياً عن الاختراقات.
+
+---
+
+## الاعتراف والتحضير
+
+هذه المدونة مستوحاة من:
+
+- [Contributor Covenant](https://www.contributor-covenant.org/) الإصدار 2.1
+- [Django Code of Conduct](https://www.djangoproject.com/conduct/)
+- [Python Community Code of Conduct](https://www.python.org/community/conduct/)
+- [Ubuntu Code of Conduct](https://ubuntu.com/community/ethos/code-of-conduct)
+
+---
+
+## الأسئلة الشائعة
+
+**س: ماذا لو اعتقدت أن الحظر غير عادل؟**
+
+ج: يمكنك طلب مراجعة القرار من خلال إرسال بريد إلكتروني للفريق التنفيذي. سنراجع القرار ونرد خلال 7 أيام عمل.
+
+**س: هل يمكنني البقاء مجهولاً عند الإبلاغ؟**
+
+ج: نعم، يمكنك تقديم بلاغ مجهول الهوية. ومع ذلك، قد تحد من قدرتنا على التواصل معك للمتابعة.
+
+**س: ماذا لو كنت ضحية تحرش من مشرف؟**
+
+ج: يمكنك الإبلاغ مباشرة عبر البريد الإلكتروني للفريق التنفيذي. سنضمن مراجعة مستقلة من مشرفين آخرين.
+
+**س: هل تنطبق هذه المدونة على التوظيف؟**
+
+ج: نعم، تنطبق على جميع جوانب المشاركة في المشروع بما في ذلك فرص العمل.
+
+---
+
+## التواصل
+
+للأسئلة حول هذه المدونة:
+
+- **البريد الإلكتروني:** support@autoguardian.local
+- **GitHub:** [Open an Issue](https://github.com/AbdulElahOthmanGwaith/auto-guardian-system/issues/new)
+
+---
+
+<div align="center">
+
+**شكراً لالتزامك بخلق مجتمع welcome وآمن! 🌟**
+
+*صُنع بـ ❤️ بواسطة عبد الإله عثمان غويث*
+
+</div>

CONTRIBUTING.md

@@ -0,0 +1,183 @@
+# دليل المساهمة في نظام Auto-Guardian
+
+شكرًا لاهتمامك بالمساهمة في تطوير نظام Auto-Guardian! نرحب بجميع المساهمات التي تساعد في تحسين هذا المشروع مفتوح المصدر.
+
+## فهرس المحتوى
+
+1. [كيفية المساهمة](#كيفية-المساهمة)
+2. [إعداد بيئة التطوير](#إعداد-بيئة-التطوير)
+3. [قواعد كتابة الكود](#قواعد-كتابة-الكود)
+4. [عملية تقديم Pull Request](#عملية-تقديم-pull-request)
+5. [إرشادات الأمان](#إرشادات-الأمان)
+6. [التواصل والدعم](#التواصل-والدعم)
+
+## كيفية المساهمة
+
+هناك عدة طرق للمساهمة في تطوير النظام:
+
+- **الإبلاغ عن الأخطاء**: إذا وجدت خطأ في النظام، يُرجى فتح Issue جديدة مع وصف مفصل للمشكلة وكيفية إعادة إنتاجها.
+- **اقتراح الميزات**: نرحب باقتراحاتك لتحسين النظام. يُرجى فتح Issue جديدة في قسم Feature Requests.
+- **تحسين الوثائق**: إذا وجدت أي أخطاء في الوثائق أو أردت تحسينها، يُرجى تقديم مساهمتك.
+- **كتابة الكود**: يمكنك حل أي Issue مفتوح وتقديم Pull Request.
+- **مراجعة الكود**: ساعد في مراجعة Pull Requests الأخرى وتقديم ملاحظات بنّاءة.
+
+## إعداد بيئة التطوير
+
+### المتطلبات الأساسية
+
+قبل البدء، تأكد من تثبيت المتطلبات التالية:
+
+```
+Python >= 3.11
+Node.js >= 20
+Go >= 1.21
+Rust (أحدث إصدار ثابت)
+Git
+```
+
+### خطوات الإعداد
+
+1. **استنساخ المستودع**:
+
+```bash
+git clone https://github.com/yourusername/auto-guardian.git
+cd auto-guardian
+```
+
+2. **تثبيت تبعيات Python**:
+
+```bash
+pip install -r requirements.txt
+```
+
+3. **تثبيت تبعيات Node.js**:
+
+```bash
+npm install
+```
+
+4. **تشغيل الفحوصات محليًا**:
+
+```bash
+# فحص Python
+bandit -r scripts/
+pylint scripts/
+
+# فحص JavaScript
+npx eslint .
+
+# فحص Go
+gosec ./...
+```
+
+## قواعد كتابة الكود
+
+### معايير كود Python
+
+- اتبع أسلوب PEP 8 لكتابة الكود.
+- استخدم أسماء متغيرات واضحة ومعبرة.
+- أضف docstrings لجميع الدوال والكلاسات.
+- استخدم type hints حيثما أمكن.
+- احتفظ بطول السطر أقل من 120 حرفًا.
+
+### معايير كود JavaScript/TypeScript
+
+- اتبع معايير ESLint المعرفة في `.eslintrc.json`.
+- استخدم `const` و `let` بدلاً من `var`.
+- استخدم arrow functions حيثما أمكن.
+- أضف أنواع TypeScript لجميع الدوال والمتغيرات.
+
+### معايير كود Go
+
+- اتبع معايير Go الرسمية.
+- استخدم `gofmt` لتنسيق الكود.
+- أضف توثيق لجميع الدوال العامة.
+- استخدم	go vet للفحص.
+
+### معايير كود Rust
+
+- اتبع معايير Rust الرسمية.
+- استخدم `cargo fmt` لتنسيق الكود.
+- أضف توثيق للدوال العامة.
+- تحقق من السلامة مع `cargo clippy`.
+
+## عملية تقديم Pull Request
+
+### الخطوة 1: إنشاء Fork
+
+انتقل إلى صفحة المستودع على GitHub وأنشئ Fork الخاص بك.
+
+### الخطوة 2: إنشاء فرع جديد
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+### الخطوة 3: إجراء التغييرات
+
+قم بإجراء التغييرات المطلوبة على الكود أو الوثائق.
+
+### الخطوة 4: اختبار التغييرات
+
+```bash
+# تشغيل جميع الفحوصات
+python -m pytest
+npm test
+```
+
+### الخطوة 5: إنشاء Commit
+
+```bash
+git add .
+git commit -m "إضافة: وصف موجز للتغييرات"
+```
+
+### الخطوة 6: رفع الفرع
+
+```bash
+git push origin feature/your-feature-name
+```
+
+### الخطوة 7: إنشاء Pull Request
+
+انتقل إلى صفحة GitHub وأنشئ Pull Request جديدًا. تأكد من:
+
+- وصف التغييرات بشكل واضح.
+- ربط أي Issue ذي صلة.
+- إرفاق لقطات شاشة إذا كانت التغييرات مرئية.
+- اجتياز جميع الفحوصات الآلية.
+
+## إرشادات الأمان
+
+### الإبلاغ عن الثغرات الأمنية
+
+إذا اكتشفت ثغرة أمنية في النظام، يُرجى عدم فتح Issue علني. بدلاً من ذلك:
+
+1. أرسل بريدًا إلكترونيًا إلى: security@example.com
+2. وصف الثغرة بتفصيل.
+3. أخبرنا إذا كنت تريد أن يتم الإشارة إليك في شكر المساهمين.
+
+### أفضل الممارسات الأمنية
+
+- لا تقم أبدًا بتنفيذ كود غير موثوق.
+- تحقق من جميع المدخلات قبل معالجتها.
+- استخدم HTTPS للاتصالات الآمنة.
+- لا تخزن بيانات حساسة في الكود.
+
+## التواصل والدعم
+
+### الحصول على المساعدة
+
+- **الأسئلة الشائعة**: راجع قسم FAQ في الوثائق.
+- **المجتمع**: انضم إلى Discord server الخاص بالمشروع.
+- **الدعم**: افتح Issue مع تصنيف "question".
+
+### ساعات العمل
+
+نحاول الرد على جميع الاستفسارات خلال 48 ساعة عمل.
+
+---
+
+## شكر خاص
+
+نشكر جميع المساهمين الذين ساعدوا في تطوير هذا المشروع! 🙏

CONTRIBUTING_NEW.md

@@ -0,0 +1,18 @@
+# المساهمة في Auto-Guardian | Contributing to Auto-Guardian
+
+نحن نرحب بمساهماتكم! إليكم كيف يمكنك البدء:
+
+## 🚀 كيف تساهم؟
+1. قم بعمل **Fork** للمستودع.
+2. أنشئ فرعاً جديداً لميزتك (`git checkout -b feature/AmazingFeature`).
+3. قم بعمل **Commit** لتغييراتك (`git commit -m 'Add some AmazingFeature'`).
+4. قم بعمل **Push** للفرع (`git push origin feature/AmazingFeature`).
+5. افتح **Pull Request**.
+
+## 🛡️ معايير الكود
+- تأكد من أن الكود يتبع معايير PEP8 بالنسبة لـ Python.
+- قم بتحديث التوثيق إذا قمت بإضافة ميزات جديدة.
+- تأكد من تشغيل الفحص الأمني قبل الإرسال.
+
+## 📧 التواصل
+إذا كان لديك أي استفسار، يمكنك فتح Issue في المستودع.

LICENSE

@@ -0,0 +1,51 @@
+# ترخيص MIT للنظام الآلي للحارس
+
+## حقوق النشر (c) 2024 Auto-Guardian Team
+
+يُمنح هنا إذنًا مجانيًا لأي شخص يحصل على نسخة من هذا البرنامج والوثائق ذات الصلة ("البرنامج") للتعامل في البرنامج دون قيود، بما في ذلك دون حصر حقوق استخدام ونسخ وتعديل ودمج ونشر وتوزيع وترخيص من الباطن وبيع نسخ من البرنامج، والأشخاص الذين يُسمح لهم بالبرنامج مُلزمون بالقيام بذلك بشرط استيفاء الشروط التالية:
+
+يجب تضمين إشعار حقوق النشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الجوهرية من البرنامج.
+
+**البرنامج يُقدم "كما هو" دون أي ضمانات صريحة أو ضمنية، بما في ذلك على سبيل المثال لا الحصر ضمانات القابلية للتسويق والملاءمة لغرض معين. في أي حال من الأحوال لا يكون المؤلفون أو أصحاب حقوق النشر مسؤولين عن أي مطالبات أو أضرار أو مسؤوليات أخرى، سواء كانت في عقد أو مسؤولية تقصيرية أو غير ذلك، تنشأ عن أو تتعلق بالبرنامج أو استخدامه أو التعاملات الأخرى فيه.**
+
+##_permissions المطلوب للتشغيل:
+
+يطلب هذا البرنامج الإذونات التالية للعمل بشكل صحيح:
+
+```
+permissions:
+  contents: read      # قراءة محتوى المستودع
+  pages: write        # نشر صفحات الويب
+  id-token: write     # المصادقة على GitHub Actions
+  issues: write       # إنشاء التقارير
+  pull-requests: write # التعليق على طلبات السحب
+```
+
+## المتطلبات الأساسية:
+
+- Python 3.11 أو أحدث
+- Node.js 20 أو أحدث
+- Go 1.21 أو أحدث (لأدوات فحص Go)
+- Rust stable (لأدوات فحص Rust)
+
+## التبعيات:
+
+- **Bandit**: لفحص أمان Python
+- **Pylint**: لفحص جودة كود Python
+- **ESLint**: لفحص أمان وجودة JavaScript/TypeScript
+- **Gosec**: لفحص أمان Go
+- **Cargo Audit**: لفحص أمان Rust
+
+## بيان عدم الضمان:
+
+هذا البرنامج موزع تحت ترخيص MIT. لا يُمنح هذا البرنامج أي ضمانات، سواء كانت صريحة أو ضمنية، بما في ذلك على سبيل المثال لا الحصر ضمانات القابلية للتسويق والملاءمة لغرض معين. لا يتحمل المؤلفون أو موزعو البرنامج أي مسؤولية عن أي أضرار مباشرة أو غير مباشرة أو عرضية أو خاصة أو تبعية ناتجة عن استخدام البرنامج أو عدم القدرة على استخدامه.
+
+## الموافقة:
+
+باستخدام هذا البرنامج، فإنك توافق على شروط هذا الترخيص.
+
+---
+
+**للتواصل والدعم:**
+- المستودع: https://github.com/yourusername/auto-guardian
+- المشاكل: https://github.com/yourusername/auto-guardian/issues

MANIFEST.txt

@@ -0,0 +1,34 @@
+# MANIFEST - Auto Guardian System Documentation Package
+# =========================================
+
+Generated: 2026-01-13 05:02:17
+Version: 1.3.0
+
+Files Included:
+--------------
+1. README.md - الملف التعريفي الرئيسي
+2. CHANGELOG.md - سجل التغييرات
+3. SECURITY.md - سياسة الأمان
+4. CODE_OF_CONDUCT.md - مدونة السلوك
+5. CONTRIBUTING.md - دليل المساهمة
+6. docker-compose.yml - تكوين Docker Compose
+7. Makefile - أوامر التطوير
+8. .editorconfig - إعدادات المحرر
+9. assets/ - ملفات الوسائط (SVG)
+
+How to Use:
+----------
+1. استخرج الملفات من الأرشيف
+2. انسخ الملفات إلى مجلد المشروع الرئيسي
+3. استخدم الأمر `make help` للحصول على قائمة الأوامر
+4. راجع CONTRIBUTING.md للمشاركة في التطوير
+
+Verification:
+------------
+Run `python verify.py` to verify all files are valid.
+
+For more information, visit:
+https://github.com/AbdulElahOthmanGwaith/auto-guardian-system
+
+---
+Generated by Auto Guardian System Documentation Generator

Makefile

@@ -0,0 +1,273 @@
+# Makefile لنظام الحارس التلقائي
+# Auto Guardian System Makefile
+
+# إعدادات افتراضية
+SHELL := /bin/bash
+PYTHON := python3
+PIP := pip3
+VENV := venv
+VENV_ACTIVATE := $(VENV)/bin/activate
+
+# المسارات
+SRC := src
+TESTS := tests
+CONFIG := config
+DOCS := docs
+ASSETS := assets
+
+# ملفات مهمة
+REQUIREMENTS := requirements.txt
+README := README.md
+DOCKER_COMPOSE := docker-compose.yml
+
+# ألوان للطباعة
+GREEN := \033[0;32m
+BLUE := \033[0;34m
+YELLOW := \033[1;33m
+RED := \033[0;31m
+NC := \033[0m # No Color
+
+# دوال مساعدة
+define print_status
+	@echo -e "$(BLUE)[INFO]$(NC) $(1)"
+endef
+
+define print_success
+	@echo -e "$(GREEN)[SUCCESS]$(NC) $(1)"
+endef
+
+define print_warning
+	@echo -e "$(YELLOW)[WARNING]$(NC) $(1)"
+endef
+
+define print_error
+	@echo -e "$(RED)[ERROR]$(NC) $(1)"
+endef
+
+.PHONY: help install dev-install test test-cov lint format check clean clean-pyc clean-build clean-docker docker-build docker-run docker-stop docker-logs logs zip upload docs docs-serve
+
+# ========================================
+# الهدف الافتراضي - عرض المساعدة
+# ========================================
+help:
+	@echo ""
+	@echo -e "$(GREEN)╔════════════════════════════════════════════════════════════╗$(NC)"
+	@echo -e "$(GREEN)║         نظام الحارس التلقائي - أوامر التطوير              ║$(NC)"
+	@echo -e "$(GREEN)╚════════════════════════════════════════════════════════════╝$(NC)"
+	@echo ""
+	@echo "الأوامر المتاحة:"
+	@echo ""
+	@echo "  $(GREEN)التثبيت والإعداد$(NC)"
+	@echo "    make install           - تثبيت التبعيات الأساسية"
+	@echo "    make dev-install       - تثبيت التبعيات مع أدوات التطوير"
+	@echo "    make update            - تحديث التبعيات"
+	@echo ""
+	@echo "  $(GREEN)الاختبارات$(NC)"
+	@echo "    make test              - تشغيل جميع الاختبارات"
+	@echo "    make test-coverage     - تشغيل الاختبارات مع تقرير التغطية"
+	@echo "    make test-unit         - تشغيل اختبارات الوحدة فقط"
+	@echo "    make test-integration  - تشغيل اختبارات التكامل"
+	@echo ""
+	@echo "  $(GREEN)جودة الكود$(NC)"
+	@echo "    make lint              - فحص الكود باستخدام linters"
+	@echo "    make format            - تنسيق الكود تلقائياً"
+	@echo "    make check             - التحقق من جودة الكود"
+	@echo ""
+	@echo "  $(GREEN)التنظيف$(NC)"
+	@echo "    make clean             - تنظيف ملفات البناء"
+	@echo "    make clean-pyc         - تنظيف ملفات Python المؤقتة"
+	@echo "    clean-all             - تنظيف كل شيء"
+	@echo ""
+	@echo "  $(GREEN)Docker$(NC)"
+	@echo "    make docker-build     - بناء صورة Docker"
+	@echo "    make docker-run       - تشغيل الحاويات"
+	@echo "    make docker-stop      - إيقاف الحاويات"
+	@echo "    make docker-logs      - عرض سجلات Docker"
+	@echo ""
+	@echo "  $(GREEN)النظام$(NC)"
+	@echo "    make run              - تشغيل النظام"
+	@echo "    make logs             - عرض سجلات النظام"
+	@echo ""
+	@echo "  $(GREEN)الأرشفة$(NC)"
+	@echo "    make zip              - إنشاء ملف ZIP للمشروع"
+	@echo ""
+	@echo "  $(GREEN)التوثيق$(NC)"
+	@echo "    make docs             - بناء التوثيق"
+	@echo "    make docs-serve       - عرض التوثيق محلياً"
+	@echo ""
+	@echo "للحصول على تفاصيل إضافية، راجع ملف CONTRIBUTING.md"
+	@echo ""
+
+# ========================================
+# قسم التثبيت
+# ========================================
+install:
+	$(call print_status,"جاري تثبيت التبعيات...")
+	@if [ ! -f $(REQUIREMENTS) ]; then $(call print_error,"ملف requirements.txt غير موجود"); exit 1; fi
+	$(PIP) install -r $(REQUIREMENTS)
+	$(call print_success,"تم تثبيت التبعيات بنجاح")
+
+dev-install: install
+	$(call print_status,"جاري تثبيت أدوات التطوير...")
+	$(PIP) install pytest pytest-cov pytest-mock pytest-cov coveralls
+	$(PIP) install black flake8 mypy isort pre-commit
+	$(PIP) install sphinx sphinx-rtd-theme
+	$(call print_success,"تم تثبيت أدوات التطوير")
+
+update:
+	$(call print_status,"جاري تحديث التبعيات...")
+	$(PIP) install --upgrade -r $(REQUIREMENTS)
+	$(call print_success,"تم تحديث التبعيات")
+
+# ========================================
+# قسم الاختبارات
+# ========================================
+test:
+	$(call print_status,"جاري تشغيل الاختبارات...")
+	@if [ ! -d "$(TESTS)" ]; then $(call print_error,"مجلد الاختبارات غير موجود"); exit 1; fi
+	$(PYTHON) -m pytest $(TESTS) -v --tb=short
+	$(call print_success,"اكتمل تشغيل الاختبارات")
+
+test-coverage:
+	$(call print_status,"جاري تشغيل الاختبارات مع التغطية...")
+	$(PYTHON) -m pytest $(TESTS) --cov=$(SRC) --cov-report=html --cov-report=term-missing
+	$(call print_success,"تم إنشاء تقرير التغطية في مجلد htmlcov/")
+
+test-unit:
+	$(call print_status,"جاري تشغيل اختبارات الوحدة...")
+	$(PYTHON) -m pytest $(TESTS)/test_*.py -v
+
+test-integration:
+	$(call print_status,"جاري تشغيل اختبارات التكامل...")
+	$(PYTHON) -m pytest $(TESTS)/test_*integration*.py -v -s
+
+# ========================================
+# قسم جودة الكود
+# ========================================
+lint:
+	$(call print_status,"جاري فحص الكود...")
+	@echo "--- Flake8 ---"
+	@flake8 $(SRC) --max-line-length=100 --extend-ignore=E203
+	@echo "--- Mypy ---"
+	@mypy $(SRC) --ignore-missing-imports --strict-optional
+	$(call print_success,"اكتمل فحص الكود")
+
+format:
+	$(call print_status,"جاري تنسيق الكود...")
+	@echo "--- Black ---"
+	@black $(SRC) $(TESTS) --line-length 100
+	@echo "--- isort ---"
+	@isort $(SRC) $(TESTS) --profile black
+	$(call print_success,"تم تنسيق الكود")
+
+check:
+	$(call print_status,"جاري التحقق من جودة الكود...")
+	@echo "--- التحقق من التنسيق ---"
+	@black --check $(SRC) $(TESTS) --line-length 100
+	@echo "--- التحقق من الاستيرادات ---"
+	@isort --check-only $(SRC) $(TESTS) --profile black
+	@echo "--- Flake8 ---"
+	@flake8 $(SRC) --max-line-length=100 --extend-ignore=E203
+	$(call print_success,"اجتاز جميع فحوصات الجودة")
+
+# ========================================
+# قسم التنظيف
+# ========================================
+clean:
+	$(call print_status,"جاري تنظيف ملفات البناء...")
+	@rm -rf build/ dist/ *.egg-info/
+	@rm -rf htmlcov/ .coverage .coverage.*
+	$(call print_success,"تم تنظيف ملفات البناء")
+
+clean-pyc:
+	$(call print_status,"جاري تنظيف ملفات Python المؤقتة...")
+	@find . -type d -name __pycache__ -exec rm -rf {} +
+	@find . -type f -name "*.pyc" -delete
+	@find . -type f -name ".pyc" -delete
+	@rm -rf $(VENV)
+	$(call print_success,"تم تنظيف ملفات Python")
+
+clean-all: clean clean-pyc
+	$(call print_status,"جاري تنظيف كل شيء...")
+	@rm -rf logs/*.log
+	@rm -rf .hypothesis/
+	$(call print_success,"تم تنظيف كل شيء")
+
+# ========================================
+# قسم Docker
+# ========================================
+docker-build:
+	$(call print_status,"جاري بناء صورة Docker...")
+	@if [ ! -f "Dockerfile" ]; then $(call print_error,"ملف Dockerfile غير موجود"); exit 1; fi
+	docker-compose build
+	$(call print_success,"تم بناء الصورة")
+
+docker-run:
+	$(call print_status,"جاري تشغيل الحاويات...")
+	@if [ ! -f "$(DOCKER_COMPOSE)" ]; then $(call print_error,"ملف docker-compose.yml غير موجود"); exit 1; fi
+	docker-compose up -d
+	$(call print_success,"تم تشغيل الحاويات. الخدمات متاحة على:")
+	@echo "  - النظام الرئيسي: http://localhost:8000"
+	@echo "  - Prometheus: http://localhost:9090"
+	@echo "  - Grafana: http://localhost:3000"
+
+docker-stop:
+	$(call print_status,"جاري إيقاف الحاويات...")
+	docker-compose down
+	$(call print_success,"تم إيقاف الحاويات")
+
+docker-logs:
+	$(call print_status,"جاري عرض السجلات...")
+	docker-compose logs -f auto-guardian
+
+# ========================================
+# قسم تشغيل النظام
+# ========================================
+run:
+	$(call print_status,"جاري تشغيل نظام الحارس التلقائي...")
+	$(PYTHON) -m $(SRC).main
+	$(call print_success,"تم تشغيل النظام")
+
+logs:
+	$(call print_status,"جاري عرض سجلات النظام...")
+	@if [ -d "logs" ]; then tail -f logs/*.log; else $(call print_warning,"مجلد السجلات غير موجود"); fi
+
+# ========================================
+# قسم الأرشفة
+# ========================================
+zip:
+	$(call print_status,"جاري إنشاء ملف ZIP...")
+	@VERSION=$$(git describe --tags 2>/dev/null || echo "1.3.0"); \
+	FILENAME="auto-guardian-system-$${VERSION}.zip"; \
+	if [ -f "$$FILENAME" ]; then rm "$$FILENAME"; fi \
+	zip -r "$$FILENAME" . \
+		--exclude="*.git*" \
+		--exclude="*.pyc" \
+		--exclude="__pycache__/*" \
+		--exclude="*.egg-info/*" \
+		--exclude="build/*" \
+		--exclude="dist/*" \
+		--exclude="htmlcov/*" \
+		--exclude=".hypothesis/*" \
+		--exclude="venv/*" \
+		--exclude="node_modules/*" \
+		--exclude=".DS_Store" \
+		--exclude="*.log" \
+		--exclude="logs/*" \
+		--exclude="backups/*"
+	$(call print_success,"تم إنشاء الملف: $$FILENAME")
+	@ls -lh "$$FILENAME"
+
+# ========================================
+# قسم التوثيق
+# ========================================
+docs:
+	$(call print_status,"جاري بناء التوثيق...")
+	@if [ ! -d "$(DOCS)" ]; then $(call print_error,"مجلد التوثيق غير موجود"); exit 1; fi
+	$(PYTHON) -m sphinx -b html $(DOCS) $(DOCS)/_build/html
+	$(call print_success,"تم بناء التوثيق في $(DOCS)/_build/html/")
+
+docs-serve:
+	$(call print_status,"جاري تشغيل خادم التوثيق...")
+	@if [ ! -d "$(DOCS)/_build/html" ]; then make docs; fi
+	$(PYTHON) -m http.server 8080 -d $(DOCS)/_build/html

README.md

@@ -0,0 +1,95 @@
+# 🛡️ Auto-Guardian Security System | نظام الحارس التلقائي للأمن
+
+<div align="center">
+
+![Auto-Guardian Logo](assets/logo.svg)
+
+![Python](https://img.shields.io/badge/Python-3.9%2B-blue?style=for-the-badge&logo=python)
+![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
+![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-Enabled-purple?style=for-the-badge)
+![Dashboard](https://img.shields.io/badge/Dashboard-Web_Interface-orange?style=for-the-badge)
+
+**نظام متكامل لفحص الكود البرمائي وكشف الثغرات الأمنية بشكل تلقائي**
+
+*Automated Code Security Scanning and Vulnerability Detection System*
+
+</div>
+
+---
+
+## 📋 نظرة عامة | Overview
+
+**نظام Auto-Guardian** هو أداة متكاملة مصممة لتعزيز الأمان في مشاريع البرمجة من خلال فحص الكود آلياً واكتشاف الثغرات الأمنية قبل دمجها في الكود الرئيسي. يجمع النظام بين قوة أدوات التحليل الثابت (Static Analysis) وسهولة الاستخدام من خلال لوحة تحكم ويب متجاوبة تدعم اللغتين العربية والإنجليزية.
+
+يهدف هذا المشروع إلى تمكين فرق التطوير من تبني ممارسات **DevSecOps** بسهولة، حيث يتم دمج الفحص الأمني تلقائياً ضمن دورة حياة التطوير. يوفر النظام تقارير تفصيلية عن الثغرات المكتشفة مع تصنيفها حسب مستوى الخطورة، مما يساعد المطورين على تحديد أولويات الإصلاح بكفاءة عالية.
+
+---
+
+## ✨ الميزات الرئيسية | Key Features
+
+### 🔍 الفحص الأمني الآلي | Automated Security Scanning
+يستخدم النظام مجموعة متكاملة من أدوات التحليل الأمني للكشف عن الثغرات الشائعة في الكود البرمجي. يدعم النظام فحص مشاريع **Python** و **JavaScript** و **Java** وغيرها من اللغات الشائعة.
+
+### 📊 لوحة تحكم تفاعلية | Interactive Dashboard
+توفر لوحة التحكم واجهة ويب متجاوبة بالكامل تعرض إحصائيات الأمان بشكل لحظي ومباشر. تدعم اللوحة اللغتين العربية والإنجليزية مع دعم كامل للاتجاه من اليمين لليسار (RTL).
+
+### 🛠️ ملحقات النظام | System Extras
+يتضمن المشروع مجموعة واسعة من الملحقات والأدوات الإضافية:
+- **Docker Support**: حاويات جاهزة للتشغيل باستخدام `docker-compose`.
+- **API Documentation**: توثيق كامل للواجهة البرمجية بصيغة `OpenAPI`.
+- **Management Scripts**: سكربتات للنسخ الاحتياطي والصيانة والترقية.
+- **Security Templates**: قوالب جاهزة لبلاغات الثغرات وطلبات السحب.
+
+---
+
+## 🏗️ هيكل المشروع | Project Structure
+
+```
+Auto-Guardian-Core/
+├── 📄 index.html                # لوحة التحكم الرئيسية (GitHub Pages)
+├── 📄 docker-compose.yml        # إعدادات Docker
+├── 📄 requirements.txt          # متطلبات Python
+├── 📂 scripts/                  # سكربتات الإدارة والفحص
+│   ├── 📄 security_scanner.py   # فحص أمني متقدم (جديد)
+│   ├── 📄 backup.sh             # النسخ الاحتياطي
+│   ├── 📄 maintenance.sh        # الصيانة
+│   └── 📄 upgrade.sh            # الترقية
+├── 📄 robots.txt                # ملفات SEO لمحركات البحث
+├── 📄 sitemap.xml               # خريطة الموقع لمحركات البحث
+├── 📄 structured-data.json      # البيانات المنظمة (JSON-LD)
+├── 📂 docs/                     # التوثيق التقني
+│   ├── 📂 api/                  # توثيق OpenAPI
+│   └── 📄 configuration.md      # إعدادات النظام
+├── 📂 assets/                   # الأصول المرئية والشعارات
+└── 📂 .github/                  # قوالب GitHub
+```
+
+---
+
+## 🚀 البدء السريع | Quick Start
+
+### التشغيل عبر Docker (موصى به)
+```bash
+docker-compose up -d
+```
+
+### التشغيل المحلي
+```bash
+pip install -r requirements.txt
+python -m http.server 8000
+```
+
+---
+
+## 📝 الترخيص | License
+هذا المشروع مرخص تحت **رخصة MIT**. راجع ملف [LICENSE](LICENSE) لمزيد من التفاصيل.
+
+---
+
+<div align="center">
+
+**صُنع بـ ❤️ بواسطة Auto-Guardian Team**
+
+[المستودع الرئيسي](https://github.com/AbdulElahOthmanGwaith/Auto-Guardian-Core) | [لوحة التحكم المباشرة](https://abdulelahothmangwaith.github.io/Auto-Guardian-Core/)
+
+</div>

SECURITY.md

@@ -0,0 +1,254 @@
+# سياسة الأمان لنظام الحارس التلقائي
+
+<div align="center">
+
+![Auto Guardian System](assets/banner.svg)
+
+**نظام ذكي لحماية الخوادم من التهديدات الإلكترونية**
+
+</div>
+
+---
+
+## مقدمة
+
+نحن نأخذ الأمان على محمل الجد في نظام الحارس التلقائي. نظراً لطبيعة المشروع كحل أمني، ندرك أهمية الحفاظ على أعلى معايير الأمان في تطويرنا ourselves. يوضح هذا المستند كيفية الإبلاغ عن الثغرات الأمنية discovered في نظامنا.
+
+---
+
+## versions المدعومة
+
+نحن ندعم أحدث إصدارين رئيسيين من نظام الحارس التلقائي مع تحديثات الأمان. الإصدارات القديمة قد لا تستقبل تصحيحات الأمان.
+
+| الإصدار | حالة الدعم | آخر تحديث |
+|---------|------------|-----------|
+| 1.3.x | ✅ نشط | الحالي |
+| 1.2.x | ⚠️ صيانة | 2024-10-15 |
+| 1.1.x | ❌ غير مدعوم | 2024-09-28 |
+| 1.0.x | ❌ غير مدعوم | 2024-09-01 |
+
+---
+
+## الإبلاغ عن الثغرات
+
+### كيف تُبلّغ عن ثغرة
+
+نحن نشجع الباحثين الأمنيين على الإبلاغ بشكل مسؤول عن الثغرات التي يكتشفونها. لمساعدتنا في معالجة الثغرات بأسرع وقت ممكن، يُرجى اتباع الخطوات التالية:
+
+**الخطوة 1:** لا تشارك الثغرة مع أي شخص آخر
+
+**الخطوة 2:** جمع معلومات كافية عن الثغرة
+
+جمع أكبر قدر ممكن من المعلومات عن الثغرة المكتشفة، بما في ذلك الخطوات المتكررة لإعادة إنتاجها، والبيئة التي تم فيها اكتشاف الثغرة، وتأثيرها المحتمل على النظام. كلما كانت المعلومات أكثر تفصيلاً، كان بإمكاننا معالجة الثغرة بشكل أسرع وأفضل.
+
+**الخطوة 3:** إرسال التقرير عبر قناة آمنة
+
+إرسال تقرير مفصل يتضمن وصفاً واضحاً للثغرة، وخطوات إعادة الإنتاج، وإثبات المفهوم (PoC) إن أمكن ذلك. يرجى تضمين معلومات الاتصال الخاصة بك حتى نتمكن من التواصل معك.
+
+### قنوات الإبلاغ
+
+**البريد الإلكتروني (المُفضّل):**
+
+```
+security@autoguardian.local
+```
+
+يرجى تشفير الرسائل باستخدام مفتاح PGP العام الخاص بنا:
+
+```
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+
+mQINBF...
+-----END PGP PUBLIC KEY BLOCK-----
+```
+
+**GitHub Security Advisories:**
+
+يمكنك أيضاً استخدام [GitHub Security Advisories](https://github.com/AbdulElahOthmanGwaith/auto-guardian-system/security/advisories/new) للإبلاغ عن الثغرات بشكل خاص.
+
+---
+
+## ما نطلبه منك
+
+### المسؤولة من الإبلاغ
+
+نطلب من الباحثين الأمنيين الالتزام بالممارسات التالية:
+
+- **عدم التأثير على المستخدمين:** لا تُشغّل هجمات حقيقية على مستخدمي النظام أو على البنية التحتية دون إذن صريح. استخدم بيئات الاختبار فقط.
+
+- **عدم الوصول إلى بيانات غير مصرح بها:** لا تحاول الوصول إلى بيانات لا تملك حق الوصول إليها، بما في ذلك بيانات المستخدمين أو البيانات الشخصية.
+
+- **الإبلاغ الفوري:** بعد اكتشاف الثغرة، أبلغنا فوراً ولا تنتظر نشرها علناً أو مشاركتها مع أطراف ثالثة.
+
+- **منحنا وقتاً كافياً:** امنحنا وقتاً كافياً لتحليل الثغرة وتطوير ونشر التصحيح قبل أي إفصاح عام. نطلب عادةً 90 يوماً كحد أدنى.
+
+### ما نعدك به
+
+نحن نلتزم بما يلي تجاه الباحثين الأمنيين:
+
+- **الاستجابة السريعة:** سنرد على تقريرك خلال 48 ساعة من استلامه.
+
+- **عدم الملاحقة القانونية:** إذا التزمت بإرشادات الإبلاغ المسؤول، لن نتخذ أي إجراء قانوني ضدك.
+
+- **الاعتراف:** إذا أردت ذلك، سنعترف بجهودك في ملف CHANGELOG وفي صفحة الشكر على الموقع.
+
+- **مكافآت:** للنثريات الحرجة، قد نقدم مكافآت مالية أو اعتراف خاص حسب تقديرنا.
+
+---
+
+## فئات الثغرات التي نبحث عنها
+
+نحن مهتمون بشكل خاص بالثغرات في المجالات التالية:
+
+### الثغرات الحرجة (Critical)
+
+هذ�� الثغرات تتطلب اهتماماً فورياً وعالياً الأولوية:
+
+- **تنفيذ كود عن بُعد (RCE):** أي ثغرة تسمح للمهاجم بتنفيذ أكواد خبيثة على الخادم
+- **رفع الامتيازات:** أي ثغرة تسمح للمهاجم بالحصول على صلاحيات أعلى
+- **التح绕过 المصادقة:** أي ثغرة تسمح بالوصول غير المصرح به
+- **حقن قاعدة البيانات:** ثغرات SQL Injection التي قد تؤدي لسرقة البيانات
+
+### الثغرات العالية (High)
+
+هذه الثغرات تؤثر بشكل كبير على أمان النظام:
+
+- **حقن الأوامر:** ثغرات Command Injection
+- **كشف البيانات الحساسة:** كشف معلومات حساسة في الاستجابات
+- **هجوم القوة الغاشمة:** نقاط ضعف تسمح بتهديدات القوة الغاشمة
+- **إدارة الجلسات:** ثغرات في إدارة رموز الوصول
+
+### الثغرات المتوسطة (Medium)
+
+هذه الثغرات لها تأثير محدود ولكنها تحتاج معالجة:
+
+- **Cross-Site Scripting (XSS):** في أي واجهات ويب
+- **Cross-Site Request Forgery (CSRF):** في نماذج التقديم
+- **تسريب المعلومات:** كشف معلومات تقنية غير ضرورية
+
+### الثغرات المنخفضة (Low)
+
+هذه ملاحظات تحسينية:
+
+- تكوينات غير مثالية
+- توصيات أمان عامة
+- تحسينات في الممارسات
+
+---
+
+## عملية المعالجة
+
+### الخطوات التي نتبعها
+
+عند استلام تقرير عن ثغرة أمنية، نتبع الخطوات التالية:
+
+**المرحلة الأولى - الاستلام والتأكيد (1-3 أيام)**
+
+فور استلام تقرير الثغرة، نقوم بالخطوات التالية: أولاً، نرسل إشعاراً بالاستلام للباحث الأمني. ثانياً، نقيّم الثغرة ونحدد مستوى خطورتها. ثالثاً، نُعيّن فريقاً لمعالجة الثغرة. رابعاً، نُبلغ الباحث الأمني بالجدول الزمني المتوقع.
+
+**المرحلة الثانية - التطوير والاختبار (7-30 يوماً)**
+
+نعمل على تطوير وتصحيح الثغرة مع المراحل التالية: تطوير التصحيح مع مراعاة عدم إدخال ثغرات جديدة، وكتابة اختبارات للتحقق من فعالية التصحيح، وإجراء اختبارات أمنية إضافية، ومراجعة الكود من قبل مطور آخر.
+
+**المرحلة الثالثة - النشر والإفصاح (14-45 يوماً)**
+
+نقوم بإصدار التصحيح مع المراحل التالية: اختبار التصحيح في بيئة الإنتاج، ونشر تحديث جديد عبر القنوات الرسمية، وإصدار إشعار أمني للمستخدمين، وتحديث وثائق الأمان إذا لزم الأمر.
+
+### الجدول الزمني المعياري
+
+| نوع الثغرة | وقت الاستجابة | وقت الإصلاح |
+|------------|---------------|-------------|
+| حرجة | 24 ساعة | 7 أيام |
+| عالية | 48 ساعة | 14 يوماً |
+| متوسطة | 72 ساعة | 30 يوماً |
+| منخفضة | أسبوع | 45 يوماً |
+
+---
+
+## إعدادات الأمان الموصى بها
+
+### متطلبات النظام
+
+لضمان أمان النظام، تأكد من:
+
+**نظام التشغيل:**
+
+- Ubuntu 20.04 LTS أو أحدث
+- Debian 11 أو أحدث
+- CentOS 8 أو أحدث
+
+**متطلبات Python:**
+
+- Python 3.8 أو أحدث
+- بيئة افتراضية معزولة
+- إدارة حزم آمنة
+
+**الشبكة:**
+
+- جدار حماية مُكوّن
+- SSH مع المصادقة بالمفاتيح فقط
+- عدم فتح منافذ غير ضرورية
+
+### إعدادات الإنتاج الموصى بها
+
+```yaml
+# إعدادات الأمان في config/settings.yaml
+
+security:
+  # تفعيل التحقق من التحديثات
+  check_updates: true
+  
+  # فترة التحقق (بالساعات)
+  check_interval: 24
+  
+  # تفعيل HTTPS فقط
+  force_https: true
+  
+  # فترة انتهاء جلسة API (بالساعات)
+  api_token_expiry: 24
+  
+  # تفعيل تسجيل جميع الإجراءات
+  audit_logging: true
+```
+
+---
+
+## الموارد الأمنية
+
+### روابط مفيدة
+
+- [دليل OWASP](https://owasp.org/) - أفضل ممارسات أمان التطبيقات
+- [CIS Benchmarks](https://www.cisecurity.org/cis-benchmarks) - إعدادات أمان النظام
+- [NIST Cybersecurity](https://www.nist.gov/cyberframework) - إطار أمان NIST
+
+---
+
+## شكر وتقدير
+
+نود أن نشكر جميع الباحثين الأمنيين الذين ساهموا في تحسين أمان نظام الحارس التلقائي. إذا ساهمت في اكتشاف ثغرة أمنية وتم إصلاحها، يمكنك طلب إضافتك لقائمة الشكر أدناه:
+
+| الباحث | الثغرة | التاريخ |
+|--------|--------|---------|
+| - | - | - |
+
+*هل تريد أن تُضاف لقائمة الشكر؟ أخبرنا في تقريرك.*
+
+---
+
+## التواصل
+
+للأسئلة المتعلقة بالأمان:
+
+- **البريد الإلكتروني:** security@autoguardian.local
+- **GitHub:** [Security Advisories](https://github.com/AbdulElahOthmanGwaith/auto-guardian-system/security/advisories)
+- **الموقع:** [autoguardian.local](https://autoguardian.local)
+
+---
+
+<div align="center">
+
+**شكراً للمساهمة في جعل الإنترنت أكثر أماناً! 🛡️**
+
+*صُنع بـ ❤️ بواسطة عبد الإله عثمان غويث*
+
+</div>

VIDEO_SCRIPT.md

@@ -0,0 +1,175 @@
+# 🎬 Auto-Guardian Video Production Guide
+
+## نظرة عامة | Overview
+
+هذا الملف يحتوي على سيناريو كامل احترافي لفيديو توضيحي (Demo Video) لمدة 90 ثانية لنظام Auto-Guardian. يمكن استخدام هذا السيناريو لإنشاء فيديو احترافي باستخدام أدوات مثل:
+- **Canva**: لإنشاء الرسوم المتحركة
+- **OBS Studio**: لتسجيل الشاشة
+- **DaVinci Resolve**: للتحرير المتقدم
+- **CapCut**: للهواتف المحمولة
+
+---
+
+## 🎥 سيناريو الفيديو | Video Script
+
+### المشهد 1: المقدمة_hook (0:00 - 0:10)
+
+| الوقت | العنصر البصري | الصوت/Narration |
+|-------|--------------|-----------------|
+| 0:00-0:03 | شاشة سوداء مع صوت نقرات لوحة مفاتيح سريعة | (صمت، تركيز) |
+| 0:03-0:06 | عرض سريع لنافذة محرر أكواد مع أسطر حمراء (أخطاء أمنية) | "في عالم البرمجة، كل سطر كود هو بوابة محتملة للاختراق" |
+| 0:06-0:10 | تحوّل سلس إلى شعار Auto-Guardian مع تأثير توهج | "لكن ماذا لو كان لديك حارس آلي يكتشف كل تهديد قبل وقوعه؟" |
+
+### المشهد 2: تعريف النظام (0:10 - 0:25)
+
+| الوقت | العنصر البصري | الصوت/Narration |
+|-------|--------------|-----------------|
+| 0:10-0:15 | عرض شعار Auto-Guardian مع نبض توهّج أخضر | "أهلاً بكم في Auto-Guardian" |
+| 0:15-0:20 | عرض سريع للوحة التحكم الرئيسية (شاشة عريضة) | "نظام فحص أمان الكود البرمجي الآلي" |
+| 0:20-0:25 | إحصائيات متحركة (1,247 تهديد محظور، 99.9% نجاح) | "المزايا التي يحتاجها كل مطور" |
+
+### المشهد 3: كيف يعمل (0:25 - 0:50)
+
+| الوقت | العنصر البصري | الصوت/Narration |
+|-------|--------------|-----------------|
+| 0:25-0:32 | رسم توضيحي متحرك: كود → فحص → اكتشاف ثغرة | "أولاً، يقوم النظام بفحص الكود تلقائياً" |
+| 0:32-0:38 | عرض أدوات الفحص (Bandit, ESLint, Trivy) | "باستخدام أحدث أدوات التحليل الأمني" |
+| 0:38-0:45 | تصفية المشاكل حسب الخطورة (حرجة، عالية، متوسطة) | "يصنّف الثغرات حسب مستوى خطورتها" |
+| 0:45-0:50 | عرض قائمة المشاكل مع تفاصيل الملف والسطر | "مع تحديد دقيق لموقع المشكلة" |
+
+### المشهد 4: لوحة التحكم (0:50 - 1:10)
+
+| الوقت | العنصر البصري | الصوت/Narration |
+|-------|--------------|-----------------|
+| 0:50-0:56 | عرض المخططات البيانية (خطية ودائرية) | "لوحة تحكم تفاعلية تعرض كل شيء" |
+| 0:56-1:02 | تصفح المستودعات النشطة وحالتها | "ومراقبة جميع مشاريعك في مكان واحد" |
+| 1:02-1:07 | التفاعل مع القائمة الجانبية والقائمة على الهاتف | "تصميم متجاوب يعمل على كل الأجهزة" |
+| 1:07-1:10 | فتح صفحة الإعدادات وتخصيص الخيارات | "وخيارات تخصيص متقدمة" |
+
+### المشهد 5: CI/CD Integration (1:10 - 1:25)
+
+| الوقت | العنصر البصري | الصوت/Narration |
+|-------|--------------|-----------------|
+| 1:10-1:15 | عرض GitHub Actions workflow | "لكن الأمر لا يتوقف هنا" |
+| 1:15-1:20 | فحص تلقائي لـ Pull Request + تعليق بالنتيجة | "يتكامل مع GitHub Actions لفحص كل طلب دمج" |
+| 1:20-1:25 | عرض تقرير الفحص مع نتائج المرور/الفشل | "ممنوع مرور الكود غير الآمن أبداً" |
+
+### المشهد 6: الختام (1:25 - 1:30)
+
+| الوقت | العنصر البصري | الصوت/Narration |
+|-------|--------------|-----------------|
+| 1:25-1:27 | عرض رابط GitHub وعداد النجوم | "Open Source ومجاني تماماً" |
+| 1:27-1:29 | زر "Star" يتزايد + زر "Deploy Now" | "ساعدنا في جعل الإنترنت أكثر أماناً" |
+| 1:29-1:30 | شعار Auto-Guardian مع معلومات التواصل | "تفضلوا بزيارة مستودعنا على GitHub" |
+
+---
+
+## 🎨 إرشادات الإنتاج | Production Guidelines
+
+### ألوان العلامة التجارية | Brand Colors
+
+| الاستخدام | اللون | الكود |
+|----------|-------|-------|
+| الأساسي | أزرق كهربائي | `#3B82F6` |
+| Secondary | بنفسجي | `#8B5CF6` |
+| نجاح | أخضر | `#10B981` |
+| خطر | أحمر | `#EF4444` |
+| تحذير | برتقالي | `#F59E0B` |
+| الخلفية | أزرق داكن | `#0F172A` |
+
+### الخطوط | Typography
+
+- **العناوين الرئيسية**: Arial Bold, 48-64px
+- **النصوص الفرعية**: Arial Regular, 18-24px
+- **الأزرار والشارات**: Arial Bold, 12-14px
+
+### المؤثرات الصوتية | Sound Effects
+
+| المشهد | المؤثر |
+|--------|--------|
+| البداية | نقرات لوحة مفاتيح (Typewriter clicks) |
+| انتقال للمشهد | Whoosh سريعة |
+| اكتشاف ثغرة | Alert sound (نغمة قصيرة) |
+| نجاح الفحص | Success chime |
+| الختام | موسيقى تشجيعية خفيفة (Uplifting music) |
+
+### سرعة الانتقال | Pacing
+
+- **المشاهد السريعة (دقيقة)**: 0:00-0:10
+- **المشهد التعريفي**: 0:10-0:25 (بطيء نسبياً)
+- **الشرح التقني**: 0:25-0:50 (متوسط)
+- **العرض التفاعلي**: 0:50-1:10 (بطيء للتفاعل)
+- **التكامل**: 1:10-1:25 (سريع)
+- **الختام**: 1:25-1:30 (رسمي)
+
+---
+
+## 📦 الأصول الجاهزة | Ready-to-Use Assets
+
+تم إنشاء الأصول التالية في مجلد `assets/`:
+
+```
+assets/
+├── 📄 logo.svg              # شعار المشروع (512x512)
+├── 📄 architecture.svg      # رسم هيكل النظام (800x400)
+├── 📄 icon-realtime.svg     # أيقونة الوقت الحقيقي (64x64)
+├── 📄 icon-ai.svg           # أيقونة الذكاء الاصطناعي (64x64)
+├── 📄 icon-alerts.svg       # أيقونة التنبيهات (64x64)
+├── 📄 icon-scan.svg         # أيقونة الفحص (64x64)
+└── 📄 video-thumbnail.svg   # صورة الفيديو المصغرة (1280x720)
+```
+
+---
+
+## 🔗 الروابط المطلوبة | Required Links
+
+لإكمال الفيديو، ستحتاج إلى:
+
+1. **رابط لوحة التحكم**: https://c6q1wmkpsakh.space.minimax.io
+2. **رابط المستودع**: https://github.com/[username]/[repo-name]
+3. **رابط المشروع**: [رابط ZIP المرفوع]
+
+---
+
+## 💡 نصائح للتسجيل
+
+### لتسجيل الشاشة (OBS Studio):
+
+```
+1. إنشاء مشهد جديد
+2. إضافة مصدر "Window Capture"
+3. اختيار نافذة المتصفح
+4. ضبط الدقة: 1920x1080
+5. معدل الإطارات: 30fps
+```
+
+### للنصArabic Voiceover:
+
+- استخدم ميكروفون جيد الجودة
+- تحدث بوضوح وبوتيرة متوسطة
+- أضف pauses عند الانتقال بين المشاهد
+- استخدم نبرة واثقة ومهنية
+
+---
+
+## 📊 الجدول الزمني المقترح
+
+| المرحلة | الوقت | الأنشطة |
+|---------|-------|---------|
+| التحضير | 30 دقيقة | قراءة السيناريو، تجهيز الأصول |
+| التسجيل | 1-2 ساعة | تسجيل الشاشة، الصوت، المؤثرات |
+| المونتاج | 2-3 ساعات | تجميع المشاهد، إضافة التأثيرات |
+| المراجعة | 30 دقيقة | مشاهدة، تعديلات نهائية |
+| **الإجمالي** | **4-6 ساعات** | فيديو نهائي احترافي |
+
+---
+
+## 📞 الدعم | Support
+
+للمساعدة في إنتاج الفيديو:
+- راجع قسم [Contributing](../CONTRIBUTING.md) في المشروع
+- أو أضف Issue في المستودع مع وسم "video-production"
+
+---
+
+*صُنع بح ❤️ لفريق Auto-Guardian*

assets/README.md

@@ -0,0 +1,296 @@
+# مجلد الوسائط - assets
+
+<div align="center">
+
+![Auto Guardian System](banner.svg)
+
+**نظام ذكي لحماية الخوادم من التهديدات الإلكترونية**
+
+</div>
+
+---
+
+## مقدمة
+
+يحتوي هذا المجلد على جميع ملفات الوسائط والرسوم التوضيحية المستخدمة في مشروع نظام الحارس التلقائي. جميع الملفات مصممة بتنسيق SVG (Scalable Vector Graphics) لضمان جودة عالية على جميع الشاشات.
+
+---
+
+## قائمة الملفات
+
+| الملف | الوصف | الأبعاد | الاستخدام |
+|-------|-------|---------|-----------|
+| `banner.svg` | البانر الرئيسي للمشروع | 1200×400 | رأس ملف README.md |
+| `dashboard.svg` | لوحة التحكم التوضيحية | 800×600 | قسم لقطات الشاشة |
+| `slack-alert.svg` | نموذج تنبيه Slack | 600×400 | قسم لقطات الشاشة |
+| `discord-alert.svg` | نموذج تنبيه Discord | 600×400 | قسم لقطات الشاشة |
+
+---
+
+## تفاصيل الملفات
+
+### banner.svg
+
+البانر الرئيسي للمشروع الذي يظهر في أعلى ملف README.md.
+
+**المكونات:**
+
+- خلفية تدرجية زرقاء داكنة تعكس الطابع الأمني والتقني
+- أيقونة درع أمان في الجانب الأيسر
+- خطوط شبكية خفيفة في الخلفية
+- عنوان المشروع بالعربية والإنجليزية
+- شارات الترخيص والتقنيات المستخدمة
+- رابط المستودع في الأسفل
+
+**مواصفات التصميم:**
+
+```
+العرض: 1200 بكسل
+الارتفاع: 400 بكسل
+التنسيق: SVG متجهي
+الحجم: ~10 KB
+```
+
+---
+
+### dashboard.svg
+
+لوحة تحكم تفاعلية تعرض الحالة الأمنية للنظام.
+
+**المكونات:**
+
+- رأس مع الشعار والمعلومات
+- أربع بطاقات إحصائية رئيسية
+  - التهديدات المحظورة (أحمر)
+  - معدل النجاح (أخضر)
+  - المشكلات المفتوحة (برتقالي)
+  - زمن الاستجابة (أزرق)
+- مخطط دائري لتوزيع المشاكل
+- رسم بياني خطي لنشاط الفحص
+- جدول المشاكل الحديثة
+
+**مواصفات التصميم:**
+
+```
+العرض: 800 بكسل
+الارتفاع: 600 بكسل
+التنسيق: SVG متجهي
+الحجم: ~25 KB
+```
+
+---
+
+### slack-alert.svg
+
+نموذج لرسالة تنبيه كما تظهر في منصة Slack.
+
+**المكونات:**
+
+- رأس القناة مع أيقونة #
+- معلومات البوت (Auto-Guardian)
+- صندوق تنبيه باللون الأحمر
+- تفاصيل الهجوم (المصدر، المنفذ، عدد المحاولات)
+- حالة "تم الحظر" باللون الأخضر
+- أزرار التفاعل
+
+**مواصفات التصميم:**
+
+```
+العرض: 600 بكسل
+الارتفاع: 400 بكسل
+التنسيق: SVG متجهي
+الحجم: ~15 KB
+```
+
+---
+
+### discord-alert.svg
+
+نموذج لرسالة إشعار بتنسيق Discord Embed.
+
+**المكونات:**
+
+- رأس الرسالة مع أيقونة البوت
+- شريط لون الخطورة
+- عنوان ووصف التهديد
+- حقول منظمة للمعلومات
+- طابع زمني
+- أزرار التفاعل
+
+**مواصفات التصميم:**
+
+```
+العرض: 600 بكسل
+الارتفاع: 400 بكسل
+التنسيق: SVG متجهي
+الحجم: ~15 KB
+```
+
+---
+
+## لماذا نستخدم SVG؟
+
+### مميزات تنسيق SVG
+
+**جودة متجاوبة:**
+
+ملفات SVG هي ملفات متجهية، مما يعني أنها يمكن تكبيرها إلى أي حجم دون فقدان الجودة. هذا مثالي للشاشات عالية الدقة (Retina) والأجهزة المختلفة.
+
+**حجم صغير:**
+
+ملفات SVG عادة ما تكون أصغر بكثير من ملفات PNG المكافئة، مما يساعد في سرعة تحميل صفحات الويب وتحسين أداء الموقع.
+
+**سهولة التعديل:**
+
+يمكن تعديل ألوان ونصوص وأي عنصر في ملف SVG باستخدام أي محرر نصوص بسيط. لا تحتاج لبرنامج تصميم متقدم لإجراء تعديلات بسيطة.
+
+**دعم GitHub:**
+
+GitHub يعرض ملفات SVG مباشرة في Markdown، مما يعني أنها ستظهر تلقائياً في ملف README.md دون الحاجة لاستضافة خارجية.
+
+---
+
+## كيفية إضافة صور جديدة
+
+### الخطوة 1: إنشاء التصميم
+
+يمكنك استخدام أحد البرامج التالية لإنشاء رسومات متجهة:
+
+| البرنامج | النوع | السعر |
+|----------|-------|-------|
+| Inkscape | مفتوح المصدر | مجاني |
+| Figma | ويب | مجاني |
+| Canva | ويب | مجاني/مدفوع |
+| Adobe Illustrator | سطح مكتب | مدفوع |
+
+### الخطوة 2: التصدير
+
+عند تصدير التصميم:
+
+1. اختر تنسيق SVG
+2. تأكد من إزالة البيانات الوصفية غير الضرورية
+3. استخدم الإعدادات الموصى بها:
+   - عدم تضمين صور نقطية (PNG/JPG)
+   - استخدام خطوط قياسية أو تضمين الخطوط
+   - الحفاظ على الأبعاد المناسبة
+
+### الخطوة 3: التحقق
+
+قبل إضافة الملف، تحقق من:
+
+- الملف يعمل بشكل صحيح عند فتحه في المتصفح
+- النص قابل للقراءة على الخلفيات المختلفة
+- الأبعاد مناسبة للاستخدام المقصود
+- حجم الملف معقول (أقل من 100 KB)
+
+### الخطوة 4: الإضافة
+
+لإضافة صورة جديدة:
+
+```bash
+# نسخ الصورة إلى مجلد assets
+cp new-image.svg assets/
+
+# إضافة إلى Git
+git add assets/new-image.svg
+
+# إنشاء التزام
+git commit -m "docs: إضافة صورة توضيحية جديدة"
+
+# رفع إلى GitHub
+git push origin main
+```
+
+---
+
+## معايير التصميم
+
+### الألوان المستخدمة
+
+| الاستخدام | اللون | الكود |
+|-----------|-------|-------|
+| الرئيسي | أزرق داكن | #1a365d |
+| الثانوية | أزرق متوسط | #2b6cb0 |
+| التأكيد | أزرق فاتح | #4299e1 |
+| الخطورة الحرجة | أحمر | #e01e5a |
+| النجاح | أخضر | #48bb78 |
+| التحذير | برتقالي | #f59e0b |
+| النص الفاتح | أبيض/رمادي فاتح | #ffffff / #d1d5db |
+| النص الغامق | رمادي | #374151 |
+
+### الخطوط
+
+نستخدم خطوطاً قياسية لضمان التوافق:
+
+- **العربية:** Noto Sans Arabic, Arial, Tahoma
+- **الإنجليزية:** Arial, Roboto, Open Sans
+- **الكود:** Monaco, Consolas, Courier New
+
+---
+
+## نصائح للصيانة
+
+### فحص الملفات
+
+```bash
+# التحقق من وجود جميع الملفات
+ls -la assets/
+
+# التحقق من حجم الملفات
+du -h assets/*
+
+# التحقق من صحة SVG
+python3 -c "
+import xml.etree.ElementTree as ET
+for f in ['banner.svg', 'dashboard.svg', 'slack-alert.svg', 'discord-alert.svg']:
+    try:
+        ET.parse(f'assets/{f}')
+        print(f'✓ {f} - صالح')
+    except Exception as e:
+        print(f'✗ {f} - خطأ: {e}')
+"
+```
+
+### ضغط الصور
+
+إذا كانت الملفات كبيرة جداً، يمكنك ضغطها:
+
+```bash
+# باستخدام svgo (أداة Node.js)
+npx svgo assets/*.svg
+
+# أو باستخدام أدوات أخرى متاحة
+```
+
+---
+
+## الموارد الإضافية
+
+### أدوات مفيدة
+
+- [SVGOMG](https://jakearchibald.github.io/svgomg/) - ضغط SVG عبر الويب
+- [SVG Preview](https://www.svgviewer.dev/) - عرض SVG عبر الويب
+- [Inkscape](https://inkscape.org/) - محرر SVG مجاني
+- [Boxy SVG](https://boxy-svg.com/) - محرر SVG على الويب
+
+### مراجع التصميم
+
+- [Material Design Icons](https://fonts.google.com/icons) - أيقونات Material
+- [Font Awesome](https://fontawesome.com/) - أيقونات شاملة
+- [Heroicons](https://heroicons.com/) - أيقونات SVG
+
+---
+
+## التحديثات
+
+| التاريخ | التغيير | بواسطة |
+|---------|---------|--------|
+| 2024-10-13 | إضافة جميع الصور الأولية | AbdulElah Othman |
+
+---
+
+<div align="center">
+
+**صُنع بـ ❤️ بواسطة عبد الإله عثمان غويث**
+
+</div>

dashboard/index.html

@@ -0,0 +1,1696 @@
+<!DOCTYPE html>
+<html lang="ar" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Auto-Guardian Dashboard</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        
+        :root {
+            --primary: #0F172A;
+            --secondary: #3B82F6;
+            --success: #10B981;
+            --danger: #EF4444;
+            --warning: #F59E0B;
+            --bg: #F8FAFC;
+            --card-bg: #FFFFFF;
+            --text: #1E293B;
+            --text-muted: #64748B;
+            --border: #E2E8F0;
+        }
+        
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            background-color: var(--bg);
+            color: var(--text);
+            min-height: 100vh;
+            overflow-x: hidden;
+        }
+        
+        .dashboard {
+            display: flex;
+            flex-direction: row;
+            min-height: 100vh;
+            width: 100%;
+        }
+        
+        /* Sidebar */
+        .sidebar {
+            background: var(--primary);
+            color: white;
+            padding: 20px 0;
+            width: 240px;
+            height: 100vh;
+            overflow-y: auto;
+            flex-shrink: 0;
+            position: sticky;
+            top: 0;
+        }
+        
+        .logo {
+            padding: 20px;
+            text-align: center;
+            border-bottom: 1px solid rgba(255,255,255,0.1);
+            margin-bottom: 20px;
+        }
+        
+        .logo h1 {
+            font-size: 20px;
+            font-weight: 700;
+            color: var(--secondary);
+        }
+        
+        .logo span {
+            font-size: 12px;
+            color: var(--text-muted);
+        }
+        
+        .nav-menu {
+            list-style: none;
+        }
+        
+        .nav-item {
+            padding: 12px 20px;
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            border-right: 3px solid transparent;
+        }
+        
+        .nav-item:hover, .nav-item.active {
+            background: rgba(59, 130, 246, 0.1);
+            border-right-color: var(--secondary);
+        }
+        
+        .nav-item svg {
+            width: 20px;
+            height: 20px;
+        }
+        
+        .nav-item span {
+            font-size: 14px;
+        }
+        
+        /* Main Content */
+        .main-content {
+            flex: 1;
+            padding: 20px 30px;
+            min-width: 0;
+            overflow-x: hidden;
+        }
+        
+        /* Header */
+        .header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 30px;
+            flex-wrap: wrap;
+            gap: 15px;
+        }
+        
+        .header h2 {
+            font-size: 24px;
+            font-weight: 600;
+        }
+        
+        .header-actions {
+            display: flex;
+            gap: 12px;
+            align-items: center;
+        }
+        
+        .search-box {
+            display: flex;
+            align-items: center;
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            padding: 8px 16px;
+            gap: 8px;
+            position: relative;
+        }
+        
+        .search-box:hover {
+            border-color: var(--secondary);
+        }
+        
+        .search-box input {
+            border: none;
+            outline: none;
+            font-size: 14px;
+            width: 150px;
+            background: transparent;
+            flex: 1;
+            min-width: 100px;
+        }
+        
+        .search-results {
+            display: none;
+            position: absolute;
+            top: 100%;
+            left: 0;
+            right: 0;
+            background: white;
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            margin-top: 8px;
+            max-height: 300px;
+            overflow-y: auto;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.1);
+            z-index: 100;
+        }
+        
+        .search-results.active {
+            display: block;
+        }
+        
+        .search-result-item {
+            padding: 12px 16px;
+            border-bottom: 1px solid var(--border);
+            cursor: pointer;
+            transition: background 0.3s ease;
+        }
+        
+        .search-result-item:hover {
+            background: var(--bg);
+        }
+        
+        .search-result-item:last-child {
+            border-bottom: none;
+        }
+        
+        .notification-btn {
+            position: relative;
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            padding: 8px 12px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+        
+        .notification-btn:hover {
+            border-color: var(--secondary);
+        }
+        
+        .notification-badge {
+            position: absolute;
+            top: -5px;
+            right: -5px;
+            background: var(--danger);
+            color: white;
+            font-size: 10px;
+            padding: 2px 6px;
+            border-radius: 10px;
+        }
+        
+        /* Settings Panel */
+        .settings-panel {
+            display: none;
+            position: fixed;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 100%;
+            background: rgba(0,0,0,0.5);
+            z-index: 1000;
+            justify-content: center;
+            align-items: center;
+        }
+        
+        .settings-panel.active {
+            display: flex;
+        }
+        
+        .settings-content {
+            background: white;
+            border-radius: 16px;
+            padding: 30px;
+            width: 90%;
+            max-width: 500px;
+            max-height: 80vh;
+            overflow-y: auto;
+        }
+        
+        .settings-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 24px;
+        }
+        
+        .settings-header h3 {
+            font-size: 20px;
+        }
+        
+        .close-btn {
+            background: none;
+            border: none;
+            font-size: 24px;
+            cursor: pointer;
+            color: var(--text-muted);
+        }
+        
+        .setting-item {
+            margin-bottom: 20px;
+        }
+        
+        .setting-label {
+            display: block;
+            font-size: 14px;
+            font-weight: 500;
+            margin-bottom: 8px;
+        }
+        
+        .setting-description {
+            font-size: 12px;
+            color: var(--text-muted);
+            margin-bottom: 8px;
+        }
+        
+        .setting-input {
+            width: 100%;
+            padding: 10px 14px;
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            font-size: 14px;
+            transition: all 0.3s ease;
+        }
+        
+        .setting-input:focus {
+            outline: none;
+            border-color: var(--secondary);
+        }
+        
+        .setting-select {
+            width: 100%;
+            padding: 10px 14px;
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            font-size: 14px;
+            background: white;
+            cursor: pointer;
+        }
+        
+        .setting-toggle {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            cursor: pointer;
+        }
+        
+        .toggle-switch {
+            position: relative;
+            width: 50px;
+            height: 26px;
+            background: var(--border);
+            border-radius: 13px;
+            transition: all 0.3s ease;
+        }
+        
+        .toggle-switch.active {
+            background: var(--secondary);
+        }
+        
+        .toggle-switch::after {
+            content: '';
+            position: absolute;
+            width: 22px;
+            height: 22px;
+            background: white;
+            border-radius: 50%;
+            top: 2px;
+            left: 2px;
+            transition: all 0.3s ease;
+        }
+        
+        .toggle-switch.active::after {
+            left: 26px;
+        }
+        
+        .save-btn {
+            width: 100%;
+            padding: 12px;
+            background: var(--secondary);
+            color: white;
+            border: none;
+            border-radius: 8px;
+            font-size: 14px;
+            font-weight: 500;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+        
+        .save-btn:hover {
+            background: var(--primary);
+        }
+        
+        /* Stats Grid */
+        .stats-grid {
+            display: grid;
+            grid-template-columns: repeat(4, 1fr);
+            gap: 20px;
+            margin-bottom: 30px;
+        }
+        
+        .stat-card {
+            background: var(--card-bg);
+            border-radius: 12px;
+            padding: 20px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+            transition: transform 0.3s ease, box-shadow 0.3s ease;
+            cursor: pointer;
+        }
+        
+        .stat-card:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+        }
+        
+        .stat-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: flex-start;
+            margin-bottom: 12px;
+        }
+        
+        .stat-icon {
+            width: 40px;
+            height: 40px;
+            border-radius: 10px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        
+        .stat-icon.blue { background: rgba(59, 130, 246, 0.1); color: var(--secondary); }
+        .stat-icon.green { background: rgba(16, 185, 129, 0.1); color: var(--success); }
+        .stat-icon.red { background: rgba(239, 68, 68, 0.1); color: var(--danger); }
+        .stat-icon.yellow { background: rgba(245, 158, 11, 0.1); color: var(--warning); }
+        
+        .stat-trend {
+            font-size: 12px;
+            display: flex;
+            align-items: center;
+            gap: 4px;
+        }
+        
+        .stat-trend.up { color: var(--success); }
+        .stat-trend.down { color: var(--danger); }
+        
+        .stat-value {
+            font-size: 28px;
+            font-weight: 700;
+            margin-bottom: 4px;
+        }
+        
+        .stat-label {
+            font-size: 13px;
+            color: var(--text-muted);
+        }
+        
+        /* Charts Section */
+        .charts-section {
+            display: grid;
+            grid-template-columns: 2fr 1fr;
+            gap: 20px;
+            margin-bottom: 30px;
+        }
+        
+        .chart-card {
+            background: var(--card-bg);
+            border-radius: 12px;
+            padding: 20px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        }
+        
+        .chart-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 20px;
+        }
+        
+        .chart-title {
+            font-size: 16px;
+            font-weight: 600;
+        }
+        
+        .chart-tabs {
+            display: flex;
+            gap: 8px;
+        }
+        
+        .chart-tab {
+            padding: 6px 12px;
+            border-radius: 6px;
+            font-size: 12px;
+            cursor: pointer;
+            background: var(--bg);
+            border: none;
+            transition: all 0.3s ease;
+        }
+        
+        .chart-tab.active {
+            background: var(--secondary);
+            color: white;
+        }
+        
+        .chart-tab:hover:not(.active) {
+            background: var(--border);
+        }
+        
+        /* Area Chart */
+        .area-chart {
+            height: 250px;
+            position: relative;
+        }
+        
+        .chart-svg {
+            width: 100%;
+            height: 100%;
+        }
+        
+        /* Donut Chart */
+        .donut-chart {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 30px;
+        }
+        
+        .donut-svg {
+            width: 180px;
+            height: 180px;
+        }
+        
+        .donut-legend {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+        
+        .legend-item {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        
+        .legend-color {
+            width: 12px;
+            height: 12px;
+            border-radius: 3px;
+        }
+        
+        .legend-label {
+            font-size: 13px;
+            color: var(--text-muted);
+        }
+        
+        .legend-value {
+            font-size: 14px;
+            font-weight: 600;
+            margin-right: auto;
+        }
+        
+        /* Activity Section */
+        .activity-section {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 20px;
+        }
+        
+        .activity-card {
+            background: var(--card-bg);
+            border-radius: 12px;
+            padding: 20px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        }
+        
+        .activity-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 16px;
+        }
+        
+        .activity-title {
+            font-size: 16px;
+            font-weight: 600;
+        }
+        
+        .view-all {
+            font-size: 13px;
+            color: var(--secondary);
+            cursor: pointer;
+        }
+        
+        .view-all:hover {
+            text-decoration: underline;
+        }
+        
+        /* Issues List */
+        .issues-list {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+        
+        .issue-item {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            padding: 12px;
+            background: var(--bg);
+            border-radius: 8px;
+            transition: all 0.3s ease;
+            cursor: pointer;
+        }
+        
+        .issue-item:hover {
+            background: rgba(59, 130, 246, 0.05);
+        }
+        
+        .issue-icon {
+            width: 32px;
+            height: 32px;
+            border-radius: 8px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        
+        .issue-content {
+            flex: 1;
+        }
+        
+        .issue-title {
+            font-size: 13px;
+            font-weight: 500;
+            margin-bottom: 2px;
+        }
+        
+        .issue-meta {
+            font-size: 11px;
+            color: var(--text-muted);
+        }
+        
+        .issue-badge {
+            padding: 4px 10px;
+            border-radius: 20px;
+            font-size: 11px;
+            font-weight: 500;
+        }
+        
+        .badge-critical { background: rgba(239, 68, 68, 0.1); color: var(--danger); }
+        .badge-warning { background: rgba(245, 158, 11, 0.1); color: var(--warning); }
+        .badge-info { background: rgba(59, 130, 246, 0.1); color: var(--secondary); }
+        .badge-success { background: rgba(16, 185, 129, 0.1); color: var(--success); }
+        
+        /* Repositories List */
+        .repos-list {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+        
+        .repo-item {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            padding: 12px;
+            background: var(--bg);
+            border-radius: 8px;
+            transition: all 0.3s ease;
+            cursor: pointer;
+        }
+        
+        .repo-item:hover {
+            background: rgba(59, 130, 246, 0.05);
+        }
+        
+        .repo-icon {
+            width: 36px;
+            height: 36px;
+            border-radius: 8px;
+            background: var(--primary);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: white;
+        }
+        
+        .repo-content {
+            flex: 1;
+        }
+        
+        .repo-name {
+            font-size: 13px;
+            font-weight: 500;
+            margin-bottom: 2px;
+        }
+        
+        .repo-stats {
+            display: flex;
+            gap: 12px;
+            font-size: 11px;
+            color: var(--text-muted);
+        }
+        
+        .repo-status {
+            display: flex;
+            align-items: center;
+            gap: 4px;
+            font-size: 12px;
+        }
+        
+        .status-dot {
+            width: 8px;
+            height: 8px;
+            border-radius: 50%;
+        }
+        
+        .status-dot.active { background: var(--success); }
+        .status-dot.warning { background: var(--warning); }
+        .status-dot.error { background: var(--danger); }
+        
+        /* Toast Notifications */
+        .toast-container {
+            position: fixed;
+            top: 20px;
+            left: 50%;
+            transform: translateX(-50%);
+            z-index: 2000;
+            display: flex;
+            flex-direction: column;
+            gap: 10px;
+        }
+        
+        .toast {
+            padding: 14px 20px;
+            background: var(--primary);
+            color: white;
+            border-radius: 10px;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.2);
+            display: flex;
+            align-items: center;
+            gap: 10px;
+            animation: slideIn 0.3s ease, fadeOut 0.3s ease 2.7s;
+        }
+        
+        .toast.success { background: var(--success); }
+        .toast.error { background: var(--danger); }
+        .toast.warning { background: var(--warning); }
+        .toast.info { background: var(--secondary); }
+        
+        @keyframes slideIn {
+            from { transform: translateY(-20px); opacity: 0; }
+            to { transform: translateY(0); opacity: 1; }
+        }
+        
+        @keyframes fadeOut {
+            from { opacity: 1; }
+            to { opacity: 0; }
+        }
+        
+        /* Responsive */
+        @media (max-width: 1200px) {
+            .stats-grid {
+                grid-template-columns: repeat(2, 1fr);
+            }
+            .charts-section {
+                grid-template-columns: 1fr;
+            }
+            .activity-section {
+                grid-template-columns: 1fr;
+            }
+        }
+        
+        @media (max-width: 992px) {
+            .sidebar {
+                position: fixed;
+                right: -240px;
+                top: 0;
+                z-index: 1000;
+                transition: right 0.3s ease;
+                box-shadow: -4px 0 20px rgba(0,0,0,0.1);
+            }
+            
+            .sidebar.active {
+                right: 0;
+            }
+            
+            .sidebar-overlay {
+                display: none;
+                position: fixed;
+                top: 0;
+                left: 0;
+                width: 100%;
+                height: 100%;
+                background: rgba(0,0,0,0.5);
+                z-index: 999;
+            }
+            
+            .sidebar-overlay.active {
+                display: block;
+            }
+            
+            .main-content {
+                width: 100%;
+                padding: 15px 20px;
+            }
+            
+            .mobile-menu-btn {
+                display: flex !important;
+            }
+            
+            .header-actions {
+                gap: 8px;
+            }
+            
+            .search-box {
+                min-width: 120px;
+            }
+            
+            .search-box input {
+                width: 80px;
+            }
+        }
+        
+        @media (max-width: 768px) {
+            .dashboard {
+                flex-direction: column;
+            }
+            
+            .stats-grid {
+                grid-template-columns: 1fr;
+                gap: 12px;
+            }
+            
+            .stat-card {
+                padding: 15px;
+                display: flex;
+                align-items: center;
+                justify-content: space-between;
+                flex-wrap: wrap;
+            }
+            
+            .stat-header {
+                margin-bottom: 0;
+                width: auto;
+            }
+            
+            .stat-value {
+                font-size: 24px;
+                text-align: left;
+            }
+            
+            .stat-label {
+                text-align: left;
+                width: 100%;
+            }
+            
+            .charts-section {
+                gap: 15px;
+                margin-bottom: 20px;
+            }
+            
+            .chart-card {
+                padding: 15px;
+            }
+            
+            .area-chart {
+                height: 200px;
+            }
+            
+            .donut-chart {
+                flex-direction: column;
+                gap: 15px;
+            }
+            
+            .donut-svg {
+                width: 150px;
+                height: 150px;
+            }
+            
+            .activity-section {
+                gap: 15px;
+            }
+            
+            .activity-card {
+                padding: 15px;
+            }
+            
+            .header {
+                margin-bottom: 20px;
+            }
+            
+            .header h2 {
+                font-size: 20px;
+                width: 100%;
+            }
+            
+            .header-actions {
+                width: 100%;
+                justify-content: space-between;
+            }
+            
+            .search-box {
+                flex: 1;
+                min-width: 0;
+            }
+            
+            .search-box input {
+                width: 100%;
+            }
+            
+            .notification-btn {
+                padding: 8px;
+            }
+        }
+        
+        @media (max-width: 480px) {
+            .stat-card {
+                padding: 12px;
+            }
+            
+            .stat-icon {
+                width: 36px;
+                height: 36px;
+            }
+            
+            .stat-value {
+                font-size: 20px;
+            }
+            
+            .stat-label {
+                font-size: 12px;
+            }
+            
+            .chart-title {
+                font-size: 14px;
+            }
+            
+            .chart-tabs {
+                gap: 4px;
+            }
+            
+            .chart-tab {
+                padding: 4px 8px;
+                font-size: 11px;
+            }
+            
+            .issue-item, .repo-item {
+                padding: 10px;
+            }
+            
+            .issue-icon {
+                width: 28px;
+                height: 28px;
+            }
+            
+            .issue-title {
+                font-size: 12px;
+            }
+            
+            .issue-meta {
+                font-size: 10px;
+            }
+        }
+        
+        /* Mobile Menu Button */
+        .mobile-menu-btn {
+            display: none;
+            position: fixed;
+            bottom: 20px;
+            left: 20px;
+            width: 50px;
+            height: 50px;
+            border-radius: 50%;
+            background: var(--secondary);
+            color: white;
+            border: none;
+            cursor: pointer;
+            z-index: 1001;
+            box-shadow: 0 4px 15px rgba(59, 130, 246, 0.4);
+            align-items: center;
+            justify-content: center;
+            transition: all 0.3s ease;
+        }
+        
+        .mobile-menu-btn:hover {
+            transform: scale(1.1);
+            background: var(--primary);
+        }
+        
+        .mobile-menu-btn svg {
+            width: 24px;
+            height: 24px;
+        }
+        
+        /* Sidebar Overlay */
+        .sidebar-overlay {
+            display: none;
+        }
+    </style>
+</head>
+<body>
+    <div class="dashboard">
+        <!-- Sidebar Overlay -->
+        <div class="sidebar-overlay" id="sidebarOverlay" onclick="toggleMobileMenu()"></div>
+        
+        <!-- Sidebar -->
+        <aside class="sidebar" id="sidebar">
+            <div class="logo">
+                <h1>Auto-Guardian</h1>
+                <span>Security Dashboard</span>
+            </div>
+            <ul class="nav-menu">
+                <li class="nav-item active" data-view="dashboard">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2V6zM14 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2V6zM4 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2v-2zM14 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2v-2z"/>
+                    </svg>
+                    <span>لوحة التحكم</span>
+                </li>
+                <li class="nav-item" data-view="protection">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z"/>
+                    </svg>
+                    <span>الحماية</span>
+                </li>
+                <li class="nav-item" data-view="analysis">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01"/>
+                    </svg>
+                    <span>الفحص والتحليل</span>
+                </li>
+                <li class="nav-item" data-view="reports">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>
+                    </svg>
+                    <span>التقارير</span>
+                </li>
+                <li class="nav-item" data-view="settings" id="settingsNavItem">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"/>
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                    </svg>
+                    <span>الإعدادات</span>
+                </li>
+                <li class="nav-item" data-view="help">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    <span>المساعدة</span>
+                </li>
+            </ul>
+        </aside>
+        
+        <!-- Mobile Menu Button -->
+        <button class="mobile-menu-btn" id="mobileMenuBtn" onclick="toggleMobileMenu()">
+            <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"/>
+            </svg>
+        </button>
+        
+        <!-- Main Content -->
+        <main class="main-content">
+            <!-- Header -->
+            <header class="header">
+                <h2>لوحة تحكم Auto-Guardian</h2>
+                <div class="header-actions">
+                    <div class="search-box" id="searchBox">
+                        <svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+                        </svg>
+                        <input type="text" placeholder="بحث..." id="searchInput">
+                        <div class="search-results" id="searchResults"></div>
+                    </div>
+                    <button class="notification-btn" id="notificationBtn">
+                        <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9"/>
+                        </svg>
+                        <span class="notification-badge" id="notificationBadge">5</span>
+                    </button>
+                </div>
+            </header>
+            
+            <!-- Stats Grid -->
+            <div class="stats-grid">
+                <div class="stat-card" onclick="filterIssues('critical')">
+                    <div class="stat-header">
+                        <div class="stat-icon blue">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend up" id="trendCritical">↑ 12%</span>
+                    </div>
+                    <div class="stat-value" id="statThreats">1,247</div>
+                    <div class="stat-label">التهديدات المحظورة</div>
+                </div>
+                
+                <div class="stat-card">
+                    <div class="stat-header">
+                        <div class="stat-icon green">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend up" id="trendSuccess">↑ 8%</span>
+                    </div>
+                    <div class="stat-value" id="statSuccess">99.9%</div>
+                    <div class="stat-label">معدل النجاح</div>
+                </div>
+                
+                <div class="stat-card" onclick="filterIssues('open')">
+                    <div class="stat-header">
+                        <div class="stat-icon red">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend down" id="trendOpen">↓ 3%</span>
+                    </div>
+                    <div class="stat-value" id="statOpen">23</div>
+                    <div class="stat-label">المشكلات المفتوحة</div>
+                </div>
+                
+                <div class="stat-card">
+                    <div class="stat-header">
+                        <div class="stat-icon yellow">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend up" id="trendResponse">↑ 15%</span>
+                    </div>
+                    <div class="stat-value" id="statResponse">0.3s</div>
+                    <div class="stat-label">زمن الاستجابة</div>
+                </div>
+            </div>
+            
+            <!-- Charts Section -->
+            <div class="charts-section">
+                <div class="chart-card">
+                    <div class="chart-header">
+                        <h3 class="chart-title">نشاط الفحص والأمان</h3>
+                        <div class="chart-tabs">
+                            <button class="chart-tab" data-period="day" onclick="changePeriod('day')">24 ساعة</button>
+                            <button class="chart-tab active" data-period="week" onclick="changePeriod('week')">أسبوع</button>
+                            <button class="chart-tab" data-period="month" onclick="changePeriod('month')">شهر</button>
+                        </div>
+                    </div>
+                    <div class="area-chart">
+                        <svg class="chart-svg" viewBox="0 0 800 250" id="mainChart">
+                            <!-- Grid lines -->
+                            <line x1="50" y1="30" x2="750" y2="30" stroke="#E2E8F0" stroke-width="1"/>
+                            <line x1="50" y1="80" x2="750" y2="80" stroke="#E2E8F0" stroke-width="1"/>
+                            <line x1="50" y1="130" x2="750" y2="130" stroke="#E2E8F0" stroke-width="1"/>
+                            <line x1="50" y1="180" x2="750" y2="180" stroke="#E2E8F0" stroke-width="1"/>
+                            
+                            <!-- Area gradient -->
+                            <defs>
+                                <linearGradient id="areaGradient" x1="0%" y1="0%" x2="0%" y2="100%">
+                                    <stop offset="0%" style="stop-color:#3B82F6;stop-opacity:0.3"/>
+                                    <stop offset="100%" style="stop-color:#3B82F6;stop-opacity:0.05"/>
+                                </linearGradient>
+                            </defs>
+                            
+                            <!-- Area path -->
+                            <path d="M50,180 L100,150 L150,160 L200,120 L250,140 L300,100 L350,110 L400,70 L450,90 L500,60 L550,80 L600,50 L650,65 L700,40 L750,55 L750,180 Z" fill="url(#areaGradient)"/>
+                            
+                            <!-- Line -->
+                            <path d="M50,180 L100,150 L150,160 L200,120 L250,140 L300,100 L350,110 L400,70 L450,90 L500,60 L550,80 L600,50 L650,65 L700,40 L750,55" fill="none" stroke="#3B82F6" stroke-width="3" stroke-linecap="round"/>
+                            
+                            <!-- Data points -->
+                            <circle cx="100" cy="150" r="5" fill="#3B82F6" class="chart-point" data-value="45"/>
+                            <circle cx="200" cy="120" r="5" fill="#3B82F6" class="chart-point" data-value="60"/>
+                            <circle cx="300" cy="100" r="5" fill="#3B82F6" class="chart-point" data-value="70"/>
+                            <circle cx="400" cy="70" r="5" fill="#3B82F6" class="chart-point" data-value="85"/>
+                            <circle cx="500" cy="60" r="5" fill="#3B82F6" class="chart-point" data-value="90"/>
+                            <circle cx="600" cy="50" r="5" fill="#3B82F6" class="chart-point" data-value="95"/>
+                            <circle cx="700" cy="40" r="5" fill="#3B82F6" class="chart-point" data-value="100"/>
+                            
+                            <!-- Labels -->
+                            <text x="50" y="200" fill="#64748B" font-size="11">السبت</text>
+                            <text x="150" y="200" fill="#64748B" font-size="11">الأحد</text>
+                            <text x="250" y="200" fill="#64748B" font-size="11">الاثنين</text>
+                            <text x="350" y="200" fill="#64748B" font-size="11">الثلاثاء</text>
+                            <text x="450" y="200" fill="#64748B" font-size="11">الأربعاء</text>
+                            <text x="550" y="200" fill="#64748B" font-size="11">الخميس</text>
+                            <text x="650" y="200" fill="#64748B" font-size="11">الجمعة</text>
+                            
+                            <!-- Y-axis labels -->
+                            <text x="45" y="35" text-anchor="end" fill="#64748B" font-size="10">100</text>
+                            <text x="45" y="85" text-anchor="end" fill="#64748B" font-size="10">75</text>
+                            <text x="45" y="135" text-anchor="end" fill="#64748B" font-size="10">50</text>
+                            <text x="45" y="185" text-anchor="end" fill="#64748B" font-size="10">25</text>
+                        </svg>
+                    </div>
+                </div>
+                
+                <div class="chart-card">
+                    <div class="chart-header">
+                        <h3 class="chart-title">توزيع المشكلات</h3>
+                    </div>
+                    <div class="donut-chart">
+                        <svg class="donut-svg" viewBox="0 0 180 180">
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#E2E8F0" stroke-width="25"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#EF4444" stroke-width="25" stroke-dasharray="110 308" stroke-dashoffset="0" transform="rotate(-90 90 90)"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#F59E0B" stroke-width="25" stroke-dasharray="88 308" stroke-dashoffset="-110" transform="rotate(-90 90 90)"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#3B82F6" stroke-width="25" stroke-dasharray="66 308" stroke-dashoffset="-198" transform="rotate(-90 90 90)"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#10B981" stroke-width="25" stroke-dasharray="44 308" stroke-dashoffset="-264" transform="rotate(-90 90 90)"/>
+                            <text x="90" y="85" text-anchor="middle" font-size="24" font-weight="bold" fill="#0F172A" id="donutTotal">23</text>
+                            <text x="90" y="105" text-anchor="middle" font-size="12" fill="#64748B">إجمالي</text>
+                        </svg>
+                        <div class="donut-legend">
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#EF4444"></div>
+                                <span class="legend-label">ح��جة</span>
+                                <span class="legend-value" id="legendCritical">5</span>
+                            </div>
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#F59E0B"></div>
+                                <span class="legend-label">عالية</span>
+                                <span class="legend-value" id="legendHigh">7</span>
+                            </div>
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#3B82F6"></div>
+                                <span class="legend-label">متوسطة</span>
+                                <span class="legend-value" id="legendMedium">6</span>
+                            </div>
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#10B981"></div>
+                                <span class="legend-label">منخفضة</span>
+                                <span class="legend-value" id="legendLow">5</span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            
+            <!-- Activity Section -->
+            <div class="activity-section">
+                <div class="activity-card">
+                    <div class="activity-header">
+                        <h3 class="activity-title">أحدث المشكلات</h3>
+                        <span class="view-all" onclick="filterIssues('all')">عرض الكل →</span>
+                    </div>
+                    <div class="issues-list" id="issuesList">
+                        <!-- Issues will be populated by JavaScript -->
+                    </div>
+                </div>
+                
+                <div class="activity-card">
+                    <div class="activity-header">
+                        <h3 class="activity-title">المستودعات النشطة</h3>
+                        <span class="view-all">عرض الكل →</span>
+                    </div>
+                    <div class="repos-list" id="reposList">
+                        <!-- Repositories will be populated by JavaScript -->
+                    </div>
+                </div>
+            </div>
+        </main>
+    </div>
+    
+    <!-- Settings Panel -->
+    <div class="settings-panel" id="settingsPanel">
+        <div class="settings-content">
+            <div class="settings-header">
+                <h3>⚙️ الإعدادات</h3>
+                <button class="close-btn" onclick="closeSettings()">&times;</button>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">اسم المستخدم</label>
+                <input type="text" class="setting-input" id="settingUsername" placeholder="أدخل اسم المستخدم">
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">البريد الإلكتروني</label>
+                <input type="email" class="setting-input" id="settingEmail" placeholder="أدخل البريد الإلكتروني">
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">لغة الواجهة</label>
+                <select class="setting-select" id="settingLanguage">
+                    <option value="ar">العربية</option>
+                    <option value="en">English</option>
+                </select>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">السمة</label>
+                <select class="setting-select" id="settingTheme">
+                    <option value="light">فاتحة</option>
+                    <option value="dark">داكنة</option>
+                    <option value="auto">تلقائي</option>
+                </select>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">فحص تلقائي عند الحفظ</label>
+                <div class="setting-toggle" onclick="toggleSetting('autoScan')">
+                    <div class="toggle-switch" id="toggleAutoScan"></div>
+                    <span>تشغيل</span>
+                </div>
+                <p class="setting-description">إجراء فحص تلقائي للكود عند حفظ الملفات</p>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">إشعارات المشاكل الحرجة</label>
+                <div class="setting-toggle" onclick="toggleSetting('criticalAlerts')">
+                    <div class="toggle-switch" id="toggleCriticalAlerts"></div>
+                    <span>تشغيل</span>
+                </div>
+                <p class="setting-description">إرسال إشعارات فورية للمشاكل الأمنية الحرجة</p>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">الإصلاح التلقائي الآمن</label>
+                <div class="setting-toggle" onclick="toggleSetting('autoFix')">
+                    <div class="toggle-switch" id="toggleAutoFix"></div>
+                    <span>تشغيل</span>
+                </div>
+                <p class="setting-description">إصلاح المشاكل الآمنة تلقائياً دون تدخل</p>
+            </div>
+            
+            <button class="save-btn" onclick="saveSettings()">💾 حفظ الإعدادات</button>
+        </div>
+    </div>
+    
+    <!-- Toast Container -->
+    <div class="toast-container" id="toastContainer"></div>
+
+    <script>
+        // Data
+        let currentData = {
+            threats: 1247,
+            successRate: 99.9,
+            openIssues: 23,
+            responseTime: 0.3,
+            issues: [],
+            repos: []
+        };
+        
+        let settings = {
+            username: '',
+            email: '',
+            language: 'ar',
+            theme: 'light',
+            autoScan: true,
+            criticalAlerts: true,
+            autoFix: true
+        };
+        
+        // Sample Data
+        const sampleIssues = [
+            { id: 1, title: 'ثغرة أمنية في وحدة المصادقة', file: 'auth-module.py', time: 'قبل 5 دقائق', severity: 'critical' },
+            { id: 2, title: 'فشل في اختبارات الأداء', file: 'performance_test.py', time: 'قبل 23 دقيقة', severity: 'warning' },
+            { id: 3, title: 'تحذير في تنسيق الكود', file: 'main_controller.dart', time: 'قبل ساعة', severity: 'info' },
+            { id: 4, title: 'تم إصلاح مشكلة التنسيق تلقائياً', file: 'utils_helper.js', time: 'قبل ساعتين', severity: 'success' },
+            { id: 5, title: 'مشكلة في اتصال قاعدة البيانات', file: 'db_connection.java', time: 'قبل ساعتين', severity: 'critical' },
+            { id: 6, title: 'تحذير: استخدام دالة قديمة', file: 'legacy_code.py', time: 'قبل 3 ساعات', severity: 'warning' }
+        ];
+        
+        const sampleRepos = [
+            { id: 1, name: 'auto-guardian-system', stars: 124, pullRequests: 45, bugs: 3, status: 'active' },
+            { id: 2, name: 'payment-gateway-api', stars: 89, pullRequests: 32, bugs: 5, status: 'warning' },
+            { id: 3, name: 'user-management-service', stars: 56, pullRequests: 18, bugs: 1, status: 'active' },
+            { id: 4, name: 'data-analytics-platform', stars: 234, pullRequests: 67, bugs: 8, status: 'error' }
+        ];
+        
+        // Initialize
+        document.addEventListener('DOMContentLoaded', function() {
+            loadSettings();
+            loadData();
+            renderIssues();
+            renderRepos();
+            setupEventListeners();
+            setupMobileMenu();
+            showToast('🎉 مرحباً بك في Auto-Guardian!', 'success');
+        });
+        
+        // Setup Mobile Menu
+        function setupMobileMenu() {
+            const mobileMenuBtn = document.getElementById('mobileMenuBtn');
+            if (mobileMenuBtn) {
+                // Show/hide mobile menu button based on screen size
+                const checkScreenSize = () => {
+                    if (window.innerWidth <= 992) {
+                        mobileMenuBtn.style.display = 'flex';
+                    } else {
+                        mobileMenuBtn.style.display = 'none';
+                        closeMobileMenu();
+                    }
+                };
+                
+                checkScreenSize();
+                window.addEventListener('resize', checkScreenSize);
+            }
+        }
+        
+        // Toggle Mobile Menu
+        function toggleMobileMenu() {
+            const sidebar = document.getElementById('sidebar');
+            const overlay = document.getElementById('sidebarOverlay');
+            
+            if (sidebar && overlay) {
+                sidebar.classList.toggle('active');
+                overlay.classList.toggle('active');
+            }
+        }
+        
+        // Close Mobile Menu
+        function closeMobileMenu() {
+            const sidebar = document.getElementById('sidebar');
+            const overlay = document.getElementById('sidebarOverlay');
+            
+            if (sidebar) {
+                sidebar.classList.remove('active');
+            }
+            if (overlay) {
+                overlay.classList.remove('active');
+            }
+        }
+        
+        // Load Settings from LocalStorage
+        function loadSettings() {
+            const saved = localStorage.getItem('autoGuardianSettings');
+            if (saved) {
+                settings = JSON.parse(saved);
+            }
+            
+            // Update UI
+            document.getElementById('settingUsername').value = settings.username || '';
+            document.getElementById('settingEmail').value = settings.email || '';
+            document.getElementById('settingLanguage').value = settings.language || 'ar';
+            document.getElementById('settingTheme').value = settings.theme || 'light';
+            updateToggle('toggleAutoScan', settings.autoScan);
+            updateToggle('toggleCriticalAlerts', settings.criticalAlerts);
+            updateToggle('toggleAutoFix', settings.autoFix);
+        }
+        
+        // Save Settings to LocalStorage
+        function saveSettings() {
+            settings.username = document.getElementById('settingUsername').value;
+            settings.email = document.getElementById('settingEmail').value;
+            settings.language = document.getElementById('settingLanguage').value;
+            settings.theme = document.getElementById('settingTheme').value;
+            
+            localStorage.setItem('autoGuardianSettings', JSON.stringify(settings));
+            closeSettings();
+            showToast('✅ تم حفظ الإعدادات بنجاح!', 'success');
+        }
+        
+        // Update toggle UI
+        function updateToggle(id, value) {
+            const toggle = document.getElementById(id);
+            if (value) {
+                toggle.classList.add('active');
+            } else {
+                toggle.classList.remove('active');
+            }
+        }
+        
+        // Toggle setting
+        function toggleSetting(setting) {
+            settings[setting] = !settings[setting];
+            updateToggle('toggle' + setting.charAt(0).toUpperCase() + setting.slice(1), settings[setting]);
+            showToast(`⚙️ تم ${settings[setting] ? 'تفعيل' : 'تعطيل'} ${setting}`, 'info');
+        }
+        
+        // Load Data
+        function loadData() {
+            currentData.issues = sampleIssues;
+            currentData.repos = sampleRepos;
+            
+            // Randomize some values
+            currentData.threats = Math.floor(Math.random() * 2000) + 500;
+            currentData.openIssues = Math.floor(Math.random() * 30) + 10;
+            currentData.responseTime = (Math.random() * 0.5 + 0.1).toFixed(1);
+            
+            updateStatsUI();
+        }
+        
+        // Update Stats UI
+        function updateStatsUI() {
+            document.getElementById('statThreats').textContent = currentData.threats.toLocaleString();
+            document.getElementById('statSuccess').textContent = currentData.successRate + '%';
+            document.getElementById('statOpen').textContent = currentData.openIssues;
+            document.getElementById('statResponse').textContent = currentData.responseTime + 's';
+            
+            // Update legend
+            const critical = currentData.issues.filter(i => i.severity === 'critical').length;
+            const warning = currentData.issues.filter(i => i.severity === 'warning').length;
+            const info = currentData.issues.filter(i => i.severity === 'info').length;
+            const success = currentData.issues.filter(i => i.severity === 'success').length;
+            
+            document.getElementById('legendCritical').textContent = critical;
+            document.getElementById('legendHigh').textContent = warning;
+            document.getElementById('legendMedium').textContent = info;
+            document.getElementById('legendLow').textContent = success;
+            document.getElementById('donutTotal').textContent = currentData.issues.length;
+        }
+        
+        // Render Issues
+        function renderIssues(issues = currentData.issues) {
+            const container = document.getElementById('issuesList');
+            container.innerHTML = '';
+            
+            issues.forEach(issue => {
+                const severityClass = issue.severity === 'critical' ? 'badge-critical' : 
+                                     issue.severity === 'warning' ? 'badge-warning' :
+                                     issue.severity === 'info' ? 'badge-info' : 'badge-success';
+                
+                const severityLabel = issue.severity === 'critical' ? 'حرجة' : 
+                                     issue.severity === 'warning' ? 'عالية' :
+                                     issue.severity === 'info' ? 'متوسطة' : 'تم الإصلاح';
+                
+                const iconSvg = issue.severity === 'critical' ? 
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/></svg>' :
+                    issue.severity === 'warning' ?
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>' :
+                    issue.severity === 'success' ?
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>' :
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>';
+                
+                const html = `
+                    <div class="issue-item" onclick="showIssueDetails(${issue.id})">
+                        <div class="issue-icon" style="background: rgba(${issue.severity === 'critical' ? '239, 68, 68' : issue.severity === 'warning' ? '245, 158, 11' : issue.severity === 'success' ? '16, 185, 129' : '59, 130, 246'}, 0.1); color: ${issue.severity === 'critical' ? '#EF4444' : issue.severity === 'warning' ? '#F59E0B' : issue.severity === 'success' ? '#10B981' : '#3B82F6'};">
+                            ${iconSvg}
+                        </div>
+                        <div class="issue-content">
+                            <div class="issue-title">${issue.title}</div>
+                            <div class="issue-meta">${issue.file} • ${issue.time}</div>
+                        </div>
+                        <span class="issue-badge ${severityClass}">${severityLabel}</span>
+                    </div>
+                `;
+                container.innerHTML += html;
+            });
+        }
+        
+        // Render Repositories
+        function renderRepos(repos = currentData.repos) {
+            const container = document.getElementById('reposList');
+            container.innerHTML = '';
+            
+            repos.forEach(repo => {
+                const statusClass = repo.status === 'active' ? 'active' : repo.status === 'warning' ? 'warning' : 'error';
+                const statusLabel = repo.status === 'active' ? 'نشط' : repo.status === 'warning' ? 'يحتاج مراجعة' : 'مشاكل';
+                const statusColor = repo.status === 'active' ? '#10B981' : repo.status === 'warning' ? '#F59E0B' : '#EF4444';
+                
+                const html = `
+                    <div class="repo-item">
+                        <div class="repo-icon">
+                            <svg width="18" height="18" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z"/>
+                            </svg>
+                        </div>
+                        <div class="repo-content">
+                            <div class="repo-name">${repo.name}</div>
+                            <div class="repo-stats">
+                                <span>⭐ ${repo.stars}</span>
+                                <span>🔀 ${repo.pullRequests}</span>
+                                <span>🐛 ${repo.bugs}</span>
+                            </div>
+                        </div>
+                        <div class="repo-status">
+                            <span class="status-dot ${statusClass}"></span>
+                            <span style="color: ${statusColor};">${statusLabel}</span>
+                        </div>
+                    </div>
+                `;
+                container.innerHTML += html;
+            });
+        }
+        
+        // Filter Issues
+        function filterIssues(type) {
+            let filtered = currentData.issues;
+            
+            if (type === 'critical') {
+                filtered = currentData.issues.filter(i => i.severity === 'critical');
+                showToast(`🔍 عرض ${filtered.length} مشكلة حرجة`, 'info');
+            } else if (type === 'open') {
+                filtered = currentData.issues.filter(i => i.severity !== 'success');
+                showToast(`🔍 عرض ${filtered.length} مشكلة مفتوحة`, 'info');
+            } else if (type === 'all') {
+                showToast(`🔍 عرض ${filtered.length} مشكلة`, 'info');
+            }
+            
+            renderIssues(filtered);
+        }
+        
+        // Show Issue Details
+        function showIssueDetails(id) {
+            const issue = currentData.issues.find(i => i.id === id);
+            if (issue) {
+                showToast(`📋 ${issue.title} - ${issue.file}`, 'info');
+            }
+        }
+        
+        // Change Chart Period
+        function changePeriod(period) {
+            // Update active tab
+            document.querySelectorAll('.chart-tab').forEach(tab => {
+                tab.classList.remove('active');
+                if (tab.dataset.period === period) {
+                    tab.classList.add('active');
+                }
+            });
+            
+            // Update chart data based on period
+            showToast(`📊 عرض بيانات ${period === 'day' ? '24 ساعة' : period === 'week' ? 'أسبوع' : 'شهر'}`, 'info');
+            
+            // Simulate data update
+            const randomFactor = period === 'day' ? 1 : period === 'week' ? 7 : 30;
+            currentData.threats = Math.floor(Math.random() * 2000 * randomFactor) + 500;
+            updateStatsUI();
+        }
+        
+        // Search Functionality
+        function setupEventListeners() {
+            // Navigation
+            document.querySelectorAll('.nav-item').forEach(item => {
+                item.addEventListener('click', function() {
+                    const view = this.dataset.view;
+                    
+                    document.querySelectorAll('.nav-item').forEach(i => i.classList.remove('active'));
+                    this.classList.add('active');
+                    
+                    // Close mobile menu when navigating
+                    closeMobileMenu();
+                    
+                    if (view === 'settings') {
+                        openSettings();
+                    } else if (view === 'help') {
+                        showToast('📖 المساعدة: استخدم القائمة للتنقل بين الأقسام', 'info');
+                    } else {
+                        showToast(`📂 الانتقال إلى ${this.querySelector('span').textContent}`, 'info');
+                    }
+                });
+            });
+            
+            // Search
+            const searchInput = document.getElementById('searchInput');
+            const searchResults = document.getElementById('searchResults');
+            
+            searchInput.addEventListener('input', function() {
+                const query = this.value.toLowerCase();
+                
+                if (query.length < 2) {
+                    searchResults.classList.remove('active');
+                    return;
+                }
+                
+                // Search in issues and repos
+                const results = [];
+                
+                currentData.issues.forEach(issue => {
+                    if (issue.title.toLowerCase().includes(query) || issue.file.toLowerCase().includes(query)) {
+                        results.push({ type: 'issue', title: issue.title, subtitle: issue.file });
+                    }
+                });
+                
+                currentData.repos.forEach(repo => {
+                    if (repo.name.toLowerCase().includes(query)) {
+                        results.push({ type: 'repo', title: repo.name, subtitle: `⭐ ${repo.stars} | 🔀 ${repo.pullRequests}` });
+                    }
+                });
+                
+                if (results.length > 0) {
+                    searchResults.innerHTML = results.map(r => `
+                        <div class="search-result-item">
+                            <div style="font-weight: 500;">${r.title}</div>
+                            <div style="font-size: 12px; color: var(--text-muted);">${r.subtitle}</div>
+                        </div>
+                    `).join('');
+                    searchResults.classList.add('active');
+                } else {
+                    searchResults.innerHTML = '<div class="search-result-item">لا توجد نتائج</div>';
+                    searchResults.classList.add('active');
+                }
+            });
+            
+            searchInput.addEventListener('blur', function() {
+                setTimeout(() => {
+                    searchResults.classList.remove('active');
+                }, 200);
+            });
+            
+            searchInput.addEventListener('focus', function() {
+                if (this.value.length >= 2) {
+                    searchResults.classList.add('active');
+                }
+            });
+            
+            // Notification button
+            document.getElementById('notificationBtn').addEventListener('click', function() {
+                showToast('🔔 الإشعارات: 5 إشعارات جديدة', 'info');
+                document.getElementById('notificationBadge').textContent = '0';
+            });
+        }
+        
+        // Settings Panel
+        function openSettings() {
+            document.getElementById('settingsPanel').classList.add('active');
+        }
+        
+        function closeSettings() {
+            document.getElementById('settingsPanel').classList.remove('active');
+        }
+        
+        // Toast Notifications
+        function showToast(message, type = 'info') {
+            const container = document.getElementById('toastContainer');
+            const toast = document.createElement('div');
+            toast.className = `toast ${type}`;
+            toast.innerHTML = message;
+            container.appendChild(toast);
+            
+            setTimeout(() => {
+                toast.remove();
+            }, 3000);
+        }
+        
+        // Close settings on outside click
+        document.getElementById('settingsPanel').addEventListener('click', function(e) {
+            if (e.target === this) {
+                closeSettings();
+            }
+        });
+    </script>
+</body>
+</html>

dashboard/public/data/latest.json

@@ -0,0 +1,435 @@
+{
+  "metadata": {
+    "timestamp": "2026-01-13T02:00:00.000Z",
+    "version": "1.0.0",
+    "tool": "auto-guardian",
+    "git": {
+      "commit_sha": "abc1234",
+      "branch": "main",
+      "workflow": "auto-guardian-scan"
+    }
+  },
+  "summary": {
+    "total_issues": 23,
+    "critical_issues": 2,
+    "high_issues": 5,
+    "medium_issues": 8,
+    "low_issues": 6,
+    "info_issues": 2,
+    "files_scanned": 15,
+    "security_score": 78,
+    "grade": "C"
+  },
+  "languages": {
+    "detected": ["python", "javascript", "typescript", "go"],
+    "lines_of_code": {
+      "python": 2450,
+      "javascript": 1890,
+      "typescript": 2100,
+      "go": 1200
+    },
+    "tools_used": {
+      "bandit": { "issues": 8, "status": "completed" },
+      "pylint": { "issues": 5, "status": "completed" },
+      "eslint": { "issues": 6, "status": "completed" },
+      "gosec": { "issues": 4, "status": "completed" }
+    }
+  },
+  "findings": [
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "CRITICAL",
+      "severity_level": 1,
+      "file": "src/authentication.py",
+      "line": 45,
+      "column": 20,
+      "rule_id": "B105",
+      "rule_name": "hardcoded_password",
+      "message": "Possible hardcoded password: 'admin123'",
+      "description": "Hardcoded password detected. This is a security vulnerability as passwords should be stored in environment variables or secure configuration files.",
+      "confidence": "HIGH",
+      "remediation": "Use environment variables or a secrets manager to store credentials. Example: os.environ.get('DB_PASSWORD')",
+      "code_snippet": "password = 'admin123'  # This is insecure!",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "CRITICAL",
+      "severity_level": 1,
+      "file": "internal/api/handler.go",
+      "line": 89,
+      "column": 15,
+      "rule_id": "G104",
+      "rule_name": "Error check skipped",
+      "message": "Errors unhandled.",
+      "description": "Errors are being ignored without proper handling, which could lead to silent failures and security issues.",
+      "confidence": "HIGH",
+      "remediation": "Always handle errors properly using if err != nil { return err } pattern",
+      "code_snippet": "_ = json.Unmarshal(data, &obj)  // Error ignored!",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/utils/auth.js",
+      "line": 12,
+      "column": 18,
+      "rule_id": "security/detect-object-injection",
+      "rule_name": "Object Injection",
+      "message": "Avoid objects with unknown properties, object injection is possible.",
+      "description": "Object injection can lead to prototype pollution vulnerabilities if user input is used as object keys.",
+      "confidence": "HIGH",
+      "remediation": "Validate and sanitize user input before using it to access object properties",
+      "code_snippet": "const value = userData[userKey];  // Potential injection!",
+      "language": "javascript"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/database/connection.py",
+      "line": 67,
+      "column": 25,
+      "rule_id": "B501",
+      "rule_name": "SQL statement with parameters",
+      "message": "Possible SQL injection: VALUES ('%s')",
+      "description": "SQL injection vulnerability detected. String formatting used to build SQL query could allow attackers to manipulate queries.",
+      "confidence": "HIGH",
+      "remediation": "Use parameterized queries or ORM methods instead of string formatting. Example: cursor.execute('SELECT * FROM users WHERE id = ?', (user_id,))",
+      "code_snippet": "query = f\"SELECT * FROM users WHERE id = '{user_id}'\"",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "cmd/server/main.go",
+      "line": 234,
+      "column": 10,
+      "rule_id": "G107",
+      "rule_name": "HTTP absolute path traversal",
+      "message": "HTTP absolute path traversal",
+      "description": "Path traversal vulnerability detected. User input used directly in file paths without validation.",
+      "confidence": "HIGH",
+      "remediation": "Validate and sanitize file paths, use filepath.Clean and check for paths outside the allowed directory",
+      "code_snippet": "filePath := r.URL.Path + filename",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/config/loader.ts",
+      "line": 28,
+      "column": 22,
+      "rule_id": "no-sync",
+      "rule_name": "Synchronous Operations",
+      "message": "Unexpected sync operation. Use asynchronous operations instead.",
+      "description": "Synchronous file operations can block the event loop and cause performance issues in Node.js applications.",
+      "confidence": "MEDIUM",
+      "remediation": "Use fs.promises.readFile() or fs.readFileSync() is acceptable but document why",
+      "code_snippet": "const config = fs.readFileSync(configPath, 'utf8');",
+      "language": "typescript"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/api/routes.py",
+      "line": 156,
+      "column": 8,
+      "rule_id": "C0115",
+      "rule_name": "Missing function docstring",
+      "message": "Missing function or method docstring",
+      "description": "Public functions should have docstrings documenting their purpose, parameters, and return values.",
+      "confidence": "HIGH",
+      "remediation": "Add a docstring following Google or NumPy style format",
+      "code_snippet": "def process_data(input_data):\n    # Missing docstring\n    return transform(input_data)",
+      "language": "python"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/utils/helpers.py",
+      "line": 23,
+      "column": 15,
+      "rule_id": "B403",
+      "rule_name": "Consider possible security implications of pickle module",
+      "message": "Consider possible security implications of pickle module.",
+      "description": "The pickle module is not secure. Untrusted data can be crafted to execute arbitrary code.",
+      "confidence": "HIGH",
+      "remediation": "Use JSON or other safe serialization formats instead of pickle",
+      "code_snippet": "import pickle  # Security risk!",
+      "language": "python"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/services/api.js",
+      "line": 45,
+      "column": 13,
+      "rule_id": "no-console",
+      "rule_name": "Console Log",
+      "message": "Unexpected console statement.",
+      "description": "Console statements should be removed in production code as they may expose sensitive information.",
+      "confidence": "HIGH",
+      "remediation": "Remove console.log statements or use a proper logging library with configurable log levels",
+      "code_snippet": "console.log('User data:', user);  // Remove in production",
+      "language": "javascript"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/utils/validators.py",
+      "line": 78,
+      "column": 12,
+      "rule_id": "W0612",
+      "rule_name": "Unused variable",
+      "message": "Unused variable 'unused_param'",
+      "description": "Unused variables should be removed to keep code clean and maintainable.",
+      "confidence": "HIGH",
+      "remediation": "Remove unused variables or prefix with underscore to indicate intentional non-use",
+      "code_snippet": "def process(a, b, unused_param):  # 'unused_param' is never used\n    return a * 2",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "internal/utils/crypto.go",
+      "line": 112,
+      "column": 8,
+      "rule_id": "G401",
+      "rule_name": "Use of weak cryptographic primitive",
+      "message": "Use of weak cryptographic primitive (MD5 or SHA1)",
+      "description": "MD5 and SHA1 are considered cryptographically broken. Use SHA-256 or better.",
+      "confidence": "HIGH",
+      "remediation": "Use crypto/sha256 or higher instead of MD5/SHA1",
+      "code_snippet": "hash := md5.Sum([]byte(data))  // Use SHA-256!",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/components/UserForm.jsx",
+      "line": 89,
+      "column": 15,
+      "rule_id": "react/no-danger",
+      "rule_name": "Dangerous Props",
+      "message": "Dangerous use of dangerouslySetInnerHTML",
+      "description": "Using dangerouslySetInnerHTML can expose XSS vulnerabilities if the content is not properly sanitized.",
+      "confidence": "HIGH",
+      "remediation": "Avoid using dangerouslySetInnerHTML or ensure content is sanitized with a library like DOMPurify",
+      "code_snippet": "<div dangerouslySetInnerHTML={{ __html: userContent }} />",
+      "language": "javascript"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/api/middleware.py",
+      "line": 34,
+      "column": 4,
+      "rule_id": "R0913",
+      "rule_name": "Too many arguments",
+      "message": "Too many arguments (6/5)",
+      "description": "Functions with more than 5 arguments are difficult to maintain and use. Consider refactoring.",
+      "confidence": "MEDIUM",
+      "remediation": "Group related parameters into a configuration object or class",
+      "code_snippet": "def create_user(name, email, password, role, department, manager): pass  # Too many!",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "internal/api/middleware.go",
+      "line": 56,
+      "column": 12,
+      "rule_id": "G304",
+      "rule_name": "File path traversal",
+      "message": "File path traversal detected",
+      "description": "User input used directly in file path without proper validation could allow path traversal attacks.",
+      "confidence": "HIGH",
+      "remediation": "Validate file paths and ensure they are within the allowed directory using filepath.Clean and path verification",
+      "code_snippet": "file, _ := os.Open(userProvidedPath)",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/utils/api.js",
+      "line": 156,
+      "column": 9,
+      "rule_id": "no-underscore-dangle",
+      "rule_name": "Underscore Dangle",
+      "message": "Unexpected dangling '_' in 'fetch_url_'",
+      "description": "Variable names with trailing underscores are unconventional and may confuse developers.",
+      "confidence": "MEDIUM",
+      "remediation": "Use conventional naming without trailing underscores",
+      "code_snippet": "const fetch_url_ = 'https://api.example.com';",
+      "language": "javascript"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "tests/test_sample.py",
+      "line": 12,
+      "column": 10,
+      "rule_id": "B101",
+      "rule_name": "Assert used",
+      "message": "Use of assert detected",
+      "description": "Assert statements should not be used in production code as they can be disabled with Python's -O flag.",
+      "confidence": "HIGH",
+      "remediation": "Use unittest assertions or raise exceptions instead of assert",
+      "code_snippet": "assert result == expected, 'Test failed'",
+      "language": "python"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/config/settings.py",
+      "line": 8,
+      "column": 0,
+      "rule_id": "C0114",
+      "rule_name": "Missing module docstring",
+      "message": "Missing module docstring",
+      "description": "Module-level docstrings should be present at the top of each file.",
+      "confidence": "HIGH",
+      "remediation": "Add a module docstring describing the purpose of this module",
+      "code_snippet": "# Module content starts here without docstring",
+      "language": "python"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/index.js",
+      "line": 3,
+      "column": 8,
+      "rule_id": "no-unused-vars",
+      "rule_name": "Unused Variables",
+      "message": "'React' is defined but never used.",
+      "description": "Unused variables increase code complexity and should be removed.",
+      "confidence": "HIGH",
+      "remediation": "Remove the unused import or use the variable",
+      "code_snippet": "import React from 'react';  // React is not used directly",
+      "language": "javascript"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "internal/config/loader.go",
+      "line": 23,
+      "column": 6,
+      "rule_id": "G108",
+      "rule_name": "Performance regression detected",
+      "message": "Benchmark result indicates potential performance regression",
+      "description": "The function shows potential performance issues based on benchmark comparison.",
+      "confidence": "MEDIUM",
+      "remediation": "Review the function for potential optimizations like caching, reducing allocations, or algorithmic improvements",
+      "code_snippet": "// Consider adding caching for repeated calls",
+      "language": "go"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/utils/constants.py",
+      "line": 5,
+      "column": 0,
+      "rule_id": "C0103",
+      "rule_name": "Invalid constant name",
+      "message": "Constant name \"MAX_SIZE\" doesn't conform to UPPER_CASE naming style",
+      "description": "Constants should be named in UPPER_CASE with underscores.",
+      "confidence": "HIGH",
+      "remediation": "Rename the constant to use UPPER_CASE format",
+      "code_snippet": "max_size = 100  # Should be MAX_SIZE = 100",
+      "language": "python"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/styles/main.css",
+      "line": 1,
+      "column": 1,
+      "rule_id": "no-irregular-whitespace",
+      "rule_name": "Irregular Whitespace",
+      "message": "Irregular whitespace not allowed.",
+      "description": "Irregular whitespace characters can cause rendering issues and are typically typos.",
+      "confidence": "HIGH",
+      "remediation": "Remove any irregular whitespace characters from the file",
+      "code_snippet": "  \t  /* Space at beginning of file */",
+      "language": "javascript"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "INFO",
+      "severity_level": 5,
+      "file": "setup.py",
+      "line": 15,
+      "column": 7,
+      "rule_id": "B602",
+      "rule_name": "Subprocess call with shell=True",
+      "message": "subprocess call with shell=True identified",
+      "description": "Using shell=True in subprocess allows shell injection attacks. Consider using shell=False.",
+      "confidence": "MEDIUM",
+      "remediation": "Use shell=False and pass arguments as a list to prevent shell injection",
+      "code_snippet": "subprocess.run(f'ls {directory}', shell=True)  # Risky!",
+      "language": "python"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "INFO",
+      "severity_level": 5,
+      "file": "src/main.py",
+      "line": 1,
+      "column": 1,
+      "rule_id": "C0111",
+      "rule_name": "Missing function docstring",
+      "message": "Missing function or method docstring (missing-docstring)",
+      "description": "Function docstrings help developers understand the purpose and usage of functions.",
+      "confidence": "MEDIUM",
+      "remediation": "Add a docstring explaining what the function does, its parameters, and return value",
+      "code_snippet": "def main():  # Missing docstring\n    run_app()",
+      "language": "python"
+    }
+  ],
+  "trends": {
+    "previous_scan": null,
+    "improvement": null
+  }
+}

development-report.md

@@ -0,0 +1,265 @@
+# تقرير تطوير مشروع Auto-Guardian
+## هندسة الأمان المؤتمت للأجيال القادمة
+
+---
+
+## الملخص التنفيذي
+
+يمثل مشروع Auto-Guardian نقلة نوعية في مجال أتمتة جودة البرمجيات وأمانها، حيث يجمع بين تقنيات التحليل المتقدمة والذكاء الاصطناعي لتقديم نظام شامل لحماية المستودعات البرمجية. يهدف هذا التقرير إلى توثيق التطورات المقترحة والمخطط لها للمشروع، مع التركيز على تعزيز قدرات النظام الحالية وتوسيع نطاق خدماته ليشمل قاعدة أوسع من المستخدمين والمطورين.
+
+يعالج النظام الحالي فجوة حقيقية في السوق، حيث تعاني معظم الفرق البرمجية من غياب آليات موحدة وفعالة لمراقبة جودة الكود وأمانه بشكل آلي ومستمر. من خلال تقديم مجموعة متكاملة من الأدوات والخدمات، يسعى Auto-Guardian إلى سد هذه الفجوة وتمكين الفرق من التركيز على الابتكار بدلاً من المهام الروتينية المتعلقة بالصيانة والفحص.
+
+تشمل التحديثات المقترحة في هذا التقرير إضافة ميزات متقدمة تعتمد على الذكاء الاصطناعي، وتطوير واجهات مستخدم أكثر حداثة وسهولة في الاستخدام، وتوسيع دعم اللغات والمنصات، وتعزيز قدرات التكامل مع أدوات التطوير الشائعة. كما يتضمن التقرير خططاً لتوفير لوحة تحكم مركزية وإمكانية التشغيل على مستوى المؤسسات.
+
+---
+
+## المقدمة
+
+### السياق والخلفية
+
+في عالم تطوير البرمجيات الحديث، أصبحت جودة الكود وأمانه من أهم العوامل التي تحدد نجاح المشاريع والorganizations. مع تزايد تعقيد المشاريع البرمجية وتنوع التقنيات المستخدمة، يجد المطورون أنفسهم أمام تحدٍّ كبير في الحفاظ على معايير الجودة والأمان بشكل يدوي. هذا التحدي يستهلك وقتاً وجهداً كبيرين، ويفتح الباب أمام أخطاء قد تكون مكلفة.
+
+تشير الدراسات إلى أن تكلفة إصلاح الأخطاء البرمجية تزداد بشكل كبير كلما تأخر اكتشافها في دورة التطوير. في المراحل المبكرة من التطوير، قد لا تتجاوز تكلفة الإصلاح بضع ساعات من العمل، بينما في مرحلة الإنتاج قد تصل إلى أيام أو أسابيع، ناهيك عن الأضرار المحتملة للسمعة والثقة. هذا الواقع يجعل الاستثمار في أدوات الفحص الآلي ضرورة ملحة وليس ترفاً.
+
+### الحاجة إلى الأتمتة
+
+توفر أتمتة عمليات فحص الجودة والأمان العديد من المزايا التي لا يمكن تحقيقها يدوياً. أولاً، تضمن الأتمتة الاتساق في تطبيق المعايير عبر جميع التغييرات، بغض النظر عن حجم الفريق أو عدد المشاريع. ثانياً، توفر سرعة التنفيذ التي تسمح بفحص الكود في وقت قياسي مقارنة بالفحص اليدوي. ثالثاً، تقلل من العبء على المطورين，使他们 يستطيعون التركيز على المهام الإبداعية والتصميمية. وأخيراً، توفر توثيقاً دقيقاً لجميع المشكلات المكتشفة والإجراءات المتخذة.
+
+يهدف مشروع Auto-Guardian إلى تقديم هذه الفوائد بشكل متكامل وميسر، مع التركيز على سهولة الاستخدام والتكامل مع سير العمل اليومي للفرق البرمجية. يتبنى المشروع فلسفة توفير الرؤية والأتمتة دون تعقيد، مما يجعله مناسباً للفرق بمختلف أحجامها ومستويات خبرتها.
+
+---
+
+## الهندسة التقنية
+
+### نظرة عامة على البنية
+
+تعتمد بنية Auto-Guardian على تصميم متعدد الطبقات يوفر المرونة والقابلية للتوسع. تتكون البنية من خمس طبقات رئيسية تعمل بشكل متكامل لتقديم خدمات شاملة للفحص والحماية. يتيح هذا التصميم فصل المسؤوليات بين المكونات المختلفة، مما يسهل عملية الصيانة والتطوير المستقبلي.
+
+تتضمن الطبقة الأول�� واجهة المستخدم التي تشمل لوحة التحكم الويب وواجهة سطر الأوامر، بالإضافة إلى التكامل مع بيئات التطوير المتكاملة. توفر هذه الطبقة نقاط وصول متعددة تناسب مختلف احتياجات المستخدمين، من المطورين الأفراد إلى فرق المؤسسات الكبيرة. تدعم الواجهات الحديثة تقنيات الاستجابة الكاملة، مما يضمن تجربة مستخدم متسقة عبر جميع الأجهزة.
+
+تأتي بعد ذلك طبقة البوابة التي تتولى إدارة الطلبات والمصادقة. تعمل هذه الطبقة كنقطة دخول موحدة لجميع الطلبات، وتضمن تطبيق سياسات الأمان والوصول بشكل مركزي. تستخدم البوابة تقنيات التخزين المؤقت لتحسين الأداء وتقليل الحمل على الطبقات الخلفية.
+
+### محركات التحليل
+
+يشكل محرك التحليل قلب النظام، حيث يتولى مسؤولية فحص الكود واكتشاف المشكلات. يعتمد المحرك على مجموعة متنوعة من الأدوات المتخصصة التي تغطي جوانب مختلفة من الجودة والأمان. تشمل هذه الأدوات أدوات التنسيق اللغوي مثل ESLint وFlake8 وPylint، وماسحات الأمان مثل Bandit وSecurityScanner، ومحركات فحص الأنواع، وأدوات تحليل الأداء.
+
+يتضمن المحرك منطقاً ذكياً لدمج نتائج الفحص من مختلف الأدوات وتصفيتها وتوجيهها. يستخدم هذا المنطق قواعد قابلة للتخصيص لتحديد أولويات المشكلات وتجنب التكرار. كما يوفر إمكانية إضافة قواعد مخصصة تلبي احتياجات محددة للمشاريع والفرق.
+
+### نظام الإصلاح التلقائي
+
+يمثل نظام الإصلاح التلقائي أحد أهم مميزات Auto-Guardian، حيث يتجاوز مجرد اكتشاف المشكلات إلى إصلاحها تلقائياً عندما يكون ذلك آمناً وممكناً. يشمل الإصلاح التلقائي مشاكل التنسيق وأنماط الكود السيئة وإصلاحات الأمان البسيطة. يتبع النظام نهجاً متحفظاً في الإصلاح التلقائي، حيث لا يقوم بإصلاح إلا المشكلات التي لديه ثقة عالية في صحة الإصلاح.
+
+يتم توثيق جميع الإصلاحات التلقائية في سجل مفصل يتيح للمطورين مراجعة التغييرات ومراجعتها. يمكن تكوين النظام لإرسال طلبات مراجعة للإصلاحات التي تتطلب موافقة بشرية، مما يوفر التوازن بين الأتمتة والرقابة.
+
+### طبقة التخزين والإشعارات
+
+توفر طبقة التخزين استمرارية البيانات وإمكانية تتبع التاريخ. تستخدم قاعدة بيانات علائقية لتخزين نتائج الفحص والإعدادات، مع دعم للنسخ الاحتياطي والاستعادة. تتضمن الطبقة أيضاً نظام تخزين مؤقت لتحسين أداء الاستعلامات المتكررة.
+
+يتولى نظام الإشعارات مهمة التواصل مع المستخدمين حول حالة الفحص والمشاكل المكتشفة. يدعم النظام قنوات إشعار متعددة تشمل البريد الإلكتروني والرسائل الفورية عبر Slack وDiscord، بالإضافة إلى إشعارات داخل منصة GitHub نفسها. يمكن للمستخدمين تخصيص تفضيلات الإشعارات لكل مشروع على حدة.
+
+### المخطط البياني للبنية
+
+```mermaid
+graph TD
+    subgraph User_Layer["طبقة المستخدم"]
+        User["المستخدمون والمطورون"]
+        Admin["المسؤولون"]
+    end
+
+    subgraph Gateway_Layer["طبقة البوابة"]
+        API["API Gateway"]
+        Auth["خدمة المصادقة"]
+    end
+
+    subgraph Core_Layer["طبقة المحرك الرئيسي"]
+        Analyzer["محلل الكود"]
+        Scanner["ماسح الأمان"]
+        Fixer["محرك الإصلاح التلقائي"]
+        Quality["بوابة الجودة"]
+    end
+
+    subgraph Agents_Layer["طبقة العملاء"]
+        Linters["أدوات التنسيق"]
+        Security["فحوصات الأمان"]
+        Tests["محركات الاختبار"]
+        TypeCheck["فحص الأنواع"]
+    end
+
+    subgraph Storage_Layer["طبقة التخزين"]
+        DB["قاعدة البيانات"]
+        Cache["التخزين المؤقت"]
+        Logs["سجلات النظام"]
+    end
+
+    subgraph Notification_Layer["طبقة التنبيهات"]
+        Alerts["نظام التنبيهات"]
+        Slack["Slack"]
+        Email["البريد الإلكتروني"]
+        Discord["Discord"]
+    end
+
+    %% Connections
+    User --> API
+    Admin --> API
+    API --> Auth
+    Auth --> Analyzer
+    Auth --> Scanner
+    
+    Analyzer --> Linters
+    Analyzer --> TypeCheck
+    Scanner --> Security
+    
+    Linters --> Quality
+    Security --> Quality
+    Tests --> Quality
+    TypeCheck --> Quality
+    
+    Analyzer --> DB
+    Scanner --> DB
+    Quality --> DB
+    
+    DB --> Cache
+    Quality --> Alerts
+    Alerts --> Slack
+    Alerts --> Email
+    Alerts --> Discord
+```
+
+---
+
+## الميزات الأساسية
+
+### المراقبة الحية
+
+توفر ميزة المراقبة الحية رؤية فورية لحالة جميع المشاريع والمراقبة المستمرة للتغييرات. تعرض لوحة التحكم الرئيسية ملخصاً شاملاً يتضمن عدد التهديدات المحظورة ومعدل نجاح الفحوصات وزمن الاستجابة والمشكلات المفتوحة. يتم تحديث هذه المعلومات في الوقت الفعلي، مما يمكّن الفرق من الاستجابة السريعة لأي مشكلات.
+
+تشمل المراقبة الحية أيضاً رسوماً بيانية توضح اتجاهات الجودة والأمان عبر الزمن. تتيح هذه الرسوم تحديد الأنماط والمشكلات المتكررة التي قد تشير إلى حاجة لتدريب إضافي أو تغييرات في العمليات. كما توفر تنبيهات فورية للمشكلات الحرجة التي تتطلب اهتماماً فورياً.
+
+### الحماية الآلية
+
+تتجاوز الحماية الآلية مجرد الاكتشاف إلى منع المشكلات قبل وصولها إلى الكود الأساسي. من خلال بوابة الجودة، يتولى النظام فحص جميع طلبات السحب والتحقق من استيفائها للمعايير المحددة. يتم حظر طلبات السحب التي تفشل في الفحص من الدمج، مما يضمن أن الكود الجديد يلتزم بمعايير الجودة.
+
+تتضمن الحماية الآلية أيضاً ميزات استباقية مثل تحليل التبعيات ومراقبة الثغرات الأمنية المعروفة. عند اكتشاف ثغرة في إحدى المكتبات المستخدمة، يُعلم النظام الفريق فوراً ويقترح تحديثات آمنة. كما يوفر تقارير دورية عن حالة الأمان والتوصيات للتحسين.
+
+### تحليل البيانات
+
+يوفر النظام قدرات متقدمة في تحليل البيانات لاستخراج رؤى قيمة من نتائج الفحص. تشمل هذه القدرات تتبع مؤشرات الأداء الرئيسية مثل عدد المشكلات المكتشفة ومعدل الإصلاح ومتوسط وقت الاستجابة. تتيح واجهة التحليل تصفية البيانات حسب المشروع واللغة ونوع المشكلة ومستوى الخطورة.
+
+تشمل القدرات التحليلية أيضاً رسم خرائط للتبعيات بين المشاريع وتحديد المخاطر المحتملة للتغييرات. من خلال تحليل تأثير التغييرات، يمكن للنظام تحديد المشاريع والمكونات الأكثر تأثراً بأي تغيير، مما يساعد في تقييم المخاطر وتخطيط الاختبارات.
+
+### التقارير الذكية
+
+يولد النظام تقارير متنوعة تناسب احتياجات مختلفة. تشمل التقارير المتاحة التقارير التنفيذية للإدارة التي تلخص الحالة العامة وتوجهات الجودة، والتقارير التفصيلية للفنيين التي تتضمن معلومات دقيقة عن كل مشكلة والإجراءات المقترحة لحلها. كما تتوفر تقارير مطابقة للمعايير التنظيمية مثل OWASP وISO 27001.
+
+يمكن تخصيص التقارير وتصديرها بصيغ متعددة تشمل PDF وExcel وHTML. يدعم النظام أيضاً التصدير الآلي للتقارير عبر البريد الإلكتروني أو تخزينها في منصات مشاركة الملفات. كما يتضمن إمكانية جدولة التقارير الدورية لتوليدها وإرسالها تلقائياً.
+
+---
+
+## التحديات والحلول
+
+### التعامل مع البيانات الضخمة
+
+يواجه النظام تحدياً في معالجة كميات كبيرة من البيانات الناتجة عن فحص المشاريع الكبيرة والمتكررة. يتضمن ذلك ملايين الأسطر من الكود ونتائج آل��ف الفحوصات. للتعامل مع هذا التحدي، يعتمد النظام على استراتيجية تخزين مؤقت ذكية تحتفظ بالنتائج الأخيرة وتتجاهل البيانات الأقل استخداماً.
+
+كما يستخدم النظام تقنيات المعالجة المتوازية لتوزيع الأحمال عبر خوادم متعددة. يتضمن ذلك تقسيم المشاريع الكبيرة إلى أجزاء أصغر يمكن معالجتها بشكل متوازٍ، ثم تجميع النتائج في النهاية. هذا النهج يقلل زمن الفالجة بشكل كبير ويحسن استجابة النظام.
+
+### التوازن بين الدقة والإنتاجية
+
+يمثل تحقيق التوازن بين شمولية الفحص وسرعة التنفيذ تحدياً مستمراً. الفحص الأكثر شمولية يستغرق وقتاً أطول، مما قد يؤثر على تجربة المطورين وسرعة دورات التطوير. للتعامل مع هذا، يستخدم النظام نهجاً تكيفياً يحدد مستوى الفحص بناءً على حجم التغييرات وسياقها.
+
+في حالة التغييرات الصغيرة، يمكن إجراء فحص خفيف يركز على المناطق المتأثرة فقط. أما التغييرات الكبيرة فتتطلب فحصاً شاملاً. كما يوفر النظام خيارات للمستخدمين لتحديد أولويات الفحص وتخصيص الموارد وفقاً لاحتياجاتهم.
+
+### التقليل من الإيجابيات الكاذبة
+
+تعد الإيجابيات الكاذبة، أي الإبلاغ عن مشكلات غير حقيقية، من أكبر تحديات أنظمة الفحص الآلي. العدد الكبير من التنبيهات الخاطئة يؤدي إلى إرهاق المطورين وتقليل ثقتهم في النظام. للتعامل مع هذا التحدي، يعتمد النظام على آليات تعلم مستمرة تحسن دقة الاكتشاف بناءً على ملاحظات المستخدمين.
+
+يتضمن النظام أيضاً قواعد ذكية لتصفية التنبيهات بناءً على السياق وتاريخ المشروع. عند اكتشاف أنماط متكررة من التنبيهات التي يتجاهلها المطورون، يتعلم النظام منها ويعدل قواعده وفقاً لذلك. كما يوفر واجهة سهلة للمستخدمين للإبلاغ عن التنبيهات الخاطئة مباشرة.
+
+---
+
+## خارطة الطريق
+
+### المرحلة الأولى: تعزيز الأساس (الربع القادم)
+
+تركز هذه المرحلة على تحسين قدرات النظام الحالية وتعزيز استقراره. يشمل ذلك تحسين أداء محركات الفحص بنسبة لا تقل عن ثلاثين بالمئة، وإضافة دعم للغات جديدة تشمل Rust وKotlin. كما تتضمن تحسين واجهة المستخدم وإضافة ميزات طلبها المجتمع.
+
+من الأهداف الرئيسية في هذه المرحلة تطوير نظام الإصلاح التلقائي ليشمل أنواعاً إضافية من المشكلات. يتضمن ذلك إصلاح مشاكل الأمان البسيطة وإعادة هيكلة أنماط الكود السيئة. كما سيتم تحسين التكامل مع منصات CI/CD الشائعة لتسهيل عملية التبني.
+
+### المرحلة الثانية: الذكاء الاصطناعي (الربع الثاني)
+
+تمثل هذه المرحلة نقلة نوعية في قدرات النظام من خلال دمج تقنيات الذكاء الاصطناعي. سيتضمن ذلك نموذجاً متقدماً لتحليل الكود يمكنه فهم السياق وتقديم اقتراحات ذكية. كما سيتم تطوير نظام تنبؤي يحدد المشاكل المحتملة قبل حدوثها.
+
+تشمل التطبيقات الأخرى للذكاء الاصطناعي تحسين تصنيف المشكلات وتحديد الأنماط في أخطاء الفريق. كما سيتم تطوير مساعد ذكي يقترح حلولاً للمشاكل بناءً على المعرفة المتراكمة من مشاريع مماثلة. هذا سيقلل بشكل كبير وقت حل المشاكل ويحسن جودة الحلول.
+
+### المرحلة الثالثة: منصة المؤسسات (الربع الثالث)
+
+تركز هذه المرحلة على تلبية احتياجات المؤسسات الكبيرة من خلال تطوير منصة متعددة المستأجرين. سيتضمن ذلك لوحات تحكم مركزية تتيح للمسؤولين إدارة جميع مشاريع المؤسسة من مكان واحد، مع صلاحيات متدرجة وإمكانية تخصيص واسعة.
+
+كما تتضمن هذه المرحلة تطوير واجهات برمجة تطبي��ات متقدمة للتكامل مع أنظمة المؤسسات القائمة. يشمل ذلك التكامل مع أنظمة إدارة الهوية والوصول وأنظمة المراقبة والتتبع. كما سيتم توفير خيارات نشر مرنة تشمل النشر السحابي والخاص.
+
+### المرحلة الرابعة: النظام البيئي (الربع الرابع)
+
+تهدف هذه المرحلة إلى بناء نظام بيئي متكامل حول Auto-Guardian. يتضمن ذلك إطلاق منصة للمكونات الإضافية تتيح للمجتمع تطوير إضافات توسع قدرات النظام. كما سيتم إنشاء marketplace للتكاملات والمكونات الإضافية.
+
+تشمل الأهداف الأخرى في هذه المرحلة تطوير برنامج شراكات مع مزودي خدمات الحوسبة السحابية وأدوات التطوير. كما سيتم إطلاق برنامج شهادات للمطورين المتخصصين في استخدام النظام، مما يعزز القيمة المهنية للمستخدمين.
+
+---
+
+## واجهة المستخدم المصممة
+
+### لوحة التحكم الرئيسية
+
+تم تصميم لوحة تحكم حديثة وسهلة الاستخدام توفر رؤية شاملة لحالة النظام. تتضمن اللوحة أقساماً واضحة لعرض الإحصائيات الرئيسية والرسوم البيانية النشاط الأخير والمستودعات النشطة. يعتمد التصميم على مبدأ البطاقات التي تسهل قراءة المعلومات وتجعلها قابلة للفحص السريع.
+
+تتميز اللوحة بنظام ألوان متناسق يعكس هوية النظام البصرية. تستخدم الألوان الكحلية والزرقاء لإعطاء انطباع بالأمان والموثوقية، مع استخدام الأخضر للإشارة إلى النجاح والأحمر للتنبيهات. التصميم متجاوب ويعمل بشكل ممتاز على مختلف أحجام الشاشات.
+
+### الرسوم البيانية التوضيحية
+
+تم إنشاء مجموعة من الرسوم البيانية التوضيحية التي تجسد مفاهيم النظام الرئيسية. تتضمن هذه الرسوم أيقونة المراقبة الحية التي تظهر رقصة مسح رادارية توضح عملية الفحص المستمرة، وأيقونة الحماية الآلية التي تجمع بين رمز الدرع والتروس لترمز إلى الحماية الذكية، وأيقونة تحليل البيانات التي توضح تدفق البيانات والتحليل المتصاعد.
+
+جميع الرسوم البيانية مصممة بأسلوب مسطح عصري يتناسب مع الهوية البصرية للنظام. تستخدم ألوان متناسقة وعناصر هندسية ناعمة تجعل المعلومات سهلة الفهم والجذابة بصرياً. يمكن استخدام هذه الرسوم في الوثائق والعروض التقديمية والمواد التسويقية.
+
+### الفيديو التوضيحي
+
+تم إعداد سيناريو مفصل لفيديو توضيحي يمتد من ستين إلى تسعين ثانية. يتبع الفيديو هيكلاً واضحاً يبدأ بإثارة المشكلة ويعرض الحل ثم يستعرض الميزات وينتهي بدعوة للعمل. يتضمن السيناريو تفاصيل دقيقة للمشاهد والرسوم المتحركة والتعليق الصوتي.
+
+تم تصميم الفيديو ليكون جذاباً ومهماً، مع التركيز على تقديم رسالة واضحة ومؤثرة. يتضمن السيناريو ترجمة إنجليزية كاملة لجعل المحتوى متاحاً لجمهور أوسع. كما يتضمن مواصفات تقنية للإنتاج تشمل الألوان والخطوط والمؤثرات الصوتية.
+
+---
+
+## المعايير والسياسات
+
+### معايير جودة الكود
+
+يلتزم النظام بمجموعة شاملة من معايير جودة الكود التي تغطي جوانب متعددة من البرمجيات. تشمل هذه المعايير معايير التنسيق التي تحدد أسلوب الكتابة المتسق، ومعايير الوثائق التي تضمن توفر تعليقات كافية، ومعايير الأمان التي تمنع الأنماط غير الآمنة، ومعايير الأداء التي تضمن الكفاءة.
+
+يمكن تخصيص هذه المعايير لكل مشروع على حدة، مع توفير قوالب جاهزة لأنواع المشاريع الشائعة. يتضمن النظام أيضاً أدوات لفرض المعايير تلقائياً ومنع الكود الذي لا يلتزم بها من الوصول إلى الكود الأساسي.
+
+### سياسات الأمان
+
+تت��نى النظام سياسات أمان صارمة لحماية البيانات والأنظمة. تتضمن هذه السياسات تشفير البيانات في حالة السكون والنقل، واستخدام المصادقة متعددة العوامل، وتطبيق مبدأ الحد الأدنى من الصلاحيات. كما تتضمن سياسات للتعامل مع الثغرات الأمنية المكتشفة.
+
+يلتزم النظام بمتطلبات اللوائح العالمية لحماية البيانات مثل GDPR، مع توفير أدوات للامتثال ومراجعة الوصول. كما يتضمن سجلات تدقيق شاملة لجميع العمليات الحساسة، مما يتيح المراجعة والتتبع عند الحاجة.
+
+---
+
+## الخاتمة
+
+يمثل مشروع Auto-Guardian خطوة مهمة نحو أتمتة جودة البرمجيات وأمانها بشكل شامل ومتكامل. من خلال الجمع بين أدوات الفحص المتقدمة والذكاء الاصطناعي، يوفر النظام قدرة غير مسبوقة على اكتشاف المشكلات وإصلاحها تلقائياً. كما يضمن تصميمه المتعدد الطبقات المرونة والقابلية للتوسع لتلبية احتياجات الفرق بمختلف أحجامها.
+
+توفر خارطة الطريق الموضحة في هذا التقرير رؤية واضحة لمسار تطوير المشروع في المستقبل القريب. من خلال المراحل الأربع المحددة، سيتحول النظام تدريجياً من أداة فحص بسيطة إلى منصة متكاملة لإدارة جودة البرمجيات على مستوى المؤسسات. سيتيح ذلك للفرق تبني النظام تدريجياً والتمتع بمزاياه المتزايدة مع نمو احتياجاتهم.
+
+ندعو المطورين والمساهمين للانضمام إلى مشروع Auto-Guardian والمساهمة في تطويره. سواء من خلال الإبلاغ عن المشاكل أو اقتراح ميزات جديدة أو كتابة وثائق أو تطوير إضافات، كل مساهمة تساعد في جعل النظام أفضل للجميع. معاً، يمكننا بناء مستقبل يكون فيه كل كود آمناً وعالي الجودة.
+
+---
+
+## المراجع والروابط
+
+- **المستودع الرئيسي:** github.com/AbdulElahOthmanGwaith/auto-guardian-system
+- **الموقع الرسمي:** autoguardian.dev
+- **التوثيق:** docs.autoguardian.dev
+- **الدعم:** support@autoguardian.dev
+
+---
+
+*نهاية التقرير*

diagrams/system-architecture.mmd

@@ -0,0 +1,80 @@
+// Auto-Guardian System Architecture Diagram
+// Generated for Auto-Guardian Enhancement Project
+
+graph TD
+    subgraph User_Layer["طبقة المستخدم"]
+        User["المستخدمون والمطورون"]
+        Admin["المسؤولون"]
+    end
+
+    subgraph Gateway_Layer["طبقة البوابة"]
+        API["API Gateway"]
+        Auth["خدمة المصادقة"]
+    end
+
+    subgraph Core_Layer["طبقة المحرك الرئيسي"]
+        Analyzer["محلل الكود"]
+        Scanner["ماسح الأمان"]
+        Fixer["محرك الإصلاح التلقائي"]
+        Quality["بوابة الجودة"]
+    end
+
+    subgraph Agents_Layer["طبقة العملاء"]
+        Linters["أدوات التنسيق"]
+        Security["فحوصات الأمان"]
+        Tests["محركات الاختبار"]
+        TypeCheck["فحص الأنواع"]
+    end
+
+    subgraph Storage_Layer["طبقة التخزين"]
+        DB["قاعدة البيانات"]
+        Cache["التخزين المؤقت"]
+        Logs["سجلات النظام"]
+    end
+
+    subgraph Notification_Layer["طبقة التنبيهات"]
+        Alerts["نظام التنبيهات"]
+        Slack["Slack"]
+        Email["البريد الإلكتروني"]
+        Discord["Discord"]
+    end
+
+    %% Connections
+    User --> API
+    Admin --> API
+    API --> Auth
+    Auth --> Analyzer
+    Auth --> Scanner
+    
+    Analyzer --> Linters
+    Analyzer --> TypeCheck
+    Scanner --> Security
+    
+    Linters --> Quality
+    Security --> Quality
+    Tests --> Quality
+    TypeCheck --> Quality
+    
+    Analyzer --> DB
+    Scanner --> DB
+    Quality --> DB
+    
+    DB --> Cache
+    Quality --> Alerts
+    Alerts --> Slack
+    Alerts --> Email
+    Alerts --> Discord
+
+    %% Styling
+    classDef primary fill:#0F172A,stroke:#3B82F6,stroke-width:2px,color:#fff
+    classDef secondary fill:#3B82F6,stroke:#0F172A,stroke-width:2px,color:#fff
+    classDef accent fill:#10B981,stroke:#0F172A,stroke-width:2px,color:#fff
+    classDef alert fill:#EF4444,stroke:#0F172A,stroke-width:2px,color:#fff
+    classDef storage fill:#64748B,stroke:#0F172A,stroke-width:2px,color:#fff
+    
+    class User,Admin primary
+    class API,Auth secondary
+    class Analyzer,Scanner,Fixer,Quality secondary
+    class Linters,Security,Tests,TypeCheck accent
+    class DB,Cache,Logs storage
+    class Alerts,Slack,Email,Discord alert

docker-compose.yml

@@ -0,0 +1,234 @@
+version: '3.8'
+
+services:
+  # ========================================
+  # خدمة نظام الحارس التلقائي الرئيسية
+  # ========================================
+  auto-guardian:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: auto-guardian-system
+    restart: unless-stopped
+    privileged: true
+    volumes:
+      # مجلد السجلات
+      - ./logs:/app/logs:rw
+      
+      # مجلد الإعدادات
+      - ./config:/app/config:rw
+      
+      # قراءة سجلات النظام (للمراقبة)
+      - /var/log/auth.log:/var/log/auth.log:ro
+      - /var/log/syslog:/var/log/syslog:ro
+      - /var/log/nginx/access.log:/var/log/nginx/access.log:ro
+      
+      # حالة IPTables (للتشغيل المحلي)
+      - /lib/modules:/lib/modules:ro
+    
+    environment:
+      # إعدادات البيئة
+      - TZ=UTC
+      - PYTHONUNBUFFERED=1
+      - LOG_LEVEL=INFO
+      
+      # إعدادات التطبيق
+      - AG_MODE=docker
+      - AG_CONFIG_PATH=/app/config/settings.yaml
+      - AG_LOG_PATH=/app/logs
+      
+      # إعدادات API
+      - AG_API_HOST=0.0.0.0
+      - AG_API_PORT=8000
+      
+      # إعدادات الإشعارات
+      - AG_NOTIFICATIONS_ENABLED=true
+      - AG_SLACK_WEBHOOK_URL=${SLACK_WEBHOOK_URL:-}
+      - AG_DISCORD_WEBHOOK_URL=${DISCORD_WEBHOOK_URL:-}
+    
+    networks:
+      - security-network
+    ports:
+      - "8000:8000"
+    
+    healthcheck:
+      test: ["CMD", "python", "-c", "import requests; requests.get('http://localhost:8000/health')"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+    
+    labels:
+      - "com.autoguardian.version=1.3.0"
+      - "com.autoguardian.service=auto-guardian"
+    
+    logging:
+      driver: json-file
+      options:
+        max-size: "100m"
+        max-file: "5"
+
+  # ========================================
+  # خدمة Prometheus للمراقبة
+  # ========================================
+  prometheus:
+    image: prom/prometheus:v2.48.0
+    container_name: prometheus
+    restart: unless-stopped
+    volumes:
+      - ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - prometheus-data:/prometheus
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--storage.tsdb.retention.time=15d'
+      - '--web.enable-lifecycle'
+      - '--web.enable-admin-api'
+    networks:
+      - security-network
+    ports:
+      - "9090:9090"
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:9090/-/healthy"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    labels:
+      - "com.autoguardian.service=prometheus"
+
+  # ========================================
+  # خدمة Grafana للوحات المراقبة
+  # ========================================
+  grafana:
+    image: grafana/grafana:10.2.0
+    container_name: grafana
+    restart: unless-stopped
+    environment:
+      # إعدادات Grafana
+      - GF_SECURITY_ADMIN_USER=${GRAFANA_USER:-admin}
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_PASSWORD:-autoguardian}
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-simple-json-datasource
+      
+      # إعدادات SMTP (لإرسال التنبيهات)
+      - GF_SMTP_ENABLED=${GRAFANA_SMTP_ENABLED:-false}
+      - GF_SMTP_HOST=${GRAFANA_SMTP_HOST:-}
+      - GF_SMTP_USER=${GRAFANA_SMTP_USER:-}
+      - GF_SMTP_PASSWORD=${GRAFANA_SMTP_PASSWORD:-}
+    
+    volumes:
+      - grafana-data:/var/lib/grafana
+      - ./grafana/provisioning:/etc/grafana/provisioning:ro
+      - ./grafana/dashboards:/var/lib/grafana/dashboards:ro
+    
+    networks:
+      - security-network
+    ports:
+      - "3000:3000"
+    depends_on:
+      - prometheus
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000/api/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    labels:
+      - "com.autoguardian.service=grafana"
+    
+    logging:
+      driver: json-file
+      options:
+        max-size: "50m"
+        max-file: "3"
+
+  # ========================================
+  # خدمة التنبيهات (قائمة الانتظار)
+  # ========================================
+  alerts-worker:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: alerts-worker
+    restart: unless-stopped
+    command: ["python", "-m", "src.notifiers.worker"]
+    volumes:
+      - ./logs:/app/logs:rw
+      - ./config:/app/config:rw
+    environment:
+      - TZ=UTC
+      - PYTHONUNBUFFERED=1
+      - AG_MODE=worker
+      - AG_CONFIG_PATH=/app/config/settings.yaml
+      - AG_REDIS_URL=redis://redis:6379/0
+    networks:
+      - security-network
+    depends_on:
+      redis:
+        condition: service_healthy
+    profiles:
+      - production
+
+  # ========================================
+  # خدمة Redis للتخزين المؤقت والرسائل
+  # ========================================
+  redis:
+    image: redis:7-alpine
+    container_name: redis
+    restart: unless-stopped
+    command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
+    volumes:
+      - redis-data:/data
+    networks:
+      - security-network
+    ports:
+      - "6379:6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+    labels:
+      - "com.autoguardian.service=redis"
+
+  # ========================================
+  # خدمة Nginx كوكيل عكسي (اختياري)
+  # ========================================
+  nginx:
+    image: nginx:alpine
+    container_name: nginx-proxy
+    restart: unless-stopped
+    volumes:
+      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
+      - ./nginx/conf.d:/etc/nginx/conf.d:ro
+      - ./nginx/html:/usr/share/nginx/html:ro
+    networks:
+      - security-network
+    ports:
+      - "80:80"
+      - "443:443"
+    depends_on:
+      - auto-guardian
+      - grafana
+    profiles:
+      - production
+
+# ========================================
+# تعريف الشبكات
+# ========================================
+networks:
+  security-network:
+    driver: bridge
+    ipam:
+      config:
+        - subnet: 172.28.0.0/16
+
+# ========================================
+# تعريف المجلدات المستمرة
+# ========================================
+volumes:
+  prometheus-data:
+    driver: local
+  grafana-data:
+    driver: local
+  redis-data:
+    driver: local

docs/api/openapi.yaml

@@ -0,0 +1,633 @@
+# توثيق واجهة برمجة التطبيقات (API)
+# API Documentation for Auto Guardian System
+# ==========================================
+
+openapi: 3.0.3
+info:
+  title: "نظام الحارس التلقائي - واجهة برمجة التطبيقات"
+  description: |
+    واجهة برمجة تطبيقات نظام الحارس التلقائي للمراقبة الأمنية وإدارة التهديدات.
+    
+    ## نظرة عامة
+    
+    توفر هذه الواجهة مجموعة من النقاط الطرفية للتحقق من حالة النظام، وإدارة التهديدات المحظورة، وإرسال التنبيهات، ومراقبة الأداء.
+    
+    ## المصادقة
+    
+    تستخدم الواجهة مصادقة JWT. للحصول على رمز الوصول، استخدم نقطة نهاية `/api/v1/auth/token`.
+    
+    ## الإصدار
+    
+    - **الإصدار الحالي:** 1.3.0
+    - **آخر تحديث:** 2024-10-13
+    
+    ## الدعم
+    
+    للمشاكل والاستفسارات: support@autoguardian.local
+  version: "1.3.0"
+  contact:
+    name: "الدعم الفني"
+    email: "support@autoguardian.local"
+    url: "https://github.com/AbdulElahOthmanGwaith/auto-guardian-system"
+  license:
+    name: "MIT License"
+    url: "https://opensource.org/licenses/MIT"
+
+servers:
+  - url: http://localhost:8000/api/v1
+    description: "خادم التطوير المحلي"
+  - url: https://api.autoguardian.local/api/v1
+    description: "خادم الإنتاج"
+
+tags:
+  - name: "الصحة"
+    description: "نقاط نهاية فحص حالة النظام"
+  - name: "التهديدات"
+    description: "إدارة التهديدات الأمنية"
+  - name: "العناوكات المحظورة"
+    description: "إدارة العناوكات المحظورة"
+  - name: "التنبيهات"
+    description: "إدارة التنبيهات والإشعارات"
+  - name: "المراقبة"
+    description: "مراقبة الأداء والإحصائيات"
+  - name: "المصادقة"
+    description: "المصادقة وإدارة الرموز"
+
+paths:
+  # ========================================
+  # قسم الصحة
+  # ========================================
+  
+  /health:
+    get:
+      tags:
+        - "الصحة"
+      summary: "فحص حالة النظام"
+      description: "إرجاع حالة النظام العامة ومعلومات الإصدار"
+      operationId: "getHealth"
+      responses:
+        "200":
+          description: "النظام يعمل بشكل صحيح"
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/HealthResponse"
+              example:
+                status: "healthy"
+                version: "1.3.0"
+                uptime: "2d 5h 30m"
+                timestamp: "2024-10-13T10:30:00Z"
+        "503":
+          description: "النظام لا يعمل بشكل صحيح"
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/HealthResponse"
+              example:
+                status: "unhealthy"
+                version: "1.3.0"
+                error: "Database connection failed"
+
+  /health/detailed:
+    get:
+      tags:
+        - "الصحة"
+      summary: "فحص تفصيلي للحالة"
+      description: "إرجاع حالة مفصلة لجميع مكونات النظام"
+      operationId: "getDetailedHealth"
+      responses:
+        "200":
+          description: "حالة تفصيلية للنظام"
+          content:
+            application/json:
+              schema:
+                type: "object"
+                properties:
+                  status:
+                    type: "string"
+                  components:
+                    type: "object"
+                    properties:
+                      database:
+                        type: "object"
+                        properties:
+                          status:
+                            type: "string"
+                          latency_ms:
+                            type: "number"
+                      monitoring:
+                        type: "object"
+                        properties:
+                          status:
+                            type: "string"
+                          active_sources:
+                            type: "integer"
+                      notifications:
+                        type: "object"
+                        properties:
+                          status:
+                            type: "string"
+                          channels:
+                            type: "array"
+                            items:
+                              type: "string"
+                  timestamp:
+                    type: "string"
+                    format: "date-time"
+
+  # ========================================
+  # قسم التهديدات
+  # ========================================
+  
+  /threats:
+    get:
+      tags:
+        - "التهديدات"
+      summary: "قائمة التهديدات"
+      description: "استرجاع قائمة التهديدات المكتشفة مع إمكانية التصفية"
+      operationId: "listThreats"
+      parameters:
+        - name: "status"
+          in: "query"
+          schema:
+            type: "string"
+            enum: [blocked, active, ignored, all]
+          description: "تصفية حسب الحالة"
+        - name: "severity"
+          in: "query"
+          schema:
+            type: "string"
+            enum: [critical, high, medium, low, all]
+          description: "تصفية حسب الخطورة"
+        - name: "limit"
+          in: "query"
+          schema:
+            type: "integer"
+            default: 50
+            maximum: 100
+          description: "عدد النتائج المطلوبة"
+        - name: "offset"
+          in: "query"
+          schema:
+            type: "integer"
+            default: 0
+          description: "رقم البداية"
+      responses:
+        "200":
+          description: "قائمة التهديدات"
+          content:
+            application/json:
+              schema:
+                type: "object"
+                properties:
+                  total:
+                    type: "integer"
+                  limit:
+                    type: "integer"
+                  offset:
+                    type: "integer"
+                  threats:
+                    type: "array"
+                    items:
+                      $ref: "#/components/schemas/Threat"
+        "400":
+          description: "طلب غير صالح"
+    
+    post:
+      tags:
+        - "التهديدات"
+      summary: "إضافة تهديد يدوي"
+      description: "إضافة تهديد جديد يدوياً إلى النظام"
+      operationId: "createThreat"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ThreatCreate"
+      responses:
+        "201":
+          description: "تم إنشاء التهديد بنجاح"
+        "400":
+          description: "بيانات غير صالحة"
+
+  /threats/{threat_id}:
+    get:
+      tags:
+        - "التهديدات"
+      summary: "تفاصيل تهديد"
+      description: "استرجاع تفاصيل تهديد محدد"
+      operationId: "getThreat"
+      parameters:
+        - name: "threat_id"
+          in: "path"
+          required: true
+          schema:
+            type: "string"
+      responses:
+        "200":
+          description: "تفاصيل التهديد"
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Threat"
+        "404":
+          description: "التهديد غير موجود"
+    
+    delete:
+      tags:
+        - "التهديدات"
+      summary: "حذف تهديد"
+      description: "حذف تهديد محدد"
+      operationId: "deleteThreat"
+      parameters:
+        - name: "threat_id"
+          in: "path"
+          required: true
+          schema:
+            type: "string"
+      responses:
+        "204":
+          description: "تم حذف التهديد بنجاح"
+        "404":
+          description: "التهديد غير موجود"
+
+  # ========================================
+  # قسم العناوكات المحظورة
+  # ========================================
+  
+  /blocked-ips:
+    get:
+      tags:
+        - "العناوكات المحظورة"
+      summary: "قائمة العناوكات المحظورة"
+      description: "استرجاع قائمة العناوكات المحظورة"
+      operationId: "listBlockedIPs"
+      parameters:
+        - name: "active"
+          in: "query"
+          schema:
+            type: "boolean"
+          description: "تصفية للعناوكات النشطة فقط"
+        - name: "limit"
+          in: "query"
+          schema:
+            type: "integer"
+            default: 50
+      responses:
+        "200":
+          description: "قائمة العناوكات المحظورة"
+          content:
+            application/json:
+              schema:
+                type: "object"
+                properties:
+                  total:
+                    type: "integer"
+                  blocked_ips:
+                    type: "array"
+                    items:
+                      $ref: "#/components/schemas/BlockedIP"
+    
+    post:
+      tags:
+        - "العناوكات المحظورة"
+      summary: "حظر عنوان"
+      description: "حظر عنوان IP جديد"
+      operationId: "blockIP"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: "object"
+              required:
+                - "ip"
+                - "reason"
+              properties:
+                ip:
+                  type: "string"
+                  format: "ipv4"
+                  example: "192.168.1.100"
+                reason:
+                  type: "string"
+                  example: "Brute force attack detected"
+                duration:
+                  type: "integer"
+                  description: "مدة الحظر بالدقائق (0 = دائم)"
+                  default: 0
+      responses:
+        "201":
+          description: "تم حظر العنوان بنجاح"
+        "400":
+          description: "بيانات غير صالحة"
+
+  /blocked-ips/{ip}:
+    delete:
+      tags:
+        - "العناوكات المحظورة"
+      summary: "إلغاء حظر عنوان"
+      description: "إلغاء حظر عنوان IP محدد"
+      operationId: "unblockIP"
+      parameters:
+        - name: "ip"
+          in: "path"
+          required: true
+          schema:
+            type: "string"
+      responses:
+        "204":
+          description: "تم إلغاء الحظر بنجاح"
+        "404":
+          description: "العنوان غير موجود"
+
+  # ========================================
+  # قسم التنبيهات
+  # ========================================
+  
+  /alerts:
+    get:
+      tags:
+        - "التنبيهات"
+      summary: "قائمة التنبيهات"
+      description: "استرجاع قائمة التنبيهات المرسلة"
+      operationId: "listAlerts"
+      parameters:
+        - name: "read"
+          in: "query"
+          schema:
+            type: "boolean"
+          description: "تصفية للرسائل المقروءة/غير المقروءة"
+        - name: "limit"
+          in: "query"
+          schema:
+            type: "integer"
+            default: 50
+      responses:
+        "200":
+          description: "قائمة التنبيهات"
+
+    post:
+      tags:
+        - "التنبيهات"
+      summary: "إرسال تنبيه"
+      description: "إرسال تنبيه يدوي عبر جميع القنوات المفعلة"
+      operationId: "sendAlert"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: "object"
+              required:
+                - "title"
+                - "message"
+                - "severity"
+              properties:
+                title:
+                  type: "string"
+                  example: "تهديد أمني جديد"
+                message:
+                  type: "string"
+                  example: "اكتشاف محاولة اختراق"
+                severity:
+                  type: "string"
+                  enum: [critical, high, medium, low]
+                channels:
+                  type: "array"
+                  items:
+                    type: "string"
+                    enum: [slack, discord, email]
+      responses:
+        "202":
+          description: "تم قبول طلب الإرسال"
+        "400":
+          description: "بيانات غير صالحة"
+
+  /alerts/stats:
+    get:
+      tags:
+        - "التنبيهات"
+      summary: "إحصائيات التنبيهات"
+      description: "استرجاع إحصائيات التنبيهات"
+      operationId: "getAlertStats"
+      responses:
+        "200":
+          description: "إحصائيات التنبيهات"
+          content:
+            application/json:
+              schema:
+                type: "object"
+                properties:
+                  total_sent:
+                    type: "integer"
+                  by_channel:
+                    type: "object"
+                  by_severity:
+                    type: "object"
+
+  # ========================================
+  # قسم المراقبة
+  # ========================================
+  
+  /monitoring/stats:
+    get:
+      tags:
+        - "المراقبة"
+      summary: "إحصائيات المراقبة"
+      description: "استرجاع إحصائيات المراقبة والأمان"
+      operationId: "getMonitoringStats"
+      responses:
+        "200":
+          description: "إحصائيات المراقبة"
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MonitoringStats"
+
+  /monitoring/logs:
+    get:
+      tags:
+        - "المراقبة"
+      summary: "سجلات النظام"
+      description: "استرجاع سجلات النظام"
+      operationId: "getSystemLogs"
+      parameters:
+        - name: "level"
+          in: "query"
+          schema:
+            type: "string"
+            enum: [DEBUG, INFO, WARNING, ERROR]
+        - name: "limit"
+          in: "query"
+          schema:
+            type: "integer"
+            default: 100
+      responses:
+        "200":
+          description: "سجلات النظام"
+
+  # ========================================
+  # قسم المصادقة
+  # ========================================
+  
+  /auth/token:
+    post:
+      tags:
+        - "المصادقة"
+      summary: "الحصول على رمز الوصول"
+      description: "الحصول على رمز JWT للوصول إلى API"
+      operationId: "getToken"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: "object"
+              required:
+                - "username"
+                - "password"
+              properties:
+                username:
+                  type: "string"
+                password:
+                  type: "string"
+                  format: "password"
+      responses:
+        "200":
+          description: "رمز الوصول"
+          content:
+            application/json:
+              schema:
+                type: "object"
+                properties:
+                  access_token:
+                    type: "string"
+                  token_type:
+                    type: "string"
+                    example: "bearer"
+                  expires_in:
+                    type: "integer"
+        "401":
+          description: "بيانات اعتماد غير صالحة"
+
+# ========================================
+# المخططات (Schemas)
+# ========================================
+
+components:
+  schemas:
+    HealthResponse:
+      type: "object"
+      properties:
+        status:
+          type: "string"
+          enum: [healthy, unhealthy, degraded]
+          example: "healthy"
+        version:
+          type: "string"
+          example: "1.3.0"
+        uptime:
+          type: "string"
+          example: "2d 5h 30m"
+        timestamp:
+          type: "string"
+          format: "date-time"
+          example: "2024-10-13T10:30:00Z"
+        error:
+          type: "string"
+          description: "رسالة الخطأ إن وجد"
+
+    Threat:
+      type: "object"
+      properties:
+        id:
+          type: "string"
+          format: "uuid"
+        type:
+          type: "string"
+          example: "brute_force"
+        source_ip:
+          type: "string"
+          format: "ipv4"
+        target_port:
+          type: "integer"
+        severity:
+          type: "string"
+          enum: [critical, high, medium, low]
+        status:
+          type: "string"
+          enum: [blocked, active, ignored]
+        timestamp:
+          type: "string"
+          format: "date-time"
+        details:
+          type: "string"
+        actions:
+          type: "array"
+          items:
+            type: "string"
+
+    ThreatCreate:
+      type: "object"
+      required:
+        - "type"
+        - "source_ip"
+        - "severity"
+        - "details"
+      properties:
+        type:
+          type: "string"
+        source_ip:
+          type: "string"
+          format: "ipv4"
+        target_port:
+          type: "integer"
+        severity:
+          type: "string"
+          enum: [critical, high, medium, low]
+        details:
+          type: "string"
+
+    BlockedIP:
+      type: "object"
+      properties:
+        ip:
+          type: "string"
+          format: "ipv4"
+        reason:
+          type: "string"
+        blocked_at:
+          type: "string"
+          format: "date-time"
+        expires_at:
+          type: "string"
+          format: "date-time"
+        active:
+          type: "boolean"
+        block_count:
+          type: "integer"
+
+    MonitoringStats:
+      type: "object"
+      properties:
+        threats_blocked:
+          type: "integer"
+          example: 1369
+        success_rate:
+          type: "number"
+          format: "float"
+          example: 99.9
+        open_issues:
+          type: "integer"
+          example: 12
+        response_time_ms:
+          type: "number"
+          format: "float"
+          example: 100.0
+
+  securitySchemes:
+    bearerAuth:
+      type: "http"
+      scheme: "bearer"
+      bearerFormat: "JWT"

docs/configuration.md

@@ -0,0 +1,430 @@
+# دليل إعدادات نظام الحارس التلقائي
+# Auto Guardian System Configuration Guide
+# ==========================================
+
+## نظرة عامة
+
+يحتوي ملف `config/settings.yaml` على جميع إعدادات نظام الحارس التلقائي. هذا الدليل يشرح كل خيار بالتفصيل مع أمثلة عملية. يُرجى قراءة هذا الدليل بعناية قبل تعديل الإعدادات.
+
+---
+
+## هيكل ملف الإعدادات
+
+```
+config/
+├── settings.yaml          # الإعدادات الرئيسية
+├── rules.yaml             # قواعد الكشف عن التهديدات
+├── alerts.yaml            # قوالب التنبيهات
+└── whitelist.yaml         # قائمة العناوكات المسموح بها
+```
+
+---
+
+## القسم الأول: الإعدادات العامة
+
+```yaml
+# config/settings.yaml - القسم العام
+
+general:
+  # وضع التشغيل: development, testing, production
+  mode: development
+  
+  # مستوى التسجيل: DEBUG, INFO, WARNING, ERROR, CRITICAL
+  log_level: INFO
+  
+  # المنطقة الزمنية (استخدم تنسيق tzdata)
+  timezone: UTC
+  
+  # مسار ملفات السجلات
+  log_path: logs/
+  
+  # تفعيل وضع التحسينات (Production فقط)
+  optimizations: false
+```
+
+### شرح الخيارات
+
+| الخيار | القيم الممكنة | الافتراضي | الوصف |
+|--------|---------------|-----------|-------|
+| mode | development, testing, production | development | يحدد بيئة التشغيل |
+| log_level | DEBUG, INFO, WARNING, ERROR, CRITICAL | INFO | يتحكم في كمية السجلات |
+| timezone | أي منطقة زمنية صالحة | UTC | المنطقة الزمنية للسجلات |
+| log_path | مسار مجلد | logs/ | مكان تخزين السجلات |
+| optimizations | true, false | false | تفعيل تحسينات الأداء |
+
+---
+
+## القسم الثاني: إعدادات المراقبة
+
+```yaml
+# config/settings.yaml - قسم المراقبة
+
+monitoring:
+  # تفعيل المراقبة
+  enabled: true
+  
+  # مصادر السجلات للمراقبة
+  log_sources:
+    - /var/log/auth.log           # سجلات المصادقة
+    - /var/log/syslog             # سجلات النظام العامة
+    - /var/log/nginx/access.log   # سجلات خادم الويب
+  
+  # الفاصل الزمني للفحص (بالثواني)
+  scan_interval: 5
+  
+  # تفعيل الفحص العميق (أبطأ لكنه أكثر دقة)
+  deep_scan: false
+  
+  # الأنماط المشبوهة للكشف (قاعدة منفصلة)
+  patterns_file: config/rules.yaml
+  
+  # تفعيل المراقبة في الوقت الفعلي
+  realtime_monitoring: true
+  
+  # حجم ذاكرة التخزين المؤقت للأحداث
+  event_buffer_size: 1000
+```
+
+### شرح الخيارات
+
+| الخيار | القيم الممكنة | الافتراضي | الوصف |
+|--------|---------------|-----------|-------|
+| enabled | true, false | true | تفعيل أو إلغاء المراقبة |
+| log_sources | قائمة مسارات | - | مصادر السجلات للمراقبة |
+| scan_interval | رقم (ثواني) | 5 | الفاصل بين عمليات الفحص |
+| deep_scan | true, false | false | فحص أعمق وأدق |
+| realtime_monitoring | true, false | true | مراقبة في الوقت الفعلي |
+| event_buffer_size | رقم | 1000 | حجم التخزين المؤقت |
+
+---
+
+## القسم الثالث: قواعد الكشف
+
+```yaml
+# config/rules.yaml - قواعد الكشف
+
+# أنماط هجوم القوة الغاشبة
+brute_force:
+  enabled: true
+  threshold: 5              # عدد المحاولات
+  time_window: 60           # بالم seconds
+  ports: [22, 2222]         # المنافذ المستهدفة
+
+# أنماط المسح الضوئي للمنافذ
+port_scan:
+  enabled: true
+  min_ports: 3              # الحد الأدنى للمنافذ
+  time_window: 30           # بالم seconds
+  severity: high
+
+# أنماط حقن SQL
+sql_injection:
+  enabled: true
+  severity: critical
+  auto_block: true
+
+# أنماط XSS
+xss:
+  enabled: true
+  severity: high
+  auto_block: false
+
+# أنماط الوصول غير المصرح به
+unauthorized_access:
+  enabled: true
+  severity: critical
+  auto_block: true
+```
+
+---
+
+## القسم الرابع: إعدادات الحظر
+
+```yaml
+# config/settings.yaml - قسم الحظر
+
+blocking:
+  # تفعيل الحظر التلقائي
+  enabled: true
+  
+  # عدد المحاولات قبل الحظر
+  threshold: 5
+  
+  # الفترة الزمنية للمحاولات (بالثواني)
+  time_window: 60
+  
+  # تفعيل IPTables للحظر
+  use_iptables: true
+  
+  # تفعيل firewalld للحظر
+  use_firewalld: false
+  
+  # تفعيل الحظر في Cloudflare
+  use_cloudflare: false
+  
+  # قائمة السماح (عناوكات لا تُحظر)
+  whitelist:
+    - 127.0.0.1
+    - 192.168.1.1
+    - 10.0.0.1
+  
+  # قائمة الحظر الدائم
+  blacklist: []
+  
+  # مدة الحظر الافتراضية (بالدقائق، 0 = دائم)
+  default_duration: 0
+  
+  # إرسال إشعار عند الحظر
+  notify_on_block: true
+```
+
+### شرح الخيارات
+
+| الخيار | القيم الممكنة | الافتراضي | الوصف |
+|--------|---------------|-----------|-------|
+| enabled | true, false | true | تفعيل الحظر التلقائي |
+| threshold | رقم | 5 | عدد المحاولات قبل الحظر |
+| time_window | رقم (ثواني) | 60 | الفترة الزمنية |
+| use_iptables | true, false | true | استخدام IPTables |
+| whitelist | قائمة IPs | [] | عناوين لا تُحظر |
+| default_duration | رقم (دقائق) | 0 | مدة الحظر الافتراضية |
+
+---
+
+## القسم الخامس: إعدادات الإشعارات
+
+```yaml
+# config/settings.yaml - قسم الإشعارات
+
+notifications:
+  # تفعيل الإشعارات
+  enabled: true
+  
+  # عنوان المرسل
+  sender_name: "Auto-Guardian System"
+  
+  # ---- Slack ----
+  slack:
+    enabled: false
+    webhook_url: ""
+    channel: "security-alerts"
+    username: "Auto-Guardian"
+    icon_emoji: ":shield:"
+  
+  # ---- Discord ----
+  discord:
+    enabled: false
+    webhook_url: ""
+    username: "Auto-Guardian"
+    avatar_url: ""
+  
+  # ---- البريد الإلكتروني ----
+  email:
+    enabled: false
+    smtp_host: "smtp.gmail.com"
+    smtp_port: 587
+    use_tls: true
+    username: ""
+    password: ""
+    from_address: "noreply@autoguardian.local"
+    to_addresses:
+      - "admin@example.com"
+  
+  # ---- عام ----
+  # تفعيل الإشعارات للتهديدات الحرجة فقط
+  critical_only: false
+  
+  # وقت عدم الإرسال (بالساعات، 0 = نش)
+  quietط دائماً_hours: 0
+```
+
+---
+
+## القسم السادس: إعدادات Prometheus
+
+```yaml
+# config/settings.yaml - قسم Prometheus
+
+prometheus:
+  # تفعيل Prometheus
+  enabled: true
+  
+  # منفذ الاستماع
+  port: 9090
+  
+  # مسار /metrics
+  metrics_path: /metrics
+  
+  # تفعيل جمع السجلات
+  include_logs: true
+  
+  # تضمين معلومات النظام
+  include_system_info: true
+  
+  # تضمين معلومات التهديدات
+  include_threat_info: true
+```
+
+### مقاييس Prometheus المتاحة
+
+| المقياس | النوع | الوصف |
+|---------|-------|-------|
+| autoguardian_threats_total | Counter | إجمالي التهديدات |
+| autoguardian_blocked_ips | Gauge | عدد العناوكات المحظورة |
+| autoguardian_blocked_ips_active | Gauge | العناوكات النشطة |
+| autoguardian_success_rate | Gauge | معدل النجاح |
+| autoguardian_response_time_seconds | Histogram | زمن الاستجابة |
+| autoguardian_alerts_sent | Counter | التنبيهات المرسلة |
+
+---
+
+## القسم السابع: إعدادات الأمان
+
+```yaml
+# config/settings.yaml - قسم الأمان
+
+security:
+  # تفعيل التحقق من التحديثات الأمنية
+  security_checks: true
+  
+  # فترة التحقق من التحديثات (بالساعات)
+  check_interval: 24
+  
+  # تفعيل تسجيل التدقيق
+  audit_logging: true
+  
+  # مسار ملف سجل التدقيق
+  audit_log_path: logs/audit.log
+  
+  # تفعيل HTTPS
+  use_https: false
+  
+  # ملف الشهادة (للإنتاج)
+  ssl_cert: ""
+  ssl_key: ""
+  
+  # فترة انتهاء الجلسة (بالساعات)
+  session_timeout: 24
+```
+
+---
+
+## أمثلة التكوين
+
+### تكوين التطوير
+
+```yaml
+# config/settings.yaml - وضع التطوير
+
+general:
+  mode: development
+  log_level: DEBUG
+  timezone: UTC
+
+monitoring:
+  enabled: true
+  scan_interval: 5
+  deep_scan: false
+
+blocking:
+  enabled: false  # لا تحظر في التطوير
+
+notifications:
+  enabled: false  # لا ترسل إشعارات في التطوير
+
+prometheus:
+  enabled: false
+```
+
+### تكوين الإنتاج
+
+```yaml
+# config/settings.yaml - وضع الإنتاج
+
+general:
+  mode: production
+  log_level: WARNING
+  timezone: Asia/Riyadh
+
+monitoring:
+  enabled: true
+  scan_interval: 1
+  deep_scan: true
+
+blocking:
+  enabled: true
+  threshold: 3
+  time_window: 30
+  use_iptables: true
+  default_duration: 360  # 6 ساعات
+
+notifications:
+  enabled: true
+  slack:
+    enabled: true
+    webhook_url: ${SLACK_WEBHOOK_URL}
+  discord:
+    enabled: true
+    webhook_url: ${DISCORD_WEBHOOK_URL}
+
+prometheus:
+  enabled: true
+  port: 9090
+
+security:
+  security_checks: true
+  audit_logging: true
+  use_https: true
+  ssl_cert: /etc/ssl/certs/cert.pem
+  ssl_key: /etc/ssl/private/key.pem
+  session_timeout: 8
+```
+
+---
+
+## متغيرات البيئة
+
+يمكن تجاوز إعدادات YAML باستخدام متغيرات البيئة:
+
+| متغير البيئة | المقابل في YAML |
+|--------------|-----------------|
+| AG_MODE | general.mode |
+| AG_LOG_LEVEL | general.log_level |
+| AG_BLOCKING_ENABLED | blocking.enabled |
+| AG_SLACK_WEBHOOK_URL | notifications.slack.webhook_url |
+| AG_PROMETHEUS_PORT | prometheus.port |
+
+مثال:
+
+```bash
+export AG_MODE=production
+export AG_LOG_LEVEL=WARNING
+export AG_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
+```
+
+---
+
+## التحقق من الإعدادات
+
+للتحقق من صحة ملف الإعدادات:
+
+```bash
+python -c "
+import yaml
+with open('config/settings.yaml') as f:
+    config = yaml.safe_load(f)
+    print('✅ الإعدادات صالحة')
+    print(f'وضع التشغيل: {config[\"general\"][\"mode\"]}')
+    print(f'المسار: {config[\"monitoring\"][\"enabled\"]}')
+"
+```
+
+---
+
+## الدعم
+
+للمساعدة في الإعدادات:
+
+- **المستندات:** راجع التوثيق الكامل
+- **GitHub Issues:** أبلغ عن مشكلة
+- **البريد:** support@autoguardian.local

google7cceda004d653872.html

@@ -0,0 +1 @@
+google-site-verification: google7cceda004d653872.html

index.html

@@ -0,0 +1,1724 @@
+<!DOCTYPE html>
+<html lang="ar" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Auto-Guardian Dashboard</title>
+    <meta name="google-site-verification" content="google7cceda004d653872" />
+    <meta name="description" content="Auto-Guardian: A comprehensive security and monitoring system dashboard for modern infrastructure. Automated security monitoring and protection core system." />
+    <meta name="keywords" content="security, monitoring, automation, guardian, dashboard, infrastructure, protection" />
+    <meta name="author" content="Abdulelah Othman Gwaith" />
+    <meta property="og:title" content="Auto-Guardian Dashboard" />
+    <meta property="og:description" content="Automated security monitoring and protection core system." />
+    <meta property="og:url" content="https://abdulelahothmangwaith.github.io/Auto-Guardian-Core/" />
+    <meta property="og:type" content="website" />
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "SoftwareApplication",
+      "name": "Auto-Guardian-Core",
+      "operatingSystem": "Linux, Windows, macOS",
+      "applicationCategory": "SecurityApplication",
+      "offers": {
+        "@type": "Offer",
+        "price": "0",
+        "priceCurrency": "USD"
+      },
+      "author": {
+        "@type": "Person",
+        "name": "Abdulelah Othman Gwaith"
+      },
+      "description": "An automated security monitoring and protection core system designed for modern infrastructure.",
+      "url": "https://abdulelahothmangwaith.github.io/Auto-Guardian-Core/"
+    }
+    </script>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        
+        :root {
+            --primary: #0F172A;
+            --secondary: #3B82F6;
+            --success: #10B981;
+            --danger: #EF4444;
+            --warning: #F59E0B;
+            --bg: #F8FAFC;
+            --card-bg: #FFFFFF;
+            --text: #1E293B;
+            --text-muted: #64748B;
+            --border: #E2E8F0;
+        }
+        
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            background-color: var(--bg);
+            color: var(--text);
+            min-height: 100vh;
+            overflow-x: hidden;
+        }
+        
+        .dashboard {
+            display: flex;
+            flex-direction: row;
+            min-height: 100vh;
+            width: 100%;
+        }
+        
+        /* Sidebar */
+        .sidebar {
+            background: var(--primary);
+            color: white;
+            padding: 20px 0;
+            width: 240px;
+            height: 100vh;
+            overflow-y: auto;
+            flex-shrink: 0;
+            position: sticky;
+            top: 0;
+        }
+        
+        .logo {
+            padding: 20px;
+            text-align: center;
+            border-bottom: 1px solid rgba(255,255,255,0.1);
+            margin-bottom: 20px;
+        }
+        
+        .logo h1 {
+            font-size: 20px;
+            font-weight: 700;
+            color: var(--secondary);
+        }
+        
+        .logo span {
+            font-size: 12px;
+            color: var(--text-muted);
+        }
+        
+        .nav-menu {
+            list-style: none;
+        }
+        
+        .nav-item {
+            padding: 12px 20px;
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            border-right: 3px solid transparent;
+        }
+        
+        .nav-item:hover, .nav-item.active {
+            background: rgba(59, 130, 246, 0.1);
+            border-right-color: var(--secondary);
+        }
+        
+        .nav-item svg {
+            width: 20px;
+            height: 20px;
+        }
+        
+        .nav-item span {
+            font-size: 14px;
+        }
+        
+        /* Main Content */
+        .main-content {
+            flex: 1;
+            padding: 20px 30px;
+            min-width: 0;
+            overflow-x: hidden;
+        }
+        
+        /* Header */
+        .header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 30px;
+            flex-wrap: wrap;
+            gap: 15px;
+        }
+        
+        .header h2 {
+            font-size: 24px;
+            font-weight: 600;
+        }
+        
+        .header-actions {
+            display: flex;
+            gap: 12px;
+            align-items: center;
+        }
+        
+        .search-box {
+            display: flex;
+            align-items: center;
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            padding: 8px 16px;
+            gap: 8px;
+            position: relative;
+        }
+        
+        .search-box:hover {
+            border-color: var(--secondary);
+        }
+        
+        .search-box input {
+            border: none;
+            outline: none;
+            font-size: 14px;
+            width: 150px;
+            background: transparent;
+            flex: 1;
+            min-width: 100px;
+        }
+        
+        .search-results {
+            display: none;
+            position: absolute;
+            top: 100%;
+            left: 0;
+            right: 0;
+            background: white;
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            margin-top: 8px;
+            max-height: 300px;
+            overflow-y: auto;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.1);
+            z-index: 100;
+        }
+        
+        .search-results.active {
+            display: block;
+        }
+        
+        .search-result-item {
+            padding: 12px 16px;
+            border-bottom: 1px solid var(--border);
+            cursor: pointer;
+            transition: background 0.3s ease;
+        }
+        
+        .search-result-item:hover {
+            background: var(--bg);
+        }
+        
+        .search-result-item:last-child {
+            border-bottom: none;
+        }
+        
+        .notification-btn {
+            position: relative;
+            background: var(--card-bg);
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            padding: 8px 12px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+        
+        .notification-btn:hover {
+            border-color: var(--secondary);
+        }
+        
+        .notification-badge {
+            position: absolute;
+            top: -5px;
+            right: -5px;
+            background: var(--danger);
+            color: white;
+            font-size: 10px;
+            padding: 2px 6px;
+            border-radius: 10px;
+        }
+        
+        /* Settings Panel */
+        .settings-panel {
+            display: none;
+            position: fixed;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 100%;
+            background: rgba(0,0,0,0.5);
+            z-index: 1000;
+            justify-content: center;
+            align-items: center;
+        }
+        
+        .settings-panel.active {
+            display: flex;
+        }
+        
+        .settings-content {
+            background: white;
+            border-radius: 16px;
+            padding: 30px;
+            width: 90%;
+            max-width: 500px;
+            max-height: 80vh;
+            overflow-y: auto;
+        }
+        
+        .settings-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 24px;
+        }
+        
+        .settings-header h3 {
+            font-size: 20px;
+        }
+        
+        .close-btn {
+            background: none;
+            border: none;
+            font-size: 24px;
+            cursor: pointer;
+            color: var(--text-muted);
+        }
+        
+        .setting-item {
+            margin-bottom: 20px;
+        }
+        
+        .setting-label {
+            display: block;
+            font-size: 14px;
+            font-weight: 500;
+            margin-bottom: 8px;
+        }
+        
+        .setting-description {
+            font-size: 12px;
+            color: var(--text-muted);
+            margin-bottom: 8px;
+        }
+        
+        .setting-input {
+            width: 100%;
+            padding: 10px 14px;
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            font-size: 14px;
+            transition: all 0.3s ease;
+        }
+        
+        .setting-input:focus {
+            outline: none;
+            border-color: var(--secondary);
+        }
+        
+        .setting-select {
+            width: 100%;
+            padding: 10px 14px;
+            border: 1px solid var(--border);
+            border-radius: 8px;
+            font-size: 14px;
+            background: white;
+            cursor: pointer;
+        }
+        
+        .setting-toggle {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            cursor: pointer;
+        }
+        
+        .toggle-switch {
+            position: relative;
+            width: 50px;
+            height: 26px;
+            background: var(--border);
+            border-radius: 13px;
+            transition: all 0.3s ease;
+        }
+        
+        .toggle-switch.active {
+            background: var(--secondary);
+        }
+        
+        .toggle-switch::after {
+            content: '';
+            position: absolute;
+            width: 22px;
+            height: 22px;
+            background: white;
+            border-radius: 50%;
+            top: 2px;
+            left: 2px;
+            transition: all 0.3s ease;
+        }
+        
+        .toggle-switch.active::after {
+            left: 26px;
+        }
+        
+        .save-btn {
+            width: 100%;
+            padding: 12px;
+            background: var(--secondary);
+            color: white;
+            border: none;
+            border-radius: 8px;
+            font-size: 14px;
+            font-weight: 500;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+        
+        .save-btn:hover {
+            background: var(--primary);
+        }
+        
+        /* Stats Grid */
+        .stats-grid {
+            display: grid;
+            grid-template-columns: repeat(4, 1fr);
+            gap: 20px;
+            margin-bottom: 30px;
+        }
+        
+        .stat-card {
+            background: var(--card-bg);
+            border-radius: 12px;
+            padding: 20px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+            transition: transform 0.3s ease, box-shadow 0.3s ease;
+            cursor: pointer;
+        }
+        
+        .stat-card:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+        }
+        
+        .stat-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: flex-start;
+            margin-bottom: 12px;
+        }
+        
+        .stat-icon {
+            width: 40px;
+            height: 40px;
+            border-radius: 10px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        
+        .stat-icon.blue { background: rgba(59, 130, 246, 0.1); color: var(--secondary); }
+        .stat-icon.green { background: rgba(16, 185, 129, 0.1); color: var(--success); }
+        .stat-icon.red { background: rgba(239, 68, 68, 0.1); color: var(--danger); }
+        .stat-icon.yellow { background: rgba(245, 158, 11, 0.1); color: var(--warning); }
+        
+        .stat-trend {
+            font-size: 12px;
+            display: flex;
+            align-items: center;
+            gap: 4px;
+        }
+        
+        .stat-trend.up { color: var(--success); }
+        .stat-trend.down { color: var(--danger); }
+        
+        .stat-value {
+            font-size: 28px;
+            font-weight: 700;
+            margin-bottom: 4px;
+        }
+        
+        .stat-label {
+            font-size: 13px;
+            color: var(--text-muted);
+        }
+        
+        /* Charts Section */
+        .charts-section {
+            display: grid;
+            grid-template-columns: 2fr 1fr;
+            gap: 20px;
+            margin-bottom: 30px;
+        }
+        
+        .chart-card {
+            background: var(--card-bg);
+            border-radius: 12px;
+            padding: 20px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        }
+        
+        .chart-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 20px;
+        }
+        
+        .chart-title {
+            font-size: 16px;
+            font-weight: 600;
+        }
+        
+        .chart-tabs {
+            display: flex;
+            gap: 8px;
+        }
+        
+        .chart-tab {
+            padding: 6px 12px;
+            border-radius: 6px;
+            font-size: 12px;
+            cursor: pointer;
+            background: var(--bg);
+            border: none;
+            transition: all 0.3s ease;
+        }
+        
+        .chart-tab.active {
+            background: var(--secondary);
+            color: white;
+        }
+        
+        .chart-tab:hover:not(.active) {
+            background: var(--border);
+        }
+        
+        /* Area Chart */
+        .area-chart {
+            height: 250px;
+            position: relative;
+        }
+        
+        .chart-svg {
+            width: 100%;
+            height: 100%;
+        }
+        
+        /* Donut Chart */
+        .donut-chart {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 30px;
+        }
+        
+        .donut-svg {
+            width: 180px;
+            height: 180px;
+        }
+        
+        .donut-legend {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+        
+        .legend-item {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+        
+        .legend-color {
+            width: 12px;
+            height: 12px;
+            border-radius: 3px;
+        }
+        
+        .legend-label {
+            font-size: 13px;
+            color: var(--text-muted);
+        }
+        
+        .legend-value {
+            font-size: 14px;
+            font-weight: 600;
+            margin-right: auto;
+        }
+        
+        /* Activity Section */
+        .activity-section {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 20px;
+        }
+        
+        .activity-card {
+            background: var(--card-bg);
+            border-radius: 12px;
+            padding: 20px;
+            box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        }
+        
+        .activity-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 16px;
+        }
+        
+        .activity-title {
+            font-size: 16px;
+            font-weight: 600;
+        }
+        
+        .view-all {
+            font-size: 13px;
+            color: var(--secondary);
+            cursor: pointer;
+        }
+        
+        .view-all:hover {
+            text-decoration: underline;
+        }
+        
+        /* Issues List */
+        .issues-list {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+        
+        .issue-item {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            padding: 12px;
+            background: var(--bg);
+            border-radius: 8px;
+            transition: all 0.3s ease;
+            cursor: pointer;
+        }
+        
+        .issue-item:hover {
+            background: rgba(59, 130, 246, 0.05);
+        }
+        
+        .issue-icon {
+            width: 32px;
+            height: 32px;
+            border-radius: 8px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        
+        .issue-content {
+            flex: 1;
+        }
+        
+        .issue-title {
+            font-size: 13px;
+            font-weight: 500;
+            margin-bottom: 2px;
+        }
+        
+        .issue-meta {
+            font-size: 11px;
+            color: var(--text-muted);
+        }
+        
+        .issue-badge {
+            padding: 4px 10px;
+            border-radius: 20px;
+            font-size: 11px;
+            font-weight: 500;
+        }
+        
+        .badge-critical { background: rgba(239, 68, 68, 0.1); color: var(--danger); }
+        .badge-warning { background: rgba(245, 158, 11, 0.1); color: var(--warning); }
+        .badge-info { background: rgba(59, 130, 246, 0.1); color: var(--secondary); }
+        .badge-success { background: rgba(16, 185, 129, 0.1); color: var(--success); }
+        
+        /* Repositories List */
+        .repos-list {
+            display: flex;
+            flex-direction: column;
+            gap: 12px;
+        }
+        
+        .repo-item {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+            padding: 12px;
+            background: var(--bg);
+            border-radius: 8px;
+            transition: all 0.3s ease;
+            cursor: pointer;
+        }
+        
+        .repo-item:hover {
+            background: rgba(59, 130, 246, 0.05);
+        }
+        
+        .repo-icon {
+            width: 36px;
+            height: 36px;
+            border-radius: 8px;
+            background: var(--primary);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: white;
+        }
+        
+        .repo-content {
+            flex: 1;
+        }
+        
+        .repo-name {
+            font-size: 13px;
+            font-weight: 500;
+            margin-bottom: 2px;
+        }
+        
+        .repo-stats {
+            display: flex;
+            gap: 12px;
+            font-size: 11px;
+            color: var(--text-muted);
+        }
+        
+        .repo-status {
+            display: flex;
+            align-items: center;
+            gap: 4px;
+            font-size: 12px;
+        }
+        
+        .status-dot {
+            width: 8px;
+            height: 8px;
+            border-radius: 50%;
+        }
+        
+        .status-dot.active { background: var(--success); }
+        .status-dot.warning { background: var(--warning); }
+        .status-dot.error { background: var(--danger); }
+        
+        /* Toast Notifications */
+        .toast-container {
+            position: fixed;
+            top: 20px;
+            left: 50%;
+            transform: translateX(-50%);
+            z-index: 2000;
+            display: flex;
+            flex-direction: column;
+            gap: 10px;
+        }
+        
+        .toast {
+            padding: 14px 20px;
+            background: var(--primary);
+            color: white;
+            border-radius: 10px;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.2);
+            display: flex;
+            align-items: center;
+            gap: 10px;
+            animation: slideIn 0.3s ease, fadeOut 0.3s ease 2.7s;
+        }
+        
+        .toast.success { background: var(--success); }
+        .toast.error { background: var(--danger); }
+        .toast.warning { background: var(--warning); }
+        .toast.info { background: var(--secondary); }
+        
+        @keyframes slideIn {
+            from { transform: translateY(-20px); opacity: 0; }
+            to { transform: translateY(0); opacity: 1; }
+        }
+        
+        @keyframes fadeOut {
+            from { opacity: 1; }
+            to { opacity: 0; }
+        }
+        
+        /* Responsive */
+        @media (max-width: 1200px) {
+            .stats-grid {
+                grid-template-columns: repeat(2, 1fr);
+            }
+            .charts-section {
+                grid-template-columns: 1fr;
+            }
+            .activity-section {
+                grid-template-columns: 1fr;
+            }
+        }
+        
+        @media (max-width: 992px) {
+            .sidebar {
+                position: fixed;
+                right: -240px;
+                top: 0;
+                z-index: 1000;
+                transition: right 0.3s ease;
+                box-shadow: -4px 0 20px rgba(0,0,0,0.1);
+            }
+            
+            .sidebar.active {
+                right: 0;
+            }
+            
+            .sidebar-overlay {
+                display: none;
+                position: fixed;
+                top: 0;
+                left: 0;
+                width: 100%;
+                height: 100%;
+                background: rgba(0,0,0,0.5);
+                z-index: 999;
+            }
+            
+            .sidebar-overlay.active {
+                display: block;
+            }
+            
+            .main-content {
+                width: 100%;
+                padding: 15px 20px;
+            }
+            
+            .mobile-menu-btn {
+                display: flex !important;
+            }
+            
+            .header-actions {
+                gap: 8px;
+            }
+            
+            .search-box {
+                min-width: 120px;
+            }
+            
+            .search-box input {
+                width: 80px;
+            }
+        }
+        
+        @media (max-width: 768px) {
+            .dashboard {
+                flex-direction: column;
+            }
+            
+            .stats-grid {
+                grid-template-columns: 1fr;
+                gap: 12px;
+            }
+            
+            .stat-card {
+                padding: 15px;
+                display: flex;
+                align-items: center;
+                justify-content: space-between;
+                flex-wrap: wrap;
+            }
+            
+            .stat-header {
+                margin-bottom: 0;
+                width: auto;
+            }
+            
+            .stat-value {
+                font-size: 24px;
+                text-align: left;
+            }
+            
+            .stat-label {
+                text-align: left;
+                width: 100%;
+            }
+            
+            .charts-section {
+                gap: 15px;
+                margin-bottom: 20px;
+            }
+            
+            .chart-card {
+                padding: 15px;
+            }
+            
+            .area-chart {
+                height: 200px;
+            }
+            
+            .donut-chart {
+                flex-direction: column;
+                gap: 15px;
+            }
+            
+            .donut-svg {
+                width: 150px;
+                height: 150px;
+            }
+            
+            .activity-section {
+                gap: 15px;
+            }
+            
+            .activity-card {
+                padding: 15px;
+            }
+            
+            .header {
+                margin-bottom: 20px;
+            }
+            
+            .header h2 {
+                font-size: 20px;
+                width: 100%;
+            }
+            
+            .header-actions {
+                width: 100%;
+                justify-content: space-between;
+            }
+            
+            .search-box {
+                flex: 1;
+                min-width: 0;
+            }
+            
+            .search-box input {
+                width: 100%;
+            }
+            
+            .notification-btn {
+                padding: 8px;
+            }
+        }
+        
+        @media (max-width: 480px) {
+            .stat-card {
+                padding: 12px;
+            }
+            
+            .stat-icon {
+                width: 36px;
+                height: 36px;
+            }
+            
+            .stat-value {
+                font-size: 20px;
+            }
+            
+            .stat-label {
+                font-size: 12px;
+            }
+            
+            .chart-title {
+                font-size: 14px;
+            }
+            
+            .chart-tabs {
+                gap: 4px;
+            }
+            
+            .chart-tab {
+                padding: 4px 8px;
+                font-size: 11px;
+            }
+            
+            .issue-item, .repo-item {
+                padding: 10px;
+            }
+            
+            .issue-icon {
+                width: 28px;
+                height: 28px;
+            }
+            
+            .issue-title {
+                font-size: 12px;
+            }
+            
+            .issue-meta {
+                font-size: 10px;
+            }
+        }
+        
+        /* Mobile Menu Button */
+        .mobile-menu-btn {
+            display: none;
+            position: fixed;
+            bottom: 20px;
+            left: 20px;
+            width: 50px;
+            height: 50px;
+            border-radius: 50%;
+            background: var(--secondary);
+            color: white;
+            border: none;
+            cursor: pointer;
+            z-index: 1001;
+            box-shadow: 0 4px 15px rgba(59, 130, 246, 0.4);
+            align-items: center;
+            justify-content: center;
+            transition: all 0.3s ease;
+        }
+        
+        .mobile-menu-btn:hover {
+            transform: scale(1.1);
+            background: var(--primary);
+        }
+        
+        .mobile-menu-btn svg {
+            width: 24px;
+            height: 24px;
+        }
+        
+        /* Sidebar Overlay */
+        .sidebar-overlay {
+            display: none;
+        }
+    </style>
+</head>
+<body>
+    <div class="dashboard">
+        <!-- Sidebar Overlay -->
+        <div class="sidebar-overlay" id="sidebarOverlay" onclick="toggleMobileMenu()"></div>
+        
+        <!-- Sidebar -->
+        <aside class="sidebar" id="sidebar">
+            <div class="logo">
+                <h1>Auto-Guardian</h1>
+                <span>Security Dashboard</span>
+            </div>
+            <ul class="nav-menu">
+                <li class="nav-item active" data-view="dashboard">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2V6zM14 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2V6zM4 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2v-2zM14 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2v-2z"/>
+                    </svg>
+                    <span>لوحة التحكم</span>
+                </li>
+                <li class="nav-item" data-view="protection">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z"/>
+                    </svg>
+                    <span>الحماية</span>
+                </li>
+                <li class="nav-item" data-view="analysis">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01"/>
+                    </svg>
+                    <span>الفحص والتحليل</span>
+                </li>
+                <li class="nav-item" data-view="reports">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>
+                    </svg>
+                    <span>التقارير</span>
+                </li>
+                <li class="nav-item" data-view="settings" id="settingsNavItem">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"/>
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                    </svg>
+                    <span>الإعدادات</span>
+                </li>
+                <li class="nav-item" data-view="help">
+                    <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    <span>المساعدة</span>
+                </li>
+            </ul>
+        </aside>
+        
+        <!-- Mobile Menu Button -->
+        <button class="mobile-menu-btn" id="mobileMenuBtn" onclick="toggleMobileMenu()">
+            <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"/>
+            </svg>
+        </button>
+        
+        <!-- Main Content -->
+        <main class="main-content">
+            <!-- Header -->
+            <header class="header">
+                <h2>لوحة تحكم Auto-Guardian</h2>
+                <div class="header-actions">
+                    <div class="search-box" id="searchBox">
+                        <svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+                        </svg>
+                        <input type="text" placeholder="بحث..." id="searchInput">
+                        <div class="search-results" id="searchResults"></div>
+                    </div>
+                    <button class="notification-btn" id="notificationBtn">
+                        <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9"/>
+                        </svg>
+                        <span class="notification-badge" id="notificationBadge">5</span>
+                    </button>
+                </div>
+            </header>
+            
+            <!-- Stats Grid -->
+            <div class="stats-grid">
+                <div class="stat-card" onclick="filterIssues('critical')">
+                    <div class="stat-header">
+                        <div class="stat-icon blue">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend up" id="trendCritical">↑ 12%</span>
+                    </div>
+                    <div class="stat-value" id="statThreats">1,247</div>
+                    <div class="stat-label">التهديدات المحظورة</div>
+                </div>
+                
+                <div class="stat-card">
+                    <div class="stat-header">
+                        <div class="stat-icon green">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend up" id="trendSuccess">↑ 8%</span>
+                    </div>
+                    <div class="stat-value" id="statSuccess">99.9%</div>
+                    <div class="stat-label">معدل النجاح</div>
+                </div>
+                
+                <div class="stat-card" onclick="filterIssues('open')">
+                    <div class="stat-header">
+                        <div class="stat-icon red">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend down" id="trendOpen">↓ 3%</span>
+                    </div>
+                    <div class="stat-value" id="statOpen">23</div>
+                    <div class="stat-label">المشكلات المفتوحة</div>
+                </div>
+                
+                <div class="stat-card">
+                    <div class="stat-header">
+                        <div class="stat-icon yellow">
+                            <svg width="20" height="20" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>
+                            </svg>
+                        </div>
+                        <span class="stat-trend up" id="trendResponse">↑ 15%</span>
+                    </div>
+                    <div class="stat-value" id="statResponse">0.3s</div>
+                    <div class="stat-label">زمن الاستجابة</div>
+                </div>
+            </div>
+            
+            <!-- Charts Section -->
+            <div class="charts-section">
+                <div class="chart-card">
+                    <div class="chart-header">
+                        <h3 class="chart-title">نشاط الفحص والأمان</h3>
+                        <div class="chart-tabs">
+                            <button class="chart-tab" data-period="day" onclick="changePeriod('day')">24 ساعة</button>
+                            <button class="chart-tab active" data-period="week" onclick="changePeriod('week')">أسبوع</button>
+                            <button class="chart-tab" data-period="month" onclick="changePeriod('month')">شهر</button>
+                        </div>
+                    </div>
+                    <div class="area-chart">
+                        <svg class="chart-svg" viewBox="0 0 800 250" id="mainChart">
+                            <!-- Grid lines -->
+                            <line x1="50" y1="30" x2="750" y2="30" stroke="#E2E8F0" stroke-width="1"/>
+                            <line x1="50" y1="80" x2="750" y2="80" stroke="#E2E8F0" stroke-width="1"/>
+                            <line x1="50" y1="130" x2="750" y2="130" stroke="#E2E8F0" stroke-width="1"/>
+                            <line x1="50" y1="180" x2="750" y2="180" stroke="#E2E8F0" stroke-width="1"/>
+                            
+                            <!-- Area gradient -->
+                            <defs>
+                                <linearGradient id="areaGradient" x1="0%" y1="0%" x2="0%" y2="100%">
+                                    <stop offset="0%" style="stop-color:#3B82F6;stop-opacity:0.3"/>
+                                    <stop offset="100%" style="stop-color:#3B82F6;stop-opacity:0.05"/>
+                                </linearGradient>
+                            </defs>
+                            
+                            <!-- Area path -->
+                            <path d="M50,180 L100,150 L150,160 L200,120 L250,140 L300,100 L350,110 L400,70 L450,90 L500,60 L550,80 L600,50 L650,65 L700,40 L750,55 L750,180 Z" fill="url(#areaGradient)"/>
+                            
+                            <!-- Line -->
+                            <path d="M50,180 L100,150 L150,160 L200,120 L250,140 L300,100 L350,110 L400,70 L450,90 L500,60 L550,80 L600,50 L650,65 L700,40 L750,55" fill="none" stroke="#3B82F6" stroke-width="3" stroke-linecap="round"/>
+                            
+                            <!-- Data points -->
+                            <circle cx="100" cy="150" r="5" fill="#3B82F6" class="chart-point" data-value="45"/>
+                            <circle cx="200" cy="120" r="5" fill="#3B82F6" class="chart-point" data-value="60"/>
+                            <circle cx="300" cy="100" r="5" fill="#3B82F6" class="chart-point" data-value="70"/>
+                            <circle cx="400" cy="70" r="5" fill="#3B82F6" class="chart-point" data-value="85"/>
+                            <circle cx="500" cy="60" r="5" fill="#3B82F6" class="chart-point" data-value="90"/>
+                            <circle cx="600" cy="50" r="5" fill="#3B82F6" class="chart-point" data-value="95"/>
+                            <circle cx="700" cy="40" r="5" fill="#3B82F6" class="chart-point" data-value="100"/>
+                            
+                            <!-- Labels -->
+                            <text x="50" y="200" fill="#64748B" font-size="11">السبت</text>
+                            <text x="150" y="200" fill="#64748B" font-size="11">الأحد</text>
+                            <text x="250" y="200" fill="#64748B" font-size="11">الاثنين</text>
+                            <text x="350" y="200" fill="#64748B" font-size="11">الثلاثاء</text>
+                            <text x="450" y="200" fill="#64748B" font-size="11">الأربعاء</text>
+                            <text x="550" y="200" fill="#64748B" font-size="11">الخميس</text>
+                            <text x="650" y="200" fill="#64748B" font-size="11">الجمعة</text>
+                            
+                            <!-- Y-axis labels -->
+                            <text x="45" y="35" text-anchor="end" fill="#64748B" font-size="10">100</text>
+                            <text x="45" y="85" text-anchor="end" fill="#64748B" font-size="10">75</text>
+                            <text x="45" y="135" text-anchor="end" fill="#64748B" font-size="10">50</text>
+                            <text x="45" y="185" text-anchor="end" fill="#64748B" font-size="10">25</text>
+                        </svg>
+                    </div>
+                </div>
+                
+                <div class="chart-card">
+                    <div class="chart-header">
+                        <h3 class="chart-title">توزيع المشكلات</h3>
+                    </div>
+                    <div class="donut-chart">
+                        <svg class="donut-svg" viewBox="0 0 180 180">
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#E2E8F0" stroke-width="25"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#EF4444" stroke-width="25" stroke-dasharray="110 308" stroke-dashoffset="0" transform="rotate(-90 90 90)"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#F59E0B" stroke-width="25" stroke-dasharray="88 308" stroke-dashoffset="-110" transform="rotate(-90 90 90)"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#3B82F6" stroke-width="25" stroke-dasharray="66 308" stroke-dashoffset="-198" transform="rotate(-90 90 90)"/>
+                            <circle cx="90" cy="90" r="70" fill="none" stroke="#10B981" stroke-width="25" stroke-dasharray="44 308" stroke-dashoffset="-264" transform="rotate(-90 90 90)"/>
+                            <text x="90" y="85" text-anchor="middle" font-size="24" font-weight="bold" fill="#0F172A" id="donutTotal">23</text>
+                            <text x="90" y="105" text-anchor="middle" font-size="12" fill="#64748B">إجمالي</text>
+                        </svg>
+                        <div class="donut-legend">
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#EF4444"></div>
+                                <span class="legend-label">حرجة</span>
+                                <span class="legend-value" id="legendCritical">5</span>
+                            </div>
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#F59E0B"></div>
+                                <span class="legend-label">عالية</span>
+                                <span class="legend-value" id="legendHigh">7</span>
+                            </div>
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#3B82F6"></div>
+                                <span class="legend-label">متوسطة</span>
+                                <span class="legend-value" id="legendMedium">6</span>
+                            </div>
+                            <div class="legend-item">
+                                <div class="legend-color" style="background:#10B981"></div>
+                                <span class="legend-label">منخفضة</span>
+                                <span class="legend-value" id="legendLow">5</span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            
+            <!-- Activity Section -->
+            <div class="activity-section">
+                <div class="activity-card">
+                    <div class="activity-header">
+                        <h3 class="activity-title">أحدث المشكلات</h3>
+                        <span class="view-all" onclick="filterIssues('all')">عرض الكل →</span>
+                    </div>
+                    <div class="issues-list" id="issuesList">
+                        <!-- Issues will be populated by JavaScript -->
+                    </div>
+                </div>
+                
+                <div class="activity-card">
+                    <div class="activity-header">
+                        <h3 class="activity-title">المستودعات النشطة</h3>
+                        <span class="view-all">عرض الكل →</span>
+                    </div>
+                    <div class="repos-list" id="reposList">
+                        <!-- Repositories will be populated by JavaScript -->
+                    </div>
+                </div>
+            </div>
+        </main>
+    </div>
+    
+    <!-- Settings Panel -->
+    <div class="settings-panel" id="settingsPanel">
+        <div class="settings-content">
+            <div class="settings-header">
+                <h3>⚙️ الإعدادات</h3>
+                <button class="close-btn" onclick="closeSettings()">&times;</button>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">اسم المستخدم</label>
+                <input type="text" class="setting-input" id="settingUsername" placeholder="أدخل اسم المستخدم">
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">البريد الإلكتروني</label>
+                <input type="email" class="setting-input" id="settingEmail" placeholder="أدخل البريد الإلكتروني">
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">لغة الواجهة</label>
+                <select class="setting-select" id="settingLanguage">
+                    <option value="ar">العربية</option>
+                    <option value="en">English</option>
+                </select>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">السمة</label>
+                <select class="setting-select" id="settingTheme">
+                    <option value="light">فاتحة</option>
+                    <option value="dark">داكنة</option>
+                    <option value="auto">تلقائي</option>
+                </select>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">فحص تلقائي عند الحفظ</label>
+                <div class="setting-toggle" onclick="toggleSetting('autoScan')">
+                    <div class="toggle-switch" id="toggleAutoScan"></div>
+                    <span>تشغيل</span>
+                </div>
+                <p class="setting-description">إجراء فحص تلقائي للكود عند حفظ الملفات</p>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">إشعارات المشاكل الحرجة</label>
+                <div class="setting-toggle" onclick="toggleSetting('criticalAlerts')">
+                    <div class="toggle-switch" id="toggleCriticalAlerts"></div>
+                    <span>تشغيل</span>
+                </div>
+                <p class="setting-description">إرسال إشعارات فورية للمشاكل الأمنية الحرجة</p>
+            </div>
+            
+            <div class="setting-item">
+                <label class="setting-label">الإصلاح التلقائي الآمن</label>
+                <div class="setting-toggle" onclick="toggleSetting('autoFix')">
+                    <div class="toggle-switch" id="toggleAutoFix"></div>
+                    <span>تشغيل</span>
+                </div>
+                <p class="setting-description">إصلاح المشاكل الآمنة تلقائياً دون تدخل</p>
+            </div>
+            
+            <button class="save-btn" onclick="saveSettings()">💾 حفظ الإعدادات</button>
+        </div>
+    </div>
+    
+    <!-- Toast Container -->
+    <div class="toast-container" id="toastContainer"></div>
+
+    <script>
+        // Data
+        let currentData = {
+            threats: 1247,
+            successRate: 99.9,
+            openIssues: 23,
+            responseTime: 0.3,
+            issues: [],
+            repos: []
+        };
+        
+        let settings = {
+            username: '',
+            email: '',
+            language: 'ar',
+            theme: 'light',
+            autoScan: true,
+            criticalAlerts: true,
+            autoFix: true
+        };
+        
+        // Sample Data
+        const sampleIssues = [
+            { id: 1, title: 'ثغرة أمنية في وحدة المصادقة', file: 'auth-module.py', time: 'قبل 5 دقائق', severity: 'critical' },
+            { id: 2, title: 'فشل في اختبارات الأداء', file: 'performance_test.py', time: 'قبل 23 دقيقة', severity: 'warning' },
+            { id: 3, title: 'تحذير في تنسيق الكود', file: 'main_controller.dart', time: 'قبل ساعة', severity: 'info' },
+            { id: 4, title: 'تم إصلاح مشكلة التنسيق تلقائياً', file: 'utils_helper.js', time: 'قبل ساعتين', severity: 'success' },
+            { id: 5, title: 'مشكلة في اتصال قاعدة البيانات', file: 'db_connection.java', time: 'قبل ساعتين', severity: 'critical' },
+            { id: 6, title: 'تحذير: استخدام دالة قديمة', file: 'legacy_code.py', time: 'قبل 3 ساعات', severity: 'warning' }
+        ];
+        
+        const sampleRepos = [
+            { id: 1, name: 'auto-guardian-system', stars: 124, pullRequests: 45, bugs: 3, status: 'active' },
+            { id: 2, name: 'payment-gateway-api', stars: 89, pullRequests: 32, bugs: 5, status: 'warning' },
+            { id: 3, name: 'user-management-service', stars: 56, pullRequests: 18, bugs: 1, status: 'active' },
+            { id: 4, name: 'data-analytics-platform', stars: 234, pullRequests: 67, bugs: 8, status: 'error' }
+        ];
+        
+        // Initialize
+        document.addEventListener('DOMContentLoaded', function() {
+            loadSettings();
+            loadData();
+            renderIssues();
+            renderRepos();
+            setupEventListeners();
+            setupMobileMenu();
+            showToast('🎉 مرحباً بك في Auto-Guardian!', 'success');
+        });
+        
+        // Setup Mobile Menu
+        function setupMobileMenu() {
+            const mobileMenuBtn = document.getElementById('mobileMenuBtn');
+            if (mobileMenuBtn) {
+                // Show/hide mobile menu button based on screen size
+                const checkScreenSize = () => {
+                    if (window.innerWidth <= 992) {
+                        mobileMenuBtn.style.display = 'flex';
+                    } else {
+                        mobileMenuBtn.style.display = 'none';
+                        closeMobileMenu();
+                    }
+                };
+                
+                checkScreenSize();
+                window.addEventListener('resize', checkScreenSize);
+            }
+        }
+        
+        // Toggle Mobile Menu
+        function toggleMobileMenu() {
+            const sidebar = document.getElementById('sidebar');
+            const overlay = document.getElementById('sidebarOverlay');
+            
+            if (sidebar && overlay) {
+                sidebar.classList.toggle('active');
+                overlay.classList.toggle('active');
+            }
+        }
+        
+        // Close Mobile Menu
+        function closeMobileMenu() {
+            const sidebar = document.getElementById('sidebar');
+            const overlay = document.getElementById('sidebarOverlay');
+            
+            if (sidebar) {
+                sidebar.classList.remove('active');
+            }
+            if (overlay) {
+                overlay.classList.remove('active');
+            }
+        }
+        
+        // Load Settings from LocalStorage
+        function loadSettings() {
+            const saved = localStorage.getItem('autoGuardianSettings');
+            if (saved) {
+                settings = JSON.parse(saved);
+            }
+            
+            // Update UI
+            document.getElementById('settingUsername').value = settings.username || '';
+            document.getElementById('settingEmail').value = settings.email || '';
+            document.getElementById('settingLanguage').value = settings.language || 'ar';
+            document.getElementById('settingTheme').value = settings.theme || 'light';
+            updateToggle('toggleAutoScan', settings.autoScan);
+            updateToggle('toggleCriticalAlerts', settings.criticalAlerts);
+            updateToggle('toggleAutoFix', settings.autoFix);
+        }
+        
+        // Save Settings to LocalStorage
+        function saveSettings() {
+            settings.username = document.getElementById('settingUsername').value;
+            settings.email = document.getElementById('settingEmail').value;
+            settings.language = document.getElementById('settingLanguage').value;
+            settings.theme = document.getElementById('settingTheme').value;
+            
+            localStorage.setItem('autoGuardianSettings', JSON.stringify(settings));
+            closeSettings();
+            showToast('✅ تم حفظ الإعدادات بنجاح!', 'success');
+        }
+        
+        // Update toggle UI
+        function updateToggle(id, value) {
+            const toggle = document.getElementById(id);
+            if (value) {
+                toggle.classList.add('active');
+            } else {
+                toggle.classList.remove('active');
+            }
+        }
+        
+        // Toggle setting
+        function toggleSetting(setting) {
+            settings[setting] = !settings[setting];
+            updateToggle('toggle' + setting.charAt(0).toUpperCase() + setting.slice(1), settings[setting]);
+            showToast(`⚙️ تم ${settings[setting] ? 'تفعيل' : 'تعطيل'} ${setting}`, 'info');
+        }
+        
+        // Load Data
+        function loadData() {
+            currentData.issues = sampleIssues;
+            currentData.repos = sampleRepos;
+            
+            // Randomize some values
+            currentData.threats = Math.floor(Math.random() * 2000) + 500;
+            currentData.openIssues = Math.floor(Math.random() * 30) + 10;
+            currentData.responseTime = (Math.random() * 0.5 + 0.1).toFixed(1);
+            
+            updateStatsUI();
+        }
+        
+        // Update Stats UI
+        function updateStatsUI() {
+            document.getElementById('statThreats').textContent = currentData.threats.toLocaleString();
+            document.getElementById('statSuccess').textContent = currentData.successRate + '%';
+            document.getElementById('statOpen').textContent = currentData.openIssues;
+            document.getElementById('statResponse').textContent = currentData.responseTime + 's';
+            
+            // Update legend
+            const critical = currentData.issues.filter(i => i.severity === 'critical').length;
+            const warning = currentData.issues.filter(i => i.severity === 'warning').length;
+            const info = currentData.issues.filter(i => i.severity === 'info').length;
+            const success = currentData.issues.filter(i => i.severity === 'success').length;
+            
+            document.getElementById('legendCritical').textContent = critical;
+            document.getElementById('legendHigh').textContent = warning;
+            document.getElementById('legendMedium').textContent = info;
+            document.getElementById('legendLow').textContent = success;
+            document.getElementById('donutTotal').textContent = currentData.issues.length;
+        }
+        
+        // Render Issues
+        function renderIssues(issues = currentData.issues) {
+            const container = document.getElementById('issuesList');
+            container.innerHTML = '';
+            
+            issues.forEach(issue => {
+                const severityClass = issue.severity === 'critical' ? 'badge-critical' : 
+                                     issue.severity === 'warning' ? 'badge-warning' :
+                                     issue.severity === 'info' ? 'badge-info' : 'badge-success';
+                
+                const severityLabel = issue.severity === 'critical' ? 'حرجة' : 
+                                     issue.severity === 'warning' ? 'عالية' :
+                                     issue.severity === 'info' ? 'متوسطة' : 'تم الإصلاح';
+                
+                const iconSvg = issue.severity === 'critical' ? 
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/></svg>' :
+                    issue.severity === 'warning' ?
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>' :
+                    issue.severity === 'success' ?
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>' :
+                    '<svg width="16" height="16" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>';
+                
+                const html = `
+                    <div class="issue-item" onclick="showIssueDetails(${issue.id})">
+                        <div class="issue-icon" style="background: rgba(${issue.severity === 'critical' ? '239, 68, 68' : issue.severity === 'warning' ? '245, 158, 11' : issue.severity === 'success' ? '16, 185, 129' : '59, 130, 246'}, 0.1); color: ${issue.severity === 'critical' ? '#EF4444' : issue.severity === 'warning' ? '#F59E0B' : issue.severity === 'success' ? '#10B981' : '#3B82F6'};">
+                            ${iconSvg}
+                        </div>
+                        <div class="issue-content">
+                            <div class="issue-title">${issue.title}</div>
+                            <div class="issue-meta">${issue.file} • ${issue.time}</div>
+                        </div>
+                        <span class="issue-badge ${severityClass}">${severityLabel}</span>
+                    </div>
+                `;
+                container.innerHTML += html;
+            });
+        }
+        
+        // Render Repositories
+        function renderRepos(repos = currentData.repos) {
+            const container = document.getElementById('reposList');
+            container.innerHTML = '';
+            
+            repos.forEach(repo => {
+                const statusClass = repo.status === 'active' ? 'active' : repo.status === 'warning' ? 'warning' : 'error';
+                const statusLabel = repo.status === 'active' ? 'نشط' : repo.status === 'warning' ? 'يحتاج مراجعة' : 'مشاكل';
+                const statusColor = repo.status === 'active' ? '#10B981' : repo.status === 'warning' ? '#F59E0B' : '#EF4444';
+                
+                const html = `
+                    <div class="repo-item">
+                        <div class="repo-icon">
+                            <svg width="18" height="18" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z"/>
+                            </svg>
+                        </div>
+                        <div class="repo-content">
+                            <div class="repo-name">${repo.name}</div>
+                            <div class="repo-stats">
+                                <span>⭐ ${repo.stars}</span>
+                                <span>🔀 ${repo.pullRequests}</span>
+                                <span>🐛 ${repo.bugs}</span>
+                            </div>
+                        </div>
+                        <div class="repo-status">
+                            <span class="status-dot ${statusClass}"></span>
+                            <span style="color: ${statusColor};">${statusLabel}</span>
+                        </div>
+                    </div>
+                `;
+                container.innerHTML += html;
+            });
+        }
+        
+        // Filter Issues
+        function filterIssues(type) {
+            let filtered = currentData.issues;
+            
+            if (type === 'critical') {
+                filtered = currentData.issues.filter(i => i.severity === 'critical');
+                showToast(`🔍 عرض ${filtered.length} مشكلة حرجة`, 'info');
+            } else if (type === 'open') {
+                filtered = currentData.issues.filter(i => i.severity !== 'success');
+                showToast(`🔍 عرض ${filtered.length} مشكلة مفتوحة`, 'info');
+            } else if (type === 'all') {
+                showToast(`🔍 عرض ${filtered.length} مشكلة`, 'info');
+            }
+            
+            renderIssues(filtered);
+        }
+        
+        // Show Issue Details
+        function showIssueDetails(id) {
+            const issue = currentData.issues.find(i => i.id === id);
+            if (issue) {
+                showToast(`📋 ${issue.title} - ${issue.file}`, 'info');
+            }
+        }
+        
+        // Change Chart Period
+        function changePeriod(period) {
+            // Update active tab
+            document.querySelectorAll('.chart-tab').forEach(tab => {
+                tab.classList.remove('active');
+                if (tab.dataset.period === period) {
+                    tab.classList.add('active');
+                }
+            });
+            
+            // Update chart data based on period
+            showToast(`📊 عرض بيانات ${period === 'day' ? '24 ساعة' : period === 'week' ? 'أسبوع' : 'شهر'}`, 'info');
+            
+            // Simulate data update
+            const randomFactor = period === 'day' ? 1 : period === 'week' ? 7 : 30;
+            currentData.threats = Math.floor(Math.random() * 2000 * randomFactor) + 500;
+            updateStatsUI();
+        }
+        
+        // Search Functionality
+        function setupEventListeners() {
+            // Navigation
+            document.querySelectorAll('.nav-item').forEach(item => {
+                item.addEventListener('click', function() {
+                    const view = this.dataset.view;
+                    
+                    document.querySelectorAll('.nav-item').forEach(i => i.classList.remove('active'));
+                    this.classList.add('active');
+                    
+                    // Close mobile menu when navigating
+                    closeMobileMenu();
+                    
+                    if (view === 'settings') {
+                        openSettings();
+                    } else if (view === 'help') {
+                        showToast('📖 المساعدة: استخدم القائمة للتنقل بين الأقسام', 'info');
+                    } else {
+                        showToast(`📂 الانتقال إلى ${this.querySelector('span').textContent}`, 'info');
+                    }
+                });
+            });
+            
+            // Search
+            const searchInput = document.getElementById('searchInput');
+            const searchResults = document.getElementById('searchResults');
+            
+            searchInput.addEventListener('input', function() {
+                const query = this.value.toLowerCase();
+                
+                if (query.length < 2) {
+                    searchResults.classList.remove('active');
+                    return;
+                }
+                
+                // Search in issues and repos
+                const results = [];
+                
+                currentData.issues.forEach(issue => {
+                    if (issue.title.toLowerCase().includes(query) || issue.file.toLowerCase().includes(query)) {
+                        results.push({ type: 'issue', title: issue.title, subtitle: issue.file });
+                    }
+                });
+                
+                currentData.repos.forEach(repo => {
+                    if (repo.name.toLowerCase().includes(query)) {
+                        results.push({ type: 'repo', title: repo.name, subtitle: `⭐ ${repo.stars} | 🔀 ${repo.pullRequests}` });
+                    }
+                });
+                
+                if (results.length > 0) {
+                    searchResults.innerHTML = results.map(r => `
+                        <div class="search-result-item">
+                            <div style="font-weight: 500;">${r.title}</div>
+                            <div style="font-size: 12px; color: var(--text-muted);">${r.subtitle}</div>
+                        </div>
+                    `).join('');
+                    searchResults.classList.add('active');
+                } else {
+                    searchResults.innerHTML = '<div class="search-result-item">لا توجد نتائج</div>';
+                    searchResults.classList.add('active');
+                }
+            });
+            
+            searchInput.addEventListener('blur', function() {
+                setTimeout(() => {
+                    searchResults.classList.remove('active');
+                }, 200);
+            });
+            
+            searchInput.addEventListener('focus', function() {
+                if (this.value.length >= 2) {
+                    searchResults.classList.add('active');
+                }
+            });
+            
+            // Notification button
+            document.getElementById('notificationBtn').addEventListener('click', function() {
+                showToast('🔔 الإشعارات: 5 إشعارات جديدة', 'info');
+                document.getElementById('notificationBadge').textContent = '0';
+            });
+        }
+        
+        // Settings Panel
+        function openSettings() {
+            document.getElementById('settingsPanel').classList.add('active');
+        }
+        
+        function closeSettings() {
+            document.getElementById('settingsPanel').classList.remove('active');
+        }
+        
+        // Toast Notifications
+        function showToast(message, type = 'info') {
+            const container = document.getElementById('toastContainer');
+            const toast = document.createElement('div');
+            toast.className = `toast ${type}`;
+            toast.innerHTML = message;
+            container.appendChild(toast);
+            
+            setTimeout(() => {
+                toast.remove();
+            }, 3000);
+        }
+        
+        // Close settings on outside click
+        document.getElementById('settingsPanel').addEventListener('click', function(e) {
+            if (e.target === this) {
+                closeSettings();
+            }
+        });
+    </script>
+</body>
+</html>

public/data/latest.json

@@ -0,0 +1,435 @@
+{
+  "metadata": {
+    "timestamp": "2026-01-13T02:00:00.000Z",
+    "version": "1.0.0",
+    "tool": "auto-guardian",
+    "git": {
+      "commit_sha": "abc1234",
+      "branch": "main",
+      "workflow": "auto-guardian-scan"
+    }
+  },
+  "summary": {
+    "total_issues": 23,
+    "critical_issues": 2,
+    "high_issues": 5,
+    "medium_issues": 8,
+    "low_issues": 6,
+    "info_issues": 2,
+    "files_scanned": 15,
+    "security_score": 78,
+    "grade": "C"
+  },
+  "languages": {
+    "detected": ["python", "javascript", "typescript", "go"],
+    "lines_of_code": {
+      "python": 2450,
+      "javascript": 1890,
+      "typescript": 2100,
+      "go": 1200
+    },
+    "tools_used": {
+      "bandit": { "issues": 8, "status": "completed" },
+      "pylint": { "issues": 5, "status": "completed" },
+      "eslint": { "issues": 6, "status": "completed" },
+      "gosec": { "issues": 4, "status": "completed" }
+    }
+  },
+  "findings": [
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "CRITICAL",
+      "severity_level": 1,
+      "file": "src/authentication.py",
+      "line": 45,
+      "column": 20,
+      "rule_id": "B105",
+      "rule_name": "hardcoded_password",
+      "message": "Possible hardcoded password: 'admin123'",
+      "description": "Hardcoded password detected. This is a security vulnerability as passwords should be stored in environment variables or secure configuration files.",
+      "confidence": "HIGH",
+      "remediation": "Use environment variables or a secrets manager to store credentials. Example: os.environ.get('DB_PASSWORD')",
+      "code_snippet": "password = 'admin123'  # This is insecure!",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "CRITICAL",
+      "severity_level": 1,
+      "file": "internal/api/handler.go",
+      "line": 89,
+      "column": 15,
+      "rule_id": "G104",
+      "rule_name": "Error check skipped",
+      "message": "Errors unhandled.",
+      "description": "Errors are being ignored without proper handling, which could lead to silent failures and security issues.",
+      "confidence": "HIGH",
+      "remediation": "Always handle errors properly using if err != nil { return err } pattern",
+      "code_snippet": "_ = json.Unmarshal(data, &obj)  // Error ignored!",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/utils/auth.js",
+      "line": 12,
+      "column": 18,
+      "rule_id": "security/detect-object-injection",
+      "rule_name": "Object Injection",
+      "message": "Avoid objects with unknown properties, object injection is possible.",
+      "description": "Object injection can lead to prototype pollution vulnerabilities if user input is used as object keys.",
+      "confidence": "HIGH",
+      "remediation": "Validate and sanitize user input before using it to access object properties",
+      "code_snippet": "const value = userData[userKey];  // Potential injection!",
+      "language": "javascript"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/database/connection.py",
+      "line": 67,
+      "column": 25,
+      "rule_id": "B501",
+      "rule_name": "SQL statement with parameters",
+      "message": "Possible SQL injection: VALUES ('%s')",
+      "description": "SQL injection vulnerability detected. String formatting used to build SQL query could allow attackers to manipulate queries.",
+      "confidence": "HIGH",
+      "remediation": "Use parameterized queries or ORM methods instead of string formatting. Example: cursor.execute('SELECT * FROM users WHERE id = ?', (user_id,))",
+      "code_snippet": "query = f\"SELECT * FROM users WHERE id = '{user_id}'\"",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "cmd/server/main.go",
+      "line": 234,
+      "column": 10,
+      "rule_id": "G107",
+      "rule_name": "HTTP absolute path traversal",
+      "message": "HTTP absolute path traversal",
+      "description": "Path traversal vulnerability detected. User input used directly in file paths without validation.",
+      "confidence": "HIGH",
+      "remediation": "Validate and sanitize file paths, use filepath.Clean and check for paths outside the allowed directory",
+      "code_snippet": "filePath := r.URL.Path + filename",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/config/loader.ts",
+      "line": 28,
+      "column": 22,
+      "rule_id": "no-sync",
+      "rule_name": "Synchronous Operations",
+      "message": "Unexpected sync operation. Use asynchronous operations instead.",
+      "description": "Synchronous file operations can block the event loop and cause performance issues in Node.js applications.",
+      "confidence": "MEDIUM",
+      "remediation": "Use fs.promises.readFile() or fs.readFileSync() is acceptable but document why",
+      "code_snippet": "const config = fs.readFileSync(configPath, 'utf8');",
+      "language": "typescript"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "HIGH",
+      "severity_level": 2,
+      "file": "src/api/routes.py",
+      "line": 156,
+      "column": 8,
+      "rule_id": "C0115",
+      "rule_name": "Missing function docstring",
+      "message": "Missing function or method docstring",
+      "description": "Public functions should have docstrings documenting their purpose, parameters, and return values.",
+      "confidence": "HIGH",
+      "remediation": "Add a docstring following Google or NumPy style format",
+      "code_snippet": "def process_data(input_data):\n    # Missing docstring\n    return transform(input_data)",
+      "language": "python"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/utils/helpers.py",
+      "line": 23,
+      "column": 15,
+      "rule_id": "B403",
+      "rule_name": "Consider possible security implications of pickle module",
+      "message": "Consider possible security implications of pickle module.",
+      "description": "The pickle module is not secure. Untrusted data can be crafted to execute arbitrary code.",
+      "confidence": "HIGH",
+      "remediation": "Use JSON or other safe serialization formats instead of pickle",
+      "code_snippet": "import pickle  # Security risk!",
+      "language": "python"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/services/api.js",
+      "line": 45,
+      "column": 13,
+      "rule_id": "no-console",
+      "rule_name": "Console Log",
+      "message": "Unexpected console statement.",
+      "description": "Console statements should be removed in production code as they may expose sensitive information.",
+      "confidence": "HIGH",
+      "remediation": "Remove console.log statements or use a proper logging library with configurable log levels",
+      "code_snippet": "console.log('User data:', user);  // Remove in production",
+      "language": "javascript"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/utils/validators.py",
+      "line": 78,
+      "column": 12,
+      "rule_id": "W0612",
+      "rule_name": "Unused variable",
+      "message": "Unused variable 'unused_param'",
+      "description": "Unused variables should be removed to keep code clean and maintainable.",
+      "confidence": "HIGH",
+      "remediation": "Remove unused variables or prefix with underscore to indicate intentional non-use",
+      "code_snippet": "def process(a, b, unused_param):  # 'unused_param' is never used\n    return a * 2",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "internal/utils/crypto.go",
+      "line": 112,
+      "column": 8,
+      "rule_id": "G401",
+      "rule_name": "Use of weak cryptographic primitive",
+      "message": "Use of weak cryptographic primitive (MD5 or SHA1)",
+      "description": "MD5 and SHA1 are considered cryptographically broken. Use SHA-256 or better.",
+      "confidence": "HIGH",
+      "remediation": "Use crypto/sha256 or higher instead of MD5/SHA1",
+      "code_snippet": "hash := md5.Sum([]byte(data))  // Use SHA-256!",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/components/UserForm.jsx",
+      "line": 89,
+      "column": 15,
+      "rule_id": "react/no-danger",
+      "rule_name": "Dangerous Props",
+      "message": "Dangerous use of dangerouslySetInnerHTML",
+      "description": "Using dangerouslySetInnerHTML can expose XSS vulnerabilities if the content is not properly sanitized.",
+      "confidence": "HIGH",
+      "remediation": "Avoid using dangerouslySetInnerHTML or ensure content is sanitized with a library like DOMPurify",
+      "code_snippet": "<div dangerouslySetInnerHTML={{ __html: userContent }} />",
+      "language": "javascript"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/api/middleware.py",
+      "line": 34,
+      "column": 4,
+      "rule_id": "R0913",
+      "rule_name": "Too many arguments",
+      "message": "Too many arguments (6/5)",
+      "description": "Functions with more than 5 arguments are difficult to maintain and use. Consider refactoring.",
+      "confidence": "MEDIUM",
+      "remediation": "Group related parameters into a configuration object or class",
+      "code_snippet": "def create_user(name, email, password, role, department, manager): pass  # Too many!",
+      "language": "python"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "internal/api/middleware.go",
+      "line": 56,
+      "column": 12,
+      "rule_id": "G304",
+      "rule_name": "File path traversal",
+      "message": "File path traversal detected",
+      "description": "User input used directly in file path without proper validation could allow path traversal attacks.",
+      "confidence": "HIGH",
+      "remediation": "Validate file paths and ensure they are within the allowed directory using filepath.Clean and path verification",
+      "code_snippet": "file, _ := os.Open(userProvidedPath)",
+      "language": "go"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "MEDIUM",
+      "severity_level": 3,
+      "file": "src/utils/api.js",
+      "line": 156,
+      "column": 9,
+      "rule_id": "no-underscore-dangle",
+      "rule_name": "Underscore Dangle",
+      "message": "Unexpected dangling '_' in 'fetch_url_'",
+      "description": "Variable names with trailing underscores are unconventional and may confuse developers.",
+      "confidence": "MEDIUM",
+      "remediation": "Use conventional naming without trailing underscores",
+      "code_snippet": "const fetch_url_ = 'https://api.example.com';",
+      "language": "javascript"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "tests/test_sample.py",
+      "line": 12,
+      "column": 10,
+      "rule_id": "B101",
+      "rule_name": "Assert used",
+      "message": "Use of assert detected",
+      "description": "Assert statements should not be used in production code as they can be disabled with Python's -O flag.",
+      "confidence": "HIGH",
+      "remediation": "Use unittest assertions or raise exceptions instead of assert",
+      "code_snippet": "assert result == expected, 'Test failed'",
+      "language": "python"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/config/settings.py",
+      "line": 8,
+      "column": 0,
+      "rule_id": "C0114",
+      "rule_name": "Missing module docstring",
+      "message": "Missing module docstring",
+      "description": "Module-level docstrings should be present at the top of each file.",
+      "confidence": "HIGH",
+      "remediation": "Add a module docstring describing the purpose of this module",
+      "code_snippet": "# Module content starts here without docstring",
+      "language": "python"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/index.js",
+      "line": 3,
+      "column": 8,
+      "rule_id": "no-unused-vars",
+      "rule_name": "Unused Variables",
+      "message": "'React' is defined but never used.",
+      "description": "Unused variables increase code complexity and should be removed.",
+      "confidence": "HIGH",
+      "remediation": "Remove the unused import or use the variable",
+      "code_snippet": "import React from 'react';  // React is not used directly",
+      "language": "javascript"
+    },
+    {
+      "tool": "gosec",
+      "tool_name": "Gosec",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "internal/config/loader.go",
+      "line": 23,
+      "column": 6,
+      "rule_id": "G108",
+      "rule_name": "Performance regression detected",
+      "message": "Benchmark result indicates potential performance regression",
+      "description": "The function shows potential performance issues based on benchmark comparison.",
+      "confidence": "MEDIUM",
+      "remediation": "Review the function for potential optimizations like caching, reducing allocations, or algorithmic improvements",
+      "code_snippet": "// Consider adding caching for repeated calls",
+      "language": "go"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/utils/constants.py",
+      "line": 5,
+      "column": 0,
+      "rule_id": "C0103",
+      "rule_name": "Invalid constant name",
+      "message": "Constant name \"MAX_SIZE\" doesn't conform to UPPER_CASE naming style",
+      "description": "Constants should be named in UPPER_CASE with underscores.",
+      "confidence": "HIGH",
+      "remediation": "Rename the constant to use UPPER_CASE format",
+      "code_snippet": "max_size = 100  # Should be MAX_SIZE = 100",
+      "language": "python"
+    },
+    {
+      "tool": "eslint",
+      "tool_name": "ESLint",
+      "severity": "LOW",
+      "severity_level": 4,
+      "file": "src/styles/main.css",
+      "line": 1,
+      "column": 1,
+      "rule_id": "no-irregular-whitespace",
+      "rule_name": "Irregular Whitespace",
+      "message": "Irregular whitespace not allowed.",
+      "description": "Irregular whitespace characters can cause rendering issues and are typically typos.",
+      "confidence": "HIGH",
+      "remediation": "Remove any irregular whitespace characters from the file",
+      "code_snippet": "  \t  /* Space at beginning of file */",
+      "language": "javascript"
+    },
+    {
+      "tool": "bandit",
+      "tool_name": "Bandit",
+      "severity": "INFO",
+      "severity_level": 5,
+      "file": "setup.py",
+      "line": 15,
+      "column": 7,
+      "rule_id": "B602",
+      "rule_name": "Subprocess call with shell=True",
+      "message": "subprocess call with shell=True identified",
+      "description": "Using shell=True in subprocess allows shell injection attacks. Consider using shell=False.",
+      "confidence": "MEDIUM",
+      "remediation": "Use shell=False and pass arguments as a list to prevent shell injection",
+      "code_snippet": "subprocess.run(f'ls {directory}', shell=True)  # Risky!",
+      "language": "python"
+    },
+    {
+      "tool": "pylint",
+      "tool_name": "Pylint",
+      "severity": "INFO",
+      "severity_level": 5,
+      "file": "src/main.py",
+      "line": 1,
+      "column": 1,
+      "rule_id": "C0111",
+      "rule_name": "Missing function docstring",
+      "message": "Missing function or method docstring (missing-docstring)",
+      "description": "Function docstrings help developers understand the purpose and usage of functions.",
+      "confidence": "MEDIUM",
+      "remediation": "Add a docstring explaining what the function does, its parameters, and return value",
+      "code_snippet": "def main():  # Missing docstring\n    run_app()",
+      "language": "python"
+    }
+  ],
+  "trends": {
+    "previous_scan": null,
+    "improvement": null
+  }
+}

requirements.txt

@@ -0,0 +1,106 @@
+# متطلبات نظام الحارس التلقائي
+# Auto Guardian System Requirements
+# ====================================
+
+# الإصدار: 1.3.0
+# تاريخ التحديث: 2024-10-13
+
+# ===============================
+# المتطلبات الأساسية للنظام
+# ===============================
+
+# طلبات HTTP للتواصل مع APIs
+requests>=2.31.0
+
+# معالجة ملفات YAML للتكوين
+pyyaml>=6.0
+
+# متغيرات البيئة
+python-dotenv>=1.0.0
+
+# التواريخ والأوقات
+pytz>=2023.3
+
+# التحقق من صحة البيانات
+marshmallow>=3.20.0
+
+# ===============================
+# التوثيق
+# ===============================
+
+# توليد التوثيق
+sphinx>=7.0.0
+
+# سمة التوثيق Read the Docs
+sphinx-rtd-theme>=1.3.0
+
+# ===============================
+# أدوات التطوير والاختبار
+# ===============================
+
+# إطار الاختبارات
+pytest>=7.4.0
+pytest-cov>=4.1.0
+pytest-mock>=3.11.0
+pytest-asyncio>=0.21.0
+
+# تغطية الكود
+coverage>=7.3.0
+
+# ===============================
+# جودة الكود
+# ===============================
+
+# تنسيق كود Python
+black>=23.0.0
+
+# فحص الكود
+flake8>=6.0.0
+flake8-builtins>=2.1.0
+flake8-docstrings>=1.7.0
+flake8-comprehensions>=3.12.0
+
+# نوع البيانات الثابت
+mypy>=1.4.0
+types-requests>=2.31.0
+types-pyyaml>=6.0.0
+
+# ترتيب الاستيرادات
+isort>=5.12.0
+
+# ===============================
+# Docker والتطوير
+# ===============================
+
+# بناء الحاويات
+docker>=6.1.0
+docker-compose>=2.21.0
+
+# ===============================
+# المراقبة والتقارير
+# ===============================
+
+# Prometheus client
+prometheus-client>=0.17.0
+
+# إرسال التنبيهات
+slack-sdk>=3.21.0
+discord-webhook>=1.3.0
+
+# ===============================
+# التطوير الإضافي (اختياري)
+# ===============================
+
+# أدوات مساعدة
+click>=8.1.0
+rich>=13.5.0
+colorama>=0.4.6
+
+# معالجة الأخطاء
+sentry-sdk>=1.30.0
+
+# تسجيل محسن
+loguru>=0.7.0
+
+# تثبيت التطوير:
+# pip install -r requirements-dev.txt

robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://abdulelahothmangwaith.github.io/Auto-Guardian-Core/sitemap.xml

scripts/aggregate_results.py

@@ -0,0 +1,414 @@
+# استخراج نتائج الفحص وتجميعها في ملف JSON واحد
+
+import json
+import os
+from datetime import datetime
+from pathlib import Path
+
+def load_json_file(filepath, default=None):
+    """تحميل ملف JSON مع معالجة الأخطاء"""
+    if os.path.exists(filepath):
+        try:
+            with open(filepath, 'r', encoding='utf-8') as f:
+                return json.load(f)
+        except (json.JSONDecodeError, IOError):
+            return default if default is not None else []
+    return default if default is not None else []
+
+def normalize_bandit_result(issue):
+    """تطبيع نتيجة Bandit"""
+    return {
+        "tool": "bandit",
+        "tool_name": "Bandit",
+        "severity": issue.get("issue_severity", "MEDIUM").upper(),
+        "severity_level": get_severity_level(issue.get("issue_severity", "MEDIUM")),
+        "file": issue.get("filename", ""),
+        "line": issue.get("line_number", 0),
+        "column": issue.get("line_range", [0, 0])[0] if issue.get("line_range") else 0,
+        "rule_id": issue.get("test_id", ""),
+        "rule_name": issue.get("test_name", ""),
+        "message": issue.get("issue_text", ""),
+        "description": issue.get("issue_text", ""),
+        "confidence": issue.get("issue_confidence", "MEDIUM").upper(),
+        "remediation": issue.get("more_info", ""),
+        "code_snippet": "",
+        "language": "python"
+    }
+
+def normalize_pylint_result(issue):
+    """تطبيع نتيجة Pylint"""
+    return {
+        "tool": "pylint",
+        "tool_name": "Pylint",
+        "severity": map_pylint_severity(issue.get("type", "info")),
+        "severity_level": get_severity_level(map_pylint_severity(issue.get("type", "info"))),
+        "file": issue.get("path", ""),
+        "line": issue.get("line", 0),
+        "column": issue.get("column", 0),
+        "rule_id": issue.get("symbol", ""),
+        "rule_name": issue.get("message-id", ""),
+        "message": issue.get("message", ""),
+        "description": issue.get("message", ""),
+        "confidence": "HIGH",
+        "remediation": "",
+        "code_snippet": issue.get("body", ""),
+        "language": "python"
+    }
+
+def normalize_eslint_result(issue):
+    """تطبيع نتيجة ESLint"""
+    return {
+        "tool": "eslint",
+        "tool_name": "ESLint",
+        "severity": map_eslint_severity(issue.get("severity", 1)),
+        "severity_level": get_severity_level(map_eslint_severity(issue.get("severity", 1))),
+        "file": issue.get("filePath", ""),
+        "line": issue.get("line", 0),
+        "column": issue.get("column", 0),
+        "rule_id": issue.get("ruleId", ""),
+        "rule_name": issue.get("ruleId", ""),
+        "message": issue.get("message", ""),
+        "description": issue.get("message", ""),
+        "confidence": "HIGH",
+        "remediation": "",
+        "code_snippet": issue.get("source", ""),
+        "language": "javascript"
+    }
+
+def normalize_gosec_result(issue):
+    """تطبيع نتيجة Gosec"""
+    return {
+        "tool": "gosec",
+        "tool_name": "Gosec",
+        "severity": map_gosec_severity(issue.get("severity", "MEDIUM")),
+        "severity_level": get_severity_level(map_gosec_severity(issue.get("severity", "MEDIUM"))),
+        "file": issue.get("file", ""),
+        "line": issue.get("line", 0),
+        "column": 0,
+        "rule_id": issue.get("rule_id", ""),
+        "rule_name": issue.get("func_name", ""),
+        "message": issue.get("details", ""),
+        "description": issue.get("details", ""),
+        "confidence": "HIGH",
+        "remediation": "",
+        "code_snippet": "",
+        "language": "go"
+    }
+
+def normalize_cargo_audit_result(vuln):
+    """تطبيع نتيجة Cargo Audit"""
+    severity_map = {
+        "high": "CRITICAL",
+        "medium": "HIGH", 
+        "low": "MEDIUM",
+        "unknown": "LOW"
+    }
+    return {
+        "tool": "cargo-audit",
+        "tool_name": "Cargo Audit",
+        "severity": severity_map.get(vuln.get("severity", "unknown"), "MEDIUM"),
+        "severity_level": get_severity_level(severity_map.get(vuln.get("severity", "unknown"), "MEDIUM")),
+        "file": vuln.get("package", {}).get("name", "unknown"),
+        "line": 0,
+        "column": 0,
+        "rule_id": vuln.get("id", ""),
+        "rule_name": vuln.get("advisory_id", ""),
+        "message": vuln.get("title", ""),
+        "description": vuln.get("description", ""),
+        "confidence": "HIGH",
+        "remediation": vuln.get("url", ""),
+        "code_snippet": "",
+        "language": "rust"
+    }
+
+def map_pylint_severity(pylint_type):
+    """تحويل نوع Pylint إلى شدة موحدة"""
+    severity_map = {
+        "error": "CRITICAL",
+        "warning": "HIGH",
+        "refactor": "MEDIUM",
+        "convention": "LOW",
+        "info": "INFO"
+    }
+    return severity_map.get(pylint_type.lower(), "MEDIUM")
+
+def map_eslint_severity(eslint_severity):
+    """تحويل شدة ESLint إلى ش��ة موحدة"""
+    severity_map = {
+        2: "CRITICAL",  # Error
+        1: "HIGH",      # Warning
+        0: "INFO"       # Info
+    }
+    return severity_map.get(eslint_severity, "MEDIUM")
+
+def map_gosec_severity(gosec_severity):
+    """تحويل شدة Gosec إلى شدة موحدة"""
+    severity_map = {
+        "HIGH": "CRITICAL",
+        "MEDIUM": "HIGH",
+        "LOW": "MEDIUM",
+        "UNKNOWN": "LOW"
+    }
+    return severity_map.get(gosec_severity.upper(), "MEDIUM")
+
+def get_severity_level(severity):
+    """الحصول على مستوى الشدة للفرز"""
+    level_map = {
+        "CRITICAL": 1,
+        "HIGH": 2,
+        "MEDIUM": 3,
+        "LOW": 4,
+        "INFO": 5
+    }
+    return level_map.get(severity.upper(), 3)
+
+def get_git_info():
+    """استخراج معلومات Git"""
+    commit_sha = os.environ.get("GITHUB_SHA", "")[:7]
+    branch = os.environ.get("GITHUB_REF", "").replace("refs/heads/", "")
+    
+    return {
+        "commit_sha": commit_sha,
+        "branch": branch,
+        "workflow": "auto-guardian-scan"
+    }
+
+def detect_languages():
+    """اكتشاف اللغات الموجودة في المشروع"""
+    languages = []
+    extensions = {
+        ".py": "python",
+        ".js": "javascript",
+        ".ts": "typescript",
+        ".jsx": "javascript",
+        ".tsx": "typescript",
+        ".go": "go",
+        ".rs": "rust",
+        ".java": "java",
+        ".cpp": "cpp",
+        ".c": "c"
+    }
+    
+    for ext, lang in extensions.items():
+        if any(Path(".").rglob(f"*{ext}")):
+            if lang not in languages:
+                languages.append(lang)
+    
+    return languages
+
+def count_lines_by_language():
+    """عدم الأسطر حسب اللغة"""
+    counts = {}
+    extensions = {
+        ".py": "python",
+        ".js": "javascript",
+        ".ts": "typescript",
+        ".go": "go",
+        ".rs": "rust"
+    }
+    
+    for ext, lang in extensions.items():
+        files = list(Path(".").rglob(f"*{ext}"))
+        total_lines = 0
+        for f in files:
+            try:
+                with open(f, 'r', encoding='utf-8', errors='ignore') as file:
+                    total_lines += sum(1 for _ in file)
+            except:
+                pass
+        if total_lines > 0:
+            counts[lang] = total_lines
+    
+    return counts
+
+def main():
+    """الدالة الرئيسية"""
+    print("=" * 50)
+    print("Auto-Guardian: تجميع نتائج الفحص")
+    print("=" * 50)
+    
+    # استخراج معلومات Git
+    git_info = get_git_info()
+    print(f"Commit: {git_info['commit_sha']}")
+    print(f"Branch: {git_info['branch']}")
+    
+    # اكتشاف اللغات
+    languages = detect_languages()
+    print(f"Languages detected: {', '.join(languages)}")
+    
+    # تجميع جميع النتائج
+    all_findings = []
+    summary_by_tool = {}
+    findings_count = 0
+    
+    # Bandit Results
+    print("\n[1/5] Processing Bandit results...")
+    bandit_results = load_json_file("bandit_results.json")
+    if isinstance(bandit_results, list):
+        for result in bandit_results:
+            if "results" in result:
+                for issue in result["results"]:
+                    finding = normalize_bandit_result(issue)
+                    all_findings.append(finding)
+                    findings_count += 1
+        summary_by_tool["bandit"] = {"issues": findings_count, "status": "completed"}
+    else:
+        summary_by_tool["bandit"] = {"issues": 0, "status": "no_data"}
+    print(f"  Found {findings_count} Bandit issues")
+    
+    # Pylint Results
+    print("\n[2/5] Processing Pylint results...")
+    pylint_results = load_json_file("pylint_results.json")
+    pylint_count = 0
+    if isinstance(pylint_results, list):
+        for issue in pylint_results:
+            if isinstance(issue, dict):
+                finding = normalize_pylint_result(issue)
+                all_findings.append(finding)
+                pylint_count += 1
+        summary_by_tool["pylint"] = {"issues": pylint_count, "status": "completed"}
+    else:
+        summary_by_tool["pylint"] = {"issues": 0, "status": "no_data"}
+    print(f"  Found {pylint_count} Pylint issues")
+    
+    # ESLint Results
+    print("\n[3/5] Processing ESLint results...")
+    eslint_results = load_json_file("eslint_results.json")
+    eslint_count = 0
+    if isinstance(eslint_results, list):
+        for result in eslint_results:
+            if "messages" in result:
+                for issue in result["messages"]:
+                    if isinstance(issue, dict):
+                        finding = normalize_eslint_result(issue)
+                        all_findings.append(finding)
+                        eslint_count += 1
+        summary_by_tool["eslint"] = {"issues": eslint_count, "status": "completed"}
+    else:
+        summary_by_tool["eslint"] = {"issues": 0, "status": "no_data"}
+    print(f"  Found {eslint_count} ESLint issues")
+    
+    # Gosec Results
+    print("\n[4/5] Processing Gosec results...")
+    gosec_results = load_json_file("gosec_results.json")
+    gosec_count = 0
+    if isinstance(gosec_results, dict) and "Issues" in gosec_results:
+        for issue in gosec_results["Issues"]:
+            finding = normalize_gosec_result(issue)
+            all_findings.append(finding)
+            gosec_count += 1
+        summary_by_tool["gosec"] = {"issues": gosec_count, "status": "completed"}
+    else:
+        summary_by_tool["gosec"] = {"issues": 0, "status": "no_data"}
+    print(f"  Found {gosec_count} Gosec issues")
+    
+    # Cargo Audit Results
+    print("\n[5/5] Processing Cargo Audit results...")
+    cargo_results = load_json_file("cargo_audit_results.json")
+    cargo_count = 0
+    if isinstance(cargo_results, dict) and "vulnerabilities" in cargo_results:
+        for vuln in cargo_results["vulnerabilities"]:
+            finding = normalize_cargo_audit_result(vuln)
+            all_findings.append(finding)
+            cargo_count += 1
+        summary_by_tool["cargo-audit"] = {"issues": cargo_count, "status": "completed"}
+    else:
+        summary_by_tool["cargo-audit"] = {"issues": 0, "status": "no_data"}
+    print(f"  Found {cargo_count} Cargo Audit issues")
+    
+    # حساب الإحصائيات
+    severity_counts = {
+        "CRITICAL": 0,
+        "HIGH": 0,
+        "MEDIUM": 0,
+        "LOW": 0,
+        "INFO": 0
+    }
+    
+    for finding in all_findings:
+        severity = finding.get("severity", "MEDIUM")
+        if severity in severity_counts:
+            severity_counts[severity] += 1
+    
+    # حساب النتيجة
+    total_findings = len(all_findings)
+    critical_penalty = severity_counts["CRITICAL"] * 10
+    high_penalty = severity_counts["HIGH"] * 5
+    medium_penalty = severity_counts["MEDIUM"] * 2
+    base_score = 100
+    security_score = max(0, base_score - critical_penalty - high_penalty - medium_penalty)
+    
+    # عدد الملفات الممسوحة ضوئياً
+    file_count = 0
+    files_set = set()
+    for finding in all_findings:
+        file_path = finding.get("file", "")
+        if file_path and file_path not in files_set:
+            files_set.add(file_path)
+    file_count = len(files_set)
+    
+    # إنشاء التقرير النهائي
+    scan_results = {
+        "metadata": {
+            "timestamp": datetime.utcnow().isoformat() + "Z",
+            "version": "1.0.0",
+            "tool": "auto-guardian",
+            "git": git_info
+        },
+        "summary": {
+            "total_issues": total_findings,
+            "critical_issues": severity_counts["CRITICAL"],
+            "high_issues": severity_counts["HIGH"],
+            "medium_issues": severity_counts["MEDIUM"],
+            "low_issues": severity_counts["LOW"],
+            "info_issues": severity_counts["INFO"],
+            "files_scanned": file_count,
+            "security_score": security_score,
+            "grade": get_grade(security_score)
+        },
+        "languages": {
+            "detected": languages,
+            "lines_of_code": count_lines_by_language(),
+            "tools_used": summary_by_tool
+        },
+        "findings": sorted(all_findings, key=lambda x: x.get("severity_level", 99)),
+        "trends": {
+            "previous_scan": None,
+            "improvement": None
+        }
+    }
+    
+    # حفظ النتائج
+    output_file = "scan_results.json"
+    with open(output_file, "w", encoding="utf-8") as f:
+        json.dump(scan_results, f, indent=2, ensure_ascii=False)
+    
+    print("\n" + "=" * 50)
+    print("ملخص الفحص:")
+    print("=" * 50)
+    print(f"  إجمالي المشاكل: {total_findings}")
+    print(f"  مشاكل حرجة: {severity_counts['CRITICAL']}")
+    print(f"  مشاكل عالية: {severity_counts['HIGH']}")
+    print(f"  مشاكل متوسطة: {severity_counts['MEDIUM']}")
+    print(f"  مشاكل منخفضة: {severity_counts['LOW']}")
+    print(f"  الملفات الممسوحة: {file_count}")
+    print(f"  نقاط الأمان: {security_score}/100 (الدرجة: {get_grade(security_score)})")
+    print("=" * 50)
+    print(f"✅ النتائج saved to: {output_file}")
+    print("=" * 50)
+
+def get_grade(score):
+    """الحصول على التقدير من النقاط"""
+    if score >= 90:
+        return "A"
+    elif score >= 80:
+        return "B"
+    elif score >= 70:
+        return "C"
+    elif score >= 60:
+        return "D"
+    else:
+        return "F"
+
+if __name__ == "__main__":
+    main()

scripts/backup.sh

@@ -0,0 +1,344 @@
+#!/bin/bash
+# سكريبت النسخ الاحتياطي لنظام الحارس التلقائي
+# Auto Guardian System Backup Script
+# ======================================
+
+# إعداداتColors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# إعدادات النسخ الاحتياطي
+BACKUP_DIR="backups"
+BACKUP_PREFIX="auto-guardian"
+RETENTION_DAYS=30
+LOG_FILE="logs/backup.log"
+
+# دوال مساعدة
+print_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_message() {
+    local level=$1
+    local message=$2
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [$level] $message" >> "$LOG_FILE"
+}
+
+# إنشاء مجلد السجلات إن لم يوجد
+mkdir -p "$(dirname "$LOG_FILE")"
+
+print_header() {
+    echo ""
+    echo "=============================================="
+    echo "  نظام الحارس التلقائي - النسخ الاحتياطي"
+    echo "=============================================="
+    echo ""
+}
+
+# دالة إنشاء نسخة احتياطية
+create_backup() {
+    print_info "جاري إنشاء نسخة احتياطية..."
+    
+    # إنشاء مجلد النسخ الاحتياطي إن لم يوجد
+    mkdir -p "$BACKUP_DIR"
+    
+    # إنشاء اسم الملف مع التاريخ والوقت
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+    local backup_filename="${BACKUP_PREFIX}_${timestamp}"
+    local backup_path="${BACKUP_DIR}/${backup_filename}"
+    local tar_filename="${backup_filename}.tar.gz"
+    
+    log_message "INFO" "بدء إنشاء نسخة احتياطية: $tar_filename"
+    
+    # إنشاء مجلد مؤقت للنسخة الاحتياطية
+    local temp_dir=$(mktemp -d)
+    trap "rm -rf $temp_dir" EXIT
+    
+    print_info "جاري تجميع الملفات..."
+    
+    # نسخ الإعدادات
+    print_info "نسخ الإعدادات..."
+    mkdir -p "$temp_dir/config"
+    cp config/settings.yaml "$temp_dir/config/" 2>/dev/null || true
+    cp config/rules.yaml "$temp_dir/config/" 2>/dev/null || true
+    cp config/alerts.yaml "$temp_dir/config/" 2>/dev/null || true
+    cp config/whitelist.yaml "$temp_dir/config/" 2>/dev/null || true
+    cp .env.example "$temp_dir/" 2>/dev/null || true
+    
+    # نسخ السجلات (آخر 7 أيام)
+    print_info "نسخ السجلات..."
+    mkdir -p "$temp_dir/logs"
+    find logs/ -name "*.log" -mtime -7 -exec cp {} "$temp_dir/logs/" \; 2>/dev/null || true
+    
+    # نسخ قاعدة البيانات إن وجدت
+    print_info "نسخ قاعدة البيانات..."
+    if [ -f "data/autoguardian.db" ]; then
+        mkdir -p "$temp_dir/data"
+        cp data/autoguardian.db "$temp_dir/data/"
+    fi
+    
+    # نسخ قائمة العناوكات المحظورة
+    print_info "نسخ قائمة العناوكات المحظورة..."
+    if [ -f "data/blocked_ips.json" ]; then
+        mkdir -p "$temp_dir/data"
+        cp data/blocked_ips.json "$temp_dir/data/"
+    fi
+    
+    # نسخ معلومات الإصدار
+    print_info "نسخ معلومات الإصدار..."
+    echo "{
+        \"backup_date\": \"$(date -Iseconds)\",
+        \"version\": \"$(git describe --tags 2>/dev/null || echo '1.3.0')\",
+        \"git_branch\": \"$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo 'unknown')\",
+        \"git_commit\": \"$(git rev-parse HEAD 2>/dev/null || echo 'unknown')\"
+    }" > "$temp_dir/backup_info.json"
+    
+    # ضغط الملفات
+    print_info "ضغط الملفات..."
+    tar -czf "$BACKUP_DIR/$tar_filename" -C "$temp_dir" .
+    
+    # حذف المجلد المؤقت
+    rm -rf "$temp_dir"
+    
+    # التحقق من نجاح الضغط
+    if [ -f "$BACKUP_DIR/$tar_filename" ]; then
+        local file_size=$(du -h "$BACKUP_DIR/$tar_filename" | cut -f1)
+        print_success "تم إنشاء النسخة الاحتياطية: $tar_filename ($file_size)"
+        log_message "INFO" "اكتمل النسخ الاحتياطي بنجاح: $tar_filename ($file_size)"
+        
+        # إنشاء ملف فهرس
+        echo "$tar_filename $(date -Iseconds) $(git describe --tags 2>/dev/null || echo 'unknown')" >> "$BACKUP_DIR/backup_index.txt"
+        
+        return 0
+    else
+        print_error "فشل في إنشاء النسخة الاحتياطية"
+        log_message "ERROR" "فشل في إنشاء النسخة الاحتياطية"
+        return 1
+    fi
+}
+
+# دالة حذف النسخ القديمة
+cleanup_old_backups() {
+    print_info "جاري حذف النسخ الاحتياطية القديمة (أقدم من $RETENTION_DAYS يوماً)..."
+    
+    local deleted_count=0
+    local deleted_size=0
+    
+    # البحث عن الملفات القديمة
+    while IFS= read -r -d '' file; do
+        local file_size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null || echo 0)
+        deleted_size=$((deleted_size + file_size))
+        rm -f "$file"
+        ((deleted_count++))
+        print_info "حُذف: $(basename "$file")"
+    done < <(find "$BACKUP_DIR" -name "${BACKUP_PREFIX}_*.tar.gz" -mtime +$RETENTION_DAYS -print0)
+    
+    if [ $deleted_count -gt 0 ]; then
+        print_success "حُذفت $deleted_count نسخة احتياطية (حوالي $(echo "scale=2; $deleted_size/1048576" | bc) MB)"
+        log_message "INFO" "حُذفت $deleted_count نسخة احتياطية"
+    else
+        print_info "لا توجد نسخ احتياطية قديمة للحذف"
+    fi
+}
+
+# دالة عرض النسخ الاحتياطية المتاحة
+list_backups() {
+    echo ""
+    echo "النسخ الاحتياطية المتاحة:"
+    echo "----------------------------"
+    
+    if [ ! -d "$BACKUP_DIR" ] || [ -z "$(ls -A "$BACKUP_DIR" 2>/dev/null)" ]; then
+        print_warning "لا توجد نسخ احتياطية"
+        return 1
+    fi
+    
+    local total_size=0
+    local count=0
+    
+    while IFS= read -r -d '' file; do
+        local filename=$(basename "$file")
+        local filesize=$(du -h "$file" | cut -f1)
+        local filedate=$(stat -c %y "$file" 2>/dev/null | cut -d' ' -f1,2 | cut -d'.' -f1 || stat -f "%Sm" -t "%Y-%m-%d %H:%M:%S" "$file" 2>/dev/null)
+        
+        echo "  $filename"
+        echo "    الحجم: $filesize | التاريخ: $filedate"
+        echo ""
+        
+        total_size=$((total_size + $(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null || echo 0)))
+        ((count++))
+    done < <(find "$BACKUP_DIR" -name "${BACKUP_PREFIX}_*.tar.gz" -print0 | sort -rz)
+    
+    echo "----------------------------"
+    echo "إجمالي النسخ: $count"
+    echo "الحجم الإجمالي: $(echo "scale=2; $total_size/1048576" | bc) MB"
+}
+
+# دالة استعادة نسخة احتياطية
+restore_backup() {
+    local backup_file=$1
+    
+    if [ -z "$backup_file" ]; then
+        print_error "يرجى تحديد ملف النسخ الاحتياطية"
+        echo "الاستخدام: $0 restore <backup_file>"
+        return 1
+    fi
+    
+    # التحقق من وجود الملف
+    if [ ! -f "$backup_file" ]; then
+        # البحث في مجلد النسخ الاحتياطية
+        if [ -f "$BACKUP_DIR/$backup_file" ]; then
+            backup_file="$BACKUP_DIR/$backup_file"
+        else
+            # البحث عن ملف يبدأ بالاسم
+            backup_file=$(find "$BACKUP_DIR" -name "${backup_file}*.tar.gz" -o -name "*${backup_file}*.tar.gz" 2>/dev/null | head -1)
+            if [ -z "$backup_file" ]; then
+                print_error "الملف غير موجود: $backup_file"
+                return 1
+            fi
+        fi
+    fi
+    
+    print_warning "سيتم استعادة النسخة الاحتياطية: $(basename "$backup_file")"
+    print_warning "سيتم الكتابة فوق الإعدادات الحالية!"
+    
+    read -p "هل تريد المتابعة؟ (y/N): " confirm
+    if [ "$confirm" != "y" ] && [ "$confirm" != "Y" ]; then
+        print_info "تم الإلغاء"
+        return 0
+    fi
+    
+    print_info "جاري استعادة النسخة الاحتياطية..."
+    
+    # إنشاء مجلد مؤقت
+    local temp_dir=$(mktemp -d)
+    trap "rm -rf $temp_dir" EXIT
+    
+    # استخراج الملفات
+    tar -xzf "$backup_file" -C "$temp_dir"
+    
+    # التحقق من وجود ملف المعلومات
+    if [ -f "$temp_dir/backup_info.json" ]; then
+        print_info "معلومات النسخة الاحتياطية:"
+        cat "$temp_dir/backup_info.json"
+        echo ""
+    fi
+    
+    # استعادة الإعدادات
+    if [ -f "$temp_dir/config/settings.yaml" ]; then
+        cp "$temp_dir/config/settings.yaml" config/settings.yaml
+        print_success "استُعيدت الإعدادات"
+    fi
+    
+    # استعادة السجلات
+    if [ -d "$temp_dir/logs" ]; then
+        cp -r "$temp_dir/logs/"* logs/ 2>/dev/null || true
+        print_success "استُعيدت السجلات"
+    fi
+    
+    # استعادة قاعدة البيانات
+    if [ -f "$temp_dir/data/autoguardian.db" ]; then
+        mkdir -p data
+        cp "$temp_dir/data/autoguardian.db" data/
+        print_success "استُعيدت قاعدة البيانات"
+    fi
+    
+    # استعادة قائمة العناوكات المحظورة
+    if [ -f "$temp_dir/data/blocked_ips.json" ]; then
+        mkdir -p data
+        cp "$temp_dir/data/blocked_ips.json" data/
+        print_success "استُعيدت قائمة العناوكات المحظورة"
+    fi
+    
+    print_success "اكتمل استعادة النسخة الاحتياطية"
+    log_message "INFO" "استُعيدت النسخة الاحتياطية: $(basename "$backup_file")"
+}
+
+# دالة إنشاء نسخة احتياطية للسجلات ��قط
+backup_logs_only() {
+    print_info "جاري إنشاء نسخة احتياطية للسجلات فقط..."
+    
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+    local backup_filename="${BACKUP_PREFIX}_logs_${timestamp}.tar.gz"
+    
+    if [ -d "logs" ] && [ "$(ls -A logs 2>/dev/null)" ]; then
+        tar -czf "$BACKUP_DIR/$backup_filename" logs/
+        print_success "تم إنشاء: $backup_filename"
+    else
+        print_warning "لا توجد سجلات للنسخ الاحتياطي"
+    fi
+}
+
+# دالة عرض المساعدة
+show_help() {
+    echo ""
+    echo "استخدام: $0 [الأمر]"
+    echo ""
+    echo "الأوامر المتاحة:"
+    echo ""
+    echo "  backup          - إنشاء نسخة احتياطية كاملة"
+    echo "  backup-logs     - إنشاء نسخة احتياطية للسجلات فقط"
+    echo "  list            - قائمة النسخ الاحتياطية المتاحة"
+    echo "  restore <file>  - استعادة نسخة احتياطية"
+    echo "  cleanup         - حذف النسخ القديمة"
+    echo "  help            - عرض هذه المساعدة"
+    echo ""
+    echo "أمثلة:"
+    echo "  $0 backup"
+    echo "  $0 list"
+    echo "  $0 restore auto-guardian_20241013_120000.tar.gz"
+    echo "  $0 cleanup"
+    echo ""
+}
+
+# ========================================
+# البرنامج الرئيسي
+# ========================================
+
+print_header
+
+# التحقق من الوسائط
+case "${1:-backup}" in
+    backup)
+        create_backup
+        cleanup_old_backups
+        ;;
+    backup-logs)
+        backup_logs_only
+        ;;
+    list)
+        list_backups
+        ;;
+    restore)
+        restore_backup "${2:-}"
+        ;;
+    cleanup)
+        cleanup_old_backups
+        ;;
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        print_error "أمر غير معروف: $1"
+        show_help
+        exit 1
+        ;;
+esac
+
+echo ""
+print_success "اكتمل العمل بنجاح!"
+echo ""

scripts/generate_report.py

@@ -0,0 +1,175 @@
+#!/usr/bin/env python3
+# سكريبت إنشاء تقارير الأمان
+
+import json
+import os
+from datetime import datetime
+
+def load_json_file(filepath):
+    """تحميل ملف JSON"""
+    if os.path.exists(filepath):
+        with open(filepath, 'r', encoding='utf-8') as f:
+            return json.load(f)
+    return None
+
+def generate_markdown_report(data):
+    """إنشاء تقرير Markdown"""
+    if not data:
+        return None
+    
+    summary = data.get('summary', {})
+    findings = data.get('findings', [])
+    metadata = data.get('metadata', {})
+    
+    # تصنيف المشاكل حسب الشدة
+    critical = [f for f in findings if f.get('severity') == 'CRITICAL']
+    high = [f for f in findings if f.get('severity') == 'HIGH']
+    medium = [f for f in findings if f.get('severity') == 'MEDIUM']
+    low = [f for f in findings if f.get('severity') == 'LOW']
+    
+    report = f"""# تقرير الأمان - Auto-Guardian
+
+## معلومات التقرير
+
+- **تاريخ الفحص:** {metadata.get('timestamp', 'غير متوفر')}
+- **الالتزام:** {metadata.get('git', {}).get('commit_sha', 'غير متوفر')}
+- **الفرع:** {metadata.get('git', {}).get('branch', 'غير متوفر')}
+- **إصدار الأداة:** {metadata.get('version', '1.0.0')}
+
+---
+
+## ملخص النتائج
+
+| المقياس | القيمة |
+|---------|--------|
+| **نتيجة الأمان** | {summary.get('security_score', 0)}/100 |
+| **التقدير** | {summary.get('grade', '-')} |
+| **إجمالي المشاكل** | {summary.get('total_issues', 0)} |
+| **ملفات مفحوصة** | {summary.get('files_scanned', 0)} |
+| **مشاكل حرجة** | {len(critical)} |
+| **مشاكل عالية** | {len(high)} |
+| **مشاكل متوسطة** | {len(medium)} |
+| **مشاكل منخفضة** | {len(low)} |
+
+---
+
+## المشاكل الحرجة ({len(critical)})
+
+"""
+    
+    if critical:
+        for i, finding in enumerate(critical, 1):
+            report += f"""### {i}. {finding.get('rule_name', finding.get('rule_id', 'غير معروف'))}
+
+- **الملف:** `{finding.get('file', 'غير معروف')}:{finding.get('line', 0)}`
+- **الأداة:** {finding.get('tool_name', finding.get('tool', 'غير معروف'))}
+- **الوصف:** {finding.get('message', finding.get('description', 'غير متوفر'))}
+- **مستوى الثقة:** {finding.get('confidence', 'غير معروف')}
+- **اللغة:** {finding.get('language', 'غير معروفة')}
+
+"""
+    else:
+        report += "لا توجد مشاكل حرجة! ممتاز! 🎉\n\n"
+
+    report += f"""---
+
+## المشاكل العالية ({len(high)})
+
+"""
+
+    if high:
+        for i, finding in enumerate(high, 1):
+            report += f"""### {i}. {finding.get('rule_name', finding.get('rule_id', 'غير معروف'))}
+
+- **الملف:** `{finding.get('file', 'غير معروف')}:{finding.get('line', 0)}`
+- **الأداة:** {finding.get('tool_name', finding.get('tool', 'غير معروف'))}
+- **الوصف:** {finding.get('message', finding.get('description', 'غير متوفر'))}
+
+"""
+    else:
+        report += "لا توجد مشاكل عالية! 🎉\n\n"
+
+    report += f"""---
+
+## التوصيات
+
+"""
+
+    # إضافة توصيات بناءً على النتائج
+    if len(critical) > 0:
+        report += "1. **أولوية قصوى:** معالجة المشاكل الحرجة المكتشفة فوراً.\n"
+    if len(high) > 0:
+        report += "2. **أولوية عالية:** حل المشاكل العالية في أقرب وقت ممكن.\n"
+    if len(medium) > 0:
+        report += "3. **أولوية متوسطة:** جدولة حل المشاكل المتوسطة في الدورة القادمة.\n"
+    if len(low) > 0:
+        report += "4. **أولوية منخفضة:** يمكن معالجة المشاكل منخفضة عند توفر الوقت.\n"
+
+    report += """
+---
+
+## اللغات المفحوصة
+
+"""
+
+    languages = data.get('languages', {})
+    for lang in languages.get('detected', []):
+        lines = languages.get('lines_of_code', {}).get(lang, 0)
+        tools = languages.get('tools_used', {}).get(lang, {})
+        report += f"- **{lang}:** {lines:,} سطر من الكود (فحص بـ {tools.get('issues', 0)} مشاكل)\n"
+
+    report += f"""
+
+---
+
+## أدوات الفحص المستخدمة
+
+"""
+
+    tools_used = languages.get('tools_used', {})
+    for tool, info in tools_used.items():
+        report += f"- **{tool}:** {info.get('issues', 0)} مشاكل مكتشفة (الحالة: {info.get('status', 'غير معروف')})\n"
+
+    report += f"""
+
+---
+
+*تم إنشاء هذا التقرير تلقائياً بواسطة Auto-Guardian في {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}*
+
+"""
+
+    return report
+
+def main():
+    """الدالة الرئيسية"""
+    print("=" * 50)
+    print("Auto-Guardian: إنشاء تقرير الأمان")
+    print("=" * 50)
+    
+    # تحميل بيانات الفحص
+    data = load_json_file('scan_results.json')
+    
+    if not data:
+        print("❌ لم يتم العثور على بيانات الفحص!")
+        print("   يرجى تشغيل aggregate_results.py أولاً")
+        return
+    
+    # إنشاء التقرير
+    report = generate_markdown_report(data)
+    
+    if report:
+        # حفظ التقرير
+        output_file = 'reports/security_report.md'
+        os.makedirs('reports', exist_ok=True)
+        
+        with open(output_file, 'w', encoding='utf-8') as f:
+            f.write(report)
+        
+        print(f"✅ تم إنشاء التقرير بنجاح!")
+        print(f"   الملف: {output_file}")
+        print("=" * 50)
+    else:
+        print("❌ فشل في إنشاء التقرير")
+
+if __name__ == "__main__":
+    main()

scripts/maintenance.sh

@@ -0,0 +1,445 @@
+#!/bin/bash
+# سكريبت صيانة نظام الحارس التلقائي
+# Auto Guardian System Maintenance Script
+# =========================================
+
+# إعداداتColors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# إعدادات
+LOG_FILE="logs/maintenance.log"
+DATA_DIR="data"
+LOGS_DIR="logs"
+
+# دوال مساعدة
+print_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [INFO] $1" >> "$LOG_FILE"
+}
+
+print_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [SUCCESS] $1" >> "$LOG_FILE"
+}
+
+print_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [WARNING] $1" >> "$LOG_FILE"
+}
+
+print_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [ERROR] $1" >> "$LOG_FILE"
+}
+
+print_header() {
+    echo ""
+    echo "=============================================="
+    echo "  نظام الحارس التلقائي - الصيانة"
+    echo "=============================================="
+    echo ""
+}
+
+# إنشاء مجلد السجلات إن لم يوجد
+mkdir -p "$(dirname "$LOG_FILE")" "$DATA_DIR" "$LOGS_DIR"
+
+# دالة تنظيف ملفات Python المؤقتة
+clean_pycache() {
+    print_info "جاري تنظيف ملفات Python المؤقتة..."
+    
+    local count=0
+    
+    # حذف مجلدات __pycache__
+    while IFS= read -r -d '' dir; do
+        rm -rf "$dir"
+        print_info "حُذف: $dir"
+        ((count++))
+    done < <(find . -type d -name "__pycache__" -print0 2>/dev/null)
+    
+    # حذف ملفات .pyc
+    while IFS= read -r -d '' file; do
+        rm -f "$file"
+        ((count++))
+    done < <(find . -name "*.pyc" -print0 2>/dev/null)
+    
+    # حذف ملفات .pyo
+    while IFS= read -r -d '' file; do
+        rm -f "$file"
+        ((count++))
+    done < <(find . -name "*.pyo" -print0 2>/dev/null)
+    
+    # حذف مجلدات .pytest_cache
+    rm -rf .pytest_cache/ 2>/dev/null
+    ((count++))
+    
+    # حذف مجلدات .hypothesis
+    rm -rf .hypothesis/ 2>/dev/null
+    ((count++))
+    
+    print_success "تم تنظيف $count عنصر"
+}
+
+# دالة تنظيف السجلات القديمة
+clean_logs() {
+    print_info "جاري تنظيف السجلات القديمة (أقدم من 14 يوماً)..."
+    
+    local count=0
+    local size_freed=0
+    
+    # البحث عن ملفات السجلات القديمة
+    while IFS= read -r -d '' file; do
+        local file_size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null || echo 0)
+        size_freed=$((size_freed + file_size))
+        rm -f "$file"
+        print_info "حُذف: $(basename "$file")"
+        ((count++))
+    done < <(find "$LOGS_DIR" -name "*.log" -mtime +14 -print0 2>/dev/null)
+    
+    if [ $count -gt 0 ]; then
+        print_success "حُذفت $count ملف سجل ($(echo "scale=2; $size_freed/1048576" | bc) MB)"
+    else
+        print_info "لا توجد ملفات سجل قديمة للحذف"
+    fi
+}
+
+# دالة تنظيف ملفات الاختبار
+clean_tests() {
+    print_info "جاري تنظيف ملفات الاختبار..."
+    
+    # حذف تقارير التغطية القديمة
+    rm -rf htmlcov/ .coverage .coverage.* 2>/dev/null
+    local count=1
+    
+    # حذف تقارير pytest
+    rm -rf pytest-results/ 2>/dev/null || true
+    
+    print_success "تم تنظيف ملفات الاختبار"
+}
+
+# دالة تنظيف ملفات البناء
+clean_build() {
+    print_info "جاري تنظيف ملفات البناء..."
+    
+    # مجلدات البناء
+    rm -rf build/ dist/ *.egg-info/ 2>/dev/null
+    local count=3
+    
+    # ملفات .egg
+    rm -rf *.egg 2>/dev/null
+    
+    # ملفات Wheel
+    rm -rf *.whl 2>/dev/null
+    
+    print_success "تم تنظيف ملفات البناء"
+}
+
+# دالة تنظيف ملفات التخزين المؤقت
+clean_cache() {
+    print_info "جاري تنظيف ملفات التخزين المؤقت..."
+    
+    # حذف ذاكرة التخزين المؤقت لـ pip
+    pip cache purge 2>/dev/null || true
+    
+    # حذف مجلدات ذاكرة التخزين المؤقت
+    rm -rf ~/.cache/pip 2>/dev/null || true
+    
+    # حذف ذاكرة التخزين المؤقت لـ mypy
+    rm -rf .mypy_cache/ 2>/dev/null || true
+    
+    # حذف ذاكرة التخزين المؤقت لـ ruff
+    rm -rf .ruff_cache/ 2>/dev/null || true
+    
+    print_success "تم تنظيف ملفات التخزين المؤقت"
+}
+
+# دالة التحقق من مساحة القرص
+check_disk_space() {
+    print_info "جاري التحقق من مساحة القرص..."
+    
+    local disk_usage=$(df -h . | tail -1 | awk '{print $5}' | sed 's/%//')
+    local disk_available=$(df -h . | tail -1 | awk '{print $4}')
+    
+    echo ""
+    echo "معلومات مساحة القرص:"
+    echo "--------------------"
+    df -h . | tail -1
+    echo ""
+    
+    if [ "$disk_usage" -gt 80 ]; then
+        print_warning "تحذير: استخدام القرص مرتفع ($disk_usage%)"
+        print_info "المساحة المتاحة: $disk_available"
+    else
+        print_success "مساحة القرص كافية (사용량: $disk_usage%)"
+    fi
+}
+
+# دالة التحقق من حالة Git
+check_git_status() {
+    print_info "جاري التحقق من حالة Git..."
+    
+    # التحقق من وجود Git
+    if ! command -v git &> /dev/null; then
+        print_warning "Git غير مثبت"
+        return
+    fi
+    
+    # التحقق من حالة المستودع
+    cd "$(dirname "$0")/.." 2>/dev/null
+    
+    if [ -d ".git" ]; then
+        # الفروع المحلية
+        echo ""
+        echo "الفروع المحلية:"
+        git branch --color=never 2>/dev/null | head -5
+        
+        # حالة المستودع
+        local status=$(git status --short 2>/dev/null | wc -l)
+        if [ "$status" -gt 0 ]; then
+            print_warning "توجد تغييرات غير ملتزم بها ($status ملف)"
+        else
+            print_success "المستودع نظيف"
+        fi
+        
+        # التحقق من التحديثات
+        git fetch origin 2>/dev/null
+        
+        local behind=$(git rev-list --count HEAD..origin/main 2>/dev/null || echo 0)
+        if [ "$behind" -gt 0 ]; then
+            print_info "يوجد تحديث متاح ($behind commits behind)"
+        else
+            print_success "المستودع محدث"
+        fi
+    else
+        print_info "المستودع ليس Git"
+    fi
+}
+
+# دالة التحقق من التبعيات
+check_dependencies() {
+    print_info "جاري التحقق من التبعيات..."
+    
+    # التحقق من Python
+    if command -v python3 &> /dev/null; then
+        print_success "Python مثبت: $(python3 --version)"
+    else
+        print_error "Python غير مثبت!"
+    fi
+    
+    # التحقق من الحزم المهمة
+    echo ""
+    echo "حالة الحزم:"
+    echo "----------"
+    
+    for pkg in requests pyyaml pytest; do
+        if python3 -c "import $pkg" 2>/dev/null; then
+            print_success "$pkg ✓"
+        else
+            print_warning "$pkg ✗ (غير مثبت)"
+        fi
+    done
+}
+
+# دالة إنشاء تقارير الحالة
+generate_status_report() {
+    print_info "جاري إنشاء تقرير الحالة..."
+    
+    local report_file="logs/status_report_$(date +%Y%m%d_%H%M%S).txt"
+    
+    {
+        echo "============================================="
+        echo "  تقرير حالة نظام الحارس التلقائي"
+        echo "============================================="
+        echo ""
+        echo "التاريخ: $(date)"
+        echo ""
+        echo "بيئة التشغيل:"
+        echo "------------"
+        echo "Python: $(python3 --version 2>&1)"
+        echo "النظام: $(uname -a)"
+        echo ""
+        echo "مساحة القرص:"
+        echo "-----------"
+        df -h . | tail -1
+        echo ""
+        echo "حالة Git:"
+        echo "--------"
+        git status --short 2>/dev/null || echo "غير متاح"
+        echo ""
+        echo "============================================="
+    } > "$report_file"
+    
+    print_success "تم إنشاء التقرير: $report_file"
+}
+
+# دالة إصلاح الأذونات
+fix_permissions() {
+    print_info "جاري إصلاح أذونات الملفات..."
+    
+    # تصحيح أذونات الملفات التنفيذية
+    chmod +x scripts/*.sh 2>/dev/null || true
+    
+    # تصحيح أذونات الملفات المهمة
+    chmod 600 config/*.yaml 2>/dev/null || true
+    
+    # تصحيح أذونات المجلدات
+    find . -type d -exec chmod 755 {} \; 2>/dev/null || true
+    
+    print_success "تم إصلاح الأذونات"
+}
+
+# دالة حذف الملفات المؤقتة
+clean_temp() {
+    print_info "جاري حذف الملفات المؤقتة..."
+    
+    local count=0
+    
+    # حذف ملفات ~
+    while IFS= read -r -d '' file; do
+        rm -f "$file"
+        ((count++))
+    done < <(find . -name "*~" -print0 2>/dev/null)
+    
+    # حذف ملفات .swp
+    while IFS= read -r -d '' file; do
+        rm -f "$file"
+        ((count++))
+    done < <(find . -name "*.swp" -print0 2>/dev/null)
+    
+    # حذف ملفات .swo
+    while IFS= read -r -d '' file; do
+        rm -f "$file"
+        ((count++))
+    done < <(find . -name "*.swo" -print0 2>/dev/null)
+    
+    # حذف ملفات .tmp
+    rm -f *.tmp 2>/dev/null
+    rm -f tmp/* 2>/dev/null || true
+    
+    print_success "تم حذف $count ملف مؤقت"
+}
+
+# دالة عرض المساعدة
+show_help() {
+    echo ""
+    echo "استخدام: $0 [الخيار]"
+    echo ""
+    echo "خيار��ت الصيانة:"
+    echo ""
+    echo "  all             - تشغيل جميع عمليات الصيانة"
+    echo "  pycache         - تنظيف ملفات Python المؤقتة"
+    echo "  logs            - تنظيف السجلات القديمة"
+    echo "  tests           - تنظيف ملفات الاختبار"
+    echo "  build           - تنظيف ملفات البناء"
+    echo "  cache           - تنظيف ملفات التخزين المؤقت"
+    echo "  temp            - حذف الملفات المؤقتة"
+    echo "  permissions     - إصلاح أذونات الملفات"
+    echo "  disk            - التحقق من مساحة القرص"
+    echo "  git             - التحقق من حالة Git"
+    echo "  deps            - التحقق من التبعيات"
+    echo "  report          - إنشاء تقرير الحالة"
+    echo "  help            - عرض هذه المساعدة"
+    echo ""
+}
+
+# ========================================
+# البرنامج الرئيسي
+# ========================================
+
+print_header
+
+# التحقق من الوسائط
+case "${1:-all}" in
+    all)
+        echo "جاري تشغيل جميع عمليات الصيانة..."
+        echo ""
+        
+        clean_pycache
+        echo ""
+        
+        clean_logs
+        echo ""
+        
+        clean_tests
+        echo ""
+        
+        clean_build
+        echo ""
+        
+        clean_cache
+        echo ""
+        
+        clean_temp
+        echo ""
+        
+        fix_permissions
+        echo ""
+        
+        check_disk_space
+        echo ""
+        
+        generate_status_report
+        ;;
+        
+    pycache)
+        clean_pycache
+        ;;
+        
+    logs)
+        clean_logs
+        ;;
+        
+    tests)
+        clean_tests
+        ;;
+        
+    build)
+        clean_build
+        ;;
+        
+    cache)
+        clean_cache
+        ;;
+        
+    temp)
+        clean_temp
+        ;;
+        
+    permissions)
+        fix_permissions
+        ;;
+        
+    disk)
+        check_disk_space
+        ;;
+        
+    git)
+        check_git_status
+        ;;
+        
+    deps)
+        check_dependencies
+        ;;
+        
+    report)
+        generate_status_report
+        ;;
+        
+    help|--help|-h)
+        show_help
+        ;;
+        
+    *)
+        print_error "خيار غير معروف: $1"
+        show_help
+        exit 1
+        ;;
+esac
+
+echo ""
+print_success "اكتمل العمل بنجاح!"
+echo ""

scripts/security_scanner.py

@@ -0,0 +1,55 @@
+import os
+import json
+import datetime
+
+class SecurityScanner:
+    def __init__(self, target_dir):
+        self.target_dir = target_dir
+        self.results = {
+            "scan_time": str(datetime.datetime.now()),
+            "vulnerabilities": [],
+            "summary": {"high": 0, "medium": 0, "low": 0}
+        }
+
+    def scan_files(self):
+        print(f"Starting security scan on: {self.target_dir}")
+        for root, dirs, files in os.walk(self.target_dir):
+            for file in files:
+                if file.endswith(('.py', '.js', '.html')):
+                    self._check_file(os.path.join(root, file))
+        
+        self._save_results()
+
+    def _check_file(self, file_path):
+        # Simple pattern matching for demonstration
+        patterns = {
+            "hardcoded_api_key": {"regex": "api_key =", "severity": "high", "desc": "Potential hardcoded API key found"},
+            "insecure_eval": {"regex": "eval\(", "severity": "high", "desc": "Use of insecure eval() function"},
+            "todo_comment": {"regex": "TODO:", "severity": "low", "desc": "Unresolved TODO comment"}
+        }
+        
+        try:
+            with open(file_path, 'r', errors='ignore') as f:
+                content = f.read()
+                for key, data in patterns.items():
+                    if data["regex"] in content:
+                        self.results["vulnerabilities"].append({
+                            "file": file_path,
+                            "issue": key,
+                            "severity": data["severity"],
+                            "description": data["desc"]
+                        })
+                        self.results["summary"][data["severity"]] += 1
+        except Exception as e:
+            print(f"Error scanning {file_path}: {e}")
+
+    def _save_results(self):
+        output_path = os.path.join(self.target_dir, 'public/data/security_scan_latest.json')
+        os.makedirs(os.path.dirname(output_path), exist_ok=True)
+        with open(output_path, 'w') as f:
+            json.dump(self.results, f, indent=4)
+        print(f"Scan complete. Results saved to {output_path}")
+
+if __name__ == "__main__":
+    scanner = SecurityScanner('.')
+    scanner.scan_files()

scripts/upgrade.sh

@@ -0,0 +1,443 @@
+#!/bin/bash
+# سكريبت ترقية نظام الحارس التلقائي
+# Auto Guardian System Upgrade Script
+# =====================================
+
+# إعداداتColors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# إعدادات
+LOG_FILE="logs/upgrade.log"
+BACKUP_DIR="backups"
+CONFIG_BACKUP="config.backup.$(date +%Y%m%d_%H%M%S)"
+
+# دوال مساعدة
+print_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [INFO] $1" >> "$LOG_FILE"
+}
+
+print_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [SUCCESS] $1" >> "$LOG_FILE"
+}
+
+print_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [WARNING] $1" >> "$LOG_FILE"
+}
+
+print_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [ERROR] $1" >> "$LOG_FILE"
+}
+
+print_header() {
+    echo ""
+    echo "=============================================="
+    echo "  نظام الحارس التلقائي - الترقية"
+    echo "=============================================="
+    echo ""
+}
+
+# إنشاء مجلد السجلات إن لم يوجد
+mkdir -p "$(dirname "$LOG_FILE")" "$BACKUP_DIR"
+
+# دالة النسخ الاحتياطي للإعدادات
+backup_config() {
+    print_info "جاري إنشاء نسخة احتياطية من الإعدادات..."
+    
+    if [ -d "config" ]; then
+        cp -r "config" "$CONFIG_BACKUP"
+        print_success "حُفظت الإعدادات في: $CONFIG_BACKUP"
+        return 0
+    else
+        print_warning "مجلد الإعدادات غير موجود"
+        return 1
+    fi
+}
+
+# دالة التحقق من المتطلبات
+check_requirements() {
+    print_info "جاري التحقق من المتطلبات..."
+    
+    # التحقق من Python
+    if ! command -v python3 &> /dev/null; then
+        print_error "Python 3 غير مثبت! يرجى تثبيت Python 3.8 أو أحدث."
+        return 1
+    fi
+    
+    local python_version=$(python3 --version 2>&1 | grep -oP '\d+\.\d+')
+    local major=$(echo "$python_version" | cut -d. -f1)
+    local minor=$(echo "$python_version" | cut -d. -f2)
+    
+    if [ "$major" -lt 3 ] || ([ "$major" -eq 3 ] && [ "$minor" -lt 8 ]); then
+        print_error "Python 3.8 أو أحدث مطلوب! الإصدار الحالي: $python_version"
+        return 1
+    fi
+    
+    print_success "Python $python_version ✓"
+    
+    # التحقق من Git
+    if ! command -v git &> /dev/null; then
+        print_error "Git غير مثبت! يرجى تثبيت Git."
+        return 1
+    fi
+    
+    print_success "Git ✓"
+    
+    # التحقق من Git repository
+    if [ ! -d ".git" ]; then
+        print_warning "المستودع ليس Git. لن يتم استخدام Git للترقية."
+        return 2
+    fi
+    
+    return 0
+}
+
+# دالة جلب التحديثات من Git
+git_pull() {
+    print_info "جاري جلب التحديثات من Git..."
+    
+    # جلب التحديثات
+    git fetch origin
+    
+    # الحصول على الفرع الحالي
+    local current_branch=$(git rev-parse --abbrev-ref HEAD)
+    print_info "الفرع الحالي: $current_branch"
+    
+    # جلب التغييرات
+    if git pull origin "$current_branch" --no-edit; then
+        print_success "تم جلب التحديثات"
+        return 0
+    else
+        print_error "فشل في جلب التحديثات"
+        return 1
+    fi
+}
+
+# دالة الترقية من ZIP
+upgrade_from_zip() {
+    local zip_file=$1
+    
+    if [ -z "$zip_file" ]; then
+        print_error "يرجى تحديد ملف ZIP"
+        return 1
+    fi
+    
+    if [ ! -f "$zip_file" ]; then
+        print_error "الملف غير موجود: $zip_file"
+        return 1
+    fi
+    
+    print_info "جاري الترقية من: $zip_file"
+    
+    # إنشاء مجلد مؤقت
+    local temp_dir=$(mktemp -d)
+    trap "rm -rf $temp_dir" EXIT
+    
+    # استخراج الملفات
+    unzip -q "$zip_file" -d "$temp_dir"
+    
+    # التحقق من المحتوى
+    if [ ! -f "$temp_dir/README.md" ]; then
+        print_error "الملف ZIP ليس لتحديث نظام الحارس التلقائي"
+        return 1
+    fi
+    
+    # نسخ الملفات (مع تجاوز)
+    print_info "جاري نسخ الملفات..."
+    cp -r "$temp_dir"/* .
+    
+    print_success "تم الترقية من ملف ZIP"
+}
+
+# دالة تحديث التبعيات
+update_dependencies() {
+    print_info "جاري تحديث التبعيات..."
+    
+    # التحقق من ملف requirements.txt
+    if [ ! -f "requirements.txt" ]; then
+        print_warning "ملف requirements.txt غير موجود"
+        return 1
+    fi
+    
+    # ترقية pip
+    print_info "تحديث pip..."
+    python3 -m pip install --upgrade pip wheel setuptools
+    
+    # ترقية التبعيات
+    print_info "تحديث التبعيات..."
+    if python3 -m pip install -r requirements.txt --upgrade; then
+        print_success "تم تحديث التبعيات"
+    else
+        print_error "فشل في تحديث التبعيات"
+        return 1
+    fi
+}
+
+# دالة تشغيل التهجير
+run_migrations() {
+    print_info "جاري تشغيل التهجير..."
+    
+    # التحقق من وجود سكريبت التهجير
+    if [ -f "scripts/migrate.py" ]; then
+        python3 scripts/migrate.py
+    elif [ -f "migrate.py" ]; then
+        python3 migrate.py
+    else
+        print_info "لا توجد تهجيرات للترقية"
+    fi
+}
+
+# دالة التحقق من الإعدادات الجديدة
+check_new_config() {
+    print_info "جاري التحقق من الإعدادات الجديدة..."
+    
+    # التحقق من وجود نموذج الإعدادات
+    if [ -f "config/settings.example.yaml" ]; then
+        if [ ! -f "config/settings.yaml" ]; then
+            print_warning "تم إنشاء ملف إعدادات جديد"
+            cp config/settings.example.yaml config/settings.yaml
+        fi
+        
+        # عرض الإعدادات الجديدة
+        print_info "راجع الإعدادات الجديدة في config/settings.yaml"
+        print_info "راجع التغييرات في config/settings.example.yaml"
+    fi
+}
+
+# دالة التحقق من الإضافات في GitHub Actions
+check_github_actions() {
+    print_info "جاري التحقق من GitHub Actions..."
+    
+    if [ -d ".github/workflows" ]; then
+        print_success "GitHub Actions موجود"
+        
+        # عرض سير العمل الجديد
+        local new_workflows=$(git diff --name-only HEAD@{1}..HEAD .github/workflows/ 2>/dev/null | wc -l)
+        if [ "$new_workflows" -gt 0 ]; then
+            print_info "يوجد $new_workflows سير عمل جديد أو معدل"
+        fi
+    fi
+}
+
+# دالة إعادة تشغيل الخدمة
+restart_service() {
+    print_info "جاري إعادة تشغيل الخدمة..."
+    
+    # التحقق من systemd
+    if command -v systemctl &> /dev/null; then
+        if systemctl is-active --quiet autoguardian 2>/dev/null; then
+            print_info "إعادة تشغيل الخدمة عبر systemd..."
+            sudo systemctl restart autoguardian
+            print_success "تم إعادة تشغيل الخدمة"
+            return 0
+        fi
+    fi
+    
+    # التحقق من Docker
+    if [ -f "docker-compose.yml" ]; then
+        print_info "إعادة تشغيل الحاويات..."
+        docker-compose restart auto-guardian
+        print_success "تم إعادة تشغيل الحاويات"
+        return 0
+    fi
+    
+    # الطريقة اليدوية
+    print_info "جاري إيقاف النظام..."
+    pkill -f "python.*src.main" 2>/dev/null || true
+    
+    print_info "جاري تشغيل النظام..."
+    nohup python3 -m src.main > logs/auto-guardian.log 2>&1 &
+    
+    sleep 2
+    
+    if pgrep -f "python.*src.main" > /dev/null; then
+        print_success "تم تشغيل النظام"
+    else
+        print_error "فشل في تشغيل النظام"
+        return 1
+    fi
+}
+
+# دالة عرض ملخص الترقية
+show_upgrade_summary() {
+    local new_version=$1
+    
+    echo ""
+    echo "=============================================="
+    echo "  ملخص الترقية"
+    echo "=============================================="
+    echo ""
+    
+    echo -e "${GREEN}✓${NC} تم إنشاء نسخة احتياطية من الإعدادات"
+    echo -e "${GREEN}✓${NC} تم تحديث التبعيات"
+    echo ""
+    
+    if [ -n "$new_version" ]; then
+        echo -e "الإصدار الجديد: ${BOLD}$new_version${NC}"
+    fi
+    
+    echo ""
+    echo "الخطوات التالية:"
+    echo "----------------"
+    echo "1. راجع ملف CHANGELOG.md لمعرفة التغييرات"
+    echo "2. راجع ملف requirements.txt للتعرف على التبعيات الجديدة"
+    echo "3. حدّث إعداداتك إذا لزم الأمر"
+    echo "4. شغل النظام: python3 -m src.main"
+    echo ""
+    
+    echo "للإبلاغ عن المشاكل:"
+    echo "- GitHub Issues: https://github.com/AbdulElahOthmanGwaith/auto-guardian-system/issues"
+    echo "- البريد: support@autoguardian.local"
+    echo ""
+}
+
+# دالة عرض المساعدة
+show_help() {
+    echo ""
+    echo "استخدام: $0 [الخيار] [الوسيطة]"
+    echo ""
+    echo "خيارات الترقية:"
+    echo ""
+    echo "  git             - الترقية من Git (الوضع الافتراضي)"
+    echo "  zip <file>      - الترقية من ملف ZIP"
+    echo "  check           - التحقق من التحديثات فقط"
+    echo "  backup          - إنشاء نسخة احتياطية فقط"
+    echo "  deps            - تحديث التبعيات فقط"
+    echo "  restart         - إعادة تشغيل الخدمة فقط"
+    echo "  help            - عرض هذه المساعدة"
+    echo ""
+    echo "أمثلة:"
+    echo "  $0 git                    # الترقية من Git"
+    echo "  $0 zip update.zip         # الترقية من ZIP"
+    echo "  $0 check                  # التحقق من التحديثات"
+    echo "  $0 restart                # إعادة تشغيل الخدمة"
+    echo ""
+}
+
+# ========================================
+# البرنامج الرئيسي
+# ========================================
+
+print_header
+
+# التحقق من الوسائط
+case "${1:-git}" in
+    git)
+        echo "وضع الترقية: Git"
+        echo ""
+        
+        # النسخ الاحتياطي للإعدادات
+        backup_config
+        
+        # التحقق من المتطلبات
+        if ! check_requirements; then
+            if [ $? -eq 2 ]; then
+                print_warning "استمرار بدون Git"
+            else
+                print_error "فشل في التحقق من المتطلبات"
+                exit 1
+            fi
+        fi
+        
+        # جلب التحديثات
+        if [ -d ".git" ]; then
+            git_pull
+        fi
+        
+        # تحديث التبعيات
+        update_dependencies
+        
+        # التحقق من الإعدادات الجديدة
+        check_new_config
+        
+        # التحقق من GitHub Actions
+        check_github_actions
+        
+        # عرض الملخص
+        local new_version=$(git describe --tags 2>/dev/null || echo "1.3.0")
+        show_upgrade_summary "$new_version"
+        ;;
+        
+    zip)
+        echo "وضع الترقية: ملف ZIP"
+        echo ""
+        
+        # النسخ الاحتياطي للإعدادات
+        backup_config
+        
+        # الترقية من ZIP
+        upgrade_from_zip "${2:-}"
+        
+        # تحديث التبعيات
+        update_dependencies
+        
+        # التحقق من الإعدادات الجديدة
+        check_new_config
+        
+        show_upgrade_summary
+        ;;
+        
+    check)
+        echo "التحقق من التحديثات..."
+        echo ""
+        
+        check_requirements || true
+        
+        if [ -d ".git" ]; then
+            git fetch origin
+            
+            local current_commit=$(git rev-parse HEAD)
+            local remote_commit=$(git rev-parse origin/main)
+            
+            if [ "$current_commit" != "$remote_commit" ]; then
+                local commits_behind=$(git rev-list --count HEAD..origin/main)
+                print_info "يوجد تحديث متاح ($commits_behind commits behind)"
+                echo ""
+                git log --oneline HEAD..origin/main | head -10
+            else
+                print_success "المستودع محدث"
+            fi
+        fi
+        ;;
+        
+    backup)
+        echo "إنشاء نسخة احتياطية..."
+        echo ""
+        backup_config
+        ;;
+        
+    deps)
+        echo "تحديث التبعيات..."
+        echo ""
+        update_dependencies
+        ;;
+        
+    restart)
+        echo "إعادة تشغيل الخدمة..."
+        echo ""
+        restart_service
+        ;;
+        
+    help|--help|-h)
+        show_help
+        ;;
+        
+    *)
+        print_error "خيار غير معروف: $1"
+        show_help
+        exit 1
+        ;;
+esac
+
+echo ""
+print_success "اكتمل العمل بنجاح!"
+echo ""

setup-guide.html

@@ -0,0 +1,823 @@
+<!DOCTYPE html>
+<html lang="ar" dir="rtl">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Auto-Guardian - دليل الإعداد الشامل</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+Arabic:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+    <style>
+        :root {
+            --bg-primary: #0f172a;
+            --bg-secondary: #1e293b;
+            --bg-tertiary: #334155;
+            --text-primary: #f1f5f9;
+            --text-secondary: #94a3b8;
+            --text-muted: #64748b;
+            --border-color: #334155;
+            --accent-blue: #3b82f6;
+            --accent-purple: #8b5cf6;
+            --accent-cyan: #06b6d4;
+            --success: #10b981;
+            --warning: #f59e0b;
+            --danger: #ef4444;
+            --shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.3);
+            --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.4);
+            --transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+        }
+
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: 'Noto Sans Arabic', -apple-system, sans-serif;
+            background: var(--bg-primary);
+            color: var(--text-primary);
+            line-height: 1.8;
+            overflow-x: hidden;
+        }
+
+        /* Hero Section */
+        .hero {
+            background: linear-gradient(135deg, var(--bg-secondary) 0%, var(--bg-primary) 100%);
+            padding: 80px 40px;
+            text-align: center;
+            position: relative;
+            overflow: hidden;
+        }
+
+        .hero::before {
+            content: '';
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+            background: 
+                radial-gradient(circle at 20% 80%, rgba(59, 130, 246, 0.1) 0%, transparent 50%),
+                radial-gradient(circle at 80% 20%, rgba(139, 92, 246, 0.1) 0%, transparent 50%);
+            pointer-events: none;
+        }
+
+        .hero-content {
+            position: relative;
+            z-index: 1;
+            max-width: 800px;
+            margin: 0 auto;
+        }
+
+        .hero-badge {
+            display: inline-flex;
+            align-items: center;
+            gap: 8px;
+            background: rgba(59, 130, 246, 0.2);
+            border: 1px solid rgba(59, 130, 246, 0.3);
+            padding: 8px 20px;
+            border-radius: 50px;
+            font-size: 14px;
+            color: var(--accent-blue);
+            margin-bottom: 24px;
+        }
+
+        .hero-title {
+            font-size: 48px;
+            font-weight: 700;
+            margin-bottom: 16px;
+            background: linear-gradient(135deg, var(--text-primary), var(--accent-blue));
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+            background-clip: text;
+        }
+
+        .hero-subtitle {
+            font-size: 18px;
+            color: var(--text-muted);
+            margin-bottom: 40px;
+        }
+
+        .hero-actions {
+            display: flex;
+            gap: 16px;
+            justify-content: center;
+            flex-wrap: wrap;
+        }
+
+        .btn {
+            display: inline-flex;
+            align-items: center;
+            gap: 8px;
+            padding: 14px 28px;
+            border-radius: 12px;
+            font-size: 15px;
+            font-weight: 600;
+            cursor: pointer;
+            transition: var(--transition);
+            border: none;
+            font-family: inherit;
+            text-decoration: none;
+        }
+
+        .btn-primary {
+            background: linear-gradient(135deg, var(--accent-blue), var(--accent-purple));
+            color: white;
+        }
+
+        .btn-primary:hover {
+            transform: translateY(-3px);
+            box-shadow: var(--shadow-lg);
+        }
+
+        .btn-secondary {
+            background: var(--bg-tertiary);
+            color: var(--text-primary);
+            border: 1px solid var(--border-color);
+        }
+
+        .btn-secondary:hover {
+            background: var(--bg-secondary);
+            border-color: var(--accent-blue);
+        }
+
+        /* Progress Section */
+        .progress-section {
+            background: var(--bg-secondary);
+            padding: 60px 40px;
+        }
+
+        .section-header {
+            text-align: center;
+            margin-bottom: 48px;
+        }
+
+        .section-title {
+            font-size: 32px;
+            font-weight: 700;
+            margin-bottom: 12px;
+        }
+
+        .section-subtitle {
+            font-size: 16px;
+            color: var(--text-muted);
+        }
+
+        .steps-container {
+            max-width: 900px;
+            margin: 0 auto;
+        }
+
+        .step {
+            display: flex;
+            gap: 24px;
+            margin-bottom: 32px;
+            padding: 24px;
+            background: var(--bg-primary);
+            border-radius: 16px;
+            border: 1px solid var(--border-color);
+            transition: var(--transition);
+            opacity: 0.5;
+        }
+
+        .step.active {
+            opacity: 1;
+            border-color: var(--accent-blue);
+            box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+        }
+
+        .step.completed {
+            opacity: 1;
+            border-color: var(--success);
+        }
+
+        .step-number {
+            width: 48px;
+            height: 48px;
+            border-radius: 50%;
+            background: var(--bg-tertiary);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            font-size: 18px;
+            font-weight: 700;
+            flex-shrink: 0;
+            transition: var(--transition);
+        }
+
+        .step.active .step-number {
+            background: var(--accent-blue);
+            color: white;
+        }
+
+        .step.completed .step-number {
+            background: var(--success);
+            color: white;
+        }
+
+        .step-content {
+            flex: 1;
+        }
+
+        .step-title {
+            font-size: 20px;
+            font-weight: 600;
+            margin-bottom: 8px;
+        }
+
+        .step-description {
+            font-size: 14px;
+            color: var(--text-muted);
+            margin-bottom: 16px;
+        }
+
+        .step-code {
+            background: var(--bg-secondary);
+            border-radius: 8px;
+            padding: 16px;
+            font-family: 'JetBrains Mono', monospace;
+            font-size: 13px;
+            overflow-x: auto;
+            border: 1px solid var(--border-color);
+        }
+
+        .step-files {
+            display: flex;
+            flex-wrap: wrap;
+            gap: 8px;
+            margin-top: 12px;
+        }
+
+        .file-tag {
+            display: inline-flex;
+            align-items: center;
+            gap: 6px;
+            padding: 6px 12px;
+            background: var(--bg-tertiary);
+            border-radius: 6px;
+            font-size: 12px;
+            font-family: 'JetBrains Mono', monospace;
+        }
+
+        .step-checklist {
+            list-style: none;
+            margin-top: 12px;
+        }
+
+        .step-checklist li {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            padding: 8px 0;
+            font-size: 14px;
+        }
+
+        .check-icon {
+            width: 20px;
+            height: 20px;
+            border-radius: 50%;
+            border: 2px solid var(--border-color);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            font-size: 12px;
+        }
+
+        .step.completed .check-icon {
+            background: var(--success);
+            border-color: var(--success);
+            color: white;
+        }
+
+        /* Files Structure */
+        .structure-section {
+            padding: 60px 40px;
+        }
+
+        .tree-container {
+            max-width: 700px;
+            margin: 0 auto;
+            background: var(--bg-secondary);
+            border-radius: 16px;
+            padding: 24px;
+            border: 1px solid var(--border-color);
+        }
+
+        .tree {
+            font-family: 'JetBrains Mono', monospace;
+            font-size: 14px;
+            line-height: 2;
+        }
+
+        .tree-line {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            padding-right: 20px;
+        }
+
+        .tree-folder {
+            color: var(--warning);
+        }
+
+        .tree-file {
+            color: var(--accent-cyan);
+        }
+
+        .tree-badge {
+            background: var(--accent-purple);
+            color: white;
+            padding: 2px 8px;
+            border-radius: 4px;
+            font-size: 10px;
+            margin-right: auto;
+        }
+
+        /* Feature Cards */
+        .features-section {
+            background: var(--bg-secondary);
+            padding: 60px 40px;
+        }
+
+        .features-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+            gap: 24px;
+            max-width: 1200px;
+            margin: 0 auto;
+        }
+
+        .feature-card {
+            background: var(--bg-primary);
+            border-radius: 16px;
+            padding: 32px;
+            border: 1px solid var(--border-color);
+            transition: var(--transition);
+        }
+
+        .feature-card:hover {
+            transform: translateY(-4px);
+            border-color: var(--accent-blue);
+        }
+
+        .feature-icon {
+            width: 56px;
+            height: 56px;
+            border-radius: 14px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            font-size: 28px;
+            margin-bottom: 20px;
+        }
+
+        .feature-icon.security { background: rgba(239, 68, 68, 0.2); }
+        .feature-icon.auto { background: rgba(59, 130, 246, 0.2); }
+        .feature-icon.dashboard { background: rgba(16, 185, 129, 0.2); }
+        .feature-icon.multi { background: rgba(139, 92, 246, 0.2); }
+
+        .feature-title {
+            font-size: 20px;
+            font-weight: 600;
+            margin-bottom: 12px;
+        }
+
+        .feature-description {
+            font-size: 14px;
+            color: var(--text-muted);
+        }
+
+        /* FAQ Section */
+        .faq-section {
+            padding: 60px 40px;
+        }
+
+        .faq-container {
+            max-width: 800px;
+            margin: 0 auto;
+        }
+
+        .faq-item {
+            background: var(--bg-secondary);
+            border-radius: 12px;
+            margin-bottom: 16px;
+            overflow: hidden;
+            border: 1px solid var(--border-color);
+        }
+
+        .faq-question {
+            padding: 20px 24px;
+            font-size: 16px;
+            font-weight: 600;
+            cursor: pointer;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            transition: var(--transition);
+        }
+
+        .faq-question:hover {
+            background: var(--bg-tertiary);
+        }
+
+        .faq-answer {
+            padding: 0 24px 20px;
+            font-size: 14px;
+            color: var(--text-muted);
+            display: none;
+        }
+
+        .faq-item.open .faq-answer {
+            display: block;
+        }
+
+        .faq-toggle {
+            transition: var(--transition);
+        }
+
+        .faq-item.open .faq-toggle {
+            transform: rotate(180deg);
+        }
+
+        /* Footer */
+        .footer {
+            background: var(--bg-secondary);
+            padding: 40px;
+            text-align: center;
+            border-top: 1px solid var(--border-color);
+        }
+
+        .footer-text {
+            font-size: 14px;
+            color: var(--text-muted);
+        }
+
+        /* Responsive */
+        @media (max-width: 768px) {
+            .hero {
+                padding: 40px 20px;
+            }
+
+            .hero-title {
+                font-size: 32px;
+            }
+
+            .step {
+                flex-direction: column;
+            }
+
+            .hero-actions {
+                flex-direction: column;
+            }
+
+            .btn {
+                width: 100%;
+                justify-content: center;
+            }
+        }
+
+        /* Animations */
+        @keyframes fadeIn {
+            from { opacity: 0; transform: translateY(20px); }
+            to { opacity: 1; transform: translateY(0); }
+        }
+
+        .step {
+            animation: fadeIn 0.5s ease forwards;
+        }
+
+        .step:nth-child(1) { animation-delay: 0.1s; }
+        .step:nth-child(2) { animation-delay: 0.2s; }
+        .step:nth-child(3) { animation-delay: 0.3s; }
+        .step:nth-child(4) { animation-delay: 0.4s; }
+        .step:nth-child(5) { animation-delay: 0.5s; }
+    </style>
+</head>
+<body>
+    <!-- Hero Section -->
+    <section class="hero">
+        <div class="hero-content">
+            <div class="hero-badge">
+                <span>🚀</span>
+                <span>دليل الإعداد الشامل</span>
+            </div>
+            <h1 class="hero-title">ابدأ مع Auto-Guardian</h1>
+            <p class="hero-subtitle">
+                نظام الفحص الأمني التلقائي للكود. اتبع الخطوات أدناه لتفعيل النظام بالكامل والحصول على لوحة تحكم تفاعلية تعرض حالة أمان مستودعك.
+            </p>
+            <div class="hero-actions">
+                <button class="btn btn-primary" onclick="scrollToSection('steps')">
+                    <span>📋</span>
+                    <span>بدء الإعداد</span>
+                </button>
+                <a href="index.html" class="btn btn-secondary">
+                    <span>🎨</span>
+                    <span>معاينة لوحة التحكم</span>
+                </a>
+            </div>
+        </div>
+    </section>
+
+    <!-- Steps Section -->
+    <section class="progress-section" id="steps">
+        <div class="section-header">
+            <h2 class="section-title">خطوات الإعداد</h2>
+            <p class="section-subtitle">اتبع هذه الخطوات بالترتيب لتفعيل النظام على مستودعك</p>
+        </div>
+
+        <div class="steps-container">
+            <!-- Step 1 -->
+            <div class="step active" id="step1">
+                <div class="step-number">1</div>
+                <div class="step-content">
+                    <h3 class="step-title">إنشاء المستودع أو نسخ القالب</h3>
+                    <p class="step-description">
+                        أولاً، تحتاج إلى إنشاء مستودع جديد. يمكنك استخدام هذا المشروع كقالب لإنشاء مستودع جديد، أو نسخ الملفات يدوياً إلى مستودع موجود.
+                    </p>
+                    <div class="step-checklist">
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>اذهب إلى <strong>GitHub</strong وسجل الدخول</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>زر <strong>Use this template</strong> لإنشاء مستودع جديد</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>أو انسخ الملفات يدوياً إذا كان لديك مستودع موجود</span>
+                        </li>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Step 2 -->
+            <div class="step" id="step2">
+                <div class="step-number">2</div>
+                <div class="step-content">
+                    <h3 class="step-title">رفع الملفات</h3>
+                    <p class="step-description">
+                        بعد إنشاء المستودع، تحتاج إلى رفع جميع الملفات. الهيكل التالي يجب أن يكون موجوداً في مستودعك:
+                    </p>
+                    <div class="step-files">
+                        <span class="file-tag">📁 .github/workflows/scan-and-deploy.yml</span>
+                        <span class="file-tag">📁 scripts/aggregate_results.py</span>
+                        <span class="file-tag">📁 scripts/generate_report.py</span>
+                        <span class="file-tag">📁 dashboard/public/data/latest.json</span>
+                        <span class="file-tag">📁 dashboard/index.html</span>
+                        <span class="file-tag">📄 README.md</span>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Step 3 -->
+            <div class="step" id="step3">
+                <div class="step-number">3</div>
+                <div class="step-content">
+                    <h3 class="step-title">تفعيل GitHub Pages</h3>
+                    <p class="step-description">
+                        الآن تحتاج إلى تفعيل GitHub Pages للسماح بنشر لوحة التحكم. اتبع الخطوات التالية:
+                    </p>
+                    <div class="step-checklist">
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>اذهب إلى <strong>Settings</strong> في مستودعك</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>انقر على <strong>Pages</strong> في القائمة الجانبية</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>في قسم <strong>Build and deployment</strong>:</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span><strong>Source:</strong> اختر <mark>GitHub Actions</mark></span>
+                        </li>
+                    </div>
+                    <div class="step-code">
+┌─────────────────────────────────────────────┐
+│  Build and deployment                        │
+│                                              │
+│  Source › GitHub Actions                     │
+└─────────────────────────────────────────────┘
+                    </div>
+                </div>
+            </div>
+
+            <!-- Step 4 -->
+            <div class="step" id="step4">
+                <div class="step-number">4</div>
+                <div class="step-content">
+                    <h3 class="step-title">تفعيل GitHub Actions</h3>
+                    <p class="step-description">
+                        الآن دعنا نتحقق من أن GitHub Actions يعمل. سير العمل سيبدأ تلقائياً عند دفع أي تغيير.
+                    </p>
+                    <div class="step-checklist">
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>اذهب إلى تبويب <strong>Actions</strong> في المستودع</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>ابحث عن <strong>Auto-Guardian Scan & Deploy</strong></span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>انقر على <strong>Enable workflow</strong> إذا كان معطلاً</span>
+                        </li>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Step 5 -->
+            <div class="step" id="step5">
+                <div class="step-number">5</div>
+                <div class="step-content">
+                    <h3 class="step-title">اختبار النظام</h3>
+                    <p class="step-description">
+                        للاختبار، قم بدفع أي تغيير بسيط إلى المستودع. سير العمل سيبدأ تلقائياً وسيتم نشر لوحة التحكم بعد اكتمال الفحص.
+                    </p>
+                    <div class="step-checklist">
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>أنشئ ملفاً جديداً أو عدل ملفاً موجوداً</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>ادفع التغييرات: <code>git add . && git commit -m "test" && git push</code></span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>تحقق من تبويب <strong>Actions</strong> لرؤية تقدم الفحص</span>
+                        </li>
+                        <li>
+                            <span class="check-icon">✓</span>
+                            <span>بعد اكتمال الفحص، اذهب إلى <strong>Settings > Pages</strong> للحصول على الرابط</span>
+                        </li>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- File Structure Section -->
+    <section class="structure-section">
+        <div class="section-header">
+            <h2 class="section-title">هيكل الملفات</h2>
+            <p class="section-subtitle">تأكد من أن جميع الملفات موجودة في الأماكن الصحيحة</p>
+        </div>
+
+        <div class="tree-container">
+            <pre class="tree">
+<span class="tree-line"><span class="tree-folder">📁</span> auto-guardian/
+  <span class="tree-line">  📁 <span class="tree-folder">.github/</span>
+    <span class="tree-line">    📁 workflows/
+  <span class="tree-badge">NEW</span>      📄 scan-and-deploy.yml</span>
+  <span class="tree-line">  📁 <span class="tree-folder">dashboard/</span>
+  <span class="tree-line">    📄 index.html</span>
+  <span class="tree-line">    📁 <span class="tree-folder">public/</span>
+  <span class="tree-line">      📁 <span class="tree-folder">data/</span>
+  <span class="tree-line">        📄 latest.json</span>
+  <span class="tree-line">  📁 <span class="tree-folder">scripts/</span>
+  <span class="tree-badge">NEW</span>  📄 aggregate_results.py
+  <span class="tree-line">      📄 generate_report.py</span>
+  <span class="tree-line">  📄 README.md</span></pre>
+        </div>
+    </section>
+
+    <!-- Features Section -->
+    <section class="features-section">
+        <div class="section-header">
+            <h2 class="section-title">مميزات النظام</h2>
+            <p class="section-subtitle">كل ما يقدمه لك نظام Auto-Guardian</p>
+        </div>
+
+        <div class="features-grid">
+            <div class="feature-card">
+                <div class="feature-icon security">🛡️</div>
+                <h3 class="feature-title">فحص أمني شامل</h3>
+                <p class="feature-description">
+                    يكتشف الثغرات الأمنية والأخطاء البرمجية باستخدام أدوات متخصصة لكل لغة برمجية.
+                </p>
+            </div>
+
+            <div class="feature-card">
+                <div class="feature-icon auto">⚡</div>
+                <h3 class="feature-title">فحص تلقائي</h3>
+                <p class="feature-description">
+                    يبدأ الفحص تلقائياً عند كل دفع للكود، ولا تحتاج لأي تدخل يدوي.
+                </p>
+            </div>
+
+            <div class="feature-card">
+                <div class="feature-icon dashboard">📊</div>
+                <h3 class="feature-title">لوحة تحكم تفاعلية</h3>
+                <p class="feature-description">
+                    واجهة جميلة وسهلة الاستخ��ام تعرض حالة الأمان بشكل واضح ومباشر.
+                </p>
+            </div>
+
+            <div class="feature-card">
+                <div class="feature-icon multi">🌐</div>
+                <h3 class="feature-title">دعم لغات متعددة</h3>
+                <p class="feature-description">
+                    يدعم Python وJavaScript وTypeScript وGo وRust وغيرها من اللغات.
+                </p>
+            </div>
+        </div>
+    </section>
+
+    <!-- FAQ Section -->
+    <section class="faq-section">
+        <div class="section-header">
+            <h2 class="section-title">الأسئلة الشائعة</h2>
+            <p class="section-subtitle">إجابات على الأسئلة المتكررة</p>
+        </div>
+
+        <div class="faq-container">
+            <div class="faq-item" onclick="toggleFaq(this)">
+                <div class="faq-question">
+                    <span>كم يستغرق الفحص؟</span>
+                    <span class="faq-toggle">▼</span>
+                </div>
+                <div class="faq-answer">
+                    يعتمد وقت الفحص على حجم المشروع. للمشاريع الصغيرة (أقل من 100 ملف) يستغرق عادة من 2 إلى 5 دقائق. للمشاريع الكبيرة قد يستغرق حتى 15 دقيقة.
+                </div>
+            </div>
+
+            <div class="faq-item" onclick="toggleFaq(this)">
+                <div class="faq-question">
+                    <span>هل يمكنني استخدام النظام في مستودع خاص؟</span>
+                    <span class="faq-toggle">▼</span>
+                </div>
+                <div class="faq-answer">
+                    نعم، يمكنك استخدام النظام في المستودعات الخاصة. لكن إذا كنت تريد GitHub Pages عام، ستحتاج إلى خطة GitHub مدفوعة.
+                </div>
+            </div>
+
+            <div class="faq-item" onclick="toggleFaq(this)">
+                <div class="faq-question">
+                    <span>ماذا يعني درجة الأمان؟</span>
+                    <span class="faq-toggle">▼</span>
+                </div>
+                <div class="faq-answer">
+                    درجة الأمان هي رقم من 0 إلى 100. الدرجة A (90-100) تعني مستوى ممتاز، بينما F (أقل من 60) تعني وجود مشاكل حرجة تحتاج اهتماماً فورياً.
+                </div>
+            </div>
+
+            <div class="faq-item" onclick="toggleFaq(this)">
+                <div class="faq-question">
+                    <span>هل يمكنني تخصيص أدوات الفحص؟</span>
+                    <span class="faq-toggle">▼</span>
+                </div>
+                <div class="faq-answer">
+                    نعم، يمكنك تعديل ملف سير العمل لإضافة أو إزالة أدوات الفحص، أو تخصيص إعدادات كل أداة من خلال ملفات الإعدادات الخاصة بها.
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Footer -->
+    <footer class="footer">
+        <p class="footer-text">
+            صنع بـ ❤️ بواسطة Auto-Guardian Team | 
+            <a href="#" style="color: var(--accent-blue);">التوثيق</a> | 
+            <a href="#" style="color: var(--accent-blue);">الإبلاغ عن مشكلة</a>
+        </p>
+    </footer>
+
+    <script>
+        // FAQ Toggle
+        function toggleFaq(element) {
+            element.classList.toggle('open');
+        }
+
+        // Scroll to section
+        function scrollToSection(sectionId) {
+            document.getElementById(sectionId).scrollIntoView({
+                behavior: 'smooth'
+            });
+        }
+
+        // Animate steps on scroll
+        const observer = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                if (entry.isIntersecting) {
+                    entry.target.style.opacity = '1';
+                }
+            });
+        }, { threshold: 0.1 });
+
+        document.querySelectorAll('.step').forEach(step => {
+            observer.observe(step);
+        });
+
+        // Welcome message
+        console.log('%c مرحباً بك في Auto-Guardian! 🎉', 'font-size: 20px; font-weight: bold; color: #3b82f6;');
+        console.log('%c نظام الفحص الأمني التلقائي للكود', 'font-size: 14px; color: #64748b;');
+    </script>
+</body>
+</html>