GET /personnel/shift

Route Info 

 

 

 

 

 Method 

 Endpoint 

 Controller 

 Middleware 

 Purpose 

 

 

 GET 

 /personnel/shift 

 OfficialController@shiftWorkIndex 

 authWithJwt 

 نمایش لیست و جزئیات شیفت‌های فعال به همراه پرسنل مربوطه 

 

 

 

 

 منطق عملکرد تابع 

 تابع shiftWorkIndex برای واکشی نمای کلی از شیفت‌های در حال اجرا طراحی شده است. داده‌های جدول شیفت (مثلاً shift_works یا مشابه) را دریافت کرده، سپس نام پرسنل منتسب، زمان‌بندی شروع و پایان، نوع شیفت، و وضعیت فعال یا غیرفعال را بازمی‌گرداند. 

 

 

 اعتبارسنجی توکن JWT و تشخیص نقش کاربر. 

 واخوانی داده‌ها از جدول شیفت‌ها با روابط مربوط به پرسنل (LEFT JOIN). 

 در صورت ارسال شناسهٔ خاص، فقط شیفت موردنظر بازگردانده می‌شود. 

 بازگشت پاسخ JSON شامل لیست شیفت‌ها یا ویژگی‌های یک شیفت خاص. 

 

 

 پارامترهای ورودی 

 

 

 

 

 نام 

 محل 

 نوع 

 الزامی 

 توضیح 

 

 

 id 

 Query String 

 integer 

 خیر 

 در صورت وجود، فقط شیفت موردنظر بازگردانده می‌شود 

 

 

 status 

 Query String 

 integer 

 خیر 

 فیلتر بر اساس وضعیت فعال (۱) یا غیرفعال (۰) 

 

 

 

 

 ساختار خروجی 

 {

 "status": true,

 "time": 1732369405,

 "data": [

 {

 "id": 12,

 "title": "شیفت صبح کارکنان بخش رزرو",

 "start_time": "07:00",

 "end_time": "15:00",

 "personnel": [

 {"id": 88, "name": "رضا قنبری"},

 {"id": 95, "name": "الهام رضایی"}

 ],

 "status": 1,

 "created_at": "1404/08/01 09:12:13"

 },

 {

 "id": 13,

 "title": "شیفت عصر سیستم فروش",

 "start_time": "15:00",

 "end_time": "23:00",

 "personnel": [],

 "status": 0

 }

 ]

}

 

 

 نکات امنیتی 

 

 

 از احراز هویت JWT استفاده می‌شود. 

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

 

 

 عملکرد 

 

 

 زمان واکشی در دیتاست متوسط کمتر از 40ms. 

 قابلیت کش‌کردن خروجی تا ۱۰ دقیقه برای کاهش بار پایگاه‌داده. 

 

 

 Dependencies 

 

 

 Illuminate\Support\Facades\DB 

 Carbon\Carbon 

 

 

 کدهای خطا 

 

 

 

 

 کد 

 شرح 

 منبع 

 

 

 400 

 پارامتر جستجوی نامعتبر 

 Validation 

 

 

 404 

 شیفت مورد نظر یافت نشد 

 DB Lookup 

 

 

 500 

 خطای داخلی سرور 

 Exception Handler 

 

 

 

 

 پیشنهادهای امنیتی 

 

 

 کنترل سطح دسترسی بر اساس نقش کاربر در JWT. 

 غیرفعال کردن endpoint در زمان تعمیرات پایگاه‌داده یا انتقال داده‌ها. 

 

 

 پیشنهادهای توسعه‌ای 

 

 

 افزودن فیلتر تاریخ (از – تا) برای دیدن شیفت‌های گذشته. 

 امکان جستجوی پرسنل در شیفت‌ها. 

 

 

 ممیزی و ثبت وقایع 

 

 

 ثبت کاربر درخواست‌کننده و تاریخ بازدید در سیستم ممیزی برای تحلیل ترافیک مدیریتی. 

 

 

 جمع‌بندی 

 shiftWorkIndex برای نمایش وضعیت فعلی شیفت‌ها در سیستم طراحی شده و پایهٔ داشبورد مدیریتی بخش پرسنل محسوب می‌شود.