جزئیات شغل

در این تسک، قابلیت Pagination مجزا برای اطلاعات دوره و زیر‌دوره در Endpoint مربوط به Single Page آموزشگاه سایت آموزشگاه‌یاب پیاده‌سازی خواهد شد.

اطلاعات دوره‌ها و زیر‌دوره‌های مرتبط با هر آموزشگاه باید به‌صورت صفحه‌بندی‌شده و مستقل از یکدیگر در خروجی API ارسال شوند تا امکان مدیریت و نمایش تعداد زیادی دوره و زیر‌دوره در صفحه اختصاصی هر آموزشگاه بدون ارسال حجم بالای اطلاعات در یک درخواست فراهم شود.

الزامات تسک

پیاده‌سازی Pagination برای اطلاعات دوره‌ها در Endpoint مربوط به Single Page آموزشگاه.
پیاده‌سازی Pagination برای اطلاعات زیر‌دوره‌ها به‌صورت مجزا.
Pagination دوره و زیر‌دوره باید مستقل از یکدیگر عمل کند.
امکان دریافت تعداد مشخصی از دوره‌ها در هر صفحه فراهم شود.
امکان دریافت تعداد مشخصی از زیر‌دوره‌ها در هر صفحه فراهم شود.
اطلاعات Pagination شامل موارد موردنیاز برای مدیریت صفحات باشد.
ساختار خروجی API به‌گونه‌ای باشد که فرانت‌اند بتواند دوره‌ها و زیر‌دوره‌ها را به‌صورت مستقل نمایش و مدیریت کند.
پیاده‌سازی باید بدون ایجاد اختلال در سایر اطلاعات Endpoint مربوط به Single Page آموزشگاه انجام شود.

وظایف اجرایی

بررسی ساختار فعلی Endpoint مربوط به Single Page آموزشگاه.
شناسایی اطلاعات دوره و زیر‌دوره مرتبط با هر آموزشگاه.
پیاده‌سازی Pagination مجزا برای لیست دوره‌ها.
پیاده‌سازی Pagination مجزا برای لیست زیر‌دوره‌ها.
تعریف پارامترهای موردنیاز Pagination برای هر بخش.
ایجاد ساختار مناسب برای ارسال اطلاعات صفحه فعلی، تعداد آیتم‌ها و اطلاعات موردنیاز Pagination.
تست دریافت دوره‌ها به‌صورت صفحه‌بندی‌شده.
تست دریافت زیر‌دوره‌ها به‌صورت صفحه‌بندی‌شده.
بررسی عملکرد مستقل Pagination دوره و زیر‌دوره در Endpoint.
بررسی خروجی نهایی API و آماده‌سازی آن برای استفاده در صفحه اختصاصی آموزشگاه.

خروجی نهایی

پیاده‌سازی Pagination مجزا برای دوره‌ها در Endpoint Single Page آموزشگاه.
پیاده‌سازی Pagination مجزا برای زیر‌دوره‌ها در همان Endpoint.
ارسال اطلاعات دوره و زیر‌دوره به‌صورت مستقل و صفحه‌بندی‌شده.
ارائه اطلاعات موردنیاز Pagination در پاسخ API.
Endpoint آماده استفاده در صفحه اختصاصی آموزشگاه سایت آموزشگاه‌یاب.

دستورالعمل جامع تحویل تسک‌ها و چرخه حیات توسعه (Definition of Done)

در فرآیند ثبت و اجرای تمامی تسک‌ها، رعایت اصول زیر الزامی است (بسته به ماهیت و دامنه هر تسک/سرویس، برخی جزئیات ممکن است کم یا زیاد شوند):

محیط و مخزن تحویل: شروع، توسعه و تحویل کار باید منحصراً روی گیت‌هاب (GitHub)، در مخزن اختصاصی پروژه و برنچ تعیین‌شده (Feature Branch یا برنچ موظف طبق ساختار GitFlow) انجام پذیرد.

استقرار نسخه آزمایشی (Staging): پس از اتمام توسعه اولیه، نسخه کاندید جهت انجام تست‌های پذیرش (Acceptance / Smoke Tests) بر روی محیط استقرار موقت (Staging / Development Server) دیپلوی شود.

معیارهای پذیرش کیفی، امنیتی و پایش:

تکمیل و به‌روزرسانی فایل README.md مخزن شامل راهنمای اجرا، تست و متغیرها.

پاس شدن کامل گیت‌های کیفی (Quality Gates) شامل بررسی استانداردهای کد، Linting و تحلیل ایستا (Static Analysis).

رفع کامل آسیب‌پذیری‌ها و خطاهای امنیتی (Security Gates) در ابزارهای پویش سورس و وابستگی‌ها.

یکپارچه‌سازی و اتصال بدون خطای سرویس به ابزار رصد خطا (Sentry Integration) برای لاگین و ترکینگ دقیق رویدادهای بحرانی.

تست‌نویسی کامل بر اساس متدولوژی TDD با پوشش کد بالا (حداکثر پوشش ممکن / ۱۰۰٪ در بخش‌های منطق تجاری حیاتی).

ادغام کد (Merge to Main): تنها پس از تأیید ناظر/تیم فنی و موفقیت تمام خطوط لوله یکپارچه‌سازی مداوم (CI/CD)، درخواست ادغام (Pull Request) به برنچ main اعمال شود.

آنالیز و رفع عیوب پس از ادغام (Post-Merge Analysis): پس از ادغام، رفتارهای سیستم، گزارش‌های لاگ و نتایج مانیتورینگ مورد ارزیابی قرار گرفته و هرگونه رگرسیون یا باگ کشف‌شده سریعاً رفع گردد.