POST /api/v2/operator/details

Route Info

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

ورودی‌ها (Request Fields)

نمونه درخواست:

POST /api/v2/operator/details
Authorization: Bearer {JWT_TOKEN}
Content-Type: application/json

{
  "branch": 9
}

خروجی (Response)

نمونه پاسخ:

{
  "status": true,
  "meta": { "timestamp": 1732290051 },
  "data": {
    "profile": {
      "id": 51,
      "name": "علیرضا ایرانپور",
      "role": "operator",
      "email": "a.iranpour88@gmail.com"
    },
    "office": {
      "id": 9,
      "name": "دفتر اصفهان",
      "country": "IR"
    },
    "settings": {
      "theme": "dark",
      "base_color": "#212121",
      "favicon": "/media/icons/favicon.ico"
    },
    "apis": [
      { "type": "sms", "service": "melipayamak", "status": 1 },
      { "type": "hub", "url": "https://hub.airplus.app/api/v2" }
    ]
  }
}

نکات امنیتی

• وابسته به توکن JWT معتبر برای شناسایی اپراتور.
• هیچ فیلد رمز یا داده حساس رمزنگاری نشده نباید در پاسخ وجود داشته باشد.
• در ورژن فعلی endpoint سطح دسترسی اپراتور را بدون فیلتر نقش بازمی‌گرداند.

عملکرد و کارایی

• تابع سبک است و فقط از چند جدول کاربر و تنظیمات خوانش دارد.
• وابستگی به latency اتصال به DB اصلی شعبه در درخواست‌های همزمان زیاد است.
• پیشنهاد: caching ۵ دقیقه‌ای پروفایل هر اپراتور بر اساس JWT.

وابستگی‌ها

• use Illuminate\Http\Request;
• use Illuminate\Support\Facades\DB;
• use Carbon\Carbon;
• use App\Helpers\Functions;
• use Exception;

کدهای خطا

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

• فیلتر نقش برای جلوگیری از مشاهده تنظیمات سایر اپراتورها.
• رمزنگاری سمت سرور برای فیلدهای حساس (email, username).
• ثبت audit برای هر مشاهده پروفایل.

پیشنهادهای بهبود

• افزودن فیلد last_login و activity_status برای مانیتورینگ.
• اضافه‌کردن بخش Roles و Permissions به خروجی JSON.
• ادغام با سرویس مرکزی احراز هویت (corporateAuth).

ممیزی و لاگ‌ها

• در نسخه فعلی هیچ لاگی برای مشاهده پروفایل ثبت نمی‌شود.
• پیشنهاد: ثبت رویداد ProfileViewed در جدول system_logs.

جمع‌بندی