ehsan-dashboards/dashboards/old_hermes/HANDOFF_EKEEPA_FIELD_DASHBOARD.md

7.2 KiB
Raw Blame History

سند هندآف: داشبورد میدانی جذب و پروپوزال اکیپا (Ekeepa Field Dashboard)

تاریخ ایجاد: سه‌شنبه ۳۱ شهریور ۱۴۰۵ (2026-09-22)
دامنه زنده: https://ekeepa.zebellkhan.com/field/
رمز عبور ذخیره‌سازی روی سرور: ekipa-field-1405


۱. هدف جلسه بعدی (Goal of next session)

  • دریافت بازخورد اولین مراجعه میدانی نماینده به مجموعه‌داران با این داشبورد.
  • در صورت درخواست، اتصال خودکار بک‌اند سینک به ربات تلگرام (با Bot Token و Chat ID کاربر) برای ارسال مستقیم اعلان‌ها بدون نیاز به مرورگر.
  • پایش لاگ‌های حسابرسی ثبت‌شده در sync_audit.db سرور.

۲. وضعیت فعلی (State of Play)

الف. انجام‌شده و تأییدشده (Done & Verified)

  1. داشبورد تک‌فایل HTML (موبایل‌محور و واکنش‌گرا):
    • طراحی بر اساس استانداردهای بصری (Vazirmatn، پالت تیره بنفش و طلایی، RTL).
    • بدون وابستگی به فایل خارجی برای تصاویر (تمام تصاویر به‌صورت WebP Base64 ادغام شده‌اند).
  2. تفکیک ۶ تب عملیاتی:
    • راهنمای نماینده: کارمزد پایه ۱۳٪، پکیج تست ۲ هفته‌ای رایگان در بدو ورود، پاسخ کوبنده به عدم تمایل به درگاه‌های اقساطی (افت ۲۰ تا ۳۰ درصدی فروش جوانان)، مقایسه رقبا، ۴ خط قرمز و کارت مرجع سریع.
    • پروپوزال مشتری: درگاه‌های اقساطی و کیف پول‌ها (اسنپ‌پی، تارا، دیجی‌پی، اوانو، اوزون، سلفیت)، تسویه منظم اول و ۱۵ هر ماه، نمایش ۳ اسکرین‌شات از پنل مالی، پکیج طلایی (۲۵٪) و نقره‌ای (۲۰٪) با قاعده سقف ۶۰ میلیون تومان فروش (مازاد رایگان)، نمایش تخفیف لحظه‌آخری، پیشنهادات ویژه با تگ VIP، گالری ۳تایی تگ «مورد تأیید تیم اکیپا»، قابلیت چاپ و ذخیره PDF.
    • ویس بلاگ: ۱۴ سؤال مصاحبه میدانی بدون اسپویل، چک‌لیست نکات مثبت و منفی، راهنمای ضبط ویس.
    • ارزیابی کیفی و وریفای: ۵ معیار ستاره‌ای (پازل، سناریو، دکور، ایمنی، پرسنل)، اعطای خودکار وریفای در صورت نمره حداقل ۴ در همه ابعاد، گالری ۳تایی نمایش تگ.
    • گزارش‌ها: فهرست گزارش‌های ثبت‌شده با امکان ارسال خلاصه به تلگرام (تصویر بزرگ نمونه گزارش به درخواست کاربر حذف شد).
    • پیشرفت جذب (CRM): پایپ‌لاین ثبت مجموعه‌ها با ۵ وضعیت، ذخیره‌سازی، خروجی CSV و گزارش متنی جامع به تلگرام.
  3. تفکیک صحیح تصاویر ارسالی کاربر:
    • تصاویر سفید (۳ عدد) -> پنل مالی شفاف و زنده در پروپوزال.
    • تصاویر تیره/بنفش (۳ عدد) -> گالری تگ «مورد تأیید تیم اکیپا» در پروپوزال و ارزیابی.
  4. سینک چنددستگاهی واقعی (Cross-Device Sync):
    • بک‌اند پایتون (api_server.py) روی پورت 8097 میزبان.
    • پروکسی معکوس در ekeepa-dashboard-nginx روی مسیر /field/api/.
    • ذخیره‌سازی پایدار در /data/dashboards/ekeepa/field/state.json و ثبت لاگ در SQLite sync_audit.db.
    • حل باگ مقایسه زمان رشته‌ای با استفاده از شمارنده نسخه ترتیبی (rev).
    • سرویس سیستمی ekeepa-field-api.service با راه‌اندازی خودکار پس از ریبوت فعال و تست شد.
    • تست انتها به انتهای Playwright با دو کانتکست مجزا (موبایل و دسکتاپ) با موفقیت پاس شد.

ب. موارد در جریان / بالقوه (In Flight / Next)

  • اتصال اختیاری به بات تلگرام برای ارسال خودکار نوتیفیکیشن بک‌اند به جای URL Share.
  • افزودن قابلیت جستجو و فیلتر در لیدهای CRM در صورت افزایش تعداد مجموعه‌ها.

۳. تصمیم‌های اتخاذشده (Decisions Log)

  • روش ذخیره‌سازی: هیبریدی (Local-First + Server Sync). در نبود اینترنت، داده در LocalStorage می‌ماند؛ در زمان اتصال و زدن دکمه ذخیره، با رمز روی سرور ثبت می‌شود.
  • احراز هویت ذخیره: هدر X-Field-Pass: ekipa-field-1405؛ خواندن اطلاعات باز است اما هرگونه بازنویسی به رمز نیاز دارد.
  • چیدمان گالری بج: در موبایل ۱ ستونی (عرض کامل تصویر) و در تبلت/دسکتاپ ۳ ستونی.
  • حذف عکس گزارش از تب گزارش‌ها: بنا به تأکید کاربر برای تمیزی و تمرکز روی داده‌های متنی.

۴. مهارت‌های پیشنهادی برای جلسه بعدی (Suggested Skills)

  1. coolify-server-access — برای بررسی سلامت سرور میزبان و مدیریت کانتینرها.
  2. ecosystem-secrets-reference — برای دسترسی به توکن‌ها و کلیدهای تلگرام در صورت توسعه بات.
  3. static-dashboard-operations — برای اصلاح یا انتشار نسخه‌های بعدی داشبوردهای استاتیک اکیپا.

۵. آدرس‌ها، فایل‌ها و ابزارهای مرتبط (Artifacts)

مورد مسیر / URL توضیحات
دامنه زنده داشبورد https://ekeepa.zebellkhan.com/field/ دسترسی عمومی، تست‌شده با کد ۲۰۰
اندپوینت سلامت API https://ekeepa.zebellkhan.com/field/api/health بازگشت {status: ok}
سورس HTML اصلی /workspace/ekeepa_field_dashboard.html نسخه محلی آماده توسعه
اسکریپت تولیدکننده /workspace/build_dash.py ساخت مجدد HTML و امبد تصاویر
سرور سینک /workspace/field_api_server.py کد بک‌اند پایتون پورت ۸۰۹۷
تست E2E سینک /workspace/e2e_sync_test.py سناریوی تست Playwright روی دامنه زنده
مسیر روی سرور میزبان /data/dashboards/ekeepa/field/ فایل‌های مستقرشده روی هیتزنر
سرویس لینوکس سرور ekeepa-field-api.service مدیریت پردازش بک‌اند با systemd
فایل پیکربندی Nginx کانتینر ekeepa-dashboard-nginx -> /etc/nginx/conf.d/default.conf هدایت /field/api/ به 10.0.1.1:8097