sara-dashboards/seo_artifacts/SEO-EKEEPA-008_action_report.md

3 KiB
Raw Permalink Blame History

[SEO-EKEEPA-008] بازرسی عمیق نفخ هدر در _document.tsx (۲۲۰ خط تگ اسپلش اسکرین) و استقرار W3C Speculation Rules

مشخصه مقدار
شناسه اقدام SEO-EKEEPA-008
سطح اولویت P0
تیم مسئول تحویل تیم فرانت‌اند Next.js
فاز اسپرینت Sprint 0 (فوریتی / P0)
تخمین زمان 0.5 ساعت کاری
امتیاز RICE Score: 2700000 (Reach: 450000, Impact: 3.0, Confidence: 1.0, Effort: 0.5)
ستون نظارتی C-Level CPO / Lead Frontend
آدرس دقیق فایل و خطوط src/pages/_document.tsx (خطوط ۴۵ تا ۲۴۴)

💼 اثر تجاری و بیزینسی (Business Impact)

اتلاف ۱۰ کیلوبایت در بایت اول سرور روی تک‌تک صفحات اکیپا، بودجه خزش گوگل را مستهلک کرده و سرعت بارگذاری و رندر صفحات در موبایل را برای کاربران کاهش داده است.


🔍 تحلیل ریشه‌ای علت باگ (Root-Cause Diagnosis)

درج ۲۲۶ خط تگ استاتیک apple-touch-startup-image در تگ Head سند _document.tsx که باعث اتلاف بیش از ۱۰ کیلوبایت در پکت اولیه TCP و افزایش تاخیر TTFB/FCP شده است؛ عدم استفاده از استاندارد جدید W3C Speculation Rules برای پیش‌رندر آنی صفحات کاتالوگ در مرورگر.


⚠️ کد باگ‌دار فعلی (Current Problematic Code)

// src/pages/_document.tsx - ۲۲۰ خط تگ‌های زائد در تمام درخواست‌ها
<link href="/assets/splash_screens/iPhone_15_Pro_Max_landscape.png" rel="apple-touch-startup-image" />
<link href="/assets/splash_screens/iPhone_15_Pro_landscape.png" rel="apple-touch-startup-image" />
... (۲۲۰ خط تکرار)

✅ کد اصلاح‌شده و آماده پروداکشن (Fixed Production Code)

// ۱. حذف تگ‌های استاتیک اسپلش و تکیه بر وب‌مانیفست PWA
// ۲. تزریق W3C Speculation Rules در تگ Head:
<script type="speculationrules" dangerouslySetInnerHTML={{ __html: JSON.stringify({
  prerender: [{ source: "list", urls: ["/s/tehran", "/s/karaj"], eagerness: "moderate" }],
  prefetch: [{ source: "document", where: { href_matches: "/room/*" }, eagerness: "conservative" }]
}) }} />

🎯 معیار پذیرش و تضمین کیفیت (Definition of Done & QA Criteria)

حجم تگ Head به زیر ۳ کیلوبایت کاهش یافته و تگ speculationrules در سورس HTML مشاهده شود.


🧪 دستور اجرای تست مستقل در ترمینال (Verification Command)

curl -s https://ekeepa.co/ | grep -c "apple-touch-startup-image" && curl -s https://ekeepa.co/ | grep -o "speculationrules"

گزارش استخراج‌شده از داشبورد مهندسی و سئو اکیپا (seo.zebellkhan.com)