#P1623

برگهٔ تازه

Redis Accounting Sync

مستندات فنی سرویس حسابداری - نسخه 2.0

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

این متد برای بازیافت اطلاعات (Data Recovery) استفاده می‌شود. سیستم تمامی کلیدهای موجود در Redis را پیمایش کرده و با دیتابیس SQL مقایسه می‌کند. اگر سندی در Redis باشد اما در دیتابیس اصلی نباشد، آن را ایجاد می‌کند.

مسیر پردازش داده (Data Flow)

Client Request

Middleware (Auth & Date)

Service: Scan Redis Keys

Exists in DB? Skip

Missing in DB? Create Doc

Return Response JSON

Header Requirements

Key	Value	وضعیت
Authorization	Bearer {Token}	الزامی
Accept	application/json	الزامی

نمونه پاسخ‌ها (Responses)

JSON Response 200 OK

{
    "success": true,
    "data": {
        "total_scanned": 1540,
        "total_processed": 12,
        "details": [
            "Document #8891 synced from Redis."
        ]
    },
    "message": "پردازش کامل شد. 12 سند ایجاد شد."
}

JSON Response 500 Server Error

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

⚠️

هشدار پرفورمنس (Performance):

این عملیات Heavy I/O است. در صورتی که تعداد کلیدهای ردیس بسیار زیاد باشد (مثلاً بیش از ۱۰,۰۰۰ رکورد)، ممکن است اجرای این درخواست باعث کندی سیستم یا خطای Timeout شود. پیشنهاد می‌شود فقط در زمان‌های کم ترافیک اجرا شود.