نظافة المستودع

يحتوي التحكّم بالإصدارات في DispatchAtlas على مصدر، واختبارات، وتهيئة، وتوثيق، وبيانات وصفية قابلة للتكرار مكتوبة يدويًّا. وتبقى مُنتَجات التنفيذ المحلية خارج Git ما لم ترفعها سياسةٌ صراحةً إلى مصدر.

🧹 سياسة المخرجات المُولَّدة

بيانات التجارب المُولَّدة، ونقاط التفتيش، وحِزَم النتائج، وتقارير التغطية، ومخرجات بناء التوثيق، ومُنتَجات الحزمة، ومرشّحات الإصدار، تُتجاهَل افتراضيًّا. وتُعاد توليدها من المصدر وتُسجَّل عبر المنشأ حين ترفعها بوّابات لاحقة.

تتطلّب الملفات المُولَّدة المتعقَّبة:

• مالك مصدر.
• أمر إعادة توليد.
• مسوّغ احتفاظ.
• مسار مراجعة للمخرجات البائتة.

🗃️ سياسة التخزين المؤقّت

تُتجاهَل ذواكر التخزين المؤقّت المحلية من Python وRuff وmypy وpytest والتغطية وعمليات بناء التوثيق والبيئات الافتراضية. يجوز لـ CI تخزين الاعتماديات مؤقّتًا، لكن يجب أن تُشتقّ مفاتيح الذاكرة المؤقّتة من ملفات القفل ومدخلات سير العمل.

🔬 سياسة مخرجات التجارب المحلية

تكتب تشغيلات التجارب المحلية إلى طبقات المخرجات المُتجاهَلة لمساحة عمل التجارب — نتائج التشغيل، والسجلّات، ونقاط التفتيش، وحِزَم الأدلّة، كما هي مُرتَّبة في README مساحة العمل نفسها — إلى جانب مواقع مسوّدة مُتجاهَلة أخرى مثل outputs/ أو artifacts/. وتُنتَج أدلّة البحث النهائية عبر أوامر حملة وتحليل مُتحقَّق منها قبل أي استخدام عامّ.

📋 قواعد الاحتفاظ بالمُنتَجات