دقیقاً چه کاری باید انجام شود؟
پیاده‌سازی Pagination مجزا برای فیلد دوره و زیر‌ده اوره در Endpoint صفحختصاصی آموزشگاه در این تسک، اطلاعات دوره و زیر‌دوره در Endpoint مربوط به Single Page آموزشگاه سایت آموزشگاه‌یاب به‌صورت صفحه‌بندی‌شده ارائه خواهد شد.
Pagination دوره و زیر‌دوره باید به‌صورت مجزا و مستقل از یکدیگر پیاده‌سازی شود تا اطلاعات هر بخش به‌صورت جداگانه و صفحه‌بندی‌شده در اختیار فرانت‌اند قرار گیرد.
الزامات تسک پیاده‌سازی Pagination برای فیلد دوره در Endpoint Single Page آموزشگاه.
پیاده‌سازی Pagination برای فیلد زیر‌دوره در Endpoint Single Page آموزشگاه.
Pagination دوره و زیر‌دوره باید به‌صورت کاملاً مجزا عمل کند.
امکان دریافت اطلاعات دوره‌ها به‌صورت صفحه‌بندی‌شده فراهم شود.
امکان دریافت اطلاعات زیر‌دوره‌ها به‌صورت صفحه‌بندی‌شده فراهم شود.
اطلاعات موردنیاز برای مدیریت Pagination در پاسخ API ارائه شود.
ساختار خروجی API باید برای استفاده در صفحه اختصاصی آموزشگاه مناسب باشد.
وظایف اجرایی بررسی ساختار فعلی Endpoint مربوط به Single Page آموزشگاه.
پیاده‌سازی Pagination برای اطلاعات دوره.
پیاده‌سازی Pagination مستقل برای اطلاعات زیر‌دوره.
تعریف پارامترهای موردنیاز Pagination برای هر بخش.
ایجاد ساختار مناسب برای ارسال اطلاعات صفحه فعلی و تعداد آیتم‌ها.
تست دریافت دوره‌ها به‌صورت صفحه‌بندی‌شده.
تست دریافت زیر‌دوره‌ها به‌صورت صفحه‌بندی‌شده.
بررسی عملکرد مستقل Pagination دوره و زیر‌دوره در Endpoint.
بررسی صحت خروجی نهایی API.
خروجی نهایی ارسال اطلاعات دوره‌ها به‌صورت صفحه‌بندی‌شده در Endpoint Single Page آموزشگاه.
ارسال اطلاعات زیر‌دوره‌ها به‌صورت صفحه‌بندی‌شده و مستقل در همان 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): پس از ادغام، رفتارهای سیستم، گزارش‌های لاگ و نتایج مانیتورینگ مورد ارزیابی قرار گرفته و هرگونه رگرسیون یا باگ کشف‌شده سریعاً رفع گردد.