در این تسک، اطلاعات دوره و زیر‌دوره در 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): پس از ادغام، رفتارهای سیستم، گزارش‌های لاگ و نتایج مانیتورینگ مورد ارزیابی قرار گرفته و هرگونه رگرسیون یا باگ کشف‌شده سریعاً رفع گردد.