Data Model

10 جداول: FounderFile أساسي + FounderFileLang + 3 جداول فرعية (LearningPoints، BestFor، Artifacts) + 2 جداول join (Authors، Topics) + Sponsor + FounderFileLead + FounderFileReadSession. سجلّ الموافقة على FounderFileLead حامل-للحمل لـ GDPR/PDPL — لا تَحذف أبداً، لا تَتجاوز أبداً.

الجدول 1 · FounderFile (أساسي)

Id، Slug، Number

Id (uuid PK)، Slug (varchar(120) unique)، Number (varchar(8)، مثل "FF#04"، مضبوط تلقائياً).

Category، ReadingTimeMinutes

Category enum (strategy | operations | fundraising | product | sales | leadership | hiring). ReadingTimeMinutes (int، محتسبة من عدد كلمات الجسم، مُسوَّى للعرض السريع على الكرت).

CoverImageUrl، SponsorId، IsFeatured، IsActive

Cover: 3:4 portrait. Sponsor FK nullable (معظم الملفات غير-مدفوعة). IsFeatured يَقود banner B على القائمة.

DownloadCount

زيادة ذرّية عند كل POST ناجح لـ /api/founder-files/{id}/leads. يَقود فرز "most-downloaded".

PublishedAt، CreatedAt، UpdatedAt

طوابع زمنية قياسية.

الجداول 2-10 · الرفقاء

• FounderFileLang (PK مُرَكَّب FounderFileId + Lang): Title، BestForTagline، Subtitle?، MetaTitle?، MetaDescription?، ReaderBodyHtml (HTML مُعَقَّم).
• FounderFileBestForBullet (FK FounderFileId، DisplayOrder، رفيق lang: Text).
• FounderFileLearningPoint (FK FounderFileId، DisplayOrder، رفيق lang: Text).
• FounderFileArtifact (FK FounderFileId، ArtifactType: pdf | template | checklist | spreadsheet، FileUrl، FileSize، DisplayOrder، lang: Label).
• FounderFileAuthor (join: FounderFileId ↔ FounderId، DisplayOrder).
• FounderFileTopic (join: FounderFileId ↔ TopicCode).
• Sponsor (Id، Name، LogoUrl، Tier: gold/silver/bronze، ContractExpiry، ConsentPartnersWebhookUrl).
• FounderFileLead (Id، FounderFileId، Email، Name، Role، Country، Stage?، ConsentPlatform، ConsentPartners، Source: 'details' | 'reader'، CreatedAt، IpAddress، UserAgent).
• FounderFileReadSession (SessionId، FounderFileId، LeadId?، FirstViewAt، LastViewAt، ScrollDepthPct، CompletedAt?) — تحليلات-فقط، ليست حسّاسة لـ GDPR (مجهولة ما لم يَكن العميل مُرفَق).