التعليمات
مرحبًا بك في فريق الهندسة في Gilded Rose!
كما تعلم، نحن نُزل يشتري ويبيع أجود البضائع فقط.
تتدهور جودة بضائعنا باستمرار مع اقتراب تاريخ انتهاء بيعها، لذلك لدينا نظام مخزون يتتبّع هذه البيانات.
نحتاج منك إلى إضافة ميزة جديدة إلى نظامنا حتى نتمكّن من البدء في بيع فئة جديدة من العناصر.
لكن الكود في حالة فوضى، وسيكون من الصعب إضافة الميزة الجديدة ما لم تُعِد هيكلة الكود الحالي أولًا.
إذن مهمتك من شقّين: إعادة هيكلة نظام المخزون، ثم إضافة الميزة الجديدة.
نظرة عامة على نظام المخزون
إليك أساسيات نظامنا:
- لكل العناصر خاصية
sell in تشير إلى عدد الأيام المتاحة لنا لبيع العنصر.
- لكل العناصر خاصية
quality تشير إلى قيمة العنصر.
- في نهاية كل يوم، يخفض نظامنا القيمتين لكل عنصر.
بسيط جدًا، أليس كذلك؟ حسنًا، هنا يصبح الأمر مثيرًا للاهتمام:
- بمجرد أن يحين تاريخ انتهاء البيع، تتدهور الجودة بسرعة مضاعفة.
- لا تكون جودة أي عنصر سالبة أبدًا.
- تزداد جودة Aged Brie فعليًا كلما زاد عمرها.
- لا تتجاوز جودة أي عنصر 50 أبدًا.
-
Sulfuras، باعتبارها عنصرًا أسطوريًا، ليس لها تاريخ انتهاء بيع، وجودتها 80 لا تنقص أبدًا.
- تزداد جودة Backstage passes، مثل Aged Brie، مع اقتراب تاريخ انتهاء بيعها: تزداد الجودة بمقدار 2 عندما يتبقى 10 أيام أو أقل، وبمقدار 3 عندما يتبقى 5 أيام أو أقل، لكن الجودة تنخفض إلى 0 بعد الحفل.
1. إعادة الهيكلة
لتمهيد الطريق أمام الميزة الجديدة، أعد هيكلة الكود الحالي واجعله أسهل في التعديل.
لا تتردد في إجراء أي تغييرات وإضافة أي كود جديد ما دام كل شيء لا يزال يعمل بشكل صحيح (أي ما دامت اختبارات الميزات الحالية لا تزال تنجح).
ملاحظة: يمكنك أن تفترض أن العناصر تبدأ دائمًا بجودة صالحة.
بعبارة أخرى، لا تتحقق الاختبارات الآلية مما يحدث عندما تكون الجودة الأولية لعنصر أعلى من الحد الأقصى، أو عندما تكون الجودة الأولية لـ Sulfuras قيمة غير 80.
2. إضافة الميزة الجديدة
تعاقدنا مؤخرًا مع مورّد لعناصر Conjured.
مهمتك هي إضافة القواعد التالية إلى نظامنا:
- تنخفض جودة عناصر Conjured إلى 0 بمجرد أن يحين تاريخ انتهاء بيعها. بالإضافة إلى ذلك:
- تتدهور جودة العناصر العادية من نوع Conjured بسرعة مضاعفة مقارنة بالعناصر العادية التي ليست Conjured.
-
Conjured Sulfuras لها تاريخ انتهاء بيع، بخلاف Sulfuras التي ليست Conjured.
- تزداد جودة Conjured backstage passes بمقدار 1 أقل مما لو لم تكن Conjured.
