8.9 KiB
8.9 KiB
دانشنامه جامع پروژه مرکز پایش تجارب اکیپا (Ekeepa Experiences Mission Control Knowledge Base)
این سند مرجع رسمی معماری، تعاریف دیتابیس، منابع تحلیلی، نکات فنی کشفشده و روش بهروزرسانی پرسرعت داشبورد مرکز پایش تجارب اکیپا به نشانی https://experiences.ghazale.test.zebellkhan.com/ است.
۱. ساختار پوشهها و همگامسازی فایلها
- مسیر اصلی توسعه و اجرا:
/workspace/personal/experiences_monitoring/ - مسیر همگام دپارتمان عملیات:
/workspace/ekeepa/operations/experiences_monitoring/ - فایل مستقر روی سابدامین:
/workspace/personal/experiences.html - مرکز عملیات بالادستی (Hooch): با هر انتشار جدید، اجرای
/workspace/personal/sync_hooch.pyبرای ثبت وضعیت در جدولekeepa_bi.dashboard_app_storageو بازنشر کارت داشبورد الزامی است. - ممنوعیت مطلق
localStorage: تمام وضعیتها و تسکهای داشبورد صرفاً در بکاند PostgreSQL 17 از طریق/api/db/stateذخیره میشوند.
۲. استاندارد قطعی افق ۳۰ روزه عرضه و زامبیها (تثبیتشده)
تعریف کاتالوگ فعال (active_rooms)
اتاقهایی که واجد تمام شروط زیر در جدول rooms (Metabase Database ID: 2) باشند:
(room_type IN ('تجربه', 'کلاس', 'تور', 'تور وحشت', 'سفر', 'رویداد') OR name LIKE '%رویداد%' OR name LIKE '%ایونت%')
AND status = 2
AND deleted_at IS NULL
(تعداد کل کاتالوگ فعال: ۳۵۶ تجربه از مجموع ۶۳۴ اتاق موجود در سیستم).
منطق افق زمانی ۳۰ روز آینده (generate_series(0, 29))
سانسهای باز یک تجربه منحصراً بر مبنای ۳۰ روز آینده با وقت محلی ایران (Asia/Tehran / +3 hours 30 minutes) محاسبه میشوند:
- تولید سری ۳۰ روزه با
generate_series(0, 29). - انطباق
play_boxes.week_dayبا روز هفته تهران (EXTRACT(DOW FROM ((CURRENT_DATE + i)::date + interval '3 hours 30 minutes'))::int). - اعمال شرط تاریخ اعتبار سانس:
(pb.valid_to IS NULL OR pb.valid_to >= d.slot_date) AND (pb.valid_from IS NULL OR pb.valid_from <= d.slot_date). - کسر سانسهای بستهشده یا بلاک تقویمی در جدول
disabled_calendar_play_boxesبر مبنای(dpb.date AT TIME ZONE 'Asia/Tehran')::date = d.slot_date.
آمار مرجع ۳۰ روزه (راستیآزماییشده)
- تجارب دارای سانس باز (Active Supply): ۳۴۷ تجربه (۹۷.۵٪ کاتالوگ فعال | محققشده ۱۵۷.۷٪ نسبت به تارگت سندی ۲۲۰).
- تجارب راکد بدون سانس (Zombie Inventory): ۹ تجربه (۲.۵٪ کاتالوگ فعال):
- ۵ تجربه زامبی با پتانسیل (دارای سابقه فروش قبلی): پخت موچی کرهای، پخت کیمباپ کرهای، پخت بیانگبیانگ، تور ترکمنصحرا و کلاب انگلیسی.
- ۴ تجربه زامبی مرده (بدون سابقه فروش و بدون سانس): شناسه اتاقهای
101256011,101256012,101490613,201298717.
- نرخ رشد هفتگی عرضه: ۵۸ تجربه فعال جدید در ۳۰ روز اخیر (معادل ۱۳.۵ تجربه جدید در هفته).
- تمرکز جغرافیایی: ۳۱۶ تجربه در تهران و کرج (۸۸.۸٪) و ۴۰ تجربه در ۱۰ شهر دیگر (۱۱.۲٪).
۳. آموختههای کلیدی دیتابیس رزروها، پرداختها و میزبانان (Metabase DB #2)
الف) وضعیتهای جدول reservations
status = 2: رزرو پرداختشده و تاییدشده.status = 6: رزرو تکمیلشده / شرکتکننده در سانس حضور یافته.status = 3: رزرو لغوشده / کنسلی.- بنابراین تعداد سفارشهای موفق واقعی =
status IN (2, 6)(در ۳۰ روز اخیر: ۴۷۶ سفارش موفق شامل ۲۰۰ سفارش وضعیت ۲ و ۲۷۶ سفارش وضعیت ۶). - نرخ کنسلی ۳۰ روزه: ۳۵ کنسلی از ۵۱۱ رزرو قطعی/لغوشده = ۶.۸٪.
ب) فرمول محاسبه دقیق درآمد ناخالص (GMV)
- ستون
reservations.base_priceمبلغ پایه یک نفر است؛ برای محاسبه GMV واقعی باید حتماً در تعداد نفرات ضرب شود:SUM(r.base_price * COALESCE(r.number_of_players, 1)) - بر این اساس، GMV واقعی ۳۰ روز اخیر تجارب اکیپا حدود ۱.۱۵ میلیارد تومان و میانگین ارزش سبد (AOV) معادل ۲,۴۱۸,۰۰۰ تومان است.
ج) استخراج اطلاعات تماس میزبانان بدون جوین اضافه
- جدول
roomsمستقیماً شامل ستونهایcell_phone_numberوphone_numberاست. برای پیگیری ۵ تجربه زامبی دارای پتانسیل نیازی به جوین جدولprovidersیاusersنیست.
د) هیتمپ تقاضای ساعتی-هفتگی
- با کوئریگیری مستقیم از
reservations.created_at + INTERVAL '3 hours 30 minutes'، ۱۶۸ خانه (۷ روز هفته × ۲۴ ساعت) در فایل JS داشبورد به صورت متغیر زندهliveHeatmapDataتزریق میشود تا نمودار هیتمپ بدون اعداد ساختگی و کاملاً متصل به پایگاه داده باشد. - قلههای واقعی خرید و اجرا: عصر پنجشنبه و جمعه (ساعات ۱۶ تا ۲۱).
۴. یکپارچهسازی منابع تحلیلی تکمیلی (Clarity, GA4, GSC, Mahsa)
- Microsoft Clarity API (
/workspace/personal/analytics/clarity_probe.py):- استخراج متریکهای رفتار واقعی کاربران در ۳ روز اخیر:
- کلیکهای مرده (
DeadClickCount): ۶.۰۹٪ (نقطه اصطکاک اصلی روی دکمه تقویم موبایل). - بازگشت سریع (
QuickbackClick): ۶.۶۲٪. - کلیکهای عصبی (
RageClickCount): ۰.۲۹٪. - عمق اسکرول (
ExcessiveScroll): ۴۹.۱۳٪. - سهم دستگاه موبایل: ۸۳.۳٪.
- کلیکهای مرده (
- استخراج متریکهای رفتار واقعی کاربران در ۳ روز اخیر:
- Google Analytics 4 REST API (بدون وابستگی پکیج خارجی):
- اتصال مستقیم با
urllib.requestو توکن رفرش/workspace/personal/analytics/google_user_tokens.jsonروی Property ID472393675. - حجم سشن ۳۰ روزه کل سایت: ~۱۵۴,۳۰۰ سشن (Direct: ۷۱.۵k، Organic Search: ۴۱.۱k، Paid Search: ۲۷.۳k، Social/Affiliates/SMS: ۱۴.۴k).
- اتصال مستقیم با
- Google Search Console API:
- استخراج عملکرد سرچ از
google_client.py gsc(کوئری برند «اکیپا» با ۸۱۴ کلیک و CTR ۸۶.۱٪ در جایگاه ۱.۰).
- استخراج عملکرد سرچ از
- دیتابیسهای کراولر مهسا (
/usr/local/bin/mahsa-sql):davvvat: جدولevents(بررسی قیمت و تعداد ایونتهای فعال رقیب دعوت).vadoostan: جدولexperiences(بررسی بازه قیمتی ۱۵۰ تا ۴۵۰ هزار تومانی وادوستان).
۵. معماری بهروزرسانی پرسرعت و سابایجنت (Quick Update Architecture)
برای جلوگیری از اتلاف وقت در درخواستهای بعدی و بهروزرسانی همزمان تمامی تبها:
- دستور اجرای پرسرعت تکخطی:
python3 /workspace/personal/experiences_monitoring/update_all_dashboard.py - اسکریپت سابایجنت موازی:
/workspace/personal/experiences_monitoring/subagent_live_updater.pyبا ۴ کارگر همزمان (ThreadPoolExecutor) و ثبت وضعیت اجرای هر تب در کانبان/workspace/personal/kanban.db(جدولsubagent_tasks). - مراحل انتشار پس از پچ HTML:
- اجرای
/usr/local/bin/deploy-dashboard /workspace/personal/experiences.html experiences "<commit>". - همگامسازی فایلها به
/workspace/ekeepa/operations/experiences_monitoring/. - اجرای
/workspace/personal/sync_hooch.pyو بررسی اسکرینشات خروجی/workspace/personal/screenshots/experiences_qa.png.
- اجرای
ثبتشده در دانشنامه (2026-11-10 13:12 UTC | اصالت داده: LIVE_VERIFIED)