استفاده از مستندات پوشفا با Agentهای هوش مصنوعی

Web — URL عمومی:
https://pushfa.com/index/doc/download/pushfa-web-push-complete-guide-fa.md

Android — URL عمومی:
https://pushfa.com/index/doc/download/pushfa-android-push-complete-guide-fa.md

iOS — URL عمومی:
https://pushfa.com/index/doc/download/pushfa-ios-push-complete-guide-fa.md

مسیر داخل Repository برای Agent محلی:
docs/pushfa-web-push-complete-guide-fa.md
docs/pushfa-android-push-complete-guide-fa.md
docs/pushfa-ios-push-complete-guide-fa.md

پلتفرم: Web / Android / iOS / چندپلتفرمی
هدف: نصب جدید / اصلاح نصب / ارسال Backend / RetenX / Auth Push
Public Key سرویس: ...
Private Key: فقط نام متغیر محیطی Backend؛ مقدار واقعی را در Prompt ننویسید
نوع سرویس و Firebase Project: ...
Frontend یا Mobile stack و نسخه‌ها: ...
Backend stack و محل endpointهای داخلی: ...
روش Login/Logout و شناسه پایدار کاربر: ...
External ID: ...
Custom Aliasها: mobile / crm_id / email / ...
Topicها و UUID آن‌ها: ...
Deep Link یا URLهای مقصد: ...
Prompt مطلوب و زمان نمایش: ...
گزارش Delivery/Click: لازم/غیرلازم
RetenX eventها و Start/Exit event: ...
Auth Push: فعال/غیرفعال
محدودیت‌ها و بخش‌هایی که نباید تغییر کنند: ...

فایل docs/pushfa-web-push-complete-guide-fa.md را ابتدا کامل بخوان و آن را قرارداد مرجع Pushfa این کار در نظر بگیر. سپس Web Push پروژه را بررسی و پیاده‌سازی/اصلاح کن.

اطلاعات پروژه:
- دامنه Production: [https://example.com]
- Public Key: [PUBLIC_KEY]
- Frontend: [Laravel Blade / React / Vue / Next.js / ...]
- Backend: [Laravel / Node.js / ...]
- نصب جدید یا موجود: [جدید/موجود]
- Prompt: [آماده Pushfa / مستقیم مرورگر / کاملاً سفارشی]
- زمان نمایش Prompt: [پس از Login / افزودن به سبد / کلیک دکمه / ...]
- External ID: [شناسه داخلی کاربر]
- Custom Aliasها: [mobile, crm_id, email]
- Topicها: [نام و UUID]
- Deep Link یا URLها: [...]
- RetenX eventها: [add_to_cart, checkout_completed, ...]
- Auth Push: [فعال/غیرفعال]

قبل از تغییر، اسکریپت Pushfa، Service Worker، Firebase، Login/Logout، ذخیره Subscriber ID و APIهای Backend فعلی را کشف کن. manual_prompt و prompt_style را مطابق UX انتخاب کن. در Login شناسه‌ها را ثبت و در Logout اتصال کاربر قبلی را پاک کن. ارسال تکی، گروهی، Subscriber ID، External ID و Custom Alias را فقط در Backend و با Private Key محیطی پیاده کن. Delivery/Click، دکمه‌ها، Collapse ID، Silent و Additional Data را حفظ کن. اگر RetenX فعال است Start/Exit eventها و idempotency را هماهنگ کن. اگر Auth Push فعال است Challenge/Grant را فقط در Backend، همراه cancel fallback، rate limit و session regeneration اجرا کن.

هیچ api_private_key یا Service Account را در Frontend، Service Worker، Git یا لاگ قرار نده. تغییرات را با سبک فعلی پروژه و حداقل refactor انجام بده. در پایان فایل‌های تغییرکرده، تنظیمات پنل/Firebase، متغیرهای محیطی و سناریوهای تست دستی را گزارش کن. هر ابهام امن و قابل‌کشف را از کد کشف کن و فقط برای تصمیمی که نتیجه را عوض می‌کند سؤال بپرس.

فایل docs/pushfa-android-push-complete-guide-fa.md را ابتدا کامل بخوان و براساس قرارداد آن Pushfa Android Push را در پروژه پیاده‌سازی/اصلاح کن.

اطلاعات پروژه:
- applicationId: [com.example.app]
- Public Key: [PUBLIC_KEY]
- زبان و UI: [Kotlin/Java و Compose/Views]
- minSdk/targetSdk: [...]
- FirebaseMessagingService موجود: [بله/خیر/نامشخص؛ کشف کن]
- Navigation و Deep Linkها: [...]
- External ID: [شناسه کاربر]
- Custom Aliasها: [mobile, crm_id, tier]
- Topicها: [نام و UUID]
- RetenX eventها: [...]
- Auth Push: [فعال/غیرفعال]

Gradle، Manifest، Application، google-services، Permission، Notification Channel، FirebaseMessagingService و Navigation فعلی را ابتدا بررسی کن. SDK رسمی Pushfa Android نسخه مرجع سند را فقط از یک Repository نصب و در Application initialize کن. برای Android 13+ ابتدا Soft Prompt اپ و سپس POST_NOTIFICATIONS را در زمان مشخص درخواست کن. Token refresh را به همان Subscriber ID متصل نگه دار. Login/Logout، External ID و Custom Aliasها را کامل مدیریت کن. Foreground، Background، اپ بسته، تصویر، دو Action، Deep Link، Collapse ID، Silent، Additional Data و Delivery/Click را بدون شکستن رفتار SDK پیاده کن. اگر Service اختصاصی FCM وجود دارد از ثبت دو FirebaseMessagingService جلوگیری کن.

Endpointهای ارسال تکی، گروهی، Subscriber، Alias و Custom Alias فقط در Backend با Private Key محیطی باشند. RetenX و Auth Push را فقط در صورت فعال‌بودن با Backend امن متصل کن. Service Account و Private Key نباید وارد APK، سورس یا لاگ شوند. در پایان فایل‌های تغییرکرده، تنظیم Firebase/Pushfa، مسیرهای Deep Link و چک‌لیست تست دستی روی دستگاه واقعی را گزارش کن.

فایل docs/pushfa-ios-push-complete-guide-fa.md را ابتدا کامل بخوان و براساس قرارداد آن Pushfa Native iOS Push را در پروژه پیاده‌سازی/اصلاح کن.

اطلاعات پروژه:
- Bundle ID: [com.example.app]
- Public Key: [PUBLIC_KEY]
- UI lifecycle: [SwiftUI/UIKit]
- Deployment target و Xcode: [...]
- Firebase swizzling: [فعال/غیرفعال/نامشخص؛ کشف کن]
- Universal Link یا Custom Scheme: [...]
- Rich Image و Notification Service Extension: [لازم/غیرلازم]
- External ID: [شناسه کاربر]
- Custom Aliasها: [mobile, crm_id]
- Topicها: [نام و UUID]
- RetenX eventها: [...]
- Auth Push: [فعال/غیرفعال]

ابتدا Xcode targets، Package dependencies، AppDelegate، SwiftUI lifecycle، entitlements، GoogleService-Info.plist، APNs registration، UNUserNotificationCenterDelegate و Navigation موجود را بررسی کن. SDK رسمی Pushfa را از Tag مرجع نصب کن؛ Product اصلی فقط در Target اپ و PushfaExtension فقط در Notification Service Extension باشد. Push Notifications و Remote notifications را تنظیم کن. Permission را بعد از Soft Prompt و اقدام کاربر بخواه. Token refresh، Subscriber ID، Login/Logout، External ID و Custom Aliasها را هماهنگ کن. Foreground، Background، Terminated، Cold Start، Actionها، Universal Link/Custom Scheme، Additional Data، Collapse و Delivery/Click را مدیریت کن. URL ورودی را validate و allowlist کن.

Private Key، APNs Key و Service Account هرگز داخل Bundle، سورس یا لاگ قرار نگیرند. ارسال و Auth Push فقط از Backend امن انجام شوند. RetenX eventهای قطعی مانند پرداخت را ترجیحاً از Backend و با idempotency بفرست. در پایان فایل‌های تغییرکرده، تنظیمات Apple Developer/Firebase/Pushfa و چک‌لیست تست روی دستگاه واقعی را گزارش کن.

هر سه فایل زیر را کامل بخوان:
- docs/pushfa-web-push-complete-guide-fa.md
- docs/pushfa-android-push-complete-guide-fa.md
- docs/pushfa-ios-push-complete-guide-fa.md

Backend مشترک Pushfa را طوری طراحی/اصلاح کن که یک کاربر روی Web، Android و iOS با External ID واحد و Custom Aliasهای مشترک به Profileهای قابل هدف‌گیری متصل شود. Private Key فقط در Secret محیط Backend باشد. سرویس و Public Key هر پلتفرم را اشتباه مخلوط نکن. یک لایه مشترک برای ارسال به Subscriber ID، External ID، Custom Alias، Topic و گروه بساز و فیلتر platform را فقط هنگام نیاز اعمال کن. Token را هویت کسب‌وکاری فرض نکن. Login/Logout، چنددستگاهی، only_last_device، smart_targeting، Delivery/Click، Bracket، Additional Data، RetenX Profile/Event و Auth Push bind/unbind را پوشش بده.

قبل از تغییر، مدل User، سرویس ارسال فعلی، Queue، Retry، Secret management، لاگ‌ها و endpointهای داخلی را بررسی کن. API عمومی موجود را نشکن و داده هر Tenant/Service را جدا نگه دار. در پایان قرارداد داخلی پیشنهادی، فایل‌های تغییرکرده، متغیرهای محیطی و نمونه درخواست هر نوع هدف‌گیری را ارائه کن.

فایل راهنمای جامع Pushfa مربوط به پلتفرم این پروژه را کامل بخوان. پیاده‌سازی موجود را فقط به‌صورت Read-only بازبینی کن و هیچ فایلی را تغییر نده. مسیر کامل ثبت Permission، ساخت/Refresh Token، نگهداری Subscriber ID، Login/Logout، External ID، Custom Alias، Topic، دریافت Foreground/Background، Deep Link، Delivery/Click، ارسال Backend، RetenX و Auth Push را Trace کن.

یافته‌ها را با اولویت Critical/High/Medium/Low گزارش بده. برای هر مورد فایل و خط، قرارداد نقض‌شده، اثر واقعی، ریسک امنیتی یا رفتاری و کوچک‌ترین اصلاح پیشنهادی را بنویس. افشای Private Key یا Service Account، اختلاط Service/Tenant، استفاده از Token به‌عنوان هویت پایدار، ثبت دو Handler، از دست‌رفتن Ack و پاک‌نشدن Alias هنگام Logout را به‌طور ویژه بررسی کن.