كيف تتخذ وتوثق القرارات التقنية المهمة؟

Question

Accepted Answer

يجب أن تكون القرارات التقنية المهمة **مدروسة وشفافة ومسجلة**، وليست قرارات تُتخذ في رأس أحدهم وتُنسى. العملية الجيدة تكشف عن المقارنات، وتبني الموافقة، وتترك سجلاً حتى يفهم المهندسون المستقبليون *لماذا*، وليس فقط *ماذا*.

## إطار عمل القرار

```text
1. FRAME the problem and the constraints (cost, time, team skill, scale)
2. LIST the realistic options — usually 2-4, including "do nothing"
3. EVALUATE each against the constraints and trade-offs
4. DECIDE, and state the reasoning explicitly
5. RECORD it (ADR) and communicate it
6. REVISIT if assumptions change
```

## سجله باستخدام ADR

**سجل القرار المعماري** هو ملاحظة قصيرة وطويلة الأمد:

```markdown
# ADR 014: Use PostgreSQL for the new service

## Status: Accepted

## Context
We need a primary datastore. Team knows SQL; data is relational; scale is moderate.

## Decision
Use PostgreSQL.

## Consequences
+ Strong consistency, team familiarity, rich querying.
- Vertical scaling limits later; revisit if write volume 10x's.

## Alternatives considered
DynamoDB (rejected: relational data, team unfamiliar).
```

## المقارنة المراد إدارتها

توثيق كل شيء يتطلب جهداً إضافياً؛ وعدم توثيق أي شيء يفقد الذاكرة المؤسسية. احتفظ بـ ADRs للقرارات التي **يكون عكسها مكلفاً** أو التي سيشكك فيها المهندسون المستقبليون.

## لماذا يهم

القرارات غير الموثقة تتعرض لإعادة نقاش لا نهاية لها، كل مهندس جديد يسأل "لماذا اخترنا هذا؟"

كتابة التبرير أيضاً يفرض الوضوح: إذا لم تستطع تبريره على الورق، فربما لم تفكر فيه بشكل كافٍ.