#P1440
DELETE /api/v2/personnel/traffic/license/delete
Route Info
| Method | Endpoint | Controller | Middleware | Purpose |
| DELETE | /api/v2/personnel/traffic/license/delete | UserController@deleteTrafficLicensePersonnel | authWithJwt | حذف رکورد مرخصی از سیستم تردد. |
منطق عملکرد
- شناسه رکورد از
$request->get('id')گرفته میشود. - با دستور
DB::table('rollcall_licenses')->where('id', id)->delete()حذف انجام میشود. - در پایان پاسخ ساده با وضعیت موفق برگردانده میشود.
پارامترهای ورودی
| نام | نوع | ضروری | توضیح |
| id | integer | بله | شناسه رکورد مرخصی برای حذف. |
DELETE /api/v2/personnel/traffic/license/delete
{
"id": 40
}
نمونه خروجی موفق
{ "status": true, "time": 1732038300 }
امنیت
- JWT الزامی است.
- پیشنهاد اعتبارسنجی مالکیت رکورد قبل از حذف برای جلوگیری از سوءاستفاده.
Dependencies
- DB Facade
- Carbon
- Exception
کارایی
اجرای سریع کوئری در حدود 1 ms — بدون عملیات جانبی.
مدیریت خطا
در قالب JSON با وضعیت `false` و پیام خطا بازگردانده میشود.
اثرات جانبی
حذف کامل رکورد بدون قابلیت بازیابی؛ در محیط عملیاتی پیشنهاد استفاده از Soft Delete.
ردپای حسابرسی
برای حفظ تاریخچه، نیازمند ثبت لاگ خودکار در SystemLog (type=DeleteLicense).
پیشنهاد بهبود
- اعمال محدودیت حذف فقط برای رکوردهای وضعیت «در انتظار».
- استفاده از Soft Delete جهت ریکاوری مرخصیهای حذفشده.
جمعبندی
آخرین گام از چرخه مرخصی است. حذف رکورد انجام میشود بدون اثرات پیدرپی یا تاییدات زنجیرهای؛ باید با حسابرسی همراه شود.