ماذا يعني source في V2؟
يحدد الحقل source المسار الذي أنتج النتيجة النهائية: بحث في مجموعة بيانات مخزَّنة، أو تقدير بالذكاء الاصطناعي، أو عدم اختيار أي مصدر. وهو ليس إحالة إلى الناشر الأصلي لمجموعة بيانات، ولا شهادة ترخيص، ولا ضمانًا لصحة التقدير.
يصف هذا الدليل عقد استجابة V2 الحالي وملفًا لقاعدة البيانات أعدّته GenderAPI.io بنفسها. الملاحظات أدناه جرد وفحوص اتساق مقيسة؛ أما فهرس المصادر الأصلية المراجَع وتقييم الدقة المستقل فلم يُنشرا بعد.
| source | ما يخبرك به | ما لا يثبته |
|---|---|---|
dataset | اختير سجل مخزَّن؛ وقد يبقى الجنس غير معروف عند تساوي العددين تمامًا | الناشر الأصلي أو طريقة الجمع أو الترخيص أو عمر السجل أو استقلال الملاحظات |
ai | جاءت الاستجابة النهائية من مسار التقدير بالذكاء الاصطناعي المهيأ؛ وقد تبقى قيمة gender هي null | عينة معدودة أو إحالة إلى مجموعة بيانات أو دقة تقدير معايَرة |
none | لم يُختر أي سجل مخزَّن للنتيجة النهائية في وضع مجموعة البيانات فقط | أن المُدخل لا يرتبط باسم محتمل في أي مجتمع أو لغة |
ملف قاعدة البيانات: 26 سبتمبر 2026
قُرئت البيانات الوصفية للمجموعات في 2026-09-26T15:28:18.227Z، وأُخذت العينات العشوائية في 2026-09-26T15:31:54.045Z. يأتي كل من عددي المستندات من البيانات الوصفية collStats في MongoDB للمجموعة المعنية، لا من عدّ كامل منفصل. تحتوي المجموعة العامة على سجلات أسماء، وتحتوي المجموعة الخاصة بالدول على أزواج من الاسم والدولة. لا تجمع العددين للحصول على إجمالي للأسماء الفريدة أو للأشخاص الفريدين.
لكل مجموعة، اختار MongoDB عشوائيًا 5,000 مستند وأجرى الفحوص الإجمالية أدناه على خادم قاعدة البيانات. لا يتضمن التقرير العام أي أسماء أو بيانات خام. هذه ملاحظات أجرتها GenderAPI.io على قاعدة بيانات الإنتاج، وليست تدقيقًا مستقلًا ولا مجموعة بيانات تقييم مجمَّدة. تفحص هذه الفحوص اتساق الأعداد، لا دقة التقديرات ولا عدد الأشخاص أو الأسماء الفريدة ولا تغطية API.
| الملاحظة | السجلات العامة | السجلات الخاصة بالدول |
|---|---|---|
| المجموعة | general | country-specific |
| عدد المستندات في البيانات الوصفية | 2,483,220 | 4,080,692 |
| المفتاح الفريد المخزَّن | name | name + country |
| المستندات المختارة عشوائيًا | 5,000 | 5,000 |
| إخفاقات القواعد الرقمية في العينة | 0 | 0 |
| اختلاف male + female عن total في العينة | 0 | 0 |
| تساوي عددي male وfemale في العينة | 124 | 94 |
| وجود الحقل updated_at في العينة | 667 / 5,000 | 741 / 5,000 |
ما تثبته فحوص قاعدة البيانات
يشترط الفحص الرقمي أن تكون قيمة total عددًا صحيحًا آمنًا موجبًا، وأن يكون عددا male وfemale قيمتين محدودتين بين الصفر وtotal. ويقارن فحص منفصل male + female بقيمة total. اجتازت كل الأعداد في العينتين هذه الفحوص؛ ولا يعني ذلك أن كل سجل في المجموعات متسق أو أن أي تقدير صحيح.
تساوى عددا male وfemale في 124 صفًّا من عينة المجموعة العامة و94 صفًّا من عينة المجموعة الخاصة بالدول. هذه حالات تساوٍ في الأعداد المخزَّنة، وليست هويات ملتبسة جرى التحقق منها بشكل مستقل ولا معدلًا للنتائج غير المعروفة في API. تعتمد نتائج API الفعلية على المُدخلات وتوفر Redis واختيار المرشحين وإعدادات الذكاء الاصطناعي.
في جرد منفصل للحقل country في المجموعة العامة بتاريخ 2026-09-26T15:33:13.811Z، وُجدت 244 قيمة مخزَّنة مختلفة: 239 منها بصيغة حرفين كبيرين و5 بصيغة أخرى. لم تُقَس المطابقة مع ISO ولا توزيع السجلات حسب الدولة ولا تغطية الدول المدعومة. ولا تمثل هذه الأرقام عدد الدول المدعومة.
لم تظهر حقول للمصدر أو للترخيص في العينتين. ولا يثبت ذلك غياب معلومات المصدر عن كل سجل أو عن الأنظمة الخارجية: فوجود حقل أو غيابه لا يثبت ترخيص مصدر ما. ظهر الحقل updated_at في بعض السجلات بقيمة رقمية، لكن قيمه ومعناه لم يُفحصا؛ ولا يدل على حداثة البيانات أو على جدول تحديث.
يجري V2 عمليات البحث في مجموعة البيانات من Redis. وفي 26 سبتمبر 2026 أكدت GenderAPI.io، بصفتها مشغّل النظام، أن MongoDB وRedis يحتويان على مجموعة البيانات نفسها. يستند هذا التطابق إلى ذلك التأكيد: لم تُجرَ بعد مقارنة مستقلة بين قاعدتي البيانات، ولا يزال هذا الفحص معلّقًا. يصف الجرد أعلاه السجلات المخزَّنة؛ أما تغطية استجابات API فتعتمد أيضًا على المُدخلات المُرسلة ومطابقة المرشحين وإعدادات الذكاء الاصطناعي. أُخذت العينات دون بذرة ثابتة، وقُرئت دون لقطة مجمَّدة، ولم تكن لها تسميات مرجعية مستقلة؛ لذا لا يمكنها قياس دقة التقدير أو المعايرة أو تغطية الإجابات.
تتبّع الأدلة في الاستجابة
| الحقل | المعنى | الحد |
|---|---|---|
input | يعيد نوع الإدخال وقيمته وسياق الدولة المُرسل | قيمة الإدخال ليست معلومات هوية جرى التحقق منها بشكل مستقل |
match.name / match.method | يعرض المرشح المختار للبحث، وما إذا كان قد طُبِّع أو استُخرج جزءًا أو جزءًا من سلسلة أو استنتجه نموذج | لا تضمن مطابقة جزء من الاسم استخراج الاسم الشخصي الحقيقي من اسم كامل أو من اسم مستخدم |
match.scope / match.country | يوضح ما إذا كان الصف المخزَّن المختار قد جاء من بحث خاص بالدولة أو من بحث عام | لا يضمن إرسال دولة توفر صف خاص بها |
sample_count | العدد الإجمالي المخزَّن في الصف المختار؛ وnull في تقديرات الذكاء الاصطناعي | لا يمثل بالضرورة أشخاصًا فريدين أو ملاحظات مأخوذة بشكل مستقل أو حجم تقييم للدقة |
confidence / confidence_kind | يميّز النسبة المحسوبة من الأعداد المخزَّنة من القيمة التي يقدّمها النموذج | لا تمثل أيٌّ من القيمتين احتمالًا موثَّقًا للهوية الجندرية لشخص ما |
country / country_source | البيانات الوصفية للدولة في السجل المُعاد، أو ارتباط اسم بدولة يقدّمه الذكاء الاصطناعي، عند توفرهما | ليس جنسية ولا مكان إقامة ولا أصلًا موثَّقًا، ولا يثبت أن دولة الإدخال قد طوبقت |
كيف تؤثر مطابقة المُدخل في النتيجة
يطبّع البحث في مجموعة البيانات النص ويستخرج منه أجزاء مرشحة. في عناوين البريد الإلكتروني تُستخرج المرشحات من الجزء المحلي، وفي أسماء المستخدمين تُزال علامة @ الاختيارية في البداية. ويمكن للبحث العادي في البريد الإلكتروني واسم المستخدم أن يجرّب أيضًا مرشحين محدودين من أجزاء السلسلة. إذا توفرت عدة سجلات مرشحة، يُختار السجل صاحب أعلى عدد إجمالي مخزَّن. وقد يؤدي ذلك إلى اختيار جزء غير الاسم الشخصي المقصود.
عند إرسال سياق دولة، يجرّب البحث صف الدولة لكل مرشح، ويستخدم الصف العام إذا لم يوجد صف الدولة. تعرض النتيجة النهائية المطابقة المختارة. ولا يُستبدل صف الدولة الملتبس تلقائيًا بالصف العام للمرشح نفسه.
تطلب التعليمات العادية الموجَّهة إلى الذكاء الاصطناعي اسمًا شخصيًا يمكن التعرف عليه. أما forceToGenderize فيسمح أيضًا بالارتباطات عبر الألقاب الشخصية أو الأسماء المستعارة، لذا يُعد الجنس غير الفارغ مع name: null نتيجة صالحة في هذا الوضع. هاتان مهمتا تقدير مختلفتان، وتحتاج كل منهما إلى تقييم منفصل.
البحث في مجموعة البيانات والمعالجة بالذكاء الاصطناعي
عند استخدام الذكاء الاصطناعي، يرسل V2 القيم المُرسلة type وvalue وسياق الدولة إلى خدمة التقدير بالذكاء الاصطناعي المهيأة. في عناوين البريد الإلكتروني، تطلب التعليمات من النموذج تجاهل النطاق واللاحقة التي تلي علامة الجمع؛ ولا يعني ذلك وعدًا بإزالة هذه الأحرف من القيمة قبل المعالجة بالذكاء الاصطناعي. استخدم ai_mode: off دون forceToGenderize عندما يتطلب سير عملك تقديرًا يعتمد على مجموعة البيانات فقط.
يتحقق فحص استجابة الذكاء الاصطناعي من حقول JSON وأنواعها واتساقها فيما بينها. ولا يثبت أن الاسم أو ارتباط الجنس أو ارتباط الدولة المُعاد صحيح فعلًا. ولا تتضمن النتيجة العامة معرّف النموذج أو إصداره أو مرجعًا يدعم تقديره.
| الخيار | مسار التقدير | الأدلة المُعادة |
|---|---|---|
| ai_mode: off | يستخدم البحث في مجموعة البيانات فقط | البيانات الوصفية لمجموعة البيانات المختارة، أو نتيجة غير معروفة دون سجل مختار |
| ai_mode: fallback | يبحث في مجموعة البيانات أولًا، ثم يستخدم الذكاء الاصطناعي إذا لم يُعَد جنس | أدلة المسار النهائي، لا عينة مجمّعة من مجموعة البيانات والذكاء الاصطناعي |
| ai_mode: always | يستخدم مسار التقدير بالذكاء الاصطناعي المهيأ مباشرة | قيمة يقدّمها النموذج أو نتيجة غير معروفة مع confidence قيمتها null؛ وقيمة sample_count دائمًا null |
| forceToGenderize: true | يبحث في مجموعة البيانات، ثم يستخدم ذكاءً اصطناعيًا يفسّر الأسماء المستعارة إذا لم تُحسم النتيجة | أدلة من مجموعة البيانات أو ارتباط عبر اسم مستعار يقدّمه النموذج؛ وقد تكون قيمة name هي null |
توثيق المصادر الذي لم يُنشر بعد
لا يُنشر هنا فهرس مراجَع للمصادر. ولا يمكن لعقد الاستجابة وسلوك التنفيذ وحدهما التحقق من أصل البيانات أو من الإذن باستخدام مصدر ما أو من تمثيله للمجتمع أو من جودة تسمياته. قبل تقديم ادعاءات تخص مصدرًا بعينه، يجب توثيق الأدلة التالية ومراجعتها.
لا تثبت مراجعة التوثيق هذه أن المصادر الأصلية مرخّصة أو غير مرخّصة، أو مكتملة أو غير مكتملة. بل توضح حدود الأدلة العامة. تواصل مع GenderAPI.io إذا تطلّب استخدامك تقييمًا خاصًا بمصدر معين.
| الدليل | السجل المطلوب | الحالة العامة |
|---|---|---|
| الأصل والاستخدام المسموح به | اسم المصدر أو الناشر، وفترة الجمع، والترخيص أو أي أساس موثَّق آخر للاستخدام | لا يُنشر هنا فهرس مراجَع |
| تسلسل المعالجة | التحويل والتطبيع وإزالة التكرار والتجميع وأي إسهام اصطناعي أو مولَّد بنموذج | لا تكشفه التسمية source: dataset |
| تغطية المجتمعات | تغطية الدول وأنظمة الكتابة، وطريقة الاختيار، وتعريفات التسميات، والتحيز الموثَّق | لا تُنشر هنا أرقام تغطية مقيَّمة بشكل مستقل |
| الحداثة | معرّفات اللقطات، وتواريخ التحديث لكل مصدر، وجدول تحديث معتمد | لا تتضمن استجابة V2 حداثة كل سجل ولا معرّف لقطة |
| الجودة والتصحيح | نتائج التحقق، وفحوص التداخل، والتعامل مع طلبات التصحيح والإزالة، والجهة المسؤولة عن المراجعة | لا تُنشر هنا نتائج تدقيق خاصة بكل مصدر |
الخصوصية والمعالجة والاستخدام المسؤول
أصل المصادر، والتعامل مع البيانات الشخصية، والشروط القانونية مسائل مختلفة. راجع السياسات المنشورة الحالية لمعرفة أدوار المعالجة ومدة الاحتفاظ والمزوّدين والشروط التعاقدية. لا يضيف هذا الدليل التقني التزامًا جديدًا بالاحتفاظ، ولا يشهد بالامتثال القانوني.
أرسل فقط المعلومات التي يحتاجها سير عملك. احتفظ بأنواع درجة الثقة وبالنتائج غير المعروفة، ولا تصف التقدير على أنه هوية صرّح بها الشخص بنفسه. لا تستخدم الجنس المُستنتج أساسًا لقرارات ذات عواقب مهمة على أي فرد.
أدلة الدقة وسجل التغييرات
تشرح تسمية المصدر مسار التقدير، لا جودته المقيسة. استخدم دليل الدقة للتمييز بين درجات الاستجابة وتغطية الإجابات والأخطاء، ولمعرفة المعلومات اللازمة لتقييم قابل لإعادة الإنتاج.
| التاريخ | إصدار المستند | التغيير |
|---|---|---|
| 2026-09-29 | 1.0.0 | النسخة العربية من جرد MongoDB المؤرَّخ، وفحوص الاتساق في العينات، وحقلي source وmatch في V2، وحدود المعالجة بالذكاء الاصطناعي، والفجوات المتبقية في فهرس المصادر. يستند تطابق MongoDB وRedis إلى تأكيد GenderAPI.io بتاريخ 26 سبتمبر 2026؛ ولا تزال المقارنة المستقلة معلّقة. لم تُضف أي نسبة دقة ولا أي ادعاء بشأن ترخيص المصادر. |