كيف تقرّر متى تُعيد الهيكلة (refactor) مقابل إعادة كتابة (rewrite) نظام من الصفر؟

Question

Accepted Answer

الافتراضي هو **إعادة الهيكلة**. إعادة الكتابة مبرَّرة فقط عندما لا يعود النظام الحالي قادراً على التطوّر لتلبية المتطلبات بكلفة مقبولة، وعندما تستطيع الاستمرار في تسليم القيمة أثناء ذلك. معظم غرائز "نحتاج إعادة كتابة" هي في الحقيقة مشكلة tech debt غير مُدارة تحلّها إعادة الهيكلة التدريجية بمخاطر أقل بكثير.

## كيف أفكّر في الأمر

- **هل البنية المعمارية الأساسية لا تزال قابلة للحياة؟** إذا كان نموذج البيانات والحدود والـ runtime يمكن أن تتمدّد للمتطلبات الجديدة، أعِد الهيكلة. إذا كانت الافتراضات التأسيسية خاطئة (نموذج تخزين خاطئ، لا طريقة للتوسّع، نهاية عمر اللغة/المنصة)، تصبح إعادة الكتابة مرشّحاً حقيقياً.
- **ما تردد التغيير؟** الكود الذي نادراً ما يتغيّر لا يحتاج أن يكون جميلاً. ركّز الجهد حيث يعمل الفريق يومياً.
- **هل نفهم السلوك الحالي؟** إعادة الكتابة ترمي سنوات من معرفة الحالات الحدّية المشفّرة. إذا لم تكن هناك اختبارات ولا مواصفات، فإن إعادة الكتابة ستعيد إدخال أخطاء قديمة.

## إطار قرار

| الإشارة | ميِّل لإعادة الهيكلة | ميِّل لإعادة الكتابة |
| --- | --- | --- |
| البنية المعمارية تناسب المتطلبات | نعم | لا |
| تغطية الاختبار/المواصفات | منخفضة أو عالية | عالية بما يكفي للتحقق من التكافؤ |
| يمكن الشحن تدريجياً | نعم | صعب، دفعة واحدة |
| الفريق يفهم الكود | نعم | لا، والمؤلّفون الأصليون رحلوا |

## المفاضلات

- **إعادة الهيكلة:** مخاطر أقل، تسليم مستمر، لكن بطيئة على أساس متعفّن فعلاً.
- **إعادة الكتابة:** صفحة بيضاء، لكنك تدفع **ضريبة تجميد الميزات**، وتحمل **كلفة صيانة مزدوجة**، وتخاطر بفخّ الإفراط في هندسة النظام الثاني الكلاسيكي.
- فضّل المسار الوسط **strangler-fig**: أقِم النظام الجديد بجانب القديم، وجّه الـ traffic تدريجياً، واحذف القديم قطعة قطعة. يمنح فوائد إعادة الكتابة بمستوى مخاطر إعادة الهيكلة.

## مزالق

- إعادة الكتابة لأسباب **جمالية أو مدفوعة بالسيرة الذاتية**، لا بكلفة العمل.
- التقليل من شأن السلوك الخفي؛ وصّف السلوك الحالي بالاختبارات أولاً دائماً.
- إعادة كتابة دفعة واحدة تمتدّ أرباع سنة لا تشحن شيئاً — ينهار الزخم والثقة معاً.

## لماذا يهم

قرار إعادة الهيكلة مقابل إعادة الكتابة من أعلى القرارات رافعةً التي يتّخذها الـ Tech Lead. أخطئ نحو إعادة الكتابة وقد تجمّد التسليم لعام وتفشل رغم ذلك؛ أخطئ نحو إعادة الهيكلة وتنزف السرعة ببطء. صياغته كقرار كلفة ومخاطرة، لا قرار ذوق، هو ما يفصل حكم الـ senior عن التفضيل.

الإشارة	ميِّل لإعادة الهيكلة	ميِّل لإعادة الكتابة
البنية المعمارية تناسب المتطلبات	نعم	لا
تغطية الاختبار/المواصفات	منخفضة أو عالية	عالية بما يكفي للتحقق من التكافؤ
يمكن الشحن تدريجياً	نعم	صعب، دفعة واحدة
الفريق يفهم الكود	نعم	لا، والمؤلّفون الأصليون رحلوا

كيف أفكّر في الأمر

إطار قرار

المفاضلات

مزالق

لماذا يهم

question.related