البدء السريع

اكتشف أول انتهاك لديك في 10 دقائق. لا حاجة إلى فريق DevOps.

1. اربط Git

في مساحة العمل لديك، أضِف بيانات اعتماد Git لـ GitHub أو GitLab (gitlab.com أو مُدار ذاتيًا) أو Bitbucket Cloud أو Azure DevOps من Credentials ← Add credential. راجع ربط مزوّد Git.

2. سجِّل مشروعًا

اختر مستودعًا باستخدام بيانات الاعتماد المتصلة وأنشئ مشروعك. يُنشئ AppArch رمزًا مميزًا للـ runner خاصًا بالمشروع.

3. عرّف القواعد

ابدأ من قالب جاهز (Clean أو Hexagonal أو Layered) أو اكتب ملف arch.yaml الخاص بك:

version: 2
style: hexagonal
layers:
  - { name: presentation, paths: ["src/ui/**"] }
  - { name: domain,       paths: ["src/domain/**"] }
  - { name: infrastructure, paths: ["src/infra/**"] }
rules:
  - { id: RULE-014, forbid: "presentation → infrastructure" }
  - { id: RULE-002, forbid: "domain → *", except: ["std"] }

4. أضِفه إلى خط أنابيب CI لديك

أضِف الـ runner إلى خط أنابيب CI لديك (مثال GitLab CI):

# 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>)"}}}
archpilot:
  image: hub.apparch.io/collectors/dotnet:latest
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  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"

في المرة التالية التي يُفتح فيها PR/MR، يترك AppArch تعليقات سطرًا بسطر. راجِع قسم التكاملات للمزيد من التفاصيل.