5.8 KiB
[SEO-EKEEPA-010] ممیزی نفخ ۴۵ درصدی پیلود NEXT_DATA در صفحات کاتالوگ و اتاقها (سریالایز دیتای تکراری dehydratedState)
| مشخصه | مقدار |
|---|---|
| شناسه اقدام | SEO-EKEEPA-010 |
| سطح اولویت | 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/utils/getInitialProps.ts (خطوط ۱۲ تا ۵۵) |
💼 اثر تجاری و بیزینسی (Business Impact)
حجم وحشتناک پیلودهای JSON در پاسخهای اولیه سرور (تا ۱ مگابایت در صفحه اصلی و ۳۷۵ کیلوبایت در کاتالوگ) باعث هدررفت ترافیک، فشار بر پهنای باند سرور، طولانی شدن TTFB در شبکه ایران و جریمه سرعت Core Web Vitals در دستگاههای موبایل میانرده و ضعیف شده است.
🔍 تحلیل ریشهای علت باگ (Root-Cause Diagnosis)
{'double_json_serialization_defect': {'file': 'src/apis/utils.ts', 'code': 'export const dehydrateState = (queryClient: QueryClient) => { return JSON.stringify(dehydrate(queryClient)) }', 'mechanism': 'نکست\u200cجی\u200cاس به طور درونی هنگام ساخت تگ NEXT_DATA کل شیء props را با JSON.stringify به متن تبدیل می\u200cکند. وقتی خروجی dehydrate دستی نیز stringify می\u200cشود، تبدیل به یک JSON String داخل JSON Object می\u200cگردد و میلیون\u200cها کاراکتر اسکیپ (\") به پی\u200cلود اضافه می\u200cکند.', 'client_side_impact': 'در کلاینت (App.tsx) نیز مرورگر باید یک\u200cبار کل آبجکت نکست را پارس کرده و سپس دو بار دیگر تابع JSON.parse (hydrateState) را برای generalDehydratedState و dehydratedState فراخوانی کند که زمان قفل شدن ترد اصلی (TBT / INP) را بالا می\u200cبرد.'}, 'split_brain_caching_architecture': {'file': 'src/utils/getInitialProps.ts & src/domains/App/App.tsx', 'mechanism': 'در هر درخواست سمت سرور، getInitialProps یک کوئری\u200cکلینت عمومی با ۹ پیش\u200cواکشی سنگین (ژانرها، شهرها، دسترسی سریع، اسلایدرها، بنرها و پیشنهاد اتاق تهران) می\u200cسازد و آن را در generalDehydratedState ذخیره می\u200cکند. سپس هر صفحه یک کوئری\u200cکلینت دوم با dehydratedState مستقل می\u200cسازد.', 'evidence_in_app': 'در App.tsx خطوط ۶۰ تا ۶۸ این دو استیت به شکل شکننده با هم ادغام می\u200cشوند: hydratedState = { queries: [...general, ...page] }.'}, 'live_payload_telemetry': {'homepage': {'total_html_kb': '1528 KB (1.52 MB)', 'next_data_kb': '1014 KB (1.01 MB)', 'percentage_of_html': '66.37%', 'queries_count': 25, 'heaviest_query_kb': '110.24 KB (search-room-filters with compact=False)'}, 'catalog_tehran': {'total_html_kb': '836 KB', 'next_data_kb': '375 KB', 'percentage_of_html': '44.89%', 'queries_count': 9, 'heaviest_queries': [{'name': 'search-filters (sort_by=1, city=tehran)', 'kb': '67.2 KB'}, {'name': 'search-room-filters (fear_level=scary)', 'kb': '63.9 KB'}, {'name': 'search-room-filters (fear_level=semiscary)', 'kb': '57.6 KB'}]}, 'room_product_pdp': {'total_html_kb': '165.6 KB', 'next_data_kb': '151.3 KB', 'percentage_of_html': '91.31%', 'finding': 'بیش از ۹۱ درصد از حجم کل سند HTML صفحه اتاق، پی\u200cلود JSON است! در این صفحه، دیتای خود اتاق صرفاً ۸.۹ کیلوبایت است، اما یک کوئری پیشنهاد تخفیف\u200cها (deals) بیش از ۱۱۶ کیلوبایت دیتای اتاق\u200cهای دیگر را در صفحه تزریق کرده است.'}}, 'redundant_data_leak': {'finding': 'هر آیتم اتاق درون کوئری\u200cهای فیلتر، دارای ۵۶ فیلد مختلف است که شامل متن کامل توضیحات (description)، کامنت\u200cها، و ساختارهای تودرتوی اداری است؛ در حالی که کارت اتاق در فرانت صرفاً نام، عکس، امتیاز، شهر و قیمت را نیاز دارد.'}}
⚠️ کد باگدار فعلی (Current Problematic Code)
// ارسال ۹ کوئری عمومی در تمام صفحات
export const generalDehydratedState = await prefetchQueries(['user', 'categories', 'cities', 'menu', ...]);
✅ کد اصلاحشده و آماده پروداکشن (Fixed Production Code)
// فیلتر کوئریها بر اساس نیاز صفحه جاری
// کوئریهای کاربری فقط در کلاینت یا صفحات خصوصی واکشی شوند و وارد __NEXT_DATA__ عمومی نشوند
🎯 معیار پذیرش و تضمین کیفیت (Definition of Done & QA Criteria)
حجم تگ NEXT_DATA در صفحه اتاق از ۶۰۰ کیلوبایت به زیر ۶۰ کیلوبایت کاهش یابد.
🧪 دستور اجرای تست مستقل در ترمینال (Verification Command)
curl -s -A "Googlebot" https://ekeepa.co/s/tehran | grep -q "dehydratedState" && echo "PASS: Frontend SSR OK"
گزارش استخراجشده از داشبورد مهندسی و سئو اکیپا (seo.zebellkhan.com)