#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) فراخوانی شود.