Search Results

Sprint Hydration Logic اسپرینت‌ها ظروف نگهداری کارت‌ها در بازه‌های زمانی مشخص هستند. منطق Hydration در اینجا بسیار سنگین است زیرا با دریافت اسپرینت، سیستم به صورت خودکار تمام کارت‌های داخل آن را واکشی کرده و فرآیند "Card Deep Hydration" را برای تک تک ...

Sprint Report Hydration Logic گزارش‌های اسپرینت، زیرمجموعه‌ای از اسپرینت‌ها هستند و منطق Hydration ساده‌ای دارند. در تمام متدها، پس از دریافت داده‌های گزارش، سیستم فقط اطلاعات اپراتور (نویسنده) را از جدول `operators` بارگذاری می‌کند. Fetch Spri...

Letter & Workflow Logic ماژول کارتابل دارای یک منطق گردش کار (Workflow) است. زمانی که یک نامه ایجاد می‌شود، سیستم به صورت خودکار اولین مرحله (Step) آن فرآیند را ایجاد می‌کند. همچنین زمانی که وضعیت یک مرحله به "انجام شده" تغییر می‌کند، سیستم به صورت هو...

Subject & Workflow Configuration Logic این کنترلر وظیفه مدیریت "موضوعات نامه" را بر عهده دارد. اهمیت اصلی این بخش در فیلد steps است. فیلد steps یک آرایه JSON است که "نقشه راه" یا "گردش کار" (Workflow) یک نامه را تعریف می‌کند. وقتی نامه‌ای با موضوع خاص...

Subject Steps Management Logic این کنترلر وظیفه مدیریت مراحل پیش‌فرض (Step Templates) را بر عهده دارد. این جدول (`cartable_subject_steps`) به عنوان یک بانک اطلاعاتی از مراحل عمل می‌کند که شامل یک عنوان (`title`) و یک اپراتور مسئول (`operator`) است. ای...

Department Recipients Management Logic این کنترلر وظیفه مدیریت لیست "گیرندگان" (`recipients`) را در سطح دپارتمان‌ها بر عهده دارد. این جدول (`cartable_department_recipients`) عناوین شغلی یا واحدهایی را نگهداری می‌کند که در یک شعبه و دپارتمان خاص مجاز ب...

Operator Role & Signature Logic این کنترلر برای انتساب یک "عنوان" (`title`) به یک "اپراتور" (`operator`) و مهم‌تر از آن، ذخیره **تصویر امضای دیجیتال** (`signature_file`) استفاده می‌شود. فایل‌های آپلود شده در فضای ذخیره‌سازی ابری (دیسک `liara`) با ساخت...

Workflow Progression Logic این متد یک مرحله خاص (`cartable_letter_steps`) از یک نامه را بروزرسانی می‌کند. جادوی گردش کار: اگر وضعیت ارسالی برابر با 3 (انجام شده) باشد، سیستم به صورت خودکار پیکربندی "موضوع نامه" (`subject->steps`) را بررسی کرده و مرحله...

AI Financial Analysis Logic این اندپوینت داده‌های خام مالی (شامل خرید، فروش، سود و زیان) را دریافت کرده و آن را به یک گزارش متنی/بصری تبدیل می‌کند. نقش سیستم: سیستم به عنوان یک مدیر مالی هوشمند برای نرم‌افزار AirPlus عمل می‌کند. فرمت خروجی: پرامپت سیس...

Global Reference Search این متد به عنوان یک جستجوگر چندمنظوره (Poly-morphic Search) عمل می‌کند. فرانت‌اند با ارسال پارامتر goal مشخص می‌کند که به دنبال چه نوع داده‌ای است (مثلاً مسافر، حساب بانکی، یا ایرلاین) و سیستم با جستجو در جداول مربوطه، لیست است...

Base System References این اندپوینت دقیقاً همان موتور جستجوی مرکزی (Global Search) است که در ماژول Trade استفاده می‌شد، اما با آدرس base برای استفاده‌های عمومی در کل سیستم (مانند فرم‌های تنظیمات، داشبورد و غیره) در دسترس قرار گرفته است. وظیفه آن تبدیل...

System Configuration & Tenant Init این متد حیاتی‌ترین اندپوینت برای راه‌اندازی اولیه اپلیکیشن (Bootstrapping) است. سیستم بر اساس هدر Domain تشخیص می‌دهد که کاربر مربوط به کدام شعبه (Office) است و تنظیمات ظاهری، مالی، حقوقی و ماژول‌های فعال آن شعبه را ...

Initial System Configuration این متد نقطه شروع (Entry Point) اپلیکیشن است. فرانت‌اند قبل از هر کاری باید این اندپوینت را صدا بزند. سیستم با بررسی هدر Domain، شعبه (Office) مورد نظر را پیدا کرده و تمام تنظیمات حیاتی شامل رنگ‌بندی، لوگو، اطلاعات تماس، ق...

B2C Frontend Configuration این اندپوینت مخصوص وب‌سایت‌های فروش آنلاین (White-label B2C) است. سیستم با بررسی هدر Domain، آدرس سایت مشتری را در ستون b2c_domains جستجو می‌کند و تنظیمات ظاهری، بنرها، مجوزهای نماد اعتماد و پیکربندی ماژول‌های فروش را برمی‌گ...

B2C Customer Authentication (OTP) این اندپوینت وظیفه مدیریت ورود و ثبت‌نام کاربران در وب‌سایت‌های فروش (B2C) را بر عهده دارد. سیستم از مکانیزم رمز یکبار مصرف (OTP) استفاده می‌کند. نکته کلیدی این است که اگر شماره موبایل در سیستم وجود نداشته باشد، کاربر...

B2C Verify OTP & Login این اندپوینت مرحله نهایی احراز هویت است. کلاینت کد دریافتی (OTP) را به همراه شناسه مسافر ارسال می‌کند. سیستم کد را در جدول otp_requests اعتبارسنجی کرده (بررسی انقضا و عدم استفاده قبلی) و در صورت صحت، وضعیت کد را به "استفاده شده"...

B2C Colleague Authentication (Basic) این اندپوینت جهت ورود همکاران و آژانس‌های طرف قرارداد (Colleagues) طراحی شده است. سیستم با دریافت نام کاربری و رمز عبور، اعتبار حساب را در جدول colleague_auth بررسی کرده و در صورت فعال بودن حساب و عدم انقضای قراردا...

Get Nationalities List این اندپوینت لیست کشورهای فعال که دارای عنوان «ملیت» (Nationality) تعریف شده هستند را باز می‌گرداند. از این داده‌ها معمولاً در فرم‌های ورود اطلاعات مسافر جهت انتخاب ملیت/تابعیت (مثلاً: ایرانی، آلمانی و...) استفاده می‌شود. لیست خ...

Get User Passengers List این اندپوینت لیست تمامی مسافران مرتبط با حساب کاربری فعلی را باز می‌گرداند. سیستم لیست مسافران را از دو منبع استخراج می‌کند: سابقه خرید (History): افرادی که کاربر لاگین شده قبلاً در فاکتورهای خود (`factors`) برای آن‌ها ...

Get Office/Company Users این اندپوینت جهت دریافت لیست تمامی کاربران (Users) تعریف شده در زیرمجموعه یک شرکت یا آژانس (Colleague) استفاده می‌شود. نکته مهم: دسترسی به این متد محدود است و تنها کاربرانی که سطح دسترسی آن‌ها مدیریت (Management) باشد مجاز به ...