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

3.2 KiB

[SEO-EKEEPA-001] بازرسی عمیق علت مفقود بودن تگ‌های Title، H1 و Canonical در خروجی پاسخ خام سرور (SSR)

مشخصه مقدار
شناسه اقدام SEO-EKEEPA-001
سطح اولویت 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/room/[...slug].tsx (خطوط ۴۸ تا ۵۶)

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

تمام موتورهای جستجو و خزنده‌های هوش مصنوعی صفحات محصولات اکیپا را بدون عنوان، بدون تیتر و به عنوان صفحات سفید (Blank Shell) ارزیابی می‌کنند که عامل اصلی نوسانات رتبه و افت ترافیک است.


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

استفاده از کتابخانه radash.dash روی رشته‌های فارسی در خط ۴۹ فایل src/pages/room/[...slug].tsx که کاراکترهای یونیکد فارسی را کاملاً پاک کرده و رشته تهی می‌سازد. این امر باعث شرط نابرابری name !== desc و اجرای router.replace() و سپس return null در مرحله رندر اولیه سرور شده و سند HTML سفید بدون Title و H1 تحویل می‌دهد.


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

// src/pages/room/[...slug].tsx
const name = dash(roomData.name.trim() || ""); // radash.dash تمام حروف فارسی را پاک می‌کند!
if (!!name && (name !== desc || !desc || slugs.length > 0)) {
  const location = encodeURI(`/room/${id}/${name}${query ? "?" + query : ""}`);
  replace(location);
  return null; // تولید صفحه سفید در رندر SSR!
}

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

// پیاده‌سازی Persian-Safe Slugger بدون حذف کاراکترهای یونیکد
const safeSlug = (str: string) => str.trim().toLowerCase().replace(/\s+/g, '-').replace(/[^\u0600-\u06FFa-z0-9\-_]/g, '');
const name = safeSlug(roomData.name || "");
// اطمینان از تزریق کامل Head و SSR قبل از بررسی ریدایرکت‌های کلاینتی

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

خروجی خام cURL از صفحه اتاق حاوی تگ