در این تسک، قابلیت مشاهده پروفایل سایر شهروندان از طریق کلیک روی تصویر پروفایل (آواتار) آنها در تمامی بخشهای ایندکس داخلی سامانه متارنگ (نسخه React) پیادهسازی خواهد شد.
هدف از این توسعه، فراهمکردن امکان دسترسی به اطلاعات و بخشهای مختلف پروفایل سایر شهروندان، مشابه پروفایل شخصی کاربر است. به این منظور، با انتخاب آواتار هر شهروند، اطلاعات اختصاصی او بر اساس شناسه کاربری (Citizen ID / User ID) از API دریافت شده و در مدال پروفایل نمایش داده میشود.
نکته کلیدی: در این تسک هیچ مدال جدیدی طراحی نخواهد شد و ساختار ظاهری مدال فعلی نیز نباید تغییر کند. توسعه باید بر مبنای استفاده مجدد از کامپوننت موجود پروفایل انجام شود؛ بهگونهای که مدال فعلی بهصورت داینامیک، متناسب با شناسه شهروند انتخابشده، اطلاعات مربوط به همان فرد را دریافت و نمایش دهد.
۲. الزامات تسک
۲.۱. فعالسازی قابلیت کلیک روی آواتار شهروندان
امکان کلیک روی تصویر پروفایل سایر شهروندان در تمامی بخشهای ایندکس داخلی فراهم شود.
با کلیک روی آواتار، مدال پروفایل فعلی باز شده و اطلاعات شهروند انتخابشده از API دریافت شود.
شناسه اختصاصی شهروند انتخابشده بهعنوان ورودی اصلی دریافت اطلاعات پروفایل استفاده شود.
این قابلیت باید در تمام بخشهایی که آواتار شهروندان نمایش داده میشود، بهصورت یکپارچه عمل کند.
۲.۲. نمایش اطلاعات و تبهای پروفایل شهروندان
اطلاعات پایه شهروند شامل تصویر پروفایل، مشخصات هویتی و داراییهای کلی نمایش داده شود.
تمامی تبهای موجود در پروفایل شخصی، از جمله داراییها، دودمان و سایر بخشهای فعلی، برای پروفایل سایر شهروندان نیز قابل مشاهده و استفاده باشند.
اطلاعات هر تب باید بر اساس شناسه شهروند انتخابشده از API دریافت شود.
جابهجایی میان پروفایل شهروندان مختلف نباید باعث نمایش اطلاعات قبلی، تداخل دادهها یا باقیماندن اطلاعات کششده شهروند قبلی شود.
وضعیت بارگذاری، خطاهای احتمالی و نبود اطلاعات در هر بخش بهدرستی مدیریت شود.
۲.۳. پیادهسازی قابلیت یادداشت خصوصی (Private Note)
در انتهای مدال پروفایل سایر شهروندان، بخشی برای ثبت و مدیریت یادداشت شخصی کاربر در نظر گرفته شود.
قابلیتهای موردنیاز:
امکان مشاهده یادداشت قبلی ثبتشده درباره هر شهروند.
امکان ثبت یادداشت جدید برای شهروند انتخابشده.
امکان ویرایش و بهروزرسانی یادداشت ثبتشده.
دریافت و ذخیره اطلاعات یادداشت از طریق API.
بازیابی خودکار یادداشت هنگام مراجعه مجدد به پروفایل همان شهروند.
الزام حریم خصوصی: یادداشتها کاملاً خصوصی هستند و صرفاً برای کاربری که آنها را ثبت کرده قابل مشاهده خواهند بود. بنابراین، هر یادداشت باید بر اساس ترکیب شناسه نویسنده یادداشت و شناسه شهروند هدف مدیریت شود و سایر کاربران به محتوای آن دسترسی نداشته باشند.
۲.۴. اتصال قابلیت محدودسازی شهروندان به API
گزینههای مربوط به محدودسازی شهروندان که در ساختار فعلی مدال پروفایل وجود دارند، باید به Endpointهای مربوطه متصل شوند.
کاربر بتواند محدودیتهای موردنظر خود را برای شهروند مقابل اعمال کند.
امکان مشاهده وضعیت محدودیتهای اعمالشده و ویرایش آنها فراهم باشد.
تغییرات باید از طریق API در بکاند ثبت و ذخیره شوند.
وضعیت محدودیتها پس از بازگشایی مجدد پروفایل نیز باید مطابق اطلاعات ذخیرهشده در بکاند نمایش داده شود.
۲.۵. حفظ عملکرد پروفایل شخصی کاربر
در صورت کلیک روی آواتار خود کاربر، مدال باید مانند قبل و با همان عملکرد فعلی باز شود.
تمامی تبها، اطلاعات و قابلیتهای موجود در پروفایل شخصی بدون اختلال باقی بمانند.
منطق تشخیص پروفایل شخصی و پروفایل سایر شهروندان باید بهصورت داینامیک و بر اساس شناسه کاربر انجام شود.
۳. وظایف اجرایی
بررسی ساختار فعلی کامپوننت مدال پروفایل و نحوه فراخوانی اطلاعات آن.
بررسی مستندات API و Endpointهای آمادهشده توسط توسعهدهنده میکروسرویس.
اصلاح منطق کامپوننت پروفایل بهمنظور دریافت و مدیریت شناسه شهروند هدف (Citizen ID / User ID).
شناسایی تمامی محلهای نمایش آواتار سایر شهروندان در ایندکس داخلی و فعالسازی قابلیت کلیک روی آنها.
اتصال اطلاعات پایه پروفایل به API و نمایش اطلاعات شهروند انتخابشده.
اتصال تمامی تبهای موجود در مدال پروفایل به Endpointهای مربوطه و دریافت اطلاعات بر اساس شناسه شهروند هدف.
پیادهسازی بخش یادداشت خصوصی شامل دریافت، ثبت و ویرایش یادداشتها.
اتصال گزینههای محدودسازی شهروندان به API و مدیریت وضعیت محدودیتها.
مدیریت وضعیتهای بارگذاری، خطا، تغییر شهروند هدف و بهروزرسانی اطلاعات دریافتی.
انجام تست یکپارچگی برای اطمینان از عملکرد صحیح پروفایل شخصی و پروفایل سایر شهروندان.
۴. نکات فنی و ملاحظات توسعه
استفاده مجدد از کامپوننت (Reusability): استفاده از همان کامپوننت فعلی مدال پروفایل الزامی است و ایجاد کامپوننت یا مدال موازی برای این قابلیت مجاز نیست.
مدیریت داینامیک شناسه: کامپوننت باید با دریافت citizenId یا userId، مالکیت پروفایل را تشخیص داده و درخواستهای API را متناسب با شهروند هدف ارسال کند.
تفکیک اطلاعات: اطلاعات پروفایل شخصی و پروفایل سایر شهروندان باید بهدرستی مدیریت شوند تا هیچگونه تداخل اطلاعاتی رخ ندهد.
مدیریت وضعیت دادهها: هنگام تغییر شهروند انتخابشده، اطلاعات قبلی باید پاکسازی یا بهدرستی جایگزین شوند.
حفظ ساختار رابط کاربری: ظاهر، چیدمان و ساختار فعلی مدال نباید تغییر کند؛ تنها قابلیتهای موردنیاز به آن اضافه شوند.
هماهنگی با بکاند: مستندات Endpointهای مربوط به اطلاعات پروفایل، تبها، یادداشت خصوصی و محدودسازی شهروندان توسط توسعهدهنده میکروسرویس در بخش کامنت تسک ارائه خواهد شد. پیادهسازی فرانتاند باید مطابق همین مستندات انجام شود.
۵. خروجی نهایی
امکان بازکردن پروفایل هر شهروند از طریق کلیک روی آواتار او در تمامی بخشهای ایندکس داخلی.
نمایش کامل اطلاعات شهروند انتخابشده در مدال پروفایل فعلی، بدون ایجاد مدال جدید.
فعالبودن تمامی تبهای پروفایل و نمایش اطلاعات اختصاصی هر شهروند.
امکان ثبت، مشاهده و ویرایش یادداشتهای خصوصی برای سایر شهروندان با رعایت کامل حریم خصوصی.
امکان اعمال، مشاهده و ویرایش محدودیتهای شهروندان از طریق API.
حفظ کامل عملکرد فعلی پروفایل شخصی کاربر.
۶. معیارهای پذیرش (Acceptance Criteria)
کلیک روی آواتار هر شهروند در هر بخش از ایندکس داخلی، مدال پروفایل را با اطلاعات صحیح همان شهروند باز کند.
اطلاعات نمایشدادهشده در مدال، بر اساس شناسه شهروند انتخابشده از API دریافت شوند.
تمامی تبهای پروفایل، از جمله داراییها و دودمان، اطلاعات شهروند هدف را بدون تداخل یا خطا نمایش دهند.
کاربر بتواند برای هر شهروند یادداشت خصوصی ثبت یا ویرایش کند و در مراجعات بعدی همان یادداشت را مشاهده کند.
یادداشتهای خصوصی فقط برای نویسنده آنها قابل مشاهده باشند.
گزینههای محدودسازی شهروندان بهدرستی عمل کرده و تغییرات در بکاند ذخیره شوند.
با تغییر شهروند انتخابشده، هیچ اطلاعاتی از پروفایل قبلی در مدال باقی نماند.
پروفایل شخصی کاربر بدون هیچگونه اختلال و مطابق عملکرد قبلی قابل استفاده باشد.
هیچ مدال جدیدی ایجاد نشده و تمام قابلیتها در چارچوب کامپوننت فعلی پروفایل پیادهسازی شده باشند.
جهت مطالعه کامل تسک در گیتهاب از لینک زیر اقدام نمایید
https://github.com/iranpsc/Metaverse-Rang-Front-ReactJS/issues/170