پرش به محتویات

نشانی و تصویر در اطلاعات تکمیلی

این مشخصات همراه فقط بخش اطلاعات تکمیلی از SET-06، OBM-UF-02 و OBM-WF-04 را تکمیل می‌کند. تصمیم کاربر در 2026-09-19 و Figma، node 1349-6973 مرجع این جریان‌اند. تغییر سایر بخش‌های راه‌اندازی و Flutter در محدوده این تصمیم نیست.

مسیر کاربر

  1. کاربر دارای setup.manage از Dashboard همان ساختمان وارد اطلاعات تکمیلی می‌شود.
  2. استان، شهر، نشانی، پلاک و کد پستی قبلی دریافت می‌شوند. تکمیل نشانی اجباری نیست؛ کد پستی در صورت ورود باید ده رقم باشد.
  3. «ذخیره نشانی و ادامه» ثبت مستقل نشانی را انجام می‌دهد و پس از موفقیت، مرحله تصویر را باز می‌کند. ثبت نشانی به‌تنهایی این بخش را تکمیل نمی‌کند.
  4. کاربر یکی از چهار آواتار محلی را انتخاب می‌کند یا JPEG، PNG یا WebP حداکثر ۲ مگابایت بارگذاری می‌کند.
  5. «انتخاب تصویر و تکمیل راه‌اندازی» تا پایان ثبت منتظر می‌ماند. Preview، شروع Upload و پاسخ در حال پردازش، موفقیت نهایی نیستند.
  6. ثبت موفق آواتار یا عکس بررسی‌شده، بخش را COMPLETED می‌کند. کاربر به Dashboard راه‌اندازی همان ساختمان برمی‌گردد و تصویر انتخاب‌شده را می‌بیند.

فهرست محلی استان و شهر

با تأیید کاربر در 2026-09-20، چهار گزینه نمایشی با Snapshot تقسیمات کشوری سال ۱۴۰۴ شامل ۳۱ استان جایگزین می‌شوند. منبع IranCountryDivisions، فایل data/1404/iran.json و نسخه 68687cf96cc1852d5d38c7283353c80829331758 با مجوز MIT و Copyright متعلق به Hamed Saeedi در سال ۲۰۲۰ است. منبع، فایل جغرافیایی مرکز آمار را نیز نگهداری می‌کند. از ۱۴۸۱ رکورد شهر، ۱۴۷۸ نام یکتای شهر در استان استخراج شده‌اند؛ نام یکسان شهرهای یک استان در قرارداد متنی فعلی یک گزینه است. متن کامل مجوز و انتساب همراه Frontend در /licenses/iran-addresses.txt منتشر می‌شود.

فقط نوع استان (DivisionType=1) و شهر (DivisionType=5) وارد شده‌اند؛ استان شهر از زنجیره والدها استخراج می‌شود. مناطق شهری و آبادی‌ها وارد گزینه شهر نمی‌شوند. فاصله ابتدا و انتهای نام حذف، «ي/ك» به «ی/ک» تبدیل و نام‌ها مرتب شده‌اند. داده در Bundle محلی است و انتخاب نشانی هیچ درخواست خارجی ندارد. این Snapshot جامعه‌محور بر پایه داده سال ۱۴۰۴ است و تطابق با تغییرات بعدی تقسیمات رسمی تضمین نمی‌شود؛ به همین دلیل مبنای رد نشانی در Backend نیست. آزمون داده، قرار داشتن طبس در خراسان جنوبی و حذف مناطق شهری از گزینه‌ها را نیز بررسی می‌کند.

انتخاب شهر به استان وابسته است. با تغییر صریح استان، شهر قبلی پاک می‌شود تا ترکیب نامرتبط ارسال نشود. استان و شهر همچنان اختیاری‌اند. نام ذخیره‌شده‌ای که در Snapshot نیست، نمایش داده و حفظ می‌شود؛ باز کردن صفحه یا ثبت بدون تغییر نباید نشانی قدیمی را حذف کند. آزمون پذیرش شامل تعداد و یکتایی داده، وابستگی شهر به استان، پاک شدن شهر پس از تغییر استان، نشانی خالی و حفظ داده قدیمی است.

وضعیت و خطا

داده پایدار وضعیت بخش
بدون نشانی و تصویر NOT_STARTED
نشانی بدون تصویر IN_PROGRESS، ۵۰ درصد
تصویر ذخیره‌شده، با یا بدون نشانی COMPLETED
Upload ناموفق، ناقص یا در حال بررسی بدون تغییر وضعیت قبلی

تصمیم قبلی DEFERRED با ورود به صفحه پاک نمی‌شود؛ ثبت نهایی تصویر آن را به تکمیل تغییر می‌دهد. این عملیات بخش دیگری را تکمیل نمی‌کند و اعلان یا پیامک ندارد.

در خطای شبکه، انتخاب و ورودی‌های همان صفحه حفظ می‌شوند. Retry عکس از همان Upload استفاده می‌کند و بارگذاری موفق قبلی را تکرار نمی‌کند. تغییر نسخه ساختمان باید با دریافت و بازبینی داده جدید حل شود؛ بازنویسی خودکار مجاز نیست. خواندن یا انتخاب عکس ساختمان یا Account دیگر رد می‌شود.

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