تخطَّ إلى المحتوى
AppArch AppArch Docs

إنشاء سجلّ قرار معماري (ADR)

تخزّن وحدة ADR قراراتك المعمارية في شكل مُرقَّم وقابل للتتبّع.

إنشاء سجلّ جديد

Section titled “إنشاء سجلّ جديد”
  1. انتقل إلى ADR ← New decision.
  2. اكتب عنوانًا؛ يخصّص AppArch رقمًا تلقائيًا متسلسلًا (مثل ADR-0007).
  3. اكتب المتن بصيغة Markdown - بأقسام السياق والقرار والنتيجة:
## السياق
نحتاج إلى اتصال غير متزامن بين الخدمات.


## القرار
سيستخدم RabbitMQ طابورا للأحداث.


## العواقب
يزداد العبء التشغيلي؛ يحل محل ADR-0003.
  1. Save - يُنشَأ السجلّ بحالة “Proposed” (مقترح).

انتقالات الحالة

Section titled “انتقالات الحالة”

دورة حياة MADR: Proposed ← Accepted ← Rejected ← Superseded. في تفاصيل القرار، استخدم Change status للانتقال؛ ويُسجَّل كل انتقال.

الإحلال

Section titled “الإحلال”

إذا حلّ قرار محلّ آخر، فاختر ADR المعني في حقل “Supersedes” في السجلّ. يُحفَظ الرابط؛ ويُعلَّم القرار القديم بأنه “Superseded”، وتبقى إجابة “لماذا تغيّر؟” دائمًا في متناول اليد.

التصدير

Section titled “التصدير”

استخدم ADR ← Export لتنزيل جميع السجلات بصيغة JSON أو CSV أو ZIP بصيغة Markdown - جاهزة للتدقيق والنسخ الاحتياطي.