مستودع واحد مقابل مستودعات متعددة: أي استراتيجية تختار؟

عند العمل على مشاريع برمجية معقدة، يمكن أن يكون للاختيار بين Monorepo و Polyrepo تأثير كبير على إنتاجية الفريق وقابلية تطوير الكود. في هذا المقال، نحلل الفروق، الإيجابيات والسلبيات لكل نهج، ونساعدك على فهم الأنسب لك.

ما هما Monorepo و Polyrepo؟

Monorepo

Monorepo (مستودع أحادي) هو مستودع واحد يحتوي على الشيفرة المصدرية لعدة مشاريع أو خدمات أو حزم، غالبًا ما تكون مترابطة.

my-monorepo/
  packages/
    frontend/
    backend/
    shared/
  package.json
  turbo.json

Polyrepo

Polyrepo (مستودعات متعددة) يعني أن كل مشروع أو خدمة أو حزمة لها مستودع منفصل خاص بها.

repos/
  frontend/
    package.json
  backend/
    package.json
  shared/
    package.json

الفرق البصري

الإيجابيات والسلبيات

Monorepo

الإيجابيات:

• يسهل مشاركة الكود (مثل المكتبات المشتركة).
• إعادة هيكلة شاملة عبر مشاريع متعددة.
• إدارة مركزية للاعتمادات والإعدادات.

السلبيات:

• قد يصبح ضخمًا مع نمو الكود.
• يتطلب أدوات لإدارة البناء/الاختبار الجزئي (مثل Nx، Turborepo).

Polyrepo

الإيجابيات:

• كل فريق/مشروع مستقل.
• أسهل في الإدارة للمشاريع الصغيرة.
• يسمح بسياسات وصول دقيقة.

السلبيات:

• صعوبة مشاركة الكود بدون نشر الحزم.
• إعادة هيكلة عبر المستودعات أكثر تعقيدًا.
• احتمال تكرار الإعدادات.

مثال عملي: Monorepo مع Turborepo

افترض أنك تريد إنشاء Monorepo يحتوي على الواجهة الأمامية والخلفية باستخدام Turborepo.

1. تهيئة Monorepo

npx create-turbo@latest

2. الهيكل النموذجي

my-monorepo/
  apps/
    web/        # الواجهة الأمامية Next.js
    api/        # الواجهة الخلفية Node.js/Express
  packages/
    ui/         # مكتبة المكونات المشتركة
    utils/      # دوال مشتركة
  turbo.json
  package.json

3. مثال workspace في package.json

{
  "private": true,
  "workspaces": [
    "apps/*",
    "packages/*"
  ]
}

4. مثال على استيراد مكتبة مشتركة

افترض أن لديك دالة في packages/utils/src/formatDate.ts:

// packages/utils/src/formatDate.ts
export function formatDate(date: Date): string {
  return date.toLocaleDateString('ar-EG');
}

في الواجهة الأمامية:

// apps/web/pages/index.tsx
import { formatDate } from '@myorg/utils';

export default function Home() {
  return <div>اليوم هو {formatDate(new Date())}</div>;
}

متى تختار Monorepo؟

• فرق متوسطة إلى كبيرة تعمل على مشاريع مترابطة.
• الحاجة لمشاركة الكود وإعادة هيكلة واسعة النطاق.
• مشاريع تنمو بسرعة وتتطلب بناء/اختبار محسن.

متى تختار Polyrepo؟

• مشاريع صغيرة أو مستقلة.
• فرق منفصلة تعمل على منتجات مختلفة.
• سياسات وصول شديدة التقييد.

الخلاصة

لا توجد حل مثالي للجميع. يعتمد الاختيار على حجم الفريق، وتعقيد المشاريع، واحتياجات التعاون. الأهم هو إدراك المزايا والعيوب واختيار الأدوات المناسبة لإدارة التعقيد.