تجربه: 3

سن: 18 الی 30

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

جای خالی: 1

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

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

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

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

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

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

همچنین کاربر می‌تواند تعیین کند که اطلاعات فیزیکی مجموعه برای سایر شهروندان قابل مشاهده باشد یا تنها برای خود او نمایش داده شود.

---

اهداف

• ایجاد API ثبت اطلاعات فیزیکی ملک یا مجموعه
• ایجاد API دریافت اطلاعات ثبت‌شده
• ایجاد API ویرایش اطلاعات
• اتصال به اطلاعات ISIC موجود در سیستم
• مدیریت وضعیت نمایش عمومی اطلاعات
• اعتبارسنجی اطلاعات ورودی
• آماده‌سازی زیرساخت برای توسعه قابلیت‌های بعدی

---

وظایف Backend
۱. توسعه API ثبت اطلاعات فیزیکی

ایجاد API جهت ثبت اطلاعات فیزیکی شامل فیلدهای زیر:

• شناسه شهروند
• شناسه ملک
• نام مجموعه
• شناسه رشته فعالیت (ISIC) (اختیاری)
• آدرس فیزیکی مجموعه
• کد پستی
• آدرس وب‌سایت
• هدف از تأسیس مجموعه
• وضعیت نمایش عمومی اطلاعات (Public / Private)

پس از ثبت موفق، اطلاعات در پایگاه داده ذخیره گردد.

---

۲. اتصال به اطلاعات ISIC

در هنگام ثبت اطلاعات:

• رشته فعالیت از اطلاعات موجود در جدول ISIC انتخاب شود.
• تنها شناسه معتبر ISIC قابل ثبت باشد.
• انتخاب رشته فعالیت الزامی نباشد.
• در صورت ارسال شناسه نامعتبر، خطای اعتبارسنجی بازگردانده شود.

---

۳. اعتبارسنجی اطلاعات

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

نام مجموعه

• اجباری
• عدم پذیرش مقدار خالی

کد پستی

• فقط مقدار عددی
• دقیقاً ۱۰ رقم
• عدم پذیرش حروف یا کاراکترهای غیرمجاز

آدرس وب‌سایت

• اختیاری
• در صورت ورود، ساختار URL معتبر بررسی شود.

هدف از تأسیس

• اختیاری
• حداکثر 1000 کاراکتر

---

۴. توسعه API دریافت اطلاعات

ایجاد API جهت دریافت اطلاعات ثبت‌شده شامل:

• نام مجموعه
• رشته فعالیت (ISIC)
• آدرس فیزیکی
• کد پستی
• آدرس وب‌سایت
• هدف از تأسیس
• وضعیت نمایش عمومی
• تاریخ ایجاد
• تاریخ آخرین ویرایش

در صورتی که وضعیت اطلاعات برابر Private باشد، اطلاعات تنها برای مالک حساب قابل نمایش باشد.

---

۵. توسعه API ویرایش اطلاعات

ایجاد API جهت ویرایش اطلاعات ثبت‌شده.

ویژگی‌ها:

• امکان ویرایش تمامی فیلدها
• اعمال مجدد اعتبارسنجی‌ها
• ثبت تاریخ آخرین بروزرسانی
• عدم ایجاد رکورد جدید

---

۶. مدیریت حریم خصوصی

امکان تعیین وضعیت اطلاعات:

• Public
• Private

در زمان دریافت اطلاعات توسط سایر کاربران، وضعیت حریم خصوصی بررسی شده و در صورت Private بودن، اطلاعات برای سایر کاربران بازگردانده نشود.

---

۷. ساختار پایگاه داده

اطلاعات زیر در پایگاه داده ذخیره گردد:

• شناسه رکورد
• شناسه شهروند
• شناسه ملک
• شناسه ISIC
• نام مجموعه
• آدرس فیزیکی
• کد پستی
• آدرس وب‌سایت
• هدف از تأسیس
• وضعیت نمایش عمومی
• تاریخ ایجاد
• تاریخ آخرین ویرایش

---

۸. مستندسازی API

تمامی Endpointها در Swagger مستندسازی شوند.

برای هر Endpoint موارد زیر درج گردد:

• Method
• URL
• Request Body
• Response
• Validation
• Status Code
• Error Response
• نمونه درخواست و پاسخ

---

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

• API ثبت اطلاعات فیزیکی ملک
• API دریافت اطلاعات فیزیکی ملک
• API ویرایش اطلاعات
• اتصال کامل به اطلاعات ISIC موجود در سامانه
• اعتبارسنجی کامل تمامی فیلدها
• مدیریت وضعیت Public و Private اطلاعات
• ذخیره‌سازی اطلاعات در پایگاه داده
• مستندسازی کامل Swagger
• آماده‌سازی زیرساخت برای توسعه قابلیت‌های بعدی مرتبط با اطلاعات فیزیکی املاک و مجموعه‌ها در متاورس رنگ.

ویدیو توضیحات:
https://drive.google.com/file/d/1TWf5fQafpr33x6XeSqvGQQ5ZmdryatxW/view?usp=sharing