تجربه: 1

سن: 18 الی 30

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

جای خالی: 1

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

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

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

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

در این فاز صرفاً زیرساخت ذخیره‌سازی مختصات پیاده‌سازی می‌شود و انتخاب موقعیت روی نقشه و رابط کاربری آن در Frontend توسعه خواهد یافت.

---

وظایف

• توسعه ساختار دیتابیس جهت ذخیره مختصات جغرافیایی آموزشگاه.
• افزودن دو فیلد جدید به اطلاعات آموزشگاه.
• توسعه APIهای ایجاد، ویرایش و دریافت اطلاعات آموزشگاه.
• اعتبارسنجی مقادیر Latitude و Longitude.
• بروزرسانی Swagger Documentation.
• آماده‌سازی زیرساخت برای توسعه قابلیت‌های مبتنی بر نقشه در آینده.

---

بخش‌های اجرایی
توسعه ساختار داده

افزودن دو فیلد جدید به اطلاعات آموزشگاه:

• Latitude (عرض جغرافیایی)
• Longitude (طول جغرافیایی)

مختصات باید با دقت مناسب (Decimal) در دیتابیس ذخیره شوند.

---

توسعه APIها
ایجاد آموزشگاه

• امکان ارسال مقدار Latitude
• امکان ارسال مقدار Longitude

ویرایش آموزشگاه

• امکان بروزرسانی مختصات جغرافیایی

دریافت اطلاعات آموزشگاه

در تمامی APIهای دریافت اطلاعات آموزشگاه، مختصات جغرافیایی نیز در Response ارسال گردد.

---

اعتبارسنجی

اعتبارسنجی مقادیر ارسالی:

• مقدار Latitude باید بین 90- تا 90+ باشد.
• مقدار Longitude باید بین 180- تا 180+ باشد.
• فقط مقادیر عددی معتبر پذیرفته شوند.
• در صورت ارسال مقادیر نامعتبر، پیام خطای مناسب بازگردانده شود.

---

سازگاری با Frontend

• Frontend مختصات انتخاب‌شده را از طریق دو فیلد جداگانه به Backend ارسال خواهد کرد.
• Backend بدون انجام هیچ‌گونه پردازش اضافی، مقادیر را پس از اعتبارسنجی ذخیره می‌کند.
• در زمان ویرایش اطلاعات آموزشگاه، مقادیر ذخیره‌شده باید مجدداً برای Frontend ارسال شوند.

---

مستندسازی

• بروزرسانی کامل Swagger Documentation.
• مستندسازی فیلدهای Latitude و Longitude.
• ارائه نمونه Request و Response جدید.
• ثبت قوانین اعتبارسنجی مربوط به مختصات جغرافیایی.

---

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

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