التكاملات

يتكامل Architecto بسلاسة مع الأدوات التي يستخدمها فريقك بالفعل.

التحكم في الإصدارات

GitHub

استورد المستودعات وشغّل توليد المعمارية عند تغير الشيفرة.

الإعداد:

1. انتقل إلى التكاملات ← GitHub
2. انقر على ربط GitHub
3. امنح Architecto صلاحية الوصول إلى المستودعات
4. اختر مستودعات محددة أو جميع المستودعات

حالات الاستخدام:

• استيراد ملفات Terraform وتحويلها إلى مخططات
• تحديث المعمارية تلقائيًا عند تغير البنية التحتية كشيفرة
• إنشاء معماريات من شيفرة المستودع
• ربط المخططات بطلبات السحب

الإجراءات:

- Import Terraform from GitHub
- Watch for changes in .tf files
- Create PR comments with diagram preview
- Sync architecture to GitHub discussion

GitLab

مشابه لتكامل GitHub (قريبًا)

• الاستيراد من مستودعات GitLab
• التكامل مع خطوط GitLab CI/CD
• مزامنة المخططات مع طلبات الدمج

البنية التحتية كشيفرة

Terraform

حلّل ملفات Terraform وولّد مخططات معمارية.

آلية العمل:

1. ارفع ملف .tf أو اربط GitHub
2. يحلل Architecto موارد المورّد
3. يولّد الطوبولوجيا من تعريفات الموارد
4. ينشئ عقدة لكل مورد
5. يربط العقد وفق الاعتماديات

مثال: رفع ملف Terraform التالي:

resource "aws_vpc" "main" {
  cidr_block = "10.0.0.0/16"
}

resource "aws_lb" "main" {
  load_balancer_type = "application"
}

resource "aws_instance" "app" {
  instance_type = "t3.medium"
  count         = 3
}

resource "aws_rds_cluster" "db" {
  engine = "aurora-postgresql"
}

يولّد مخططًا يعرض: VPC ← موازن الحمل ← مثيلات EC2 ← RDS

CloudFormation

استورد قوالب AWS CloudFormation.

• تحليل قوالب YAML وJSON
• توليد الطوبولوجيا من المكدسات
• دعم جميع موارد AWS

Bicep

دعم لغة البنية التحتية في Azure (قريبًا)

CDK (البنية التحتية كشيفرة)

دعم AWS CDK (قريبًا)

منصات التعاون

Discord

شارك المعماريات وتلقَّ الإشعارات في Discord.

الإعداد:

1. انتقل إلى التكاملات ← Discord
2. انقر على إضافة إلى Discord
3. اختر مساحة العمل وامنح الإذن
4. اختر قناة الإشعارات

الميزات:

• مشاركة المعماريات في قنوات Discord
• تلقي إشعارات عند:
  • مشاركة معمارية معك
  • إضافة تعليقات إلى المخططات المشتركة
  • دعوات الفريق
• البحث عن المعماريات في Discord
• عرض معاينات لروابط المعماريات

مثال:

/architecto share my-ecommerce-arch #team-architecture

Jira

اربط المعماريات بمشكلات Jira وأنشئ تذاكر من النتائج.

الإعداد:

1. انتقل إلى التكاملات ← Jira
2. أدخل معرّف Jira Cloud
3. ولّد رمز API والصقه

الميزات:

• ربط المعمارية بالملاحم وقصص المستخدم في Jira
• إنشاء تذاكر من نتائج التحليل:
  • اقتراحات تحسين التكلفة
  • توصيات قابلية التوسع
  • إجراءات تخفيف المخاطر الأمنية
  • مشكلات الامتثال
• إضافة المخططات المعمارية كمرفقات في Jira
• تحديث حالة المشكلة من Architecto

الاتصالات

البريد الإلكتروني

أرسل المعماريات والتقارير عبر البريد الإلكتروني.

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

Teams (قريبًا)

تكامل Microsoft Teams

• المشاركة في قنوات Teams
• تلقي إشعارات Teams
• تضمين المخططات في محادثات Teams

التحليلات والمراقبة

Datadog (قريبًا)

راقب عمليات نشر المعمارية.

New Relic (قريبًا)

تتبع مقاييس الأداء.

Grafana (قريبًا)

اعرض المقاييس والسجلات بصريًا.

المورّدون السحابيون

AWS

تكامل أصلي مع AWS (مضمن بالفعل)

• أيقونات لأكثر من 200 خدمة AWS
• تكامل بيانات التسعير
• دعم VPC ومجموعات الأمان

Google Cloud Platform

تكامل GCP (مضمن بالفعل)

• أيقونات لخدمات GCP
• بيانات التسعير
• دعم VPC

Microsoft Azure

تكامل Azure (مضمن بالفعل)

• أيقونات لأكثر من 100 خدمة Azure
• بيانات التسعير
• دعم الشبكات الافتراضية

Kubernetes

Kubernetes وتنسيق الحاويات (مضمنان بالفعل)

• أيقونات Pods وDeployments وServices
• دعم العناقيد المتعددة
• عرض Helm charts بصريًا (قريبًا)

اختبار API

Postman

اختبر واجهات API والتكاملات.

• مجموعة Postman
• استوردها لاختبار جميع نقاط النهاية
• مصادقة معدة مسبقًا

الذكاء الاصطناعي والأتمتة (قريبًا)

GitHub Actions

أتمت مسارات العمل المعمارية.

- name: Update Architecture
  uses: architecto/update-architecture@v1
  with:
    terraform-path: ./infrastructure
    api-key: ${{ secrets.ARCHITECTO_API_KEY }}

Zapier

اربط أكثر من 1000 تطبيق عبر Zapier.

• تشغيل الإجراءات عند أحداث Zapier
• إرسال المعماريات إلى أي تطبيق متصل

التكاملات المخصصة

Webhooks

أنشئ تكاملات مخصصة باستخدام Webhooks.

POST /webhooks
{
  "url": "https://your-app.com/architecto-webhook",
  "events": ["architecture.created", "analysis.completed"]
}

API

استخدم REST API لبناء ما تحتاجه.

• مرجع API الكامل
• حزم SDK لـ Python وNode.js وGo وRuby وJava
• دعم GraphQL (قريبًا)

أفضل ممارسات إعداد التكاملات

1. أقل الصلاحيات — لا تمنح سوى نطاقات الوصول المطلوبة
2. حماية الأسرار — خزّن مفاتيح API في متغيرات البيئة
3. الاختبار أولًا — اختبر التكامل في بيئة مرحلية
4. المراقبة — تتبع سلامة التكامل ومعدلات الأخطاء
5. التوثيق — حدّث وثائق الفريق باستمرار

استكشاف الأخطاء وإصلاحها

لا تجد تكاملًا؟

• راجع صفحة التكاملات
• أرسل طلب ميزة على GitHub
• راسلنا عبر support@architecto.dev

التكامل لا يعمل؟

• تحقق من صلاحية مفتاح API
• تحقق من إمكانية الوصول إلى عنوان Webhook
• راجع سجلات الأخطاء في إعدادات التكامل
• تواصل عبر support@architecto.dev

الخطوات التالية:

• مرجع API
• أمثلة مسارات العمل