{
  "openapi": "3.0.4",
  "info": {
    "title": "School CRM & Financial Accounting API (FRMS + StoreSystem Architecture)",
    "description": "منظومة متابعة المسوقين، المدارس، المرشدين، العناية بالزبائن، المخازن، الطلبيات، الفواتير، والسندات المالية المزدوجة.",
    "version": "v1.0"
  },
  "paths": {
    "/api/auth/login": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور المشفرة مع اشتراط إرسال الموقع الجغرافي (Latitude/Longitude)\r\nوإصدار JWT Token يحمل كافة أدوار وصلاحيات المستخدم وتفضيلات لوحة التحكم الخاصة به",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/login-gmail": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تسجيل الدخول السريع عبر حساب Google / Gmail مع توثيق الموقع الجغرافي وإصدار JWT Token متعدد الأدوار",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoogleLoginRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/GoogleLoginRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/GoogleLoginRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/me": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/logout": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تسجيل الخروج وإبطال صلاحية رمز JWT الحالي فوراً (Token Revocation) وتحديث وقت وموقع الخروج في سجل الجلسة",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LogoutRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/LogoutRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/LogoutRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/refresh-token": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تجديد رمز الجلسة (JWT Access Token) باستخدام الـ Refresh Token دون الحاجة لإعادة إدخال كلمة المرور",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "string"
              }
            },
            "text/json": {
              "schema": {
                "type": "string"
              }
            },
            "application/*+json": {
              "schema": {
                "type": "string"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/change-password": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تغيير كلمة المرور للمستخدم الحالي مع تشفيرها بـ PBKDF2 وتسجيل الحركة في جدول PasswordChangeLogs",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePasswordRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePasswordRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePasswordRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "إنشاء مستخدم جديد مع إمكانية منحه أكثر من صلاحية / دور (مثلاً: عناية بالزبائن + مرشد) وتخصيص صلاحيات القوائم المنفصلة",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استعراض قائمة المستخدمين مع كافة الأدوار المتعددة الممنوحة لكل مستخدم وصلاحياته التفصيلية مع دعم الفلترة لكل حقل",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "roleId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "isActive",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "searchName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "searchEmail",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "searchPhone",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users/{userId}": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استرجاع بيانات مستخدم محدد بالمعرف مع أدواره وصلاحياته",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "put": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تعديل معلومات المستخدم الأساسية (الاسم، البريد الإلكتروني، رقم الهاتف/الواتساب، المسمى الوظيفي، الدور الأساسي، وحالة الحساب)",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "حذف حساب مستخدم من النظام (حذف ناعم Soft Delete مع إيقاف الحساب)",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users/{userId}/lock-status": {
      "put": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "إقفال (تعطيل) أو تفعيل حساب مستخدم محدد في النظام",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ToggleUserLockRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ToggleUserLockRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ToggleUserLockRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/roles-and-permissions": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "جلب دليل الأدوار المتاحة (LookupRoles) والصلاحيات التفصيلية (LookupPermissions) لتخصيصها للمستخدمين",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users/{userId}/roles-and-permissions": {
      "put": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تحديث الأدوار المتعددة (مثلاً: عناية بالزبائن + مرشد) والصلاحيات التفصيلية (المدارس، المكتبات، التجار، الواتساب، الإيميل) لمستخدم معين",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRolesAndPermissionsDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRolesAndPermissionsDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserRolesAndPermissionsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/dashboard-config": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "جلب إعدادات وتخصيص لوحة التحكم (Dashboard) الخاصة بالمستخدم الحالي بناءً على أدواره المتعددة وتخصيصه الشخصي",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "put": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "حفظ تخصيص لوحة التحكم (ترتيب البطاقات، إظهار/إخفاء الأقسام، وحجم العرض) للمستخدم الحالي كما يريد",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveDashboardPreferenceDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveDashboardPreferenceDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SaveDashboardPreferenceDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/login-logs": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استعراض سجلات تسجيل الدخول للمستخدمين مع الموقع الجغرافي ونوع الجهاز وتفاصيل العمليات والفلترة",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "authMethod",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "isSuccess",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "deviceType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users/{userId}/login-logs": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استعراض سجلات تسجيل الدخول للمستخدمين مع الموقع الجغرافي ونوع الجهاز وتفاصيل العمليات والفلترة",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "authMethod",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "isSuccess",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "deviceType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/my-login-logs": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استعراض سجلات تسجيل الدخول الخاصة بالمستخدم الحالي مع الفلترة التفصيلية",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "authMethod",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "isSuccess",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "deviceType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/audit-logs": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استعراض سجل حركات المستخدمين والتدقيق الشامل (UserAuditLogs) مع إمكانية البحث والفلترة حسب المستخدم، نوع العملية، الوحدة، والتاريخ",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "userId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "actionType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "moduleName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/channels-health-check": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "فحص جاهزية وربط قناتي الواتساب (GREEN-API) والبريد الإلكتروني (Pepipost) قبل الإرسال",
        "parameters": [
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/forgot-password": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "طلب استعادة كلمة المرور (Forgot Password): يفحص ربط الواتساب والإيميل أولاً ثم يرسل رمز الاستعادة (OTP) عبر قالب مخصص (PASSWORD_RESET_TEMPLATE)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForgotPasswordRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ForgotPasswordRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ForgotPasswordRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/reset-password": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تأكيد رمز استعادة كلمة المرور (OTP) وتعيين كلمة المرور الجديدة للمستخدم",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResetPasswordWithCodeDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ResetPasswordWithCodeDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ResetPasswordWithCodeDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users/{userId}/admin-change-password": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "قيام الأدمن بتغيير كلمة المرور لمستخدم معين مع فحص القنوات وإرسال قالب إشعار خاص للمستخدم (ADMIN_CHANGED_PASSWORD_TEMPLATE) على الإيميل والواتساب",
        "parameters": [
          {
            "name": "userId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdminResetUserPasswordDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/AdminResetUserPasswordDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/AdminResetUserPasswordDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/admin-marketer-alerts/preferences": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "جلب إعدادات إشعارات الأدمن حول أنشطة المسوقين (مع دعم تتبع جميع المسوقين أو مسوق محدد بعينه) وسجل الإشعارات المرسلة",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "put": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تحديث رغبة الأدمن باستلام إشعارات أنشطة المسوقين الستة وتحديد النطاق (جميع المسوقين ALL أو مسوق محدد بعينه SPECIFIC_USER)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAdminMarketerAlertPreferencesDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAdminMarketerAlertPreferencesDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAdminMarketerAlertPreferencesDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/admin-marketer-alerts/trigger-test": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تجربة إرسال إشعار فوري للأدمن لأي حدث من الأحداث الستة للمسوقين مع فحص الواتساب والإيميل وتضمين (مَن، وفي أي ساعة، والموقع الجغرافي)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TriggerMarketerAlertTestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/TriggerMarketerAlertTestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/TriggerMarketerAlertTestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/reverse-geocode": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "تحويل الإحداثيات الجغرافية إلى عنوان شارع وبلدة دقيق بالعربية مع كاش سريع واحتياطي فوري\r\nيتم استدعاؤه كبروكسي داخلي آمن يمنع حظر المتصفحات بسياسة CORS ويزود رأس User-Agent المطلوب",
        "parameters": [
          {
            "name": "lat",
            "in": "query",
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "schema": {
              "type": "number",
              "format": "double"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/location-ping": {
      "post": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "استقبال نبضات الموقع الجغرافي للمستخدم (حية أو بالخلفية أو عند إغلاق التبويب عبر sendBeacon)\r\nوتحديث مسار الحركة (Auto-Run) وموقع آخر ظهور أو تسجيل الخروج",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserLocationPingDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UserLocationPingDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UserLocationPingDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/users-live-tracking": {
      "get": {
        "tags": [
          "AuthAndSecurity"
        ],
        "summary": "جلب بيانات التتبع الحقيقية المسجلة للمستخدمين على الخريطة التفاعلية (Auto-Run Real Tracking Only)\r\nمع جلب مواعيد المستخدم المسجلة وخط السير المقرر للزيارات الميدانية",
        "parameters": [
          {
            "name": "userId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "roleId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/cache-management/status": {
      "get": {
        "tags": [
          "CacheManagement"
        ],
        "summary": "استعراض حالة جميع نطاقات الكاش في السيرفر (المدارس، المكتبات، التجار، وكل ثابت من الـ Lookups على حدة)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/cache-management/evict-scope": {
      "post": {
        "tags": [
          "CacheManagement"
        ],
        "summary": "تفريغ نطاق كاش واحد محدد فقط (مثلاً: customers:schools أو lookup:regions أو lookup:subjects)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvictCacheScopeDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/EvictCacheScopeDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/EvictCacheScopeDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/cache-management/evict-category/{category}": {
      "post": {
        "tags": [
          "CacheManagement"
        ],
        "summary": "تفريغ فئة كاملة من الكاش (LOOKUPS لتفريغ كافة الثوابت، أو CUSTOMERS لتفريغ كاش المدارس والمكتبات والتجار)",
        "parameters": [
          {
            "name": "category",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/cache-management/evict-all": {
      "post": {
        "tags": [
          "CacheManagement"
        ],
        "summary": "تفريغ كافة نطاقات الكاش في الخادم بالكامل",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/error-logs": {
      "get": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "استعراض وفلترة جميع الأخطاء المسجلة في ملفات اللوج اليومية (حسب الملف، التاريخ من/إلى، نوع الخطأ، درجة الخطورة، كود الحالة، الوحدة، أو البحث النصي)\r\nمع إرجاع قائمة الملفات اليومية وإحصائيات الأخطاء المنشورة",
        "parameters": [
          {
            "name": "FileName",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "FromDate",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ToDate",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ErrorType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Severity",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "StatusCode",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Module",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/error-logs/files": {
      "get": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "استعراض قائمة ملفات اللوج المقسمة حسب تاريخ اليوم (errors-YYYY-MM-DD.jsonl) مع حجم كل ملف وعدد الأخطاء فيه",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "حذف جميع ملفات تسجيل الأخطاء اليومية دفعة واحدة",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/error-logs/statistics": {
      "get": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "نشر إحصائيات الأخطاء الشاملة (حسب نوع الخطأ، درجة الخطورة، التاريخ اليومي، الوحدة البرمجية، وكود الحالة)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/error-logs/record": {
      "post": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "تسجيل خطأ جديد في ملف تاريخ اليوم (errors-YYYY-MM-DD.jsonl) من الفرونت أو لتجربة التوثيق المباشر",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateManualErrorLogDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateManualErrorLogDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateManualErrorLogDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/error-logs/files/{fileName}": {
      "delete": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "حذف ملف لوج يومي محدد فقط (مثلاً: errors-2026-10-20.jsonl)",
        "parameters": [
          {
            "name": "fileName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/visits": {
      "get": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "استعراض وبحث زيارات المسوقين للمدارس (التاريخ، الحالة، المسوق، والأقسام/المباحث التي تمت متابعتها)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "تسجيل أو جدولة زيارة مسوق جديدة للمدرسة مع تحديد الأقسام/المباحث التي سيتم أو تمت متابعتها",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSchoolVisitDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSchoolVisitDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSchoolVisitDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/visits/{visitId}/status": {
      "put": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "تحديث حالة زيارة المدرسة (من مجدولة إلى تمت أو ألغيت) مع توثيق الموقع الجغرافي والأقسام المتابعة",
        "parameters": [
          {
            "name": "visitId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateVisitStatusDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateVisitStatusDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateVisitStatusDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/guidance-sessions": {
      "get": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "استعراض وبحث الجلسات الإرشادية التي تمت أو جدولها المرشدون للمدارس مع عدد الحصص الإرشادية والمسوق الطالب للإرشاد",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "طلب أو جدولة جلسة إرشادية جديدة للمدرسة (يحدد فيها المرشد، المبحث، التاريخ، الساعة، عدد الحصص، والمسوق الذي طلب الإرشاد)\r\nويرسل إشعاراً حياً عبر SignalR للمرشد المكلف فوراً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGuidanceSessionDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGuidanceSessionDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGuidanceSessionDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/guidance-sessions/{sessionId}/status": {
      "put": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "توثيق إتمام أو إلغاء الجلسة الإرشادية من قِبل المرشد مع تحديد عدد الحصص الفعلية التي تمت في ذلك اليوم وإشعار المسوق",
        "parameters": [
          {
            "name": "sessionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompleteGuidanceSessionDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CompleteGuidanceSessionDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CompleteGuidanceSessionDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar": {
      "get": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "جلب رزنامة المواعيد الموحدة (الزيارات المجدولة، الجلسات الإرشادية، ومتابعات العناية بالزبائن) خلال فترة زمنية",
        "parameters": [
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar-appointments": {
      "get": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "استعراض جميع المواعيد في الرزنامة الموحدة (يراها الأدمن لجميع المستخدمين مع إمكانية الفلترة والاستفسار، ويراها المسوق/المرشد لمواعيده)",
        "parameters": [
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "userId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "customerId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "appointmentType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "إضافة موعد جديد في الرزنامة (زيارة مسوق، جلسة إرشاد لمرشد، طلب تحديد جلسة إرشاد، أو تكليف من مسؤول النظام) مع الرفض القاطع لأي تعارض للمواعيد المؤكدة",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCalendarAppointmentDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCalendarAppointmentDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCalendarAppointmentDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar-appointments/check-conflict": {
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "فحص تعارض المواعيد الفوري لنفس الشخص قبل الحفظ مع اقتراح الأوقات المتاحة",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckAppointmentConflictDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckAppointmentConflictDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CheckAppointmentConflictDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar-appointments/{appointmentId}": {
      "put": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "تعديل موعد قائم في الرزنامة أو تنسيق وتأكيد طلب جلسة إرشاد مع إعادة فحص التعارض الصارم لنفس الشخص",
        "parameters": [
          {
            "name": "appointmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCalendarAppointmentDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCalendarAppointmentDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCalendarAppointmentDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "حذف موعد من الرزنامة",
        "parameters": [
          {
            "name": "appointmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/guidance-requests": {
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "تقديم طلب تحديد جلسة إرشاد للمدرسة من قبل المسوق بعد الزيارة الميدانية (بموعد مقترح ومواضيع مقترحة)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGuidanceScheduleRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGuidanceScheduleRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGuidanceScheduleRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/guidance-requests/{appointmentId}/confirm": {
      "put": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "تنسيق وتأكيد طلب جلسة الإرشاد من قبل الأدمن أو المرشد بعد التواصل مع المدرسة والتحقق الصارم من عدم وجود تعارض مع جدول المواعيد",
        "parameters": [
          {
            "name": "appointmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmGuidanceScheduleRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmGuidanceScheduleRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmGuidanceScheduleRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar-appointments/{appointmentId}/notify-user": {
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "إرسال تنبيه فوري عبر الواتساب أو البريد الإلكتروني أو كلاهما للمستخدم صاحب الموعد بتفاصيل الموعد (وقته + ملاحظات + نوع الموعد)",
        "parameters": [
          {
            "name": "appointmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendAppointmentNotificationDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SendAppointmentNotificationDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SendAppointmentNotificationDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar-appointments/{appointmentId}/inquiries": {
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "إرسال استفسار من الأدمن (مسؤول النظام) إلى المستخدم صاحب الموعد حول أي تفصيل يخص الموعد",
        "parameters": [
          {
            "name": "appointmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAppointmentInquiryDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAppointmentInquiryDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAppointmentInquiryDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/field-visits-and-guidance/calendar-appointments/{appointmentId}/inquiries/{inquiryId}/reply": {
      "post": {
        "tags": [
          "FieldVisitsAndGuidance"
        ],
        "summary": "رد الموظف على استفسار الإدارة حول الموعد",
        "parameters": [
          {
            "name": "appointmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "inquiryId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReplyAppointmentInquiryDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ReplyAppointmentInquiryDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ReplyAppointmentInquiryDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/accounts": {
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "استعراض شجرة الحسابات المالية الهرمية:\r\nيدعم البدء بأعلى مستوى فقط (rootOnly=true) وإحضار الحسابات الفرعية عند النزول في المستويات (parentAccountId)\r\nمع تزويد كل مستوى بتفاصيل أغنى وأعمق للحساب وحركاته وبيانات الجهة المرتبطة به",
        "parameters": [
          {
            "name": "rootOnly",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "parentAccountId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "level",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "accountType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "إضافة حساب جديد (رئيسي أو فرعي) في شجرة الحسابات المالية",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAccountDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAccountDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAccountDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/accounts/{parentId}/sub-accounts": {
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "إحضار الحسابات الفرعية المباشرة لحساب أب محدد عند النزول إلى مستوى أدنى في شجرة الحسابات\r\nمع تفاصيل إضافية موسعة لهذا المستوى وآخر الحركات المالية للحساب",
        "parameters": [
          {
            "name": "parentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/accounts/{accountId}/statement": {
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "جلب كشف حساب تفصيلي (Account Statement) لأي حساب (مدرسة، مكتبة، تاجر، وزارة التربية والتعليم، أو الصندوق)\r\nيعرض الرصيد وحركات المدين والدائن وأرقام سندات القيد المرتبطة بها",
        "parameters": [
          {
            "name": "accountId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/receipt-vouchers": {
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "إصدار سند قبض مالي (مرتبط بالحساب المالي AccountId مباشرة كما في StoreSystem)\r\nيدعم القبض النقدي والقبض بالشيكات (مع حفظ رقم الشيك واسم صاحب الشيك والبنك وتاريخ الاستحقاق)\r\nوينشئ تلقائياً سند قيد مزدوج ويرحله إلى جدول حركات الحسابات AccountTransactions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateReceiptVoucherDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateReceiptVoucherDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateReceiptVoucherDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "استعراض وبحث سندات القبض وتفاصيل الشيكات المرفقة بها مع دعم الفلترة حسب التاريخ، رقم السند، الحساب، وطريقة القبض",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "voucherNumber",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "accountId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "paymentType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/receipt-vouchers/{id}": {
      "delete": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "حذف سند قبض مالي وعكس أثره المحاسبي من شجرة الحسابات وحركات كشف الحساب",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/payment-vouchers": {
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "إصدار سند صرف مالي (مرتبط بالحساب المالي AccountId مباشرة كما في StoreSystem) نقداً و/أو بشيكات\r\nمع توليد سند قيد مزدوج وترحيله إلى جدول AccountTransactions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaymentVoucherDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaymentVoucherDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaymentVoucherDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "استعراض وبحث سندات الصرف وتفاصيل الشيكات الصادرة مع دعم الفلترة حسب التاريخ، رقم السند، الحساب، وطريقة الصرف",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "voucherNumber",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "accountId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "paymentType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/payment-vouchers/{id}": {
      "delete": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "حذف سند صرف مالي وعكس أثره المحاسبي من شجرة الحسابات وحركات كشف الحساب",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/journal-vouchers": {
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "إنشاء سند قيد يومية مزدوج يدوي (Journal Voucher) وترحيل أطرافه إلى جدول حركات الحسابات AccountTransactions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateManualJournalVoucherDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateManualJournalVoucherDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateManualJournalVoucherDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "استعراض وبحث سندات القيد المالي (JournalVouchers) مع بنود المدين والدائن والفلترة حسب نوع السند والتاريخ ورقم السند والبيان",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "sourceType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "voucherNumber",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/journal-vouchers/{id}": {
      "delete": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "حذف سند قيد يومية يدوي وعكس أثره المحاسبي وإعادة احتساب الأرصدة التراكمية",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/checks/statuses": {
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "جلب حالات دورة حياة الشيكات الواردة والصادرة من جدول الثوابت LookupCheckStatuses",
        "parameters": [
          {
            "name": "direction",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/checks/transition-status": {
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "تحديث حالة الشيك (الوارد أو الصادر) ضمن دورة حياته وتوليد سند القيد المحاسبي المزدوج آلياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckStatusTransitionDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckStatusTransitionDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CheckStatusTransitionDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/voucher-numbers": {
      "get": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "استعراض جدول الأرقام التسلسلية الحالي للسندات والفواتير والطلبيات والمرتجعات (JV, RV, PV, OB, SO, RS)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/voucher-numbers/reset/{newFiscalYear}": {
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "تصفير الأرقام التسلسلية لجميع السندات والفواتير والطلبيات والمرتجعات مع تمييز دورة التصفير (YYYY_Cycle_Number)",
        "parameters": [
          {
            "name": "newFiscalYear",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/financial-accounting/voucher-numbers/reset-single/{voucherType}/{newFiscalYear}": {
      "post": {
        "tags": [
          "FinancialAccounting"
        ],
        "summary": "تصفير الرقم التسلسلي لنوع سند واحد محدد بشكل مستقل (RV, PV, JV, OB, SO, RS) مع تمييز دورة التصفير (YYYY_Cycle_Number)",
        "parameters": [
          {
            "name": "voucherType",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "newFiscalYear",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/status": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "فحص حالة اتصال واتساب (Green-API Instance Status) ورقم الواتساب المتصل",
        "parameters": [
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/pre-send-check": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "فحص جاهزية كل من الواتساب (GREEN-API) والبريد الإلكتروني (Pepipost) قبل الإرسال",
        "parameters": [
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/check": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "فحص ما إذا كان رقم هاتف معين يمتلك حساب واتساب فعال على Green-API مع تحديث الحقل HasWhatsapp في قاعدة البيانات",
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "IL"
            }
          },
          {
            "name": "customerId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/avatar": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "جلب الصورة الشخصية لحساب واتساب من Green-API (getAvatar)",
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/chats": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "جلب قائمة المحادثات من واتساب (Green-API getChats) مع كاش آخر رسالة وصورة الحساب",
        "parameters": [
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/history": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "جلب سجل الرسائل لمحادثة واتساب معينة (Green-API getChatHistory)",
        "parameters": [
          {
            "name": "chatId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "count",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/message": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "إرسال رسالة واتساب مباشرة أو جدولتها في طابور الحماية Anti-Ban عبر Green-API (كما في ALARAEYYA)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendGreenWhatsAppDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SendGreenWhatsAppDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SendGreenWhatsAppDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/contact/add": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "إضافة جهة اتصال جديدة إلى دفتر عناوين واتساب عبر Green-API (contact/add)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddGreenContactDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/AddGreenContactDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/AddGreenContactDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/contact/edit": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "تعديل جهة اتصال في واتساب عبر Green-API (contact/edit)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EditGreenContactDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/EditGreenContactDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/EditGreenContactDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/contact/delete": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "حذف جهة اتصال من واتساب عبر Green-API (contact/delete)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteGreenContactDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteGreenContactDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteGreenContactDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/clear-queue": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "تفريغ طابور رسائل واتساب المعلقة في Green-API (clear-queue)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/webhook": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "نقطة استقبال إشعارات الرسائل الواردة من Green-API Webhook (معالجة كلمة \"قف\" / \"تفعيل\" وتحديث حالة الواتساب تلقائياً)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JsonNode"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/JsonNode"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/JsonNode"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/email/send": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "إرسال بريد إلكتروني مباشر لمدرسة أو مكتبة أو تاجر باستخدام مفتاح Pepipost المعتمد في ALARAEYYA",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendEmailRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SendEmailRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SendEmailRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/email/send-invoice/{invoiceId}": {
      "post": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "إرسال إشعار فاتورة بالبريد الإلكتروني للمدرسة / الزبون باستخدام قالب send_payment (مطابق لـ SendBillByEmailController في ALARAEYYA)",
        "parameters": [
          {
            "name": "invoiceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/email/templates": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "استعراض وتعديل قوالب البريد الإلكتروني (send_payment, received, replies) كما في EmailContentsController في ALARAEYYA",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/email/templates/{id}": {
      "put": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "تحديث قالب بريد إلكتروني معتمد",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailTemplateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailTemplateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailTemplateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/green/logs": {
      "get": {
        "tags": [
          "GreenApiAndEmail"
        ],
        "summary": "استعراض سجل الرسائل المرسلة والواردة عبر واتساب (Green-API) والبريد الإلكتروني (Pepipost)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/all-lookups": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "جلب كافة القوائم المنسدلة والثوابت (Lookups) دفعة واحدة من الكاش المستقل لكل جدول\r\nلا يعيد الاستعلام من قاعدة البيانات إلا للجزء الذي تم تعديله أو تفريغه من إدارة الكاش",
        "parameters": [
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/all-lookups": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "جلب كافة القوائم المنسدلة والثوابت (Lookups) دفعة واحدة من الكاش المستقل لكل جدول\r\nلا يعيد الاستعلام من قاعدة البيانات إلا للجزء الذي تم تعديله أو تفريغه من إدارة الكاش",
        "parameters": [
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/lookup/{lookupName}": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "جلب ثابت واحد محدد (Single Lookup) من الكاش الخاص به أو إعادة تحميله",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة عنصر ثابت عبر المسار العام الموحد POST lookup/{lookupName}",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": { }
            },
            "text/json": {
              "schema": { }
            },
            "application/*+json": {
              "schema": { }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/lookup/{lookupName}": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "جلب ثابت واحد محدد (Single Lookup) من الكاش الخاص به أو إعادة تحميله",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "forceRefresh",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة عنصر ثابت عبر المسار العام الموحد POST lookup/{lookupName}",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": { }
            },
            "text/json": {
              "schema": { }
            },
            "application/*+json": {
              "schema": { }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/dashboard-summary": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "جلب مؤشرات وإحصائيات لوحة التحكم المخصصة حسب صلاحيات المستخدم المتعددة (مع دعم الكاش)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/dashboard-summary": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "جلب مؤشرات وإحصائيات لوحة التحكم المخصصة حسب صلاحيات المستخدم المتعددة (مع دعم الكاش)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/regions": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منطقة جغرافية جديدة إلى قائمة ثوابت المناطق (LookupRegions) وتفريغ كاش المناطق تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/regions": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منطقة جغرافية جديدة إلى قائمة ثوابت المناطق (LookupRegions) وتفريغ كاش المناطق تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/regions/{regionId}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل بيانات منطقة جغرافية في جدول ثوابت المناطق (LookupRegions) وتفريغ كاش المناطق والمدارس تلقائياً",
        "parameters": [
          {
            "name": "regionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منطقة جغرافية من جدول ثوابت المناطق (LookupRegions)",
        "parameters": [
          {
            "name": "regionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/regions/{regionId}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل بيانات منطقة جغرافية في جدول ثوابت المناطق (LookupRegions) وتفريغ كاش المناطق والمدارس تلقائياً",
        "parameters": [
          {
            "name": "regionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منطقة جغرافية من جدول ثوابت المناطق (LookupRegions)",
        "parameters": [
          {
            "name": "regionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/competitors": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة شركة منافسة جديدة إلى قائمة ثوابت المنافسين (LookupCompetitors) وتفريغ كاش المنافسين فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/competitors": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة شركة منافسة جديدة إلى قائمة ثوابت المنافسين (LookupCompetitors) وتفريغ كاش المنافسين فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/competitors/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل شركة منافسة في جدول ثوابت المنافسين (LookupCompetitors)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف شركة منافسة من جدول ثوابت المنافسين (LookupCompetitors)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/competitors/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل شركة منافسة في جدول ثوابت المنافسين (LookupCompetitors)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف شركة منافسة من جدول ثوابت المنافسين (LookupCompetitors)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/subjects": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مبحث دراسي جديد إلى جدول LookupSubjects وتفريغ كاش المباحث فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/subjects": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مبحث دراسي جديد إلى جدول LookupSubjects وتفريغ كاش المباحث فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/subjects/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مبحث دراسي في جدول LookupSubjects",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مبحث دراسي من جدول LookupSubjects",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/subjects/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مبحث دراسي في جدول LookupSubjects",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مبحث دراسي من جدول LookupSubjects",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/cities": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مدينة / بلدة جديدة إلى جدول ثوابت المدن (LookupCities) وتفريغ كاش المدن فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/cities": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مدينة / بلدة جديدة إلى جدول ثوابت المدن (LookupCities) وتفريغ كاش المدن فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/cities/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مدينة / بلدة في جدول ثوابت المدن (LookupCities)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مدينة / بلدة من جدول ثوابت المدن (LookupCities)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/cities/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مدينة / بلدة في جدول ثوابت المدن (LookupCities)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCityLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مدينة / بلدة من جدول ثوابت المدن (LookupCities)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/school-stages": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مرحلة مدرسية جديدة إلى جدول LookupSchoolStages وتفريغ كاش المراحل فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/school-stages": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مرحلة مدرسية جديدة إلى جدول LookupSchoolStages وتفريغ كاش المراحل فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/school_stages": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مرحلة مدرسية جديدة إلى جدول LookupSchoolStages وتفريغ كاش المراحل فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/school_stages": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مرحلة مدرسية جديدة إلى جدول LookupSchoolStages وتفريغ كاش المراحل فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/stages": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مرحلة مدرسية جديدة إلى جدول LookupSchoolStages وتفريغ كاش المراحل فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/stages": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة مرحلة مدرسية جديدة إلى جدول LookupSchoolStages وتفريغ كاش المراحل فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/school-stages/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مرحلة مدرسية في جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مرحلة مدرسية من جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/school-stages/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مرحلة مدرسية في جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مرحلة مدرسية من جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/school_stages/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مرحلة مدرسية في جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مرحلة مدرسية من جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/school_stages/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مرحلة مدرسية في جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مرحلة مدرسية من جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/stages/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مرحلة مدرسية في جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مرحلة مدرسية من جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/stages/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل مرحلة مدرسية في جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف مرحلة مدرسية من جدول LookupSchoolStages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/grades": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة صف دراسي جديد إلى جدول LookupGrades وتفريغ كاش الصفوف فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/grades": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة صف دراسي جديد إلى جدول LookupGrades وتفريغ كاش الصفوف فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/grades/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل صف دراسي في جدول LookupGrades",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف صف دراسي من جدول LookupGrades",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/grades/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل صف دراسي في جدول LookupGrades",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف صف دراسي من جدول LookupGrades",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/service-platforms": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منصة خدمات رقمية جديدة إلى جدول LookupServicePlatforms وتفريغ كاش المنصات فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/service-platforms": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منصة خدمات رقمية جديدة إلى جدول LookupServicePlatforms وتفريغ كاش المنصات فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/service_platforms": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منصة خدمات رقمية جديدة إلى جدول LookupServicePlatforms وتفريغ كاش المنصات فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/service_platforms": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منصة خدمات رقمية جديدة إلى جدول LookupServicePlatforms وتفريغ كاش المنصات فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/platforms": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منصة خدمات رقمية جديدة إلى جدول LookupServicePlatforms وتفريغ كاش المنصات فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/platforms": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة منصة خدمات رقمية جديدة إلى جدول LookupServicePlatforms وتفريغ كاش المنصات فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/service-platforms/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل منصة خدمات رقمية في جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منصة خدمات رقمية من جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/service-platforms/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل منصة خدمات رقمية في جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منصة خدمات رقمية من جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/service_platforms/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل منصة خدمات رقمية في جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منصة خدمات رقمية من جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/service_platforms/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل منصة خدمات رقمية في جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منصة خدمات رقمية من جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/platforms/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل منصة خدمات رقمية في جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منصة خدمات رقمية من جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/platforms/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل منصة خدمات رقمية في جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف منصة خدمات رقمية من جدول LookupServicePlatforms",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/customer-types": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة نوع زبون إلى جدول LookupCustomerTypes وتفريغ كاش أنواع الزبائن فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/customer-types": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة نوع زبون إلى جدول LookupCustomerTypes وتفريغ كاش أنواع الزبائن فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/customer_types": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة نوع زبون إلى جدول LookupCustomerTypes وتفريغ كاش أنواع الزبائن فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/customer_types": {
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة نوع زبون إلى جدول LookupCustomerTypes وتفريغ كاش أنواع الزبائن فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/customer-types/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل نوع زبون في جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف نوع زبون من جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/customer-types/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل نوع زبون في جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف نوع زبون من جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/customer_types/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل نوع زبون في جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف نوع زبون من جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/customer_types/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل نوع زبون في جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerTypeLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف نوع زبون من جدول LookupCustomerTypes",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/change-reasons": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض أسباب عدم تغيير المنهاج ومقاومته (LookupChangeReasons)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سبب عدم تغيير منهاج جديد إلى جدول LookupChangeReasons",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/change-reasons": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض أسباب عدم تغيير المنهاج ومقاومته (LookupChangeReasons)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سبب عدم تغيير منهاج جديد إلى جدول LookupChangeReasons",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/change_reasons": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض أسباب عدم تغيير المنهاج ومقاومته (LookupChangeReasons)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سبب عدم تغيير منهاج جديد إلى جدول LookupChangeReasons",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/change_reasons": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض أسباب عدم تغيير المنهاج ومقاومته (LookupChangeReasons)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سبب عدم تغيير منهاج جديد إلى جدول LookupChangeReasons",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/change-reasons/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سبب عدم تغيير منهاج في جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سبب عدم تغيير منهاج من جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/change-reasons/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سبب عدم تغيير منهاج في جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سبب عدم تغيير منهاج من جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/change_reasons/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سبب عدم تغيير منهاج في جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سبب عدم تغيير منهاج من جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/change_reasons/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سبب عدم تغيير منهاج في جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChangeReasonLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سبب عدم تغيير منهاج من جدول LookupChangeReasons",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/paper-books": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض وبحث الكتب الورقية مع استخدام الكاش",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة كتاب ورقي جديد وتفريغ كاش الكتب الورقية فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/paper-books": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض وبحث الكتب الورقية مع استخدام الكاش",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة كتاب ورقي جديد وتفريغ كاش الكتب الورقية فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/paper-books/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل كتاب ورقي وتفريغ كاش الكتب الورقية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف كتاب ورقي وتفريغ كاش الكتب الورقية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/paper-books/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل كتاب ورقي وتفريغ كاش الكتب الورقية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaperBookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف كتاب ورقي وتفريغ كاش الكتب الورقية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/digital-services": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض وبحث الخدمات المحوسبة/الرقمية مع دعم الكاش",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة خدمة محوسبة جديدة وتفريغ كاش الخدمات الإلكترونية فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/digital-services": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض وبحث الخدمات المحوسبة/الرقمية مع دعم الكاش",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة خدمة محوسبة جديدة وتفريغ كاش الخدمات الإلكترونية فقط",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/digital-services/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل خدمة محوسبة وتفريغ كاش الخدمات الإلكترونية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف خدمة محوسبة وتفريغ كاش الخدمات الإلكترونية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/digital-services/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل خدمة محوسبة وتفريغ كاش الخدمات الإلكترونية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDigitalServiceDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف خدمة محوسبة وتفريغ كاش الخدمات الإلكترونية فقط",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/communication-channels": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض قنوات التواصل المعتمدة في النظام (Communication Channels Lookup)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة قناة تواصل جديدة إلى ثوابت قنوات التواصل وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/communication-channels": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض قنوات التواصل المعتمدة في النظام (Communication Channels Lookup)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة قناة تواصل جديدة إلى ثوابت قنوات التواصل وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/communication_channels": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض قنوات التواصل المعتمدة في النظام (Communication Channels Lookup)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة قناة تواصل جديدة إلى ثوابت قنوات التواصل وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/communication_channels": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض قنوات التواصل المعتمدة في النظام (Communication Channels Lookup)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة قناة تواصل جديدة إلى ثوابت قنوات التواصل وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/communication-channels/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل قناة تواصل في ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف قناة تواصل من ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/communication-channels/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل قناة تواصل في ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف قناة تواصل من ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/communication_channels/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل قناة تواصل في ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف قناة تواصل من ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/communication_channels/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل قناة تواصل في ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف قناة تواصل من ثوابت قنوات التواصل",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/academic-years": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض السنوات الدراسية المعتمدة في النظام (LookupAcademicYears)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سنة دراسية جديدة إلى ثوابت السنوات الدراسية (LookupAcademicYears) وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/academic-years": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض السنوات الدراسية المعتمدة في النظام (LookupAcademicYears)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سنة دراسية جديدة إلى ثوابت السنوات الدراسية (LookupAcademicYears) وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/academic_years": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض السنوات الدراسية المعتمدة في النظام (LookupAcademicYears)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سنة دراسية جديدة إلى ثوابت السنوات الدراسية (LookupAcademicYears) وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/academic_years": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض السنوات الدراسية المعتمدة في النظام (LookupAcademicYears)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة سنة دراسية جديدة إلى ثوابت السنوات الدراسية (LookupAcademicYears) وتحديث الكاش تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/academic-years/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سنة دراسية في جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سنة دراسية من جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/academic-years/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سنة دراسية في جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سنة دراسية من جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/academic_years/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سنة دراسية في جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سنة دراسية من جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/academic_years/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل سنة دراسية في جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicYearLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف سنة دراسية من جدول ثوابت السنوات الدراسية (LookupAcademicYears)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/check-statuses": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض حالات الشيكات الصادرة والواردة المعتمدة في النظام (LookupCheckStatuses)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة حالة شيك جديدة إلى جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/check-statuses": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض حالات الشيكات الصادرة والواردة المعتمدة في النظام (LookupCheckStatuses)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة حالة شيك جديدة إلى جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/check_statuses": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض حالات الشيكات الصادرة والواردة المعتمدة في النظام (LookupCheckStatuses)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة حالة شيك جديدة إلى جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/check_statuses": {
      "get": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "استعراض حالات الشيكات الصادرة والواردة المعتمدة في النظام (LookupCheckStatuses)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "إضافة حالة شيك جديدة إلى جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/check-statuses/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل حالة شيك في جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف حالة شيك من جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/check-statuses/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل حالة شيك في جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف حالة شيك من جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/check_statuses/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل حالة شيك في جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف حالة شيك من جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/check_statuses/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل حالة شيك في جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckStatusLookupDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف حالة شيك من جدول ثوابت حالات الشيكات (LookupCheckStatuses)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/catalog-and-lookups/lookup/{lookupName}/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل عنصر ثابت عبر المسار العام الموحد PUT lookup/{lookupName}/{id}",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": { }
            },
            "text/json": {
              "schema": { }
            },
            "application/*+json": {
              "schema": { }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف عنصر ثابت عبر المسار العام الموحد DELETE lookup/{lookupName}/{id}",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/lookups-and-catalog/lookup/{lookupName}/{id}": {
      "put": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "تعديل عنصر ثابت عبر المسار العام الموحد PUT lookup/{lookupName}/{id}",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": { }
            },
            "text/json": {
              "schema": { }
            },
            "application/*+json": {
              "schema": { }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "LookupsAndCatalog"
        ],
        "summary": "حذف عنصر ثابت عبر المسار العام الموحد DELETE lookup/{lookupName}/{id}",
        "parameters": [
          {
            "name": "lookupName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/orders": {
      "get": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "استعراض وبحث طلبيات الكتب الورقية مع حالة التسليم (كامل، جزئي، ملغاة) ومكان التسليم",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "إنشاء طلبية جديدة (كتب ورقية أو خدمات إلكترونية) بحالة \"قيد التجهيز\" (Pending)\r\nلا يتم إنشاء أي سند مالي (قيد أو قبض أو فاتورة) ولا خصم الرصيد الفعلي إلا بعد الموافقة والتأكيد من الأدمن أو المحاسب",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSalesOrderDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSalesOrderDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSalesOrderDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/orders/{orderId}/confirm": {
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "اعتماد وتأكيد الطلبية من الأدمن أو المحاسب وتحويلها إلى فاتورة مبيعات مؤكدة (OB):\r\n1) في حال كانت طلبية كتب ورقية: يتم التحقق من توفر الرصيد وخصم الكميات فعلياً من المخزن وتحرير الكمية المحجوزة\r\n2) يتم إنشاء سند قيد أوتوماتيكي لإثبات الذمة على حساب المدرسة\r\n3) في حال كانت الذمة على الوزارة (Ministry): يتم نقل الذمة بسند قيد أوتوماتيكي ثانٍ من ذمة المدرسة إلى ذمة الوزارة (1201)\r\n4) في حال كان الدفع نقداً (Cash) أو شيكاً (Check): يعيد النظام إشارة لفتح شاشة سند القبض فوراً للمحاسب لإدخال تفاصيل القبض يدوياً",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmSalesOrderDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmSalesOrderDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmSalesOrderDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/orders/{orderId}/cancel": {
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "إلغاء طلبية قيد التجهيز وتحرير الكميات المحجوزة في المخزن",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmSalesOrderDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmSalesOrderDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ConfirmSalesOrderDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/orders/{orderId}/process-delivery": {
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "تنفيذ التسليم الكلي أو الجزئي للطلبية أو إلغائها، مع إمكانية توليد فاتورة مبيعات تلقائية بالكميات المسلمة فقط",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProcessOrderDeliveryDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ProcessOrderDeliveryDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ProcessOrderDeliveryDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/invoices": {
      "get": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "استعراض وبحث فواتير المبيعات (تشمل فواتير الكتب الورقية، فواتير الخدمات المحوسبة لوحدها، أو الفواتير المشتركة)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "إصدار فاتورة مبيعات (مباشرة دون طلبية أو مرتبطة بطلبية):\r\n1) تدعم شراء الخدمة الإلكترونية لوحدها (WarehouseId = NULL) أو شراء الكتب الورقية (مع الخصم من المخزن المحدد) أو كليهما معاً\r\n2) تولد سند قيد مزدوج وترحل لحساب المدرسة/الزبون، وتدعم التغطية التلقائية عن طريق الوزارة (Ministry) أو النقد أو الشيك\r\n3) تضيف الكتب والخدمات المشتراة تلقائياً إلى سجل خدمات المدرسة (SchoolProvidedItems) لمتابعة مدى الرضا عنها",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInvoiceDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInvoiceDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInvoiceDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/invoices/{invoiceId}/attachments": {
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "رفع مرفق آمن للفاتورة (صورة الفاتورة الموقعة أو كتاب التغطية من الوزارة) بعد فحص البصمة الأمنية للملف (Magic Bytes)",
        "parameters": [
          {
            "name": "invoiceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/sales-orders-invoices-returns/returns": {
      "get": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "استعراض وبحث مرتجعات المبيعات المرتبطة بالكتب الورقية والمخازن",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "OrdersInvoicesAndReturns"
        ],
        "summary": "إنشاء مرتجع مبيعات للكتب الورقية:\r\nيعيد الكميات المرتجعة إلى المخزن المحدد (WarehouseId) وينشئ سند قيد عكسي يخفض ذمة المدرسة/المكتبة في كشف الحساب",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSalesReturnDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSalesReturnDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSalesReturnDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/provided-items": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "استعراض الكتب المشتراة والخدمات الرقمية المقدمة للمدارس مع تقييم مدى الرضا وملاحظاته\r\nيدعم البحث في أي حقل (AcademicYear, ItemType, SatisfactionRating...)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/evaluate-satisfaction": {
      "post": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "تسجيل أو تحديث مدى رضا المدرسة (1 إلى 5) عن كتاب ورقي مشترى أو خدمة رقمية مقدمة (مثلاً: رضاهم عن كتاب الغيث للصف الأول)\r\nمع إدراج هذه الملاحظات تلقائياً في سجل العناية بالزبائن (CustomerCareLogs) وإرسال تنبيه فوري عبر SignalR إذا كان الرضا منخفضاً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvaluateSchoolItemSatisfactionDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/EvaluateSchoolItemSatisfactionDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/EvaluateSchoolItemSatisfactionDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/customer-care-logs": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "استعراض وبحث سجلات العناية بالزبائن (ملاحظات الرضا، الاتصالات الدورية، الشكاوى، المتابعات)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "إضافة تذكرة أو سجل متابعة جديد في قسم العناية بالزبائن",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerCareLogDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerCareLogDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerCareLogDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/customer-care-logs/{id}": {
      "put": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "متابعة وتحديث الشكوى أو سجل المتابعة مع توثيق التغييرات بالكامل في سجل التدقيق (Audit Log)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerCareLogDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerCareLogDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerCareLogDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/customer-care-logs/{id}/audit-history": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "استعراض سجل حركات وتدقيق متابعة محددة (Audit History)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/competitor-items": {
      "post": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "تسجيل الكتب والخدمات التي تأخذها المدرسة من الشركات المنافسة حسب المبحث والصف وتقييم حالة الاستعداد للتغيير والسبب",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCompetitorItemDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCompetitorItemDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCompetitorItemDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "استعراض وبحث الكتب والخدمات التي تأخذها المدارس من الشركات المنافسة مع إمكانية البحث في أي حقل",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/competitor-items/{id}": {
      "put": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "تحديث بيانات المنهاج أو الخدمة المنافسة وحالة الاستعداد للتغيير",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCompetitorItemDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCompetitorItemDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCompetitorItemDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "حذف عنصر منهاج أو خدمة منافسة عند تحول المدرسة لمنهاجنا",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/schools/{customerId}/competitor-items": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "استعراض قائمة المناهج المنافسة الخاصة بمدرسة محددة مع إمكانية التصفية بالسنة الدراسية",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "academicYear",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/schools/{customerId}/curriculum-matrix": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "مصفوفة توزيع واعتماد المناهج السنوية للمدرسة (كتبنا مقابل المنافسين عبر جميع الصفوف 1-12)",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "academicYear",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subjectId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "حفظ وتحديث مصفوفة المناهج السنوية للمدرسة ولمبحث محدد بدفعة واحدة",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveCurriculumMatrixDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveCurriculumMatrixDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SaveCurriculumMatrixDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/schools/{customerId}/curriculum-matrix/copy-year": {
      "post": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "نسخ توزيع المناهج من سنة دراسية إلى أخرى بدفعة واحدة",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CopyAcademicYearCurriculumDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CopyAcademicYearCurriculumDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CopyAcademicYearCurriculumDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/schools/{customerId}/curriculum-matrix/comparison": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "مقارنة توزيع المناهج السنوية بين سنتين دراسيتين جنبًا إلى جنب لمعرفة التحول والاستحواذ",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "yearA",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "yearB",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subjectId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/competitors-analytics": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "تقرير تحليلي شامل عن الشركات المنافسة وتوزيع حصصها حسب المباحث والصفوف ومدى صعوبة الإقناع بالتغيير",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/schools/{customerId}/books-and-services-grid": {
      "get": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "جدول الكتب الورقية والخدمات المحوسبة للمدرسة (الأعمدة = الصفوف الدراسية، السطور = المباحث الدراسية)\r\nيعرض ما تم أخذه منا وما لم يتم أخذه، مع السجل التاريخي الكامل للحركات والشراء وفترات التوقف وتقييم الكتاب في كل فترة",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "academicYear",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/satisfaction-and-customer-care/schools/{customerId}/books-and-services-grid/record-period": {
      "post": {
        "tags": [
          "SatisfactionAndCustomerCare"
        ],
        "summary": "توثيق أو تحديث حركة فترة زمنية (شراء / اعتماد أو فترة توقف مع تقييم الكتاب في تلك الفترة) لخلية (مبحث × صف)",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RecordSchoolGridCellPeriodDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/RecordSchoolGridCellPeriodDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/RecordSchoolGridCellPeriodDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "استعراض وبحث المدارس والمكتبات والتجار مع إمكانية البحث في أي حقل (الكود، الاسم، الهاتف، البلدة...)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "إنشاء مدرسة أو مكتبة أو تاجر جديد، وتفريغ الكاش الخاص بالمدارس/المكتبات/التجار تلقائياً فور الإضافة",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/schools": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "قائمة المدارس المنفصلة (تخضع لصلاحية MENU_SCHOOLS المستقلة) مع حفظها في كاش المدارس (customers:schools)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/bookstores": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "قائمة المكتبات المنفصلة (تخضع لصلاحية MENU_BOOKSTORES المستقلة) مع حفظها في كاش المكتبات (customers:bookstores)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/traders": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "قائمة التجار والموزعين المنفصلة (تخضع لصلاحية MENU_TRADERS المستقلة) مع حفظها في كاش التجار (customers:traders)",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "regionId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/full-profile": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "جلب الملف الشامل للمدرسة مع حفظه في كاش المدارس (customers:schools)",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}": {
      "put": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "تعديل بيانات مدرسة أو مكتبة أو تاجر، وتفريغ الكاش الخاص به تلقائياً فور التعديل",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/location": {
      "put": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "تحديث الموقع الجغرافي والإحداثيات للمدرسة أو المكتبة أو التاجر وإنشاء روابط Google Maps و Waze ديناميكياً دون تخزين الروابط مباشرة في قاعدة البيانات",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerLocationDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerLocationDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerLocationDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/resolve-location-url": {
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "استخراج إحداثيات الموقع الجغرافي (Latitude / Longitude) من رابط خرائط Google أو Waze (بما في ذلك الروابط المختصرة)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResolveLocationUrlRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ResolveLocationUrlRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ResolveLocationUrlRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/marketers-list": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "جلب قائمة المسوقين والمستخدمين النشطين لتعيين المسوق المسؤول والمسوقين المصرح لهم والفلترة حسبهم في قائمة المدارس",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/marketers": {
      "put": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "تحديث المسوق المسؤول عن المدرسة + قائمة المسوقين الذين يمتلكون صلاحية الوصول للمدرسة دفعة واحدة",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSchoolMarketersDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSchoolMarketersDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSchoolMarketersDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/logo": {
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "رفع أو تغيير شعار/أيقونة مخصصة للمدرسة (Logo) مع فحص الأمان ضد الملفات الضارة",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "حذف الشعار المخصص للمدرسة والعودة للأيقونة الافتراضية",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/attachments": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "جلب مرفقات قوائم المدرسة (مع معلومات السنة الدراسية، الوصف، النصوص المستخرجة عبر OCR، تاريخ الرفع، آخر تحديث، واسم المستخدم الرافع/المعدل)",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "إرفاق قائمة مدرسة جديدة مع التحقق الأمني واستخراج نصوص OCR وتسجيل السنة الدراسية والوصف وبيانات الرفع",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "AcademicYear": {
                    "type": "string"
                  },
                  "Description": {
                    "type": "string"
                  },
                  "Title": {
                    "type": "string"
                  },
                  "Category": {
                    "type": "string"
                  },
                  "Notes": {
                    "type": "string"
                  },
                  "ExtractedOcrText": {
                    "type": "string"
                  },
                  "File": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "AcademicYear": {
                  "style": "form"
                },
                "Description": {
                  "style": "form"
                },
                "Title": {
                  "style": "form"
                },
                "Category": {
                  "style": "form"
                },
                "Notes": {
                  "style": "form"
                },
                "ExtractedOcrText": {
                  "style": "form"
                },
                "File": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/attachments/{attachmentId}": {
      "put": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "تحديث بيانات مرفق قائمة مدرسة (السنة الدراسية، الوصف، النصوص المستخرجة عبر OCR، أو استبدال الملف المرفق) مع تسجيل تاريخ التحديث واسم المعدل",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "attachmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "AcademicYear": {
                    "type": "string"
                  },
                  "Description": {
                    "type": "string"
                  },
                  "Title": {
                    "type": "string"
                  },
                  "Category": {
                    "type": "string"
                  },
                  "Notes": {
                    "type": "string"
                  },
                  "ExtractedOcrText": {
                    "type": "string"
                  },
                  "File": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "AcademicYear": {
                  "style": "form"
                },
                "Description": {
                  "style": "form"
                },
                "Title": {
                  "style": "form"
                },
                "Category": {
                  "style": "form"
                },
                "Notes": {
                  "style": "form"
                },
                "ExtractedOcrText": {
                  "style": "form"
                },
                "File": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "حذف مرفق قائمة مدرسة",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "attachmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/{customerId}/subject-supervisors": {
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "إضافة أو تحديث مشرف مبحث دراسي في المدرسة وتفريغ كاش المدارس تلقائياً",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubjectSupervisorDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SubjectSupervisorDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SubjectSupervisorDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/assign-marketer": {
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "تعيين صلاحية مسوق على مدرسة معينة وتفريغ كاش المدارس تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssignMarketerDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/AssignMarketerDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/AssignMarketerDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/bulk-import": {
      "post": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "استيراد مجموعة مدارس دفعة واحدة وتفريغ كاش المدارس تلقائياً",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CreateCustomerDto"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CreateCustomerDto"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CreateCustomerDto"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/grouped-by-region": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "استعراض تقسيم المدارس والزبائن حسب المناطق الجغرافية (مع دعم كاش المدارس)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/schools-and-customers/export-excel-csv": {
      "get": {
        "tags": [
          "SchoolsAndCustomers"
        ],
        "summary": "تصدير بيانات المدارس والزبائن ومناطقهم الجغرافية وأرصدتهم المالية إلى ملف متوافق مع Excel (UTF-8 CSV)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/system-health/metrics": {
      "get": {
        "tags": [
          "SystemHealth"
        ],
        "summary": "جلب القياسات الحية المحدثة للسيرفر (المعالج، الرامات، قواعد البيانات، الأقراص، الشبكة)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/system-health/history": {
      "get": {
        "tags": [
          "SystemHealth"
        ],
        "summary": "جلب السجل التاريخي لمؤشرات الأداء للرسم البياني في صفحة التتبع",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/system-health/gc-collect": {
      "post": {
        "tags": [
          "SystemHealth"
        ],
        "summary": "تحفيز تنظيف الذاكرة يدوياً (Manual Garbage Collection) لتفريغ الذاكرة المهملة",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/warehouses": {
      "get": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "استعراض جميع المخازن والمستودعات ومواقعها الجغرافية وأرصدة الكتب المتوفرة داخل كل مخزن مع الإحصائيات الحية",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cityId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "post": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "تعريف مخزن أو مستودع جديد في موقع جغرافي محدد مع تحديد أمين المستودع المسؤول",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWarehouseDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWarehouseDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWarehouseDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/warehouses/{id}": {
      "get": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "جلب تفاصيل مخزن محدد مع مؤشراته وإحصائيات أرصدة الكتب وأحدث الحركات",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "put": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "تعديل بيانات مخزن قائم",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWarehouseDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWarehouseDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWarehouseDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      },
      "delete": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "حذف مخزن (يُشترط خلوه تماماً من أي أرصدة فعلية أو حركات مخزنية)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/warehouses/{id}/set-main": {
      "post": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "تعيين المخزن كمستودع رئيسي للنظام",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/transfers": {
      "post": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "تحويل كميات كتب ورقية بين مستودعين وتوثيق قيود الحركة في السجل",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WarehouseTransferRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/WarehouseTransferRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/WarehouseTransferRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/warehouses/{id}/stock": {
      "get": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "استعراض أرصدة الكتب الخاصة بمخزن محدد مع البحث والفلترة",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subjectId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "gradeId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/books-stock-catalog": {
      "get": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "استعراض كتالوج أرصدة المخزون الشامل لجميع الكتب الورقية في المخازن مع الكميات المتاحة والمحجوزة والصافية",
        "parameters": [
          {
            "name": "warehouseId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "subjectId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "gradeId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/stock-movements": {
      "post": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "إدخال كميات طباعة جديدة أو إجراء تسوية جردية أو تعديل رصيد يدوي لكتاب ورقي داخل مخزن محدد",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StockMovementRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/StockMovementRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/StockMovementRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/transactions": {
      "get": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "استعراض سجل حركات المخزون (InventoryTransactions) لجميع الكتب والمخازن مع إمكانية البحث والفلترة",
        "parameters": [
          {
            "name": "GlobalSearch",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchField",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SearchValue",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Filters",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortBy",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "SortDesc",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "PageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "warehouseId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "paperBookId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "transactionType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fromDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "toDate",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/warehouses-and-inventory/summary-report": {
      "get": {
        "tags": [
          "WarehousesAndInventory"
        ],
        "summary": "تقرير ملخص المخزون وحركة الكتب (مؤشرات الأداء المخزنية وحركات الإدخال والصرف والمرتجعات محسوبة مباشرة عبر SQL Aggregates)",
        "parameters": [
          {
            "name": "warehouseId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AddGreenContactDto": {
        "type": "object",
        "properties": {
          "phone": {
            "type": "string",
            "nullable": true
          },
          "firstName": {
            "type": "string",
            "nullable": true
          },
          "lastName": {
            "type": "string",
            "nullable": true
          },
          "country": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "AdminResetUserPasswordDto": {
        "type": "object",
        "properties": {
          "newPassword": {
            "type": "string",
            "nullable": true
          },
          "notifyEmail": {
            "type": "boolean"
          },
          "notifyWhatsapp": {
            "type": "boolean"
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "AssignMarketerDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "marketerUserId": {
            "type": "integer",
            "format": "int32"
          },
          "isPrimaryMarketer": {
            "type": "boolean"
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ChangePasswordRequestDto": {
        "type": "object",
        "properties": {
          "currentPassword": {
            "type": "string",
            "nullable": true
          },
          "newPassword": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CheckAppointmentConflictDto": {
        "type": "object",
        "properties": {
          "assignedToUserId": {
            "type": "integer",
            "format": "int32"
          },
          "appointmentDate": {
            "type": "string",
            "format": "date-time"
          },
          "startTime": {
            "type": "string",
            "nullable": true
          },
          "endTime": {
            "type": "string",
            "nullable": true
          },
          "excludeAppointmentId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "appointmentId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CheckItemDto": {
        "type": "object",
        "properties": {
          "checkNumber": {
            "type": "string",
            "nullable": true
          },
          "checkOwnerName": {
            "type": "string",
            "nullable": true
          },
          "bankName": {
            "type": "string",
            "nullable": true
          },
          "dueDate": {
            "type": "string",
            "format": "date-time"
          },
          "amount": {
            "type": "number",
            "format": "double"
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CheckStatusTransitionDto": {
        "type": "object",
        "properties": {
          "direction": {
            "type": "string",
            "nullable": true
          },
          "checkId": {
            "type": "integer",
            "format": "int32"
          },
          "newStatusCode": {
            "type": "string",
            "nullable": true
          },
          "targetAccountId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CompleteGuidanceSessionDto": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "nullable": true
          },
          "classesCount": {
            "type": "integer",
            "format": "int32"
          },
          "teachersAttendedCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "checkInLatitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "checkInLongitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "reportNotes": {
            "type": "string",
            "nullable": true
          },
          "cancellationReason": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ConfirmGuidanceScheduleRequestDto": {
        "type": "object",
        "properties": {
          "advisorUserId": {
            "type": "integer",
            "format": "int32"
          },
          "appointmentDate": {
            "type": "string",
            "format": "date-time"
          },
          "startTime": {
            "type": "string",
            "nullable": true
          },
          "endTime": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "classesCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "teachersCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "metWithPersonName": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonRole": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonPhone": {
            "type": "string",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "priority": {
            "type": "string",
            "nullable": true
          },
          "proposedTopics": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "sendViaWhatsapp": {
            "type": "boolean"
          },
          "sendViaEmail": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "ConfirmSalesOrderDto": {
        "type": "object",
        "properties": {
          "paymentMethod": {
            "type": "string",
            "nullable": true
          },
          "warehouseId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "extraDiscountAmount": {
            "type": "number",
            "format": "double"
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CopyAcademicYearCurriculumDto": {
        "type": "object",
        "properties": {
          "sourceAcademicYear": {
            "type": "string",
            "nullable": true
          },
          "targetAcademicYear": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateAcademicYearLookupDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "nameEn": {
            "type": "string",
            "nullable": true
          },
          "startYear": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "endYear": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "isCurrentYear": {
            "type": "boolean",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateAccountDto": {
        "type": "object",
        "properties": {
          "accountNumber": {
            "type": "string",
            "nullable": true
          },
          "accountCode": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "accountNameAr": {
            "type": "string",
            "nullable": true
          },
          "accountType": {
            "type": "string",
            "nullable": true
          },
          "isGroup": {
            "type": "boolean"
          },
          "parentAccountId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateAppointmentInquiryDto": {
        "type": "object",
        "properties": {
          "inquiryText": {
            "type": "string",
            "nullable": true
          },
          "sendViaWhatsapp": {
            "type": "boolean"
          },
          "sendViaEmail": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "CreateCalendarAppointmentDto": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "nullable": true
          },
          "appointmentType": {
            "type": "string",
            "nullable": true
          },
          "assignedToUserId": {
            "type": "integer",
            "format": "int32"
          },
          "isAssignedByAdmin": {
            "type": "boolean"
          },
          "customerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "classesCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "teachersAttendedCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "teachersCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "appointmentDate": {
            "type": "string",
            "format": "date-time"
          },
          "startTime": {
            "type": "string",
            "nullable": true
          },
          "endTime": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "priority": {
            "type": "string",
            "nullable": true
          },
          "colorCode": {
            "type": "string",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonName": {
            "type": "string",
            "nullable": true
          },
          "metWithPerson": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonRole": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonPhone": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "proposedTopics": {
            "type": "string",
            "nullable": true
          },
          "requestedByMarketerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "requestedByMarketerName": {
            "type": "string",
            "nullable": true
          },
          "linkedSchoolVisitId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "sendViaWhatsapp": {
            "type": "boolean"
          },
          "sendViaEmail": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "CreateChangeReasonLookupDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "nameEn": {
            "type": "string",
            "nullable": true
          },
          "categoryAr": {
            "type": "string",
            "nullable": true
          },
          "descriptionAr": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateCheckStatusLookupDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "nameEn": {
            "type": "string",
            "nullable": true
          },
          "direction": {
            "type": "string",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateCityLookupDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "nameEn": {
            "type": "string",
            "nullable": true
          },
          "regionId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateCompetitorItemDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "competitorId": {
            "type": "integer",
            "format": "int32"
          },
          "itemType": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "gradeId": {
            "type": "integer",
            "format": "int32"
          },
          "competitorProductName": {
            "type": "string",
            "nullable": true
          },
          "convincingDifficulty": {
            "type": "string",
            "nullable": true
          },
          "changeReadiness": {
            "type": "string",
            "nullable": true
          },
          "changeReadinessScore": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "changeReasonId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "reasonNotes": {
            "type": "string",
            "nullable": true
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateCustomerCareLogDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "schoolProvidedItemId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "careType": {
            "type": "string",
            "nullable": true
          },
          "channel": {
            "type": "string",
            "nullable": true
          },
          "satisfactionScore": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "summaryNotes": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "nextFollowUpDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "contactPerson": {
            "type": "string",
            "nullable": true
          },
          "actionTaken": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateCustomerDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "customerTypeId": {
            "type": "integer",
            "format": "int32"
          },
          "regionId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "cityId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "address": {
            "type": "string",
            "nullable": true
          },
          "phone1": {
            "type": "string",
            "nullable": true
          },
          "whatsappNumber": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "googleMapsUrl": {
            "type": "string",
            "nullable": true
          },
          "schoolStageId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "principalName": {
            "type": "string",
            "nullable": true
          },
          "firstSubscriptionDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "defaultDiscountPercent": {
            "type": "number",
            "format": "double"
          },
          "subjectSupervisors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubjectSupervisorDto"
            },
            "nullable": true
          },
          "marketerIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          },
          "primaryMarketerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "wazeUrl": {
            "type": "string",
            "nullable": true
          },
          "logoUrl": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateCustomerTypeLookupDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "nameEn": {
            "type": "string",
            "nullable": true
          },
          "defaultDiscountPercentage": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "CreateDigitalServiceDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "platformId": {
            "type": "integer",
            "format": "int32"
          },
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "gradeId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "annualPrice": {
            "type": "number",
            "format": "double"
          },
          "description": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateGradeLookupDto": {
        "type": "object",
        "properties": {
          "gradeNumber": {
            "type": "integer",
            "format": "int32"
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "stageNameAr": {
            "type": "string",
            "nullable": true
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "code": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateGuidanceScheduleRequestDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "proposedDate": {
            "type": "string",
            "format": "date-time"
          },
          "proposedStartTime": {
            "type": "string",
            "nullable": true
          },
          "proposedEndTime": {
            "type": "string",
            "nullable": true
          },
          "proposedTopics": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "suggestedAdvisorUserId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "requestedByMarketerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "linkedSchoolVisitId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "classesCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "expectedTeachersCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "metWithPersonName": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonRole": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonPhone": {
            "type": "string",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "priority": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateGuidanceSessionDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "advisorUserId": {
            "type": "integer",
            "format": "int32"
          },
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "sessionDate": {
            "type": "string",
            "format": "date-time"
          },
          "sessionTime": {
            "type": "string",
            "nullable": true
          },
          "classesCount": {
            "type": "integer",
            "format": "int32"
          },
          "teachersAttendedCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "reportNotes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateInvoiceDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "salesOrderId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "warehouseId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "paymentMethod": {
            "type": "string",
            "nullable": true
          },
          "extraDiscountAmount": {
            "type": "number",
            "format": "double"
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InvoiceItemRequestDto"
            },
            "nullable": true
          },
          "paymentCheckDetails": {
            "$ref": "#/components/schemas/CheckItemDto"
          }
        },
        "additionalProperties": false
      },
      "CreateLookupDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "nameAr": {
            "type": "string",
            "nullable": true
          },
          "nameEn": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateManualErrorLogDto": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "integer",
            "format": "int32"
          },
          "errorType": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "module": {
            "type": "string",
            "nullable": true
          },
          "httpMethod": {
            "type": "string",
            "nullable": true
          },
          "path": {
            "type": "string",
            "nullable": true
          },
          "userName": {
            "type": "string",
            "nullable": true
          },
          "stackTrace": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateManualJournalVoucherDto": {
        "type": "object",
        "properties": {
          "voucherDate": {
            "type": "string",
            "format": "date-time"
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/JournalLineInputDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreatePaperBookDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "gradeId": {
            "type": "integer",
            "format": "int32"
          },
          "partNumber": {
            "type": "integer",
            "format": "int32"
          },
          "price": {
            "type": "number",
            "format": "double"
          },
          "coverImageUrl": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "detailedInfo": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreatePaymentVoucherDto": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "integer",
            "format": "int32"
          },
          "boxAccountId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "cashValue": {
            "type": "number",
            "format": "double"
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CheckItemDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateReceiptVoucherDto": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "integer",
            "format": "int32"
          },
          "boxAccountId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "cashValue": {
            "type": "number",
            "format": "double"
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CheckItemDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateSalesOrderDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "warehouseId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "deliveryLocation": {
            "type": "string",
            "nullable": true
          },
          "deliveryLatitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "deliveryLongitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "expectedDeliveryDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SalesOrderItemRequestDto"
            },
            "nullable": true
          },
          "paymentMethod": {
            "type": "string",
            "nullable": true
          },
          "orderCategory": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateSalesReturnDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "invoiceId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "warehouseId": {
            "type": "integer",
            "format": "int32"
          },
          "reasonNotes": {
            "type": "string",
            "nullable": true
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SalesReturnItemRequestDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateSchoolVisitDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "visitDate": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonName": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonRole": {
            "type": "string",
            "nullable": true
          },
          "checkInLatitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "checkInLongitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "followedSubjectIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateUserRequestDto": {
        "type": "object",
        "properties": {
          "fullName": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "password": {
            "type": "string",
            "nullable": true
          },
          "whatsappNumber": {
            "type": "string",
            "nullable": true
          },
          "phoneNumber": {
            "type": "string",
            "nullable": true
          },
          "roleId": {
            "type": "integer",
            "format": "int32"
          },
          "additionalRoleIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          },
          "permissionCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "CreateWarehouseDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "cityId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "address": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "keeperUserId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "isMainWarehouse": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "CurriculumMatrixSlotDto": {
        "type": "object",
        "properties": {
          "gradeId": {
            "type": "integer",
            "format": "int32"
          },
          "provider": {
            "type": "string",
            "nullable": true
          },
          "competitorId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "competitorProductName": {
            "type": "string",
            "nullable": true
          },
          "convincingDifficulty": {
            "type": "string",
            "nullable": true
          },
          "changeReadiness": {
            "type": "string",
            "nullable": true
          },
          "changeReadinessScore": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "changeReasonId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "reasonNotes": {
            "type": "string",
            "nullable": true
          },
          "satisfactionRating": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "satisfactionNotes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "DeleteGreenContactDto": {
        "type": "object",
        "properties": {
          "chatId": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "EditGreenContactDto": {
        "type": "object",
        "properties": {
          "chatId": {
            "type": "string",
            "nullable": true
          },
          "firstName": {
            "type": "string",
            "nullable": true
          },
          "lastName": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "EvaluateSchoolItemSatisfactionDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "itemType": {
            "type": "string",
            "nullable": true
          },
          "paperBookId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "digitalServiceId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "satisfactionRating": {
            "type": "integer",
            "format": "int32"
          },
          "satisfactionNotes": {
            "type": "string",
            "nullable": true
          },
          "channel": {
            "type": "string",
            "nullable": true
          },
          "nextFollowUpDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "EvictCacheScopeDto": {
        "type": "object",
        "properties": {
          "scopeKey": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ForgotPasswordRequestDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "nullable": true
          },
          "channelPreference": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "GoogleLoginRequestDto": {
        "type": "object",
        "properties": {
          "googleIdToken": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "fullName": {
            "type": "string",
            "nullable": true
          },
          "googleSubjectId": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "deviceType": {
            "type": "string",
            "nullable": true
          },
          "idToken": {
            "type": "string",
            "nullable": true
          },
          "credential": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "InvoiceItemRequestDto": {
        "type": "object",
        "properties": {
          "itemType": {
            "type": "string",
            "nullable": true
          },
          "paperBookId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "printingYear": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "digitalServiceId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "unitPrice": {
            "type": "number",
            "format": "double"
          },
          "discountPercentage": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "JournalLineInputDto": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "integer",
            "format": "int32"
          },
          "debit": {
            "type": "number",
            "format": "double"
          },
          "credit": {
            "type": "number",
            "format": "double"
          },
          "lineDescription": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "JsonNode": {
        "type": "object",
        "properties": {
          "options": {
            "$ref": "#/components/schemas/JsonNodeOptions"
          },
          "parent": {
            "$ref": "#/components/schemas/JsonNode"
          },
          "root": {
            "$ref": "#/components/schemas/JsonNode"
          }
        },
        "additionalProperties": false
      },
      "JsonNodeOptions": {
        "type": "object",
        "properties": {
          "propertyNameCaseInsensitive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "LoginRequestDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "nullable": true
          },
          "password": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "accuracyMeters": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "deviceType": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "LogoutRequestDto": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "accuracyMeters": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "PartialDeliveryItemDto": {
        "type": "object",
        "properties": {
          "salesOrderItemId": {
            "type": "integer",
            "format": "int32"
          },
          "deliveredNowQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "cancelledQuantity": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "ProcessOrderDeliveryDto": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PartialDeliveryItemDto"
            },
            "nullable": true
          },
          "convertDeliveredToInvoice": {
            "type": "boolean"
          },
          "paymentMethod": {
            "type": "string",
            "nullable": true
          },
          "cancellationReason": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "RecordSchoolGridCellPeriodDto": {
        "type": "object",
        "properties": {
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "gradeId": {
            "type": "integer",
            "format": "int32"
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "itemType": {
            "type": "string",
            "nullable": true
          },
          "paperBookId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "digitalServiceId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "adoptionStatus": {
            "type": "string",
            "nullable": true
          },
          "purchasedQuantity": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "satisfactionRating": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "satisfactionNotes": {
            "type": "string",
            "nullable": true
          },
          "stopReason": {
            "type": "string",
            "nullable": true
          },
          "competitorId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "competitorProductName": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ReplyAppointmentInquiryDto": {
        "type": "object",
        "properties": {
          "replyText": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ResetPasswordWithCodeDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "nullable": true
          },
          "resetCode": {
            "type": "string",
            "nullable": true
          },
          "newPassword": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ResolveLocationUrlRequestDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SalesOrderItemRequestDto": {
        "type": "object",
        "properties": {
          "paperBookId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "printingYear": {
            "type": "integer",
            "format": "int32"
          },
          "orderedQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "unitPrice": {
            "type": "number",
            "format": "double"
          },
          "discountPercentage": {
            "type": "number",
            "format": "double"
          },
          "itemType": {
            "type": "string",
            "nullable": true
          },
          "digitalServiceId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SalesReturnItemRequestDto": {
        "type": "object",
        "properties": {
          "paperBookId": {
            "type": "integer",
            "format": "int32"
          },
          "printingYear": {
            "type": "integer",
            "format": "int32"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "unitPrice": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "SaveCurriculumMatrixDto": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "integer",
            "format": "int32"
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "slots": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CurriculumMatrixSlotDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SaveDashboardPreferenceDto": {
        "type": "object",
        "properties": {
          "preferredTheme": {
            "type": "string",
            "nullable": true
          },
          "defaultLandingRoute": {
            "type": "string",
            "nullable": true
          },
          "widgetsConfigJson": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SendAppointmentNotificationDto": {
        "type": "object",
        "properties": {
          "sendViaWhatsapp": {
            "type": "boolean"
          },
          "sendViaEmail": {
            "type": "boolean"
          },
          "additionalNote": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SendEmailRequestDto": {
        "type": "object",
        "properties": {
          "recipientEmail": {
            "type": "string",
            "nullable": true
          },
          "recipientName": {
            "type": "string",
            "nullable": true
          },
          "subject": {
            "type": "string",
            "nullable": true
          },
          "htmlContent": {
            "type": "string",
            "nullable": true
          },
          "sendBcc": {
            "type": "boolean"
          },
          "customerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SendGreenWhatsAppDto": {
        "type": "object",
        "properties": {
          "chatId": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "customerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "enqueueAntiBan": {
            "type": "boolean"
          },
          "firstName": {
            "type": "string",
            "nullable": true
          },
          "lastName": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "StockMovementRequestDto": {
        "type": "object",
        "properties": {
          "warehouseId": {
            "type": "integer",
            "format": "int32"
          },
          "paperBookId": {
            "type": "integer",
            "format": "int32"
          },
          "printingYear": {
            "type": "integer",
            "format": "int32"
          },
          "quantityChange": {
            "type": "integer",
            "format": "int32"
          },
          "transactionType": {
            "type": "string",
            "nullable": true
          },
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "exactQuantity": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "minReorderLevel": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SubjectSupervisorDto": {
        "type": "object",
        "properties": {
          "subjectId": {
            "type": "integer",
            "format": "int32"
          },
          "supervisorName": {
            "type": "string",
            "nullable": true
          },
          "phoneNumber": {
            "type": "string",
            "nullable": true
          },
          "whatsappNumber": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "roleTitle": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ToggleUserLockRequestDto": {
        "type": "object",
        "properties": {
          "isActive": {
            "type": "boolean"
          },
          "reason": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "TriggerMarketerAlertTestDto": {
        "type": "object",
        "properties": {
          "eventKey": {
            "type": "string",
            "nullable": true
          },
          "marketerUserId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "marketerName": {
            "type": "string",
            "nullable": true
          },
          "schoolName": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "extraDetails": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateAdminMarketerAlertPreferencesDto": {
        "type": "object",
        "properties": {
          "adminEmail": {
            "type": "string",
            "nullable": true
          },
          "adminWhatsappNumber": {
            "type": "string",
            "nullable": true
          },
          "targetScope": {
            "type": "string",
            "nullable": true
          },
          "targetMarketerUserId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "targetMarketerName": {
            "type": "string",
            "nullable": true
          },
          "eventChannels": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "nullable": true
          },
          "eventTargetUserIds": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "nullable": true
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateCalendarAppointmentDto": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "nullable": true
          },
          "appointmentType": {
            "type": "string",
            "nullable": true
          },
          "assignedToUserId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "customerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "classesCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "teachersAttendedCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "teachersCount": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "appointmentDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "startTime": {
            "type": "string",
            "nullable": true
          },
          "endTime": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "priority": {
            "type": "string",
            "nullable": true
          },
          "colorCode": {
            "type": "string",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonName": {
            "type": "string",
            "nullable": true
          },
          "metWithPerson": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonRole": {
            "type": "string",
            "nullable": true
          },
          "metWithPersonPhone": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "proposedTopics": {
            "type": "string",
            "nullable": true
          },
          "requestedByMarketerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "requestedByMarketerName": {
            "type": "string",
            "nullable": true
          },
          "linkedSchoolVisitId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "cancellationReason": {
            "type": "string",
            "nullable": true
          },
          "sendViaWhatsapp": {
            "type": "boolean"
          },
          "sendViaEmail": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "UpdateCompetitorItemDto": {
        "type": "object",
        "properties": {
          "competitorId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "itemType": {
            "type": "string",
            "nullable": true
          },
          "subjectId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "gradeId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "competitorProductName": {
            "type": "string",
            "nullable": true
          },
          "convincingDifficulty": {
            "type": "string",
            "nullable": true
          },
          "changeReadiness": {
            "type": "string",
            "nullable": true
          },
          "changeReadinessScore": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "changeReasonId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "reasonNotes": {
            "type": "string",
            "nullable": true
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateCustomerCareLogDto": {
        "type": "object",
        "properties": {
          "careType": {
            "type": "string",
            "nullable": true
          },
          "channel": {
            "type": "string",
            "nullable": true
          },
          "contactPerson": {
            "type": "string",
            "nullable": true
          },
          "summaryNotes": {
            "type": "string",
            "nullable": true
          },
          "actionTaken": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "nextFollowUpDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "auditReason": {
            "type": "string",
            "nullable": true
          },
          "satisfactionScore": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateCustomerLocationDto": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "googleMapsUrl": {
            "type": "string",
            "nullable": true
          },
          "wazeUrl": {
            "type": "string",
            "nullable": true
          },
          "sourceUrl": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateEmailTemplateDto": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "nullable": true
          },
          "body": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateSchoolMarketersDto": {
        "type": "object",
        "properties": {
          "primaryMarketerId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "authorizedMarketerIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          },
          "academicYear": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateUserRequestDto": {
        "type": "object",
        "properties": {
          "fullName": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "whatsappNumber": {
            "type": "string",
            "nullable": true
          },
          "phoneNumber": {
            "type": "string",
            "nullable": true
          },
          "roleId": {
            "type": "integer",
            "format": "int32"
          },
          "avatarUrl": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean",
            "nullable": true
          },
          "roleIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateUserRolesAndPermissionsDto": {
        "type": "object",
        "properties": {
          "primaryRoleId": {
            "type": "integer",
            "format": "int32"
          },
          "roleIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          },
          "permissionCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateVisitStatusDto": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "nullable": true
          },
          "checkInLatitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "checkInLongitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "cancellationReason": {
            "type": "string",
            "nullable": true
          },
          "followedSubjectIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "UpdateWarehouseDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "cityId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "address": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "keeperUserId": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "isMainWarehouse": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "UserLocationPingDto": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "double"
          },
          "longitude": {
            "type": "number",
            "format": "double"
          },
          "accuracyMeters": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "speedKmh": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "headingDegrees": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "locationAddress": {
            "type": "string",
            "nullable": true
          },
          "eventType": {
            "type": "string",
            "nullable": true
          },
          "activityDescription": {
            "type": "string",
            "nullable": true
          },
          "isBackground": {
            "type": "boolean"
          },
          "batteryLevel": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "deviceType": {
            "type": "string",
            "nullable": true
          },
          "accessToken": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "WarehouseTransferRequestDto": {
        "type": "object",
        "properties": {
          "fromWarehouseId": {
            "type": "integer",
            "format": "int32"
          },
          "toWarehouseId": {
            "type": "integer",
            "format": "int32"
          },
          "paperBookId": {
            "type": "integer",
            "format": "int32"
          },
          "printingYear": {
            "type": "integer",
            "format": "int32"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "notes": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "أدخل رمز التوكن المشفر (JWT Token) مسبوقاً بكلمة Bearer ومسافة",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    { }
  ],
  "tags": [
    {
      "name": "AuthAndSecurity"
    },
    {
      "name": "CacheManagement",
      "description": "إدارة الكاش المركزي للنظام (Backend Cache Management Controller)\r\nيتيح استعراض حالة كافة نطاقات الكاش (كاش المدارس، المكتبات، التجار، وكل جدول من جداول الـ Lookups على حدة)\r\nوتفريغ أي جزء محدد لوحده أو تفريغ فئة كاملة أو تفريغ الكاش بالكامل"
    },
    {
      "name": "ErrorLogs"
    },
    {
      "name": "FieldVisitsAndGuidance",
      "description": "إدارة الزيارات الميدانية للمسوقين إلى المدارس (مجدولة، تمت، ألغيت + الأقسام المتابعة)،\r\nإدارة الجلسات والحصص الإرشادية للمرشدين (بطلب من المسوق)، والرزنامة الموحدة مع إشعارات SignalR الفورية"
    },
    {
      "name": "FinancialAccounting",
      "description": "إدارة النظام المالي والمحاسبي المزدوج (على نمط StoreSystem):\r\nشجرة الحسابات، سندات القيد المزدوج (JournalVouchers)، سندات القبض نقداً وشيكات (ReceiptVouchers)،\r\nسندات الصرف (PaymentVouchers)، كشوفات الحسابات التفصيلية، وتصفير الأرقام التسلسلية سنوياً من الأدمن"
    },
    {
      "name": "GreenApiAndEmail",
      "description": "إدارة التواصل عبر واتساب (GREEN-API) وإرسال البريد الإلكتروني (Pepipost)\r\nمطابق تماماً لمسارات وصلاحيات ومفاتيح مشروع ALARAEYYA (/api/green)"
    },
    {
      "name": "LookupsAndCatalog",
      "description": "إدارة جميع جداول الثوابت (Lookups: المباحث، الصفوف 1-12، الصلاحيات، أنواع الزبائن، منصات لبيب وهيا، المنافسين، المدن، المناطق)\r\nبالإضافة إلى دليل الكتب الورقية (PaperBooks) والخدمات المحوسبة (DigitalServices)\r\nمع نظام كاش مستقل لكل Lookup على حدة وتفريغ تلقائي للجزء المعدل فقط عند التعديل أو الإضافة"
    },
    {
      "name": "OrdersInvoicesAndReturns",
      "description": "إدارة طلبيات الكتب الورقية (مرتبطة بالكتب والمخازن فقط، مع مكان التسليم ودعم التسليم الجزئي والإلغاء)،\r\nإدارة الفواتير السنوية (مباشرة دون طلبية أو من طلبية، للكتب الورقية و/أو الخدمات المحوسبة لوحدها، مع طرق الدفع: الوزارة/نقداً/شيك/ذمم والمرفقات)،\r\nوإدارة مرتجعات المبيعات المرتبطة بالكتب والمخازن"
    },
    {
      "name": "SatisfactionAndCustomerCare",
      "description": "إدارة تقييم مدى رضا المدارس عن كل خدمة مقدمة وكل كتاب تم شراؤه (مع إدراج الملاحظات تلقائياً في العناية بالزبائن)،\r\nإدارة سجلات العناية بالزبائن (CustomerCareLogs)، ومتابعة الكتب والخدمات التي تأخذها المدرسة من الشركات المنافسة"
    },
    {
      "name": "SchoolsAndCustomers",
      "description": "إدارة الزبائن الموحدة (المدارس، المكتبات، والتجار)، مشرفي المباحث في المدارس (مشرف العربي ورقمه، مشرف العبري ورقمه...)،\r\nوتعيين صلاحيات المسوقين على المدارس، مع كاش مستقل للمدارس والمكتبات والتجار يتم تفريغه تلقائياً عند التعديل أو الإضافة"
    },
    {
      "name": "SystemHealth",
      "description": "مراقبة وتتبع موارد النظام الحقيقية (CPU، RAM، Database، Disks، Network)"
    },
    {
      "name": "WarehousesAndInventory",
      "description": "إدارة المستودعات والمخازن المتعددة المواقع، أرصدة الكتب الورقية حسب سنة الطباعة،\r\nوحركات المخزون (إدخال طباعة جديدة، تسوية جردية، وكشف حركة الكتاب في المخازن)"
    }
  ]
}