توثيق الموديولز
الاتصالات بين الموديولز
أي موديولز أخرى تطرح إشارات هنا ولماذا.
التغطية مساهم ثقيل في الـ cross-module graph رغم وجود رابط هيكلي واحد فقط (parentEventId). عبر مصفوفات الإشارة الاختيارية الأربع، مقالة تغطية واحدة يمكنها الاتصال بـ 10-30 مؤسّس + شركة + فرصة + ملف. البحث العكسي يُغذّي شرائط "Mentioned in coverage" على كل ملف entity مُتَّصِل.
الوصلات الخمس
- التغطية → التقويم (T1 هيكلي)
- parentEventId — مطلوب، لا null أبداً. الرابط cross-module الوحيد غير-الاختياري في المنصّة. على صفحة تفاصيل الفعالية، كل مقالة تغطية بهذا الوالد تُرسَم ككرت في قسم "Coverage".
- التغطية → المؤسّسون (T2 تحريري)
- mentionedFounderIds[]. كل إدخال يَبرز كـ pill ملف في الشريط الجانبي للمقالة. على ملف المؤسّس، البحث العكسي يُنتج شريط "Mentioned in coverage".
- التغطية → الشركات (T2 تحريري)
- mentionedStartupIds[]. نفس معالجة pill الشريط الجانبي. على صفحة تفاصيل الشركة، شريط "Mentioned in coverage" يَبرز كل مقالة سَمَّت الشركة.
- التغطية → الفرص (T2 تحريري)
- mentionedOpportunityIds[]. عادة مُستخدَم حين تَنقل التغطية نواتج تَربط بفرصة (مثلاً "الفائزون مدعوّون للتقديم لدفعة [الفرصة] التالية"). البحث العكسي على الفرصة يُبرز صلة التغطية السابقة.
- التغطية → Founder Files (T3 سياقي)
- mentionedFileIds[]. مُستخدَم حين Founder File تَوَزَّع أو رُجِع إليه في الفعالية. البحث العكسي يُغذّي كتلة "Coverage that references this file" على صفحة تفاصيل الملف.
لماذا الإشارات entity-مُكَتَّبة (ليست نصّاً حرّاً)
المحرّرون يَستطيعون نظرياً مجرد كتابة أسماء المؤسّسين/الشركات في الـ bodyHtml كنصّ حرّ. بدلاً من ذلك، مصفوفات الإشارة تُجبر المحرّر على اختيار الـ entity الفعلية من منتقي بحث عند المسودَّة. هذا يَشتري شيئَيْن: (1) البحث العكسي يَعمل — مؤسّس مذكور في 5 مقالات تغطية يَحصل تلقائياً على شريط "Mentioned in 5 coverage articles" بدون أيّ توصيل إضافي، (2) تهجئة الاسم تَبقى قياسية — لو مؤسّس مُسَمَّى "Ahmed Hassan" على ملفّه، كل إشارة تَرسم تلقائياً تلك التهجئة بدلاً من المخاطرة بـ "Ahmad Hasan" / "A. Hassan" / إلخ تَنافضات عبر المقالات.
