🎯 هدف:

طراحی و توسعه یک سایت پرداخت‌یار ارزی که امکان اتصال پذیرنده‌ها از طریق API را فراهم می‌کند. کاربران نهایی پس از احراز هویت، از طریق درگاه بانکی ریالی پرداخت می‌کنند و معادل مبلغ به صورت ارز دیجیتال TRON (TRC20)، به کیف پول مقصد پذیرنده از طریق API صرافی کوینکس واریز می‌شود.

⸻

⚙️ تکنولوژی مورد انتظار:

لطفاً پروژه با JavaScript/TypeScript توسعه یابد با استفاده از موارد زیر:

•    Next.js (فرانت‌اند و SSR)
•    TailwindCSS (برای طراحی ریسپانسیو و مدرن)
•    Framer Motion (برای انیمیشن‌های روان)
•    Node.js + Express (برای بک‌اند)
•    MongoDB یا PostgreSQL (برای دیتابیس)
•    Auth + API + Security اصولی

⸻

🧩 ماژول‌ها و صفحات مورد نیاز:

1. سایت عمومی: • صفحه اصلی با معرفی مزایا و دعوت به همکاری • دکمه ورود پذیرنده • FAQ + مستندات API

2. صفحه پرداخت (کاربر نهایی): • دریافت پارامتر از لینک پرداخت • نمایش اطلاعات: مبلغ، مقدار ترون، کیف پول مقصد، نام پذیرنده • فرم ورود: • شماره تلفن همراه • کد ملی • تاریخ تولد • احراز هویت با API زحل • نمایش کارت‌های بانکی متعلق به کاربر (از زحل) • انتخاب کارت → اتصال به درگاه زحل • پس از پرداخت موفق → اتصال به API کوینکس و تسویه آنی • نمایش رسید + وضعیت پرداخت

3. پنل پذیرنده: • ثبت‌نام، ورود، تغییر رمز • ساخت API Key • ساخت لینک پرداخت (مبلغ + کیف پول مقصد) • لیست تراکنش‌ها + فیلتر بر اساس تاریخ و وضعیت • مشاهده هش تراکنش بلاک‌چین + وضعیت تسویه

4. پنل مدیریت: • لیست پذیرندگان • فعال‌سازی/غیرفعالسازی حساب • مشاهده لاگ API‌ها و درخواست‌ها • تنظیمات عمومی: کارمزد، کلید API زحل و کوینکس • بررسی تراکنش‌های معلق + Retry دستی

⸻

🔐 الزامات امنیتی:

•    فقط پرداخت با کارت بانکی به نام دارنده کد ملی مجاز باشد
•    محدودسازی IP در استفاده از API
•    اعتبارسنجی دقیق مقادیر ورودی
•    سیستم لاگ، هشدار، و جلوگیری از پرداخت تکراری

⸻

📄 مستندات:

•    تولید فایل کامل مستندات API برای پذیرندگان (Postman + Markdown)
•    توضیح endpoint‌ها، مدل داده، response‌ها و خطاها

⸻

⏱ زمان‌بندی پروژه:

•    نسخه MVP: حداکثر ۲۰ روز کاری
•    نسخه نهایی با تمام پنل‌ها، تسویه و مستندات: ۳۰ روز کاری

⸻

🎁 تحویل نهایی:

•    سورس کامل پروژه (Next.js + Node.js)
•    فایل‌های مستندات
•    فایل env.sample برای راه‌اندازی
•    تست نهایی روی سرور (یا لوکال)
•    راهنمای اجرا روی Ubuntu + PM2 یا Docker