الوحدة 6 — التوثيق: بطاقات النماذج وأوراق بيانات مجموعات البيانات
النموذج بلا وثائق يشبه دواءً بلا نشرة داخليّة. من دون توثيق منظَّم، لا يستطيع المدقّق أن يعرف: من الّذي بنى النموذج، على أيّ بيانات، لأيّ استخدام، وبأيّ حدود. تُعرّف هذه الوحدة القالبَين المعياريَّين — بطاقة النموذج (ميتشل وآخرون، 2019) وورقة البيانات (غيبرو وآخرون، 2021) — وتُقدّم مثالًا مكتوبًا للخيط الأحمر.
بطاقة النموذج: قالب من عشرة أقسام
اقترحت مارغريت ميتشل وزملاؤها في غوغل، ثمّ لاحقًا في Hugging Face، قالبًا موحَّدًا للنماذج. الأقسام العشرة الأساسيّة:
1. تفاصيل النموذج: الاسم، والإصدار، والفريق المسؤول، والتاريخ، والترخيص.
2. الاستخدامات المشمولة والمستثناة: هذا القسم الأهمّ. «هذا النموذج مصمَّم لتقييم قروض استهلاكيّة بين 500 و20 000 يورو، للراشدين المقيمين في الاتّحاد الأوروبيّ. لا يجب استخدامه للقروض العقاريّة، ولا للقروض المهنيّة، ولا خارج الاتّحاد الأوروبيّ».
3. المتغيّرات: قائمة كاملة، مع مصدر كلّ متغيّر ودلالته، وأيّها متغيّرات محميّة، وأيّها متغيّرات استبدال محتملة (كما شخّصتها الوحدة 2).
4. البيانات المستخدَمة للتدريب: يشير إلى ورقة البيانات المُلحقة.
5. مقاييس الأداء: الدقّة، ومساحة تحت المنحنى، والاسترجاع، والتحديد؛ إجمالًا ومُقسَّمًا حسب الفئات الفرعيّة (الجنس، والفئة العمريّة، والقطاع، إلخ).
6. مقاييس الإنصاف: القيم المُقاسة بـFairlearn (الوحدة 3)، والمقياس المُختار، وحدّ التسامح.
7. تقييمات الأخلاقيّات والسلامة: هل أُجري تحليل مخاطر رسميّ؟ ما هي المخاطر المُعرَّفة؟ ما التخفيفات؟
8. القيود المعروفة: كلّ ما لا يعمل: لا يعمل جيّدًا على الفئة الع مريّة 18–24 (ناقصة التمثيل)، ولا على القطاعات الحرّة (بيانات صاخبة).
9. توصيات النشر: هل يعمل تلقائيًّا أم يعرض على مستشار؟ ما هو مسار الطعن؟ ما هي عتبات الإنذار؟
10. تاريخ التحديثات: كلّ نسخة، والفارق عن السابقة.
نموذج مكتوب: بطاقة نموذج القرض
# بطاقة النموذج : credit-consumer-v2.3
## تفاصيل النموذج
- المؤلّف: فريق مخاطر الائتمان، بنك مثال
- التاريخ: 2026-09-06
- الإصدار: 2.3
- الترخيص: داخليّ، غير قابل للتوزيع
- نوع النموذج: تعزيز تدرّجيّ بأشجار (LightGBM)
## الاستخدامات
✅ المشمول: قروض استهلاكيّة، 500 - 20 000 يورو، اتّحاد أوروبيّ، أفراد راشدون.
❌ المستثنى: قروض عقاريّة، قروض مهنيّة، خارج الاتّحاد.
❌ المستثنى: مقارنة المرشّحين للتوظيف، تقييم أسر بأكملها.
## الأداء
- المساحة تحت المنحنى (ROC): 0.847 على العيّنة الاختباريّة
- الدقّة عند العتبة 0.5: 0.812
- استرجاع الفئة «مسدَّد»: 0.891
## الأداء حسب الفئات الفرعيّة
| الفئة | حجم | مساحة تحت المنحنى |
| --- | --- | --- |
| ذكور | 47 800 | 0.851 |
| إناث | 52 200 | 0.842 |
| 18-24 | 9 100 | 0.783 ⚠️ |
| 25-45 | 63 200 | 0.858 |
| 46-65 | 27 700 | 0.849 |
## الإنصاف
- المقياس المُختار: تكافؤ الفرص
- عتبة التسامح: 0.03
- القيمة المُقاسة: 0.02 (بعد التخفيف بـExponentiatedGradient)
- التكافؤ الديمغرافيّ الملحوظ: 0.09 (خارج المقياس المختار)
## القيود المعروفة
- ضعف الأداء على 18-24 (ناقصة التمثيل)
- عدم التقييم على العمّال الحرّين (< 3 % من العيّنة)
- الحدّ الأقصى للقيمة المُقترَحة: 20 000 يورو
ورقة بيانات: كيف وُلدت البيانات
بطاقة النموذج لا تكفي: تجيب عن «ماذا يفعل هذا النموذج»، لا عن «من أين تأتي بياناته». ورقة البيانات (Datasheet for Datasets) تُغطّي الجانب الثاني بسبعة أقسام:
- الدافع: لماذا أُنشئت هذه القاعدة؟ من طلبها؟
- التركيبة: ما نوع كلّ سجلّ؟ كم عددهم؟ ما هي المتغيّرات؟
- الجمع: كيف جُمعت البيانات؟ في أيّ فترة؟ ما نسبة التغطية؟
- التوسيم: من وسم البيانات؟ بأيّ إجراء؟ ما تدابير مراقبة الجودة؟
- الاستخدامات: للأيّ مهامّ صُمِّمت؟ لأيّها لا ينبغي استخدامها؟
- التوزيع: من له الحقّ في الوصول؟ تحت أيّ ترخيص؟
- الصيانة: من يواصل تحديثها؟ متى ستُتلَف؟
الفارق بين توثيق «شكليّ» وتوثيق «مفيد»
توثيق شكليّ يقول «الن موذج مصمَّم للقروض الاستهلاكيّة». توثيق مفيد يقول: «صُمِّم للقروض بين 500 و20 000 يورو للاتّحاد الأوروبيّ؛ رأينا في الاختبار الوطنيّ في المغرب انخفاض المساحة تحت المنحنى إلى 0.71 بسبب اختلاف توزيع الدخل».
الفرق يعود إلى قبول الاعتراف بالحدود صراحةً. توثيق يخفي القيود يُنتج ثقة مزيَّفة، ويُنتج مخاطر حين يتبنّى فريق جديد النموذج خارج مجاله.
لا تقبل نموذجًا في الإنتاج بلا بطاقة نموذج مكتوبة ومقروءة على صفحة واحدة. لا تقبل قاعدة بلا ورقة بيانات. الوقت المُستثمَر في هذا التوثيق يُوَفَّر عشر مرّات في المراجعة السنويّة.
الخلاصة
- بطاقة النموذج تصف من صنعه، ولأيّ استخدام، وبأيّ حدود، وبأيّ أداء مُقسَّم على الفئات الفرعيّة.
- ورقة البيانات تصف من أين تأتي البيانات، وكيف جُمعت ووُسمت، ومَن يصونها.
- الاستخدامات المستثناة أهمّ من المشمولة: صراحة رفض الاستخدامات الخاطئة تحمي المشروع من الانحرافات.
- التوثيق المفيد يعترف بالحدود صراحةً؛ التوثيق الشكليّ يُنتج ثقة مزيّفة ومخاطر لاحقة.
الوحدة القادمة: الإشراف البشريّ، والفارق بين الإنسان «في الحلقة» والإنسان «فوق الحلقة»، وبناء إجراء طعن حقيقيّ.