توثيق الموديولز

حقول البيانات

الكيانات، الحقول، الأنواع.

مكتمل

الواجهة CalendarEvent (core/models/calendar-event.model.ts:98) هي مصدر الحقيقة الوحيد لكل سجلّ فعالية. 30+ حقل مُكتَّب مُجَّمَع في 11 كتلة منطقية: الهوية، النصّ التحريري، المنظِّم، الموقع، الزمن، التصنيف، URLs الفعل، الإعلام، الحجّية، القرارات التحريرية، مراجع Cross-Module، SEO، التدقيق.

كتل الحقول

الهوية: id (سلسلة، داخلي)؛ slug (URL kebab-case، EN قياسي)؛ title (Bilingual). الـ slug هو الحقل الوحيد الذي يظهر في URLs المرئية للمستخدم.
النصّ التحريري: shortDescription (≤200 حرف، Bilingual)؛ fullDescription (markdown مسموح)؛ whyItMatters (فقرة تحريرية اختيارية).
المنظِّم: organizerName + organizerType (Accelerator/Incubator/VC/Corporate/Government/University/Community/Media/Other) + organizerLogoUrl + organizerWebsite.
الموقع: country (CountryCode — 16 رمز MENA)؛ city؛ venue؛ venueAddress؛ geo {lat,lng}؛ onlineUrl؛ mode (physical/online/hybrid). للفعاليات الـ online، country + city ما زالا مطلوبَيْن (يدلّان على قاعدة المنظِّم).
الزمن: startDate (ISO 8601)؛ endDate (اختياري)؛ timezone (مثلاً "Africa/Cairo")؛ registrationDeadline؛ applicationDeadline. الحالة تُحتسَب منها — انظر status-badge-logic.
التصنيف: category (1 من 17 قيمة EventCategory)؛ status (1 من 7 قيم EventStatus)؛ audiences[] (1+ من 9)؛ stageRelevance[] (1+ من 7)؛ industries[] (tags سلسلة حرّة).
URLs الفعل: websiteUrl، registrationUrl، applyUrl، contactEmail، socialLinks {twitter,linkedin,instagram}. على الأقل واحد من websiteUrl / registrationUrl / applyUrl مطلوب (وإلا الفعالية لا تستطيع التقمّع لأيّ مكان).
الحجّية: sourceUrl (URL خارجي ذي سلطة)؛ verificationStatus (pending/verified/rejected/needs_info)؛ lastVerifiedAt (ISO 8601 — متى أعاد محرّر التأكيد على الإدخال).
القرارات التحريرية: editorialPriority (standard/featured/spotlight — يقود وضع الهبوط)؛ coverageEligible (boolean)؛ coverageStatus (not_planned/planned/covered) — يُغذّي طابور تغطية الفعاليات.
مراجع Cross-Module: relatedEditorialIds[]؛ relatedStartupIds[]؛ relatedFounderIds[]؛ relatedOpportunityIds[]؛ relatedFileIds[]. كلها اختيارية. الفعاليات غير الموصولة تُرسَم بدون كتلة الشريط الجانبي.
SEO + التدقيق: metaTitle، metaDescription (Bilingual — تَخطّي الافتراضيات)؛ createdAt، updatedAt، publishedAt (ISO 8601).