آنچه هر نقش میتواند ببیند و انجام دهد — اندپوینتها، مسئولیتها و مراحل فرآیند. سوپر ادمین در این مستند نیست.
| وظیفه اصلی | محدوده | پنل ورود | enum نقش |
|---|---|---|---|
| مشاهده تمام فایلها؛ مدیریت شعب و کارشناسان؛ گزارشگیری؛ امتیازدهی به کارشناسان | سطح تنانت | پورتال بیمهگر | company |
| قفلکردن پروندههای تقصیر، بررسی اسناد طرفین، صدور رأی یا درخواست ارسال مجدد | صف DISAGREEMENT تنانت | پنل کارشناس تقصیر | expert |
| قفلکردن خسارت، قیمتگذاری، اعتبارسنجی فاکتورها، درخواست ارسال مجدد/بازدید | صف خسارت تنانت | پنل خسارت | damage_expert |
| ثبت حضوری تقصیر + خسارت در V2/V3؛ دسترسی به پنلهای تقصیر/خسارت | فایلهای ساختهشده توسط خود | پنل کارشناس میدانی | field_expert |
| روایت طرفین V4/V5 (OTP، استعلام، جزئیات، امضا)؛ تأیید خسارت در V5 | فایلهای ساختهشده توسط خود | پنل فایلساز | file_maker |
| ارزیابی خسارت V4/V5 (فیلدهای تصادف، قطعات، عکسها، امضای مالک) | فایلهای تخصیصیافته | پنل بازبین فایل | file_reviewer |
| ثبت حضوری اداری تقصیر + خسارت به نمایندگی از طرفین | فایلهای ساختهشده توسط خود | پنل ثبات | registrar |
| ثبت تلفنی V6: اجرای استعلام، ارسال لینک؛ کاربر بقیه را تکمیل میکند | فایلهای ساختهشده توسط خود | پنل مرکز تماس | call_center |
به ازای هر تنانت شرکت بیمه یک اکتور company وجود دارد. پورتال بیمهگر
لایه مدیریتی است: میتواند همه چیز زیر تنانت خود را ببیند، لیست کارشناسان را مدیریت
کند، شعب را اداره کند، تنظیمات رسانهای هر تنانت را پیکربندی کند و گزارشهای آماری
استخراج کند. بیمهگر هرگز مستقیماً با مراحل تقصیر/خسارت درگیر نمیشود — فقط نظارهگر
و امتیازدهنده است.
expert-insurer/| متد | مسیر | توضیح |
|---|---|---|
| GET | expert-insurer/files | فهرست تمام فایلهای تقصیر + خسارت تنانت (ادغامشده بر اساس publicId). فیلترپذیر بر اساس وضعیت، نوع فایل، جستجو، مرتبسازی، صفحه. |
| GET | expert-insurer/files/:publicId | جزئیات کامل یک فایل بر اساس publicId. |
| GET | expert-insurer/files/:publicId/timeline | تایملاین فعالیت به ترتیب زمانی (تمام رویدادهای تاریخچه: منبع، نوع، اکتور، متادیتا). |
| GET | expert-insurer/files/:publicId/report | دادههای ساختاریافته گزارش برای تولید PDF (بخشهای مالک، راننده، بیمه، خودرو، تصادف). |
| PUT | expert-insurer/files/:publicId/rating | امتیازدهی به کارشناسان یک فایل (۱–۵ در هر بُعد: روش تصادف، بهموقعبودن، دقت علت، دقت شناسایی مقصر، امتیاز ربات). |
| GET | expert-insurer/report/unified-file-statuses | کاتالوگ وضعیت یکپارچه + تعداد به ازای هر وضعیت برای کل پرتفولیوی تنانت. فیلترپذیر بر اساس fileType و بازه تاریخ. |
| GET | expert-insurer/report/status-counts | منسوخشده — از unified-file-statuses استفاده کنید. |
expert-insurer/branches| متد | مسیر | توضیح |
|---|---|---|
| GET | expert-insurer/branches | فهرست تمام شعب این بیمهگر. پارامترها: جستجو، بازه تاریخ from/to، فیلتر isActive. |
| POST | expert-insurer/branches | افزودن شعبه جدید (نام، کد، آدرس، شهر، تلفن و غیره). |
| PUT | expert-insurer/branches/:branchId/status | فعال یا غیرفعال کردن یک شعبه. |
expert-insurer/experts| متد | مسیر | توضیح |
|---|---|---|
| POST | expert-insurer/experts/blame | ایجاد حساب کارشناس تقصیر جدید زیر این بیمهگر. |
| POST | expert-insurer/experts/claim | ایجاد حساب کارشناس خسارت جدید زیر این بیمهگر. |
| POST | expert-insurer/experts/file-maker | ایجاد حساب فایلساز جدید زیر این بیمهگر. |
| POST | expert-insurer/experts/file-reviewer | ایجاد حساب بازبین فایل جدید زیر این بیمهگر. |
| GET | expert-insurer/experts/list | فهرست صفحهبندیشده تمام حسابهای کارشناس در این تنانت. |
| GET | expert-insurer/experts/top | برترین کارشناسان تقصیر و خسارت رتبهبندیشده بر اساس میانگین امتیاز کلی (حداکثر ۱۰ نفر از هر نوع). |
| GET | expert-insurer/top-experts | نام مستعار experts/top (سازگاری با فرانتاند). |
| GET | expert-insurer/:expertId | فایلهای رسیدگیشده توسط یک کارشناس (ردیفهای خلاصه — تقصیر یا خسارت بسته به نوع کارشناس). |
| متد | مسیر | توضیح |
|---|---|---|
| GET | expert-insurer/statistics | کارتهای KPI: totalFilesReviewed، averageUserRating، inPersonCount، filesThisMonth، objectionPercentage و غیره. فیلترپذیر بر اساس بازه تاریخ. |
| GET | expert-insurer/top-files | ۱۰ فایل خسارت برتر بر اساس بالاترین امتیاز (ترکیبی از امتیاز بیمهگر + کاربر). |
| GET | expert-insurer/expert-work-log | لاگ کاری هر کارشناس: totalHandled، currentlyChecking، distinctFilesCheckedInPeriod. فیلترپذیر بر اساس expertKind و بازه تاریخ. |
| GET | reports/report/insurer/requests | تعداد خسارت + وضعیت تقصیر + تعداد فایل یکپارچه برای تنانت. |
| GET | reports/report/insurer/per-month-requests | همان خلاصه، تفکیکشده بر اساس ۵ ماه تقویمی اخیر. |
| GET | reports/report/insurer/checked-requests | همان خلاصه، فیلترشده بر اساس بازه زمانی اختیاری createdAt. |
| GET | reports/report/insurer/expert-work-log | لاگ کاری کارشناسان (مجموعههای کارشناس تقصیر و خسارت، نه کارشناسان میدانی). |
| GET | reports/report/insurer/expert-work-log/per-month | همان لاگ کاری تفکیکشده بر اساس ماه تقویمی (۵ ماه اخیر). |
client-panel/| متد | مسیر | توضیح |
|---|---|---|
| GET | client-panel/settings | دریافت محدودیتهای رسانهای هر تنانت (حداکثر بایت ویدیو/تصویر/صوت) و پنجره زمانی تصادف CAR_BODY (روز). |
| PATCH | client-panel/settings | بهروزرسانی جزئی این تنظیمات. نمیتواند از سقفهای سطح سیستم تجاوز کند. |
فایلهای تقصیر در صف DISAGREEMENT را بررسی میکند — پروندههایی که دو طرف درباره
مقصر بودن توافق ندارند. پس از بررسی اسناد و اظهارات طرفین، کارشناس پرونده را قفل
میکند، سپس یا رأی صادر میکند، درخواست ارسال مجدد اسناد میدهد، یا نتیجه بازدید
حضوری را ثبت میکند. تمام اندپوینتها زیر v2/expert-blame/ هستند.
۱ مرور فهرست ← ۲ تخصیص (قفل) پرونده ← ۳ بررسی مدارک طرفین (ویدیو، صدا، اسناد) ← ۴الف صدور رأی یا ۴ب درخواست ارسال مجدد اسناد یا ۴پ ثبت بازدید حضوری.
v2/expert-blame/| متد | مسیر | توضیح |
|---|---|---|
| GET | v2/expert-blame/ | فهرست پروندههای تقصیر در صف DISAGREEMENT (موجود، قفلشده توسط من، یا تصمیمگرفتهشده توسط من). پارامترها: search، sortBy، sortOrder، page، limit، unifiedStatus، fileType. |
| GET | v2/expert-blame/:id | جزئیات کامل یک پرونده تقصیر (اظهارات، عکس، صدا، ویدیو طرفین). |
| POST | v2/expert-blame/:id/assign | بررسی در دسترس بودن و قفل پرونده برای این کارشناس. بازمیگرداند: assigned، already_assigned_to_you، یا ۴۰۹ در صورتی که شخص دیگری آن را نگه داشته باشد. |
| PUT | v2/expert-blame/reply/submit/:id | ارسال رأی (accidentWay، accidentReason، accidentType، تصمیم طرف مقصر). پرونده را آزاد میکند و به COMPLETED منتقل میکند. |
| PUT | v2/expert-blame/reply/resend/:id | درخواست از طرفین برای بارگذاری مجدد اسناد. تقصیر را به WAITING_FOR_RESEND تنظیم میکند. یک درخواست ارسال مجدد در هر چرخه عمر. |
| PUT | v2/expert-blame/reply/inPerson/:id | ثبت اینکه بازدید حضوری انجام شده و صدور رأی. |
| GET | v2/expert-blame/report/unified-file-statuses | کاتالوگ وضعیت + تعداد به ازای هر وضعیت برای پرتفولیوی این کارشناس. |
| GET | v2/expert-blame/report/status-counts | منسوخشده — از unified-file-statuses استفاده کنید. |
| PUT | v2/expert-blame/lock/:id | اندپوینت قفل منسوخشده — از POST assign استفاده کنید. |
فایلهای خسارت را پس از ارسال مدارک خسارت توسط کاربر بررسی میکند. کارشناس
هر قطعه آسیبدیده را قیمتگذاری میکند، بهصورت اختیاری کاهش قیمت (استهلاک)
محاسبه میکند، و میتواند از کاربر بخواهد مدارک را مجدداً ارسال کند، حضوری مراجعه
کند، یا فاکتورهای تعمیرگاه را هنگام نیاز به قیمتگذاری کارگاهی بارگذاری کند.
تمام اندپوینتها زیر v2/expert-claim/ هستند.
۱ مرور فهرست ← ۲ تخصیص (قفل) خسارت ← ۳ بررسی عکسها و اسناد خسارت ← ۴ ویرایش اختیاری قطعات انتخابشده یا محاسبه کاهش قیمت ← ۵الف ارسال پاسخ قیمتگذاریشده یا ۵ب درخواست ارسال مجدد یا ۵پ درخواست بازدید حضوری ← ۶ در صورت وجود قطعات فاکتوردار: اعتبارسنجی فاکتورهای تعمیرگاه بارگذاریشده.
v2/expert-claim/| متد | مسیر | توضیح |
|---|---|---|
| GET | v2/expert-claim/requests | فهرست خسارتها در صف WAITING_FOR_DAMAGE_EXPERT + صف اعتبارسنجی فاکتور. پارامترها: search، sortBy، page، limit، unifiedStatus، fileType. |
| GET | v2/expert-claim/request/:claimRequestId | جزئیات کامل خسارت: قطعات آسیبدیده، تصاویر گرفتهشده، اسناد، priceDrop، داده طرف بلیم، آدرسهای ویدیو. |
| POST | v2/expert-claim/assign/:claimRequestId | قفل خسارت برای این کارشناس. بازمیگرداند: assigned، already_assigned_to_you، یا ۴۰۹. |
| GET | v2/expert-claim/request/:claimRequestId/price-drop | محتوای کاهش قیمت: برچسبهای شدت، کاتالوگ ضریب، قطعات آسیبدیده + نگاشت، سال پیشنهادی خودرو از استعلام تقصیر. |
| PUT | v2/expert-claim/request/:claimRequestId/price-drop | محاسبه و ذخیره کاهش قیمت: قیمت خودرو × ضریب سال × مجموع ضرایب ÷ ۴۰۰. |
| PUT | v2/expert-claim/reply/submit/:claimRequestId | ارسال پاسخ ارزیابی خسارت (لیست قطعات قیمتگذاریشده، داغی، branchId). سقف: کل ≤ ۵۳،۰۰۰،۰۰۰ تومان. بسته به پرچمهای factorNeeded، خسارت را به owner-sign، mixed-factors-pending، یا صف اعتبارسنجی فاکتور منتقل میکند. |
| PUT | v2/expert-claim/reply/resend/:claimRequestId | درخواست از کاربر برای ارسال مجدد اسناد/عکسها. یک ارسال مجدد در هر چرخه خسارت؛ در صورت تکمیل قبلی ۴۲۲ برمیگرداند. |
| PATCH | v2/expert-claim/:claimRequestId/visit | درخواست از کاربر برای مراجعه حضوری. خسارت را آزاد میکند، وضعیت claimStatus را به NEEDS_REVISION تنظیم میکند. |
| PATCH | v2/expert-claim/validate-factors/:claimRequestId | اعتبارسنجی فاکتورهای تعمیرگاه بارگذاریشده. تأیید یا رد هر خط فاکتور با totalPayment. سقف برای تمام خطوط اعمال میشود (≤ ۵۳،۰۰۰،۰۰۰ تومان). پس از تصمیمگیری درباره تمام خطوط، بهصورت خودکار تکمیل میشود. |
| PATCH | v2/expert-claim/request/:claimRequestId/damaged-parts | ویرایش قطعات آسیبدیده انتخابشده در حالی که خسارت توسط این کارشناس قفل است (EXPERT_REVIEWING). |
| GET | v2/expert-claim/outer-parts-catalog | کاتالوگ قطعات بیرونی خودرو فناوران (مشترک با جریان کاربر). |
| GET | v2/expert-claim/inner-parts-catalog | JSON ثابت کاتالوگ قطعات داخلی خودرو. |
| GET | v2/expert-claim/branches | شعب بیمهگر برای تنانت این کارشناس (برای انتخاب داغی/شعبه در پیلود پاسخ). |
| GET | v2/expert-claim/stream/:id/video | پخش ویدیوی خسارت (ویدیوی دور زدن خودرو یا ویدیوی تصادف). پارامتر: query=car-capture|accident. |
| GET | v2/expert-claim/report/unified-file-statuses | کاتالوگ وضعیت + تعداد برای پرتفولیوی خسارت این کارشناس. |
| GET | v2/expert-claim/report/status-counts | منسوخشده — از unified-file-statuses استفاده کنید. |
| PUT | v2/expert-claim/lock/:claimRequestId | اندپوینت قفل منسوخشده — از POST assign استفاده کنید. |
به صحنه تصادف میرود و فرمهای هر دو طرف را حضوری پر میکند (جریان V2 mirror / V3). کارشناس میدانی همچنین دسترسی خواندن به پنلهای expert-blame و expert-claim دارد (محدود به فایلهای خودش). تنها نقشی است که هم ثبت تقصیر و هم ثبت خسارت را در یک جلسه انجام میدهد.
v2/expert-initiated/blame-request-management/آینهای از API تقصیر کاربر. فرانتاند همان صفحات را با تغییر فقط پیشوند مسیر بازاستفاده میکند.
| متد | مسیر | توضیح |
|---|---|---|
| POST | POST / | ایجاد فایل تقصیر IN_PERSON. |
| POST | send-party-otp/:id | ارسال OTP به یک طرف از طریق شماره تلفن (بدون لینک دعوت). |
| POST | verify-party-otp/:id | تأیید OTP یک طرف و اتصال حساب آنها. |
| POST | blame-confession/:id | ثبت اعتراف تقصیر طرف. |
| POST | car-body-form/:id | [فقط CAR_BODY] فرم نوع تصادف. |
| POST | run-inquiries/:id / run-inquiries-vin/:id | فرم اولیه / استعلام پلاک یا VIN برای طرف فعلی. |
| POST | upload-video/:id | بارگذاری ویدیوی طرف اول. |
| POST | add-detail-location/:id | افزودن موقعیت GPS برای طرف فعلی. |
| POST | upload-voice/:id | بارگذاری ضبط صوتی برای طرف فعلی. |
| POST | add-detail-description/:id | افزودن توضیحات برای طرف فعلی. |
| POST | add-second-party/:phone/:id/ | پیشروی به طرف دوم (بدون ارسال لینک SMS). |
| PUT | sign/:id | بارگذاری امضای طرف (اول سپس دوم، پارامتر partyRole). |
| POST | accident-fields/:id | ذخیره فیلدهای تصادف و تکمیل فوری تقصیر (بدون صف کارشناس). |
v3/expert-initiated/blame-request-management/ترتیب مراحل بازسازماندهیشده: ابتدا تمام روایت طرفین، سپس ارزیابی خسارت. هم تقصیر هم خسارت در این کنترلر واحد مدیریت میشوند.
| متد | مسیر | توضیح |
|---|---|---|
| POST | POST / ← send-party-otp ← verify-party-otp ← run-inquiries ← add-detail-* ← sign (×۲) | مرحله روایت طرفین (مراحل ۱–۸) — اندپوینتهای یکسان با mirror، همان قرارداد. |
| POST | accident-fields/:id | مرحله ۹: ذخیره فیلدهای تصادف پس از امضای هر دو طرف. |
| GET | claim-id/:requestId | مرحله ۱۰: دریافت شناسه خسارت ایجادشده بهصورت خودکار. |
| POST | upload-document/:claimId | مرحله ۱۱: بارگذاری اسناد گواهینامه / کارت خودرو. |
| PATCH | select-outer-parts/:claimId / select-other-parts/:claimId | مراحل ۱۲–۱۳: انتخاب قطعات آسیبدیده. |
| POST | capture-part/:claimId | مرحله ۱۴: عکسبرداری از قطعات + زوایا. |
| PATCH | car-capture/:claimId | مرحله ۱۵: ویدیوی دور زدن خودرو. |
| POST | upload-video/:requestId | مرحله ۱۶: ویدیوی تصادف تقصیر (نهایی) ← WAITING_FOR_EXPERT (THIRD_PARTY) یا COMPLETED (CAR_BODY). |
FIELD_EXPERT مسیر v2/expert-blame/ را محدود به فایلهای ساختهشده توسط خودش میبیند (نه صف اختلاف).
همچنین v2/expert-claim/ را برای خسارتهای مرتبط با فایلهای تقصیرش میبیند.
اندپوینتهای یکسان با پنلهای کارشناس تقصیر و کارشناس خسارت در بالا.
اولین اکتور در تقسیم V4/V5. فایلساز روایت طرفین را در محل انجام میدهد: OTPها، استعلامها، موقعیت/توضیحات/صدا و امضاها برای هر دو طرف. همچنین اسناد اولیه خسارت (گواهینامهها، کارتهای خودرو) را بارگذاری میکند. پس از امضای دوم، فایل برای تحویل به بازبین فایل «مهرومومه» میشود. در V5، فایلساز در انتها بازمیگردد تا خسارت تکمیلشده را قبل از ارسال به فناوران تأیید یا رد کند.
v4/file-maker/blame-request-management/ و v5/…اندپوینتهای V4 و V5 یکسان هستند — فقط پیشوند تغییر میکند. V5 هنگام ایجاد requiresFileMakerApproval=true را تنظیم میکند.
| متد | مسیر | توضیح |
|---|---|---|
| POST | POST / | ایجاد فایل تقصیر IN_PERSON. |
| GET | my-files | فهرست تمام فایلهای تقصیر ایجادشده توسط این فایلساز. |
| GET | my-files/:requestId | جزئیات کامل یک فایل (طرفین، گردش کار، شناسه خسارت مرتبط). |
| GET | claim-id/:requestId | دریافت شناسه خسارت ایجادشده بهصورت خودکار پس از استعلام طرف مقصر. |
| POST | send-party-otp/:id / verify-party-otp/:id | ارسال + تأیید OTP برای یک طرف در هر بار (ابتدا مقصر، سپس زیاندیده). |
| POST | car-body-form/:id | [فقط CAR_BODY] فرم نوع تصادف. |
| POST | run-inquiries/:id / run-inquiries-vin/:id | اجرای استعلام پلاک یا VIN. فراخوانی اول = مقصر (+ خودکار خسارت ایجاد میکند). فراخوانی دوم = زیاندیده (فقط THIRD_PARTY). |
| POST | add-detail-location/:id / add-detail-description/:id / upload-voice/:id | افزودن موقعیت، توضیحات و صدا برای طرف فعلی (پارامتر partyRole، FIRST/SECOND را انتخاب میکند). |
| PUT | sign/:id | بارگذاری امضای طرف (partyRole=FIRST سپس SECOND). پس از امضای دوم، فایل مهرومومه میشود. |
| POST | upload-document/:claimId | بارگذاری گواهینامه / کارتهای خودرو روی خسارت ایجادشده بهصورت خودکار. |
| GET | capture-requirements/:claimId | الزامات عکسبرداری آگاه از مرحله (فازها: اسناد پیش از عکسبرداری در مقابل قطعات آسیبدیده + شاسی/موتور). |
v5/file-maker/claim-approval/فقط در V5 استفاده میشود. پس از بررسی کارشناس خسارت و امضای مالک، خسارت وارد WAITING_FOR_FILE_MAKER_APPROVAL میشود.
| متد | مسیر | توضیح |
|---|---|---|
| POST | approve/:claimId | تأیید خسارت تکمیلشده ← ارسال SMS امضای مالک را فعال میکند ← پس از امضای مالک به فناوران ارسال میشود. |
| POST | reject/:claimId | رد به بازبین فایل ← خسارت به WAITING_FOR_DAMAGE_EXPERT برمیگردد. محدودیت: حداکثر ۲ رد در هر خسارت؛ تلاش سوم ۴۲۲ با کد FILE_MAKER_REJECTION_LIMIT_EXCEEDED برمیگرداند. |
دومین اکتور در تقسیم V4/V5. بازبین فایل فایلهای مهرومومهشده (پس از اتمام کار فایلساز) را تحویل میگیرد و مرحله کامل ارزیابی خسارت را انجام میدهد: فیلدهای تصادف، دریافت الزامات عکسبرداری، بارگذاری اسناد (شاسی/موتور)، انتخاب قطعات، عکسهای قطعات، ویدیوی دور زدن خودرو، امضای مالک. تقصیر با car-capture به COMPLETED علامتگذاری میشود. بازبین فایل همچنین دسترسی خواندن به پنل expert-claim برای خسارتهایی که بررسی میکند دارد.
v4/file-reviewer/blame-request-management/ و v5/…اندپوینتهای V4 و V5 یکسان هستند — فقط پیشوند تغییر میکند.
| متد | مسیر | توضیح |
|---|---|---|
| GET | my-files | فهرست تمام فایلهای تخصیصیافته به این بازبین فایل. |
| GET | my-files/:requestId | جزئیات کامل یک فایل (طرفین، گردش کار، فیلدهای کارشناس، شناسه خسارت مرتبط). |
| GET | claim-id/:requestId | دریافت شناسه خسارت ایجادشده بهصورت خودکار (از استعلام طرف مقصر فایلساز). |
| POST | accident-fields/:requestId | مرحله ۱ (بازبین): ذخیره فیلدهای تصادف (accidentWay، accidentReason، accidentType). |
| GET | capture-requirements/:claimId | الزامات عکسبرداری آگاه از مرحله (فاز اسناد پیش از عکسبرداری در مقابل فاز عکسبرداری قطعات). |
| POST | upload-document/:claimId | بارگذاری اسناد شاسی / موتور / پلاک فلزی. |
| PATCH | select-outer-parts/:claimId | انتخاب قطعات آسیبدیده بیرونی (بدنه). |
| PATCH | select-other-parts/:claimId | انتخاب سایر قطعات آسیبدیده (غیر بدنه). |
| POST | capture-part/:claimId | عکسبرداری از قطعات + زوایا برای هر قطعه آسیبدیده انتخابشده. |
| PATCH | car-capture/:claimId | ویدیوی دور زدن خودرو (آخرین مرحله عکسبرداری بازبین). خسارت ← WAITING_FOR_DAMAGE_EXPERT، تقصیر ← COMPLETED. |
| PUT | claim-sign/:claimId | ثبت امضای مالک روی قیمتگذاری کارشناس به نمایندگی از طرف زیاندیده (موافقت + branchId + تصویر امضا). |
| POST | upload-video/:requestId | در V4/V5 بیاثر است — تقصیر از قبل توسط car-capture COMPLETED شده. موفقیت idempotent برمیگرداند. |
FILE_REVIEWER در نقشهای مجاز برای v2/expert-claim/ است.
میتواند جزئیات خسارت را مشاهده کند و جریان assign/lock را برای خسارتهای
مرتبط با فایلهایش اجرا کند. نمیتواند بهطور مستقل درخواست ارسال مجدد
کارشناس خسارت را آغاز کند.
نقش اداری که تقصیر و خسارت حضوری را به نمایندگی از طرفین ثبت میکند. از جریان OTP دستهای استفاده میکند (OTPهای هر دو طرف بهصورت همزمان ارسال و تأیید میشوند) به جای OTP یکبهیک که توسط کارشناسان میدانی استفاده میشود. پس از تقصیر، ثبات آینه API خسارت کاربر را دنبال میکند تا انتخاب قطعات، اسناد و عکسبرداری را پر کند. سپس فایل وارد چرخه عادی بررسی کارشناس خسارت میشود.
registrar-initiated-blame/توجه: @ApiExcludeController — مسیرها وجود دارند اما در مستندات Swagger نمایش داده نمیشوند.
| متد | مسیر | توضیح |
|---|---|---|
| POST | registrar-initiated-blame/create | ایجاد فایل تقصیر IN_PERSON. |
| GET | registrar-initiated-blame/my-files | فهرست تمام فایلهای تقصیر ایجادشده توسط این ثبات. |
| GET | registrar-initiated-blame/blame/:requestId | جزئیات کامل یک فایل تقصیر. |
| POST | registrar-initiated-blame/send-party-otps/:id | ارسال OTP به هر دو طرف بهصورت همزمان. |
| POST | registrar-initiated-blame/verify-party-otps/:id | تأیید OTPهای هر دو طرف در یک فراخوانی. |
| POST | registrar-initiated-blame/complete-blame-data/:id | ارسال تمام دادههای فرم تقصیر هر دو طرف در یک پیلود. |
| POST | registrar-initiated-blame/upload-video/:id | بارگذاری ویدیوی تقصیر. |
| POST | registrar-initiated-blame/upload-voice/:id | بارگذاری ضبط صوتی. |
| POST | registrar-initiated-blame/add-accident-fields/:id | ذخیره فیلدهای تصادف و تکمیل تقصیر. |
| POST | registrar-initiated-blame/upload-party-signature/:id | بارگذاری امضای یک طرف (partyRole=FIRST/SECOND). |
v2/registrar/claim-request-management/آینهای از API خسارت کاربر. فرانتاند همان صفحات خسارت را با تغییر فقط پیشوند بازاستفاده میکند.
| متد | مسیر | توضیح |
|---|---|---|
| POST | create-from-blame/:blameId | ایجاد خسارت از یک فایل تقصیر تکمیلشده. |
| GET | outer-parts-catalog / car-other-part | کاتالوگ قطعات (قطعات بیرونی بدنه + JSON سایر قطعات). |
| GET | branches/:insuranceId | فهرست شعب بیمهگر (برای انتخاب شعبه در مرحله امضای خسارت). |
| PATCH | select-outer-parts/:claimId | انتخاب قطعات آسیبدیده بیرونی. |
| PATCH | select-other-parts/:claimId | انتخاب سایر قطعات آسیبدیده + اطلاعات بانکی. |
| POST | upload-document/:claimId | بارگذاری اسناد خسارت (گواهینامه، کارت خودرو). |
| POST | capture-part/:claimId | عکسبرداری از قطعات + زوایا. |
| PATCH | car-capture/:claimId | ویدیوی دور زدن خودرو (مرحله نهایی) ← WAITING_FOR_DAMAGE_EXPERT. |
ثبت تقصیر تلفنی V6 را مدیریت میکند. اپراتور دادههای طرف مقصر را از طریق تلفن جمعآوری میکند، استعلام بیمه را اجرا میکند و لینک تقصیر را از طریق SMS ارسال میکند. کاربر سپس بقیه فرم را از طریق جریان استاندارد V2 تکمیل میکند (با رد شدن مرحله فرم اولیه/استعلام). کار اپراتور مرکز تماس پس از send-link پایان مییابد؛ میتواند پیشرفت را از طریق اندپوینتهای خواندن پایش کند.
v6/call-center-blame/| متد | مسیر | توضیح |
|---|---|---|
| POST | create | ایجاد فایل تقصیر LINK. بدنه: { type: "THIRD_PARTY" | "CAR_BODY" }. |
| POST | run-inquiry/:requestId | اجرای استعلام بیمه پلاک + کد ملی برای طرف مقصر. نتیجه را روی سند تقصیر ذخیره میکند. |
| POST | run-inquiry-vin/:requestId | VIN/شاسی جایگزین برای run-inquiry. از جستجوی شاسی ESG استفاده میکند. |
| POST | send-link/:requestId | در صورت لزوم کاربر را ثبتنام میکند، بهعنوان طرف اول ذخیره میکند، لینک دعوت تقصیر را از طریق SMS ارسال میکند. بدنه: { phoneNumber }. |
| GET | my-files | فهرست تمام فایلهای تقصیر شروعشده توسط این اپراتور. |
| GET | blame/:requestId | وضعیت فعلی و مرحله گردش کار یک فایل (برای بررسی اینکه کاربر لینک را باز کرده و پیشرفت کرده است). |
پس از send-link، کاربر فرم را از طریق
v2/blame-request-management/ (جریان استاندارد V2) تکمیل میکند.
مرحله فرم اولیه / استعلام بهصورت خودکار رد میشود
(skipInitialFormStep=true). جریان خسارت پاییندستی همان
جریان استاندارد خسارت V2 است.
تمام اکتورهای پنل (هر نقش به جز user) از طریق همان اندپوینت
POST actor/login با کپچا احراز هویت میکنند. بازنشانی رمز عبور از
طریق OTP ایمیل است. خواندن و ویرایش پروفایل نیز مشترک است.
actor/| متد | مسیر | توضیح |
|---|---|---|
| GET | actor/captcha | صدور یک چالش کپچای ورود جدید (captchaId + تصویر SVG را برمیگرداند). |
| POST | actor/login | احراز هویت هر نقش اکتور. بدنه: role، username/email/nationalCode، password، captchaId، captcha. توکنهای JWT دسترسی + رفرش را برمیگرداند. |
| POST | actor/forget-password | ارسال OTP بازنشانی رمز عبور به ایمیل. |
| POST | actor/forget-password-verify | تأیید OTP و تنظیم رمز عبور جدید. |
| GET | actor/profile | دریافت پروفایل اکتور فعلی. |
| PATCH | actor/profile | بهروزرسانی پروفایل اکتور فعلی. |