Skip to main content
Architecture9 min read

قرار العمارة الذي لا يكتبه أحد

نقضي أسابيع في الاختيار بين Kafka وRabbitMQ لكننا لا نوثق السبب أبدًا. تستغرق ADRs 15 دقيقة وتوفر شهورًا من محادثات 'لماذا فعلنا هذا؟'

Part ofProduct Systems->
By Jason TeixeiraDecember 20, 2025
ArchitectureDocumentationADRDecision MakingBest Practices
Share:
On this page

منذ ستة أشهر، اخترت Supabase بدلاً من Firebase لمشروع Nexural. كانت لدي أسباب وجيهة — PostgreSQL، أمان على مستوى الصفوف، قابلية الاستضافة الذاتية. لكنني كدت أنسى تلك الأسباب. الشيء الوحيد الذي أنقذني من إعادة تقييم نفس القرار (وإضاعة أسبوع) كان ملف ماركداون كتبته في 15 دقيقة.

المشكلة

كل فريق هندسي يمر بهذا الحوار:

"لماذا نستخدم RabbitMQ بدلاً من Kafka؟" "أعتقد أن Dave اختاره. Dave غادر منذ 8 أشهر." "..." "هل يجب أن نتحول إلى Kafka؟"

والآن أنت تقضي سباقًا لإعادة تقييم قرار تم تقييمه بالفعل. المعرفة المؤسسية غادرت الباب.

سجلات قرارات المعمارية (ADRs)

ADR هو مستند قصير يلتقط قرارًا مهمًا. سجلاتي بسيطة جدًا:

\\

Reader route

article -> proof -> offer

ReadClusterProofScope

cluster

Product Systems

intent

Architecture

route

next step

What to do with this

Turn the note into a build path.

If this topic maps to a real business problem, keep reading the cluster, study the academy path, or route the work into a scoped engagement.

Jason Teixeira
Written by
Jason Teixeira
Founder, Sage Ideas Studio · Principal Engineer
livebuild 5d6c8652026-08-05 06:00Z
// solo studio// no analytics resold// every commit human-reviewed