7.2 KiB
7.2 KiB
سند هندآف: داشبورد میدانی جذب و پروپوزال اکیپا (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)
- داشبورد تکفایل HTML (موبایلمحور و واکنشگرا):
- طراحی بر اساس استانداردهای بصری (Vazirmatn، پالت تیره بنفش و طلایی، RTL).
- بدون وابستگی به فایل خارجی برای تصاویر (تمام تصاویر بهصورت WebP Base64 ادغام شدهاند).
- تفکیک ۶ تب عملیاتی:
- راهنمای نماینده: کارمزد پایه ۱۳٪، پکیج تست ۲ هفتهای رایگان در بدو ورود، پاسخ کوبنده به عدم تمایل به درگاههای اقساطی (افت ۲۰ تا ۳۰ درصدی فروش جوانان)، مقایسه رقبا، ۴ خط قرمز و کارت مرجع سریع.
- پروپوزال مشتری: درگاههای اقساطی و کیف پولها (اسنپپی، تارا، دیجیپی، اوانو، اوزون، سلفیت)، تسویه منظم اول و ۱۵ هر ماه، نمایش ۳ اسکرینشات از پنل مالی، پکیج طلایی (۲۵٪) و نقرهای (۲۰٪) با قاعده سقف ۶۰ میلیون تومان فروش (مازاد رایگان)، نمایش تخفیف لحظهآخری، پیشنهادات ویژه با تگ VIP، گالری ۳تایی تگ «مورد تأیید تیم اکیپا»، قابلیت چاپ و ذخیره PDF.
- ویس بلاگ: ۱۴ سؤال مصاحبه میدانی بدون اسپویل، چکلیست نکات مثبت و منفی، راهنمای ضبط ویس.
- ارزیابی کیفی و وریفای: ۵ معیار ستارهای (پازل، سناریو، دکور، ایمنی، پرسنل)، اعطای خودکار وریفای در صورت نمره حداقل ۴ در همه ابعاد، گالری ۳تایی نمایش تگ.
- گزارشها: فهرست گزارشهای ثبتشده با امکان ارسال خلاصه به تلگرام (تصویر بزرگ نمونه گزارش به درخواست کاربر حذف شد).
- پیشرفت جذب (CRM): پایپلاین ثبت مجموعهها با ۵ وضعیت، ذخیرهسازی، خروجی CSV و گزارش متنی جامع به تلگرام.
- تفکیک صحیح تصاویر ارسالی کاربر:
- تصاویر سفید (۳ عدد) -> پنل مالی شفاف و زنده در پروپوزال.
- تصاویر تیره/بنفش (۳ عدد) -> گالری تگ «مورد تأیید تیم اکیپا» در پروپوزال و ارزیابی.
- سینک چنددستگاهی واقعی (Cross-Device Sync):
- بکاند پایتون (
api_server.py) روی پورت8097میزبان. - پروکسی معکوس در
ekeepa-dashboard-nginxروی مسیر/field/api/. - ذخیرهسازی پایدار در
/data/dashboards/ekeepa/field/state.jsonو ثبت لاگ در SQLitesync_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)
coolify-server-access— برای بررسی سلامت سرور میزبان و مدیریت کانتینرها.ecosystem-secrets-reference— برای دسترسی به توکنها و کلیدهای تلگرام در صورت توسعه بات.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 |