SyncSaaS — دليل سير العمل الكامل

System architecture, data flow, and control guide

العمارة العامة

src/data/tools.json          ← المصدر الوحيد للبيانات
       │
       ▼
src/lib/tools.ts             ← قراءة JSON، فلترة، بحث
src/lib/blog.ts              ← توليد المقالات والمراجعات والمقارنات
src/lib/seo.ts               ← عناوين SEO، وصف، canonical
src/lib/schema.ts            ← JSON-LD structured data
       │
       ▼
src/pages/                   ← صفحات Astro (HTML ثابت)
  ├── index.astro             ← الصفحة الرئيسية
  ├── 404.astro
  ├── alternatives/index.astro  ← دليل الأدوات مع بحث/فلتر
  ├── alternatives/[slug].astro ← صفحة أداة فردية (75 صفحة)
  ├── category/[slug].astro    ← صفحة تصنيف (22 صفحة)
  ├── blog/index.astro         ← قائمة المقالات
  ├── blog/[slug].astro        ← مقالة مراجعة/مقارنة
  ├── about.astro, contact.astro, privacy.astro, terms.astro
       │
       ▼
dist/                        ← الإخراج النهائي (HTML ثابت)
  sitemap-index.xml           ← يتولد تلقائيًا

سير العمل اليومي

1 عدّل src/data/tools.json

2 شغّل npm run build

3 ارفع dist/ على السيرفر

إضافة أداة جديدة

#	الخطوة	المسار
1	أضف إدخال JSON	`src/data/tools.json`
2	ضع اللوغو (اختياري)	`public/images/tools/[slug].svg`
3	ابنِ الموقع	`npm run build`
4	تتولد تلقائيًا:	صفحة أداة، مراجعة، مقارنات، تحديث sitemap

خريطة التحكم الكاملة

لوحة التحكم

/admin/ — إحصائيات، جدول الأدوات، فلترة، حالة المحتوى

tools.json بيانات

إضافة/تعديل أدوات، تصنيفات، ميزات، أسعار

blog.ts محتوى

توليد مقالات، مقدمات، pros/cons، FAQ، شخصيات حسب التصنيف

seo.ts SEO

اسم الموقع، رابط، عناوين، وصف لكل صفحة

schema.ts Structured Data

JSON-LD: Breadcrumb, Product, Article, FAQ, WebSite

BaseLayout.astro شكل

Header, footer, nav، الهيكل العام للموقع

blog/[slug].astro تخطيط

صفحة المقالة: hero logos, TOC, FAQ accordion

ToolCard.astro مكون

بطاقة الأداة في القوائم (اسم، لوغو، تصنيف)

الأوامر

npm run dev

npm run build

npm run pipeline

npm run preview

npm run logos

npm run workflow

هيكل tools.json

src/data/tools.json

{
  "tools": [
    {
      "slug": "notion",
      "name": "Notion",
      "description": "All-in-one workspace...",
      "category": "Project Management",
      "price_tier": "freemium",
      "features_list": [
        "Docs",
        "Databases",
        "Templates"
      ],
      "integrations": [
        "slack",
        "github"
      ],
      "alternatives_list": [
        "clickup",
        "coda"
      ],
      "official_url": "https://notion.so",
      "logo": "/images/tools/notion.svg"
    }
  ]
}

قواعد البيانات

• slug: أحرف صغيرة، واصلات. فريد
• alternatives_list: slugs موجودة في نفس الملف
• integrations: اختياري، slugs موجودة

أنواع الأسعار

• free: مجاني بالكامل
• freemium: مجاني + مدفوع
• paid: مدفوع بالكامل

الموقع حاليًا

أداة

تصنيف

0 JS

Client Runtime

Static

HTML Output