73 lines
7.2 KiB
Markdown
73 lines
7.2 KiB
Markdown
# سند هندآف: داشبورد میدانی جذب و پروپوزال اکیپا (Ekeepa Field Dashboard)
|
||
|
||
**تاریخ ایجاد:** سهشنبه ۳۱ شهریور ۱۴۰۵ (2026-09-22)
|
||
**دامنه زنده:** [https://ekeepa.zebellkhan.com/field/](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` |
|