تشغيل ArchScan وقراءة التقرير

يفحص ArchScan قاعدة الكود لديك ويُنتج تقريرًا كاملًا مع درجة جودة واحدة مرجّحة حسب الفئات.

بدء فحص

هناك طريقتان:

• في CI: شغِّل الـ runner في خط أنابيب push/مجدول - خارج سياق الـ MR يتحوّل تلقائيًا إلى وضع الفحص الكامل (ArchScan) (راجِع إضافة الـ runner إلى CI).
• من اللوحة: استخدم ArchScan ← (المشروع) ← Run scan لفحص أحدث فرع.

# Image pulls are authorized with your INSTALLATION credential, not the project token
# (Settings → CI/CD → Variables):
#   DOCKER_AUTH_CONFIG = {"auths":{"hub.apparch.io":{"auth":"base64(<installation-id>:<installation-key>)"}}}
archscan:
  image: hub.apparch.io/collectors/dotnet:latest
  rules:
    - if: $CI_PIPELINE_SOURCE == "push"
  variables:
    APPARCH_Collector__Token: "$APPARCH_TOKEN"
    APPARCH_Collector__ApiUrl: "https://api.yourdomain.com"
  script:
    # Optional flags: --modules archpilot,archscan (pin what runs)
    #                 --fail-on critical (fail this step when findings at/above the level exist)
    - apparch "$CI_PROJECT_DIR"

قراءة التقرير

يتألف التقرير من سبعة أقسام:

1. درجة الملخّص - درجة واحدة مرجّحة حسب الفئات + الحالة.
2. النتائج - مع مقتطف الكود وموقع الملف.
3. تفصيل SOLID - الانتهاكات بحسب المبادئ الخمسة.
4. الحِزم - التبعيات والإصدارات.
5. المشاريع - مقاييس لكل مشروع.
6. خريطة التبعيات - رسم بياني تفاعلي.
7. التصدير.

خريطة التبعيات

في تفاصيل التقرير، تعرض علامة التبويب Map التبعيات بين المشاريع في رسم بياني تفاعلي؛ ويمكنك رصد الدورات وتسريبات الطبقات في لمحة.

التصدير إلى HTML/PDF

استخدم Report ← Export لإنتاج تقرير قابل للمشاركة. تُضبَط لغة التقرير لكل مساحة عمل. لإنشاء PDF، استخدم ميزة “طباعة ← حفظ بصيغة PDF” في متصفّحك.

ملاحظة

يُجرى الفحص في CI الخاص بك؛ ولا يُرسَل إلى اللوحة سوى مخرجات التحليل.