دليل النجاة مع الكود الموروث (Legacy Code Survival Guide): إزاي تتعامل مع كود مش بتاعك من غير ما تنهار؟

أكيد مريت بالموقف ده: جالك مشروع جديد، فتحت ملفات الكود، ولقيت نفسك قدام كود موروث (Legacy Code) عبارة عن "عك" برمجي من غير أي توثيق (Documentation)، والأسوأ إنك خايف تلمس أي سطر كود عشان السيستم كله ما يقعش. الشعور ده طبيعي جداً، وكل مبرمج شاطر بيقابله في مسيرته المهنية. في المقال ده، هناخدك في رحلة عملية عشان تحول الكود القديم ده من كابوس لميزة تنافسية.

يعني إيه أصلاً كود موروث (Legacy Code)؟

ببساطة، الكود الموروث مش هو الكود القديم وبس، ده أي كود تم كتابته بمعرفة مبرمج تاني (أو حتى أنت من سنتين) ومافيش عليه اختبارات تلقائية (Automated Tests) تغطيه. التعامل مع النوع ده من الكود بيحتاج "نفس طويل" وخطة مدروسة، مش مجرد "مسح وإعادة كتابة".

الخطوة الأولى: ما تلمسش أي حاجة قبل ما تفهم

أكبر غلطة بيقع فيها المبرمجين هي "الاندفاع". أول ما تشوف دالة (Function) مكتوبة بشكل غلط، نفسك بتميل إنك تمسحها وتكتبها من جديد. استنى شوية! الكود ده شغال حالياً وبيدخل فلوس للشركة، فممنوع تغيره قبل ما تعمل الخطوات دي:

• اقرأ الكود وحاول ترسم "خريطة تدفق" (Flowchart) للمنطق اللي ماشي عليه.
• استخدم أدوات الـ Debugging عشان تشوف القيم اللي بتدخل واللي بتخرج من الدوال المعقدة.
• اكتب ملاحظاتك (Comments) في ملف جانبي - مش جوه الكود لسه - عشان تفهم الـ Business Logic.

الخطوة الثانية: حائط الحماية (Test Harness)

قبل ما تغير أي سطر، لازم تبني "شبكة أمان". إزاي؟ عن طريق كتابة اختبارات الوحدة (Unit Tests) أو اختبارات التكامل (Integration Tests). لو الكود معقد ومش قابل للاختبار (Untestable)، ابدأ بكتابة اختبارات الحالات الذهبية (Golden Master Testing):

// مثال تخيلي لـ Test بسيط
function testCalculateTotal() {
    const input = { price: 100, tax: 0.1 };
    const expected = 110;
    const actual = legacyFunction(input);
    console.assert(actual === expected, "النتيجة مش مطابقة!");
}

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

الخطوة الثالثة: التحسين التدريجي (Refactoring)

دلوقتي بعد ما بقيت مأمن نفسك بالاختبارات، ابدأ بمبدأ "الكشافة": سيب المكان أنضف مما كان. ما تحاولش تعمل إعادة بناء شامل (Total Rewrite) للنظام، لأن ده غالباً بينتهي بالفشل. اتبع أسلوب الخطوات الصغيرة:

1. قسم الدوال الكبيرة (God Functions) لدوال أصغر وأوضح.
2. غير أسماء المتغيرات (Variable Renaming) عشان تعبر عن وظيفتها بوضوح.
3. طبق مبادئ الـ Clean Code واحدة واحدة.

نصيحة من أخ: الصبر مفتاح الاحتراف

يا صديقي، التعامل مع الكود الموروث هو اللي بيفرق بين "مبرمج المبتدئ" و "المُهندس المحترف". المبتدئ بيشتكي من سوء الكود، والمحترف بيشوفه فرصة عشان يطور مهاراته في تحليل الأنظمة، ويضيف قيمة حقيقية للشركة. خليك هادي، اكتب اختباراتك، وحسن الكود حتة حتة، وفي خلال شهور هتلاقي نفسك حولت المشروع من "متاهة" لمشروع نضيف وممتع في التعامل معاه.

موفق في رحلتك في تنظيف الكود، ولو احتجت أي استفسار تقني، أنا موجود!