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

5.6 KiB
Raw Permalink Blame History

[SEO-EKEEPA-009] ممیزی باگ کانونیکال الحاق اسلش ناخواسته در انتهای آدرس صفحات کتگوری (/s/tehran/) و تفکیک با صفحات فیلتردار

مشخصه مقدار
شناسه اقدام SEO-EKEEPA-009
سطح اولویت P0
تیم مسئول تحویل تیم فرانت‌اند و بک‌اند
فاز اسپرینت 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/s/[[...slug]].tsx (خطوط ۷۰ تا ۹۰)

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

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


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

{'source_code_inspection': {'file': 'src/pages/s/...slug.tsx', 'line_25_formula': 'const canonical = /s/${city ? city : ""}/${city && fear_level ? fear_level : ""}', 'inherent_bug': 'در صورت وجود شهر بدون فیلتر، رشته خروجی به شکل /s/tehran/ تولید می\u200cشود که حاوی اسلش ناخواسته انتهایی است.', 'accidental_safety_guard': "تابع سراسری getRelativePath در src/utils/helper.ts با فراخوانی trimEnd(..., '/') اسلش انتهایی را حذف می\u200cکند و مانع از نشت مستقیم آن به تگ کانونیکال در رندر نهایی شده است.", 'legacy_titles_contamination': 'در فایل src/assets/data/plpTitles copy.json سه روت شامل /s/، /s/tehran/ و /s/karaj/ با اسلش انتهایی ثبت شده بودند که در نسخه فعلی plpTitles.json به حالت بدون اسلش تصحیح شده\u200cاند.'}, 'edge_server_behavior': {'trailing_slash_handling': 'Next.js به طور پیش\u200cفرض درخواست\u200cهای دارای اسلش انتهایی را با کد 308 Permanent Redirect به آدرس بدون اسلش هدایت می\u200cکند.', 'cdn_status': 'سرور لبه آروان بدون دخالت (BYPASS) مستقیماً ریدایرکت ۳۰۸ را همراه با هدر Refresh: 0;url=/s/... تحویل مرورگر و بات می\u200cدهد.', 'live_probes': [{'url': 'https://ekeepa.co/s/tehran/', 'status': 308, 'redirect_to': '/s/tehran'}, {'url': 'https://ekeepa.co/s/karaj/', 'status': 308, 'redirect_to': '/s/karaj'}, {'url': 'https://ekeepa.co/s/tehran/?page=2', 'status': 308, 'redirect_to': '/s/tehran?page=2'}]}, 'faceted_canonical_rules': {'filter_and_sort_handling': 'پارامترهای فیلترینگ مانند ?sort=newest و ?price_range به درستی از تگ کانونیکال حذف شده و به آدرس تمیز شهر مادر (/s/tehran) اشاره می\u200cکنند.', 'pagination_risk': 'آدرس\u200cهای صفحه\u200cبندی\u200cشده (?page=2) نیز به صفحه ریشه (/s/tehran) کانونیکال می\u200cزنند. طبق راهنماهای مدرن گوگل، در صورتی که آیتم\u200cهای صفحه دوم کاملاً متفاوت با صفحه اول باشند، کانونیکال کردن آن به صفحه اول ممکن است توسط گوگل رد شده یا موجب شناسایی Soft 404 گردد.'}, 'gsc_16m_telemetry': {'total_catalog_urls_with_trailing_slash': 0, 'total_catalog_urls_without_trailing_slash': 39, 'total_clicks_on_clean_catalog_urls': '> 50,000', 'top_performers': [{'url': 'https://ekeepa.co/s/mashhad', 'clicks': 9702, 'impressions': 443228}, {'url': 'https://ekeepa.co/s/karaj', 'clicks': 9110, 'impressions': 378917}, {'url': 'https://ekeepa.co/s/isfahan', 'clicks': 7153, 'impressions': 419083}, {'url': 'https://ekeepa.co/s/tehran', 'clicks': 6461, 'impressions': 544641}], 'finding': 'گوگل نسخه\u200cهای بدون اسلش صفحات کاتالوگ را به طور کامل به عنوان نسخه اصلی ایندکس کرده است؛ هرگونه درخواست یا لینک داخلی که اسلش اضافی داشته باشد یک جهش ریدایرکت ۳۰۸ اضافی تحمیل می\u200cکند.'}}


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

const canonicalUrl = `https://ekeepa.co/s/${slug.join('/')}/`; // اسلش اضافه در انتها در حالی که سرور ریدایرکت ۳۰۸ می‌دهد

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

const canonicalUrl = `https://ekeepa.co/s/${slug.join('/')}`.replace(/\/+$/, ''); // تضمین تطابق کامل کانونیکال با URL بدون اسلش

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

تگ کانونیکال عیناً برابر با URL درخواستی مرورگر بدون ریدایرکت ۳۰۸ باشد.


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

curl -s -A "Googlebot" https://ekeepa.co/s/tehran | grep -q "dehydratedState" && echo "PASS: Frontend SSR OK"

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