شرح تسک
در پروژه متاورس رنگ، زیرساخت و داده‌های مربوط به بخش رفرال‌گیری (دعوت دوستان) از سمت Backend / API آماده و در دسترس است.
وظیفه این تسک، پیاده‌سازی کامل اتصال فرانت‌اند به APIهای رفرال و نمایش داده‌ها در رابط کاربری مطابق با ساختار سامانه است.
توضیحات عملکرد بخش رفرال
هر کاربر دارای یک کد یا لینک اختصاصی دعوت (Referral Link) است.
زمانی که فرد جدیدی از طریق لینک دعوت یک کاربر در متاورس رنگ ثبت‌نام می‌کند، سیستم باید:
در بخش فرانت، این فرد جدید را در قسمت «دعوتی‌ها / زیرمجموعه‌ها» نمایش دهد.
امتیاز (Reward/Point) مربوط به آن دعوت را به حساب کاربر مادر (دعوت‌کننده) اضافه کند.
تمامی اطلاعات مورد نیاز از طریق APIهای آماده‌ی بک‌اند قابل دریافت است.
توجه فرمایید:
- وقتی شخصی از طریق لینک رفرال بنده وارد صفحه میشود در همان ابتدا باید شناسه بنده که به عنوان دعوت کننده هستم در کوکی یا هر جایی که قادر هستید ذخیره شود تا اگر کاربر از طریق شناسه من به صفحه مشخصات من مراجعه کرد اما در ابتدای کار ثبت نام نکرد و به صفحات دیگر رفت و از طریق دیگر صفحات متاورس رنگ ثبت نام کرد باز هم زیرجموعه بنده شود.
- وقتی کاربری از دو نفر لینک رفرال دریافت کرده است و از طریق لینک رفرال اولین فرد صفحات متاورس رنگ را مشاهده کرد ولی ثبت نام نکرد و با لینک دوم بعدا صفخات را مشاهده کرد و ثبت نام کرد میبایست زیرمجموعه نفر دوم شود.
الزامات و جزئیات فنی
1.اتصال به APIهای بخش رفرال طبق مستندات ارائه‌شده توسط بک‌اند.
2.نمایش لیست افراد دعوت‌شده (زیرمجموعه‌ها) با جزئیات آن
گام‌های پیشنهادی اجرا
معیار پذیرش (Acceptance Criteria)
بررسی مستندات API و اطمینان از صحت ساختار پاسخ‌ها (Response Structure).
پیاده‌سازی اتصال APIها در سطح Service یا Store پروژه.
طراحی و پیاده‌سازی UI مطابق با سیستم دیزاین موجود.
نمایش داده‌ها در کامپوننت دعوتی‌ها و امتیاز.
تست عملکرد با داده‌های واقعی و سناریوهای مختلف ثبت‌نام از طریق لینک دعوت.
رفع باگ‌ها و آماده‌سازی برای Merge Request.
اتصال کامل به API و دریافت صحیح داده‌های دعوتی‌ها و امتیازها.
نمایش لیست دعوت‌شده‌ها در رابط کاربری با داده واقعی.
نمایش و عملکرد صحیح لینک دعوت کاربر.
طراحی هماهنگ با سیستم دیزاین (Light/Dark) و بدون خطای بصری.
مدیریت خطاها و حالت‌های بدون داده (Empty State) به‌صورت استاندارد.
تست موفق بر روی محیط تست (Staging) با داده واقعی.
تحویل دادنی ها
کد نهایی پیاده‌سازی‌شده در فرانت با Merge Request.
مستند کوتاه نحوه تست و عملکرد.
-----------------------------------------------------------------------
منابع مرتبط با تسک
دسترسی به ریپازیتوری پروژه نکست خارجی متارنگ :
https://github.com/iranpsc/Metaverse-Rang-Front-NextJS
لینک فیگما بخش های خارجی متارنگ :
https://www.figma.com/design/qyvJ4Sjw4h5gRIrE9KotBY/ui-next?node-id=1957-4055&t=43QGHNIE6h4i1O8I-1
لینک سایت رسمی پروژه :
https://rgb.irpsc.com/fa
دسترسی به سامانه مدیریت بر مدیران :
https://crm.irpsc.com