أفضل الممارسات في التصميم الكائني

// ❌ تعقيد غير ضروري
interface GreetingStrategy {
  greet(name: string): string;
}
class ArabicGreeting implements GreetingStrategy {
  greet(name: string) { return `مرحباً ${name}`; }
}
class Greeter {
  constructor(private strategy: GreetingStrategy) {}
  greet(name: string) { return this.strategy.greet(name); }
}

// ✅ بسيط ومباشر
function greet(name: string) {
  return `مرحباً ${name}`;
}

// ❌ تخمين الاحتياجات المستقبلية
abstract class PaymentProvider {
  abstract pay(amount: number): void;
  abstract refund(amount: number): void;
  abstract getBalance(): number;
  abstract subscribe(plan: string): void;
}
// في النهاية استخدمت PayPal فقط!

// ✅ اكتب ما تحتاجه الآن
class PayPalPayment {
  constructor(private apiKey: string) {}
  async charge(amount: number) {
    // فقط ما أحتاجه الآن
  }
}

// ❌ وراثة عميقة
class Animal {}
class Bird extends Animal {}
class FlyingBird extends Bird {}
class Penguin extends FlyingBird {} // البطريق لا يطير!

// ✅ تكوين (Composition)
interface FlyBehavior {
  fly(): void;
}

class CanFly implements FlyBehavior {
  fly() { console.log("أطير!"); }
}

class CannotFly implements FlyBehavior {
  fly() {} // لا يفعل شيئاً
}

class Bird {
  constructor(private flyBehavior: FlyBehavior) {}
  performFly() { this.flyBehavior.fly(); }
}

const penguin = new Bird(new CannotFly());
const eagle = new Bird(new CanFly());

// بدلاً من شرح طويل
class DataStore {
  // ... 100 سطر ...
}

// قل: "هذا Singleton لإعدادات التطبيق"
// المطور الآخر يفهم فوراً أن:
// - يوجد instance وحيد
// - يمكن الوصول إليه من أي مكان
// - يجب الحذر من الحالة المشتركة

// ❌ فرض النمط حيث لا يناسب
class MathOperations {
  // Strategy pattern لعمليات جمع بسيطة!
  constructor(private operation: Operation) {}
  execute(a: number, b: number) {
    return this.operation.calculate(a, b);
  }
}
// مجرد function أفضل

// ✅ استخدم الأنماط عندما تحل مشكلة حقيقية
// - اقتران زائد؟ استخدم DI
// - كائنات معقدة؟ استخدم Factory أو Builder
// - تغييرات متكررة؟ استخدم Strategy

// المرحلة 1: كود بسيط
function processOrder(order) {
  if (order.type === "physical") { /* شحن */ }
  if (order.type === "digital") { /* إرسال رابط */ }
}

// المرحلة 2: لاحظ وجود تكرار ونمط
// المرحلة 3: أعد الهيكلة نحو Strategy
interface OrderProcessor {
  process(order: Order): void;
}

class PhysicalProcessor implements OrderProcessor {
  process(order: Order) { /* شحن */ }
}

class DigitalProcessor implements OrderProcessor {
  process(order: Order) { /* إرسال رابط */ }
}