Search Results

Travel Requests List این اندپوینت لیست درخواست‌های سفر (مانند پرواز، هتل، قطار و ...) را با قابلیت‌های پیشرفته فیلترینگ و غنی‌سازی (Data Enrichment) بازمی‌گرداند. نکته متمایز این کنترلر، منطق Scoping (تعیین سطح دسترسی بر اساس گروه کاربری) و همچنین اتصال به چن...

Change Request Status این اندپوینت برای تغییر وضعیت یک درخواست سفر و همچنین تخصیص اپراتور مسئول استفاده می‌شود. نکته مهم در این متد، منطق شرطی برای ثبت شماره فاکتور (`reference_id`) است که تنها در وضعیت خاصی (وضعیت ۴) اعمال می‌شود. Update Status & Assign...

Accommodation Facilities CRUD این کنترلر وظیفه مدیریت امکانات اقامتگاه‌ها (Facilities) را بر عهده دارد. ویژگی بارز این پیاده‌سازی، استفاده مستقیم از Query Builder لاراول (`DB::table`) به جای Eloquent Models برای تمامی عملیات‌ها (خواندن، نوشتن، ویرایش و حذف) ا...

Accommodation Facility Categories این کنترلر وظیفه مدیریت دسته‌بندی‌های امکانات (Facility Categories) را بر عهده دارد (مانند: تفریحی، بهداشتی، عمومی و ...). مشابه کنترلر Facilities، این بخش نیز برای افزایش سرعت و کارایی از Query Builder لاراول (`DB::table`) ا...

Accommodation Rules CRUD این کنترلر وظیفه مدیریت قوانین اقامتگاه (Accommodation Rules) را بر عهده دارد (مانند: قوانین کنسلی، ساعت ورود/خروج، ممنوعیت حیوانات خانگی و ...). داده‌ها مستقیماً در جدول accommodation_rules ذخیره می‌شوند و برای تمام عملیات دیتابیس از...

Comments: List & Filter این اندپوینت برای دریافت لیستی از نظرات (Comments) با قابلیت‌های فیلترینگ و مرتب‌سازی پیشرفته طراحی شده است. این پیاده‌سازی از Eloquent ORM و API Resources لاراول بهره می‌برد و نتایج را به صورت صفحه‌بندی شده (15 آیتم در هر صفحه) بازمی‌...

Show Comment Details این اندپوینت جزئیات کامل یک نظر خاص را برمی‌گرداند. در این متد از قابلیت Route Model Binding لاراول استفاده شده است؛ به این معنی که اگر شناسه‌ی ارسال شده در URL در دیتابیس وجود نداشته باشد، فریم‌ورک به صورت خودکار خطای 404 برمی‌گرداند. ...

Delete Comment این اندپوینت برای حذف یک نظر مشخص از دیتابیس استفاده می‌شود. این متد نیز از قابلیت Route Model Binding لاراول بهره می‌برد؛ به این معنی که ابتدا مدل Comment متناظر با شناسه ارسالی را پیدا کرده و سپس آن را حذف می‌کند. اگر شناسه نامعتبر باشد، به ط...

Create Comment این اندپوینت برای ثبت یک نظر جدید در سیستم طراحی شده است. فرآیند ارسال داده به این اندپوینت به دلیل ملاحظات امنیتی، پیچیدگی خاصی دارد. داده‌های اصلی نظر ابتدا باید به صورت یک آبجکت JSON ساخته شده، سپس با استفاده از کلید عمومی (Public Key) مربوط...

Update Comment این اندپوینت برای به‌روزرسانی اطلاعات یک نظر موجود استفاده می‌شود. همانند اندپوینت ایجاد نظر، داده‌های ارسالی برای به‌روزرسانی نیز باید ابتدا رمزنگاری شده و سپس ارسال شوند. این متد از قابلیت Route Model Binding لاراول استفاده می‌کند. به این معن...

Like or Dislike a Comment این اندپوینت برای ثبت لایک یا دیسلایک برای یک نظر مشخص استفاده می‌شود. عملیات مورد نظر (لایک یا دیسلایک) از طریق پارامتر action در URL تعیین می‌گردد. این متد به صورت اتمیک عمل نمی‌کند، اما شمارنده‌های likes و dislikes را در مدل Comme...

Remove a Like or Dislike from a Comment این اندپوینت برای کاهش (حذف) یک لایک یا دیسلایک از یک نظر مشخص استفاده می‌شود. این عملیات، معکوس اندپوینت POST برای افزودن لایک/دیسلایک است و به کاربر اجازه می‌دهد تا رأی خود را پس بگیرد. Decrement Like/Dislike Cou...

Hub: Create Payment Invoice این اندپوینت برای ایجاد یک صورت‌حساب قابل پرداخت طراحی شده است. فرآیند شامل ثبت یک "قبض" (Bill)، یافتن یک درگاه پرداخت فعال، تولید یک فاکتور منحصر به فرد با اسلاگ (Slug) یکتا، و در نهایت بازگرداندن یک لینک پرداخت برای کاربر است. ...

Hub: Get Invoice Payment Details این اندپوینت برای استعلام وضعیت و دریافت جزئیات تراکنش یک فاکتور خاص استفاده می‌شود. معمولاً پس از بازگشت کاربر از درگاه بانک، کلاینت با ارسال slug فاکتور به این اندپوینت، وضعیت نهایی پرداخت (موفق یا ناموفق)، شماره پیگیری، شما...

Hub: Pay using Wallet این اندپوینت یک فرآیند پرداخت ترکیبی را مدیریت می‌کند که به کاربر اجازه می‌دهد از کیف پول داخلی شعبه برای تسویه حساب استفاده کند. این مسیر دو سناریوی اصلی دارد: ۱. موجودی کافی: مبلغ کامل از کیف پول کسر شده و تراکنش با موفقیت ثبت می‌شود. ...

Hub: Get Branch Bills این اندپوینت برای دریافت لیست صورتحساب‌های پرداخت نشده (`status = 1`) یک شعبه خاص طراحی شده است. کلاینت می‌تواند با ارسال نوع سرویس (مانند `hotel`, `flight` و...)، فقط صورتحساب‌های مربوط به آن سرویس را فیلتر و دریافت کند. خروجی شامل جزئی...

Hub: Get Basic Information این اندپوینت به عنوان یک مسیر عمومی برای دریافت اطلاعات پایه‌ای و مرکزی (Hub Information) عمل می‌کند. رفتار این اندپوینت بر اساس پارامتر action که در کوئری استرینگ ارسال می‌شود، تغییر می‌کند. در حال حاضر، این مسیر تنها برای دریافت ل...

Hub: Flight Reservation Analysis این اندپوینت یک گزارش تحلیلی جامع از تمام رزروهای پرواز آنلاین (`product='online'`, `byproduct='aircraft'`) ارائه می‌دهد. داده‌ها بر اساس سال شمسی، تأمین‌کننده (Supplier)، و تأمین‌کننده سیستمی (System Supplier) دسته‌بندی و agr...

Hub: Get Master Reservation List این اندپوینت یک لیست جامع و صفحه‌بندی شده از تمام رزروهای ثبت شده در سیستم مرکزی (Hub) را برمی‌گرداند. برای هر رزرو، اطلاعات از جداول مختلفی مانند offices، factor_items، colleagues، و wallet استخراج و با داده‌های اصلی ادغام می...

Hub: Create Manual Wallet Transaction این اندپوینت برای ثبت دستی یک تراکنش مالی (سند) در کیف پول (`wallet`) استفاده می‌شود. اگرچه URL به "رزرو" اشاره دارد، اما عملکرد اصلی آن ایجاد یک رکورد بدهکار (`debit`) یا بستانکار (`credit`) برای یک شعبه خاص است. این عمل...