تجربه: 1

سن: 18 الی 30

محدوده حقوق و دستمزد: قابل مذاکره

جای خالی: 1

طبیعت شغلی : پیمانی

تاریخ ارسال : 2026.07.13

آخرین تاریخ : 2026.09.30

در این تسک، زیرساخت Backend مربوط به پنل ادمین آموزشگاه یاب توسعه داده خواهد شد تا مدیر سامانه بتواند لیست کامل کاربران ثبت‌شده را از طریق یک API دریافت نماید.

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

API باید مطابق استانداردهای پروژه طراحی شده، مستندسازی کامل در Swagger داشته باشد و پاسخ‌های استاندارد و قابل استفاده برای Frontend ارائه نماید.

---

وظایف

• توسعه API دریافت لیست کاربران پنل ادمین آموزشگاه.
• پیاده‌سازی قابلیت صفحه‌بندی (Pagination) برای دریافت اطلاعات کاربران.
• پیاده‌سازی قابلیت جستجو در لیست کاربران.
• پیاده‌سازی قابلیت فیلتر اطلاعات کاربران بر اساس پارامترهای موردنیاز.
• مستندسازی کامل Endpoint در Swagger.
• رعایت ساختار استاندارد Response تمامی APIهای پروژه.
• بهینه‌سازی Queryها جهت جلوگیری از افت سرعت در حجم بالای اطلاعات.
• اعتبارسنجی تمامی ورودی‌های API.
• مدیریت صحیح خطاها و ارسال پیام‌های استاندارد.

---

قابلیت‌های موردنیاز API
دریافت اطلاعات کاربران

API باید اطلاعات موردنیاز جهت نمایش کاربران در پنل مدیریت را بازگرداند و صرفاً فیلدهای موردنیاز Frontend ارسال شوند. از ارسال اطلاعات غیرضروری یا داخلی سیستم خودداری گردد.

---

فیلترینگ

امکان فیلتر اطلاعات کاربران بر اساس موارد زیر فراهم گردد:

• استان
• شهر
• دوره آموزشی
• سایر فیلترهای موردنیاز که در صفحه مدیریت کاربران استفاده می‌شوند.

فیلترها باید قابلیت استفاده همزمان را داشته باشند.

---

جستجو

امکان جستجو در لیست کاربران فراهم گردد.

جستجو بر اساس:

• نام آموزشگاه

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

---

صفحه‌بندی (Pagination)

API باید از Pagination استاندارد پشتیبانی نماید.

موارد موردنیاز:

• شماره صفحه
• تعداد آیتم هر صفحه (Page Size)
• تعداد کل رکوردها
• تعداد صفحات
• اطلاعات صفحه جاری

---

الزامات فنی

• استفاده از متد GET.
• رعایت استاندارد REST API.
• پیاده‌سازی Query Parameterها برای فیلتر، جستجو و صفحه‌بندی.
• مستندسازی کامل Endpoint در Swagger.
• استفاده از Response استاندارد پروژه.
• جلوگیری از ارسال اطلاعات حساس کاربران.
• رعایت اصول امنیتی در دریافت اطلاعات.

---

تست و کنترل کیفیت

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

---

خروجی مورد انتظار

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