#P1622

POST /v2/redis-accounting/create-missing-documents

Route Info

Method	Endpoint	Controller	Middleware
POST	/v2/redis-accounting/create-missing-documents	RedisAccountingController@createMissingDocuments	authWithJwt, shamsiDate

شرح عملکرد (Functionality)

این API مسئول بررسی وجود اسناد مفقود و سپس ایجاد خودکار آن‌ها در سیستم است. منطق ساخت اسناد به‌طور کامل در سرویس redisAccountingService اجرا می‌شود و این روت فقط فراخوانی و مدیریت پاسخ را انجام می‌دهد.

هیچ ورودی‌ای نیاز ندارد.
عملیات به‌صورت Batch اجرا می‌شود.
خروجی شامل تعداد کل اسناد پردازش‌شده و تعداد اسناد ایجادشده است.

ورودی‌ها (Input Parameters)

این روت هیچ پارامتر ورودی‌ای در Query یا Body دریافت نمی‌کند.

منطق اجرا (Execution Logic)

فراخوانی مستقیم متد createMissingDocuments() از سرویس.
سرویس عملیات زیر را انجام می‌دهد:
- شناسایی اسناد مفقود
- ایجاد اسناد جدید
- محاسبه تعداد اسناد پردازش‌شده
Controller نتیجه سرویس را در ساختار JSON استاندارد برمی‌گرداند.
در صورت بروز هرگونه Exception، پاسخ خطای 500 بازگردانده می‌شود.

پاسخ موفق (200 OK)

{
  "success": true,
  "data": {
    "total_processed": 42,
    "created": 42,
    "existing": 0
  },
  "message": "پردازش کامل شد. 42 سند ایجاد شد."
}

پاسخ‌های خطا (Error Responses)

خطای سمت سرویس (500)

در صورت بروز Exception در سرویس:

{
  "success": false,
  "message": "خطا در ایجاد اسناد: Redis connection failed"
}

نکات فنی (Technical Notes)

این روت هیچ عملیات Read ندارد؛ صرفاً اجرای یک Job سنگین است.
اجرا می‌تواند بسته به حجم داده چند ثانیه طول بکشد.
توصیه می‌شود فقط توسط کاربران سطح بالا (Admins) فراخوانی شود.