# السجلات

تمتلك نقطة البيع واجهتي سجلّات: **شاشة السجلات داخل التطبيق** (داخل تطبيق نقطة البيع) و**صفحة السجلات في WP Admin** (داخل WordPress). معًا تمنحانك صورة كاملة عن نشاط نقطة البيع لأغراض التصحيح والتدقيق.

<!-- -->

## سجلات تطبيق نقطة البيع[​](#pos-application-logs "رابط مباشر إلى سجلات تطبيق نقطة البيع")

### الوصول إلى السجلات[​](#accessing-logs "رابط مباشر إلى الوصول إلى السجلات")

افتح شاشة السجلات من لوحة الملاحة اليسرى (رمز نبض القلب).

### نظرة عامة على الواجهة[​](#interface-overview "رابط مباشر إلى نظرة عامة على الواجهة")

#### البحث والتصفية[​](#search--filter "رابط مباشر إلى البحث والتصفية")

* **بحث السجلات** - العثور على إدخالات سجل محددة حسب محتوى الرسالة
* **تصفية مستوى السجل** - التصفية حسب مستوى السجل (info، warn، error)
* **إعدادات العرض** - تكوين الأعمدة المرئية

#### جدول السجلات[​](#log-table "رابط مباشر إلى جدول السجلات")

يُظهر كل إدخال سجل ما يلي:

| العمود      | الوصف                                               |
| ----------- | --------------------------------------------------- |
| **الوقت**   | متى وقع الحدث                                       |
| **المستوى** | الخطورة: info (رمادي)، warn (برتقالي)، error (أحمر) |
| **الرسالة** | وصف للحدث يمكن قراءته من قبل الإنسان                |
| **السياق**  | JSON قابل للتوسيع مع تفاصيل إضافية                  |
| **الرمز**   | رمز الخطأ (يرتبط بالوثائق)                          |

### مستويات السجل[​](#log-levels "رابط مباشر إلى مستويات السجل")

#### Info (رمادي)[​](#info-grey "رابط مباشر إلى Info (رمادي)")

العمليات العادية والأحداث الناجحة:

* "تم جلب جميع معرّفات المنتجات"
* "تمت مزامنة العملاء الجدد"
* "تم جلب جميع معرّفات الضرائب"

#### Warning (برتقالي)[​](#warning-orange "رابط مباشر إلى Warning (برتقالي)")

مشكلات غير حرجة قد تحتاج إلى الانتباه:

* "تعذّر تحديث الجلسة"
* "محاولة إعادة للمزامنة"

#### Error (أحمر)[​](#error-red "رابط مباشر إلى Error (أحمر)")

مشكلات تحتاج إلى معالجة:

* "عذرًا، لا يمكنك سرد الموارد" (مشكلة في الإذن)
* "فشل طلب API"
* "خطأ في مزامنة قاعدة البيانات"

#### Audit (أزرق)[​](#audit-blue "رابط مباشر إلى Audit (أزرق)")

يسجّل مستوى سجل التدقيق التغييرات التي تُجريها نقطة البيع على قاعدة البيانات، ملتقطًا حالة كل تعديل بالكامل قبله وبعده. هذا مفيد لتتبّع ما تغيّر بالضبط ومتى، على سبيل المثال أثناء إنشاء الطلبات أو تعديلات المخزون أو تحديثات العملاء.

تتضمّن إدخالات التدقيق ما يلي:

* **نوع الكيان** - المورد الذي تم تعديله (مثل الطلب، المنتج، العميل)
* **الإجراء** - نوع التغيير (إنشاء، تحديث، حذف)
* **الحالة قبل** - القيم السابقة قبل التغيير
* **الحالة بعد** - القيم الجديدة بعد التغيير

### بيانات السياق[​](#context-data "رابط مباشر إلى بيانات السياق")

انقر على سهم التوسع في أي إدخال سجل لرؤية سياق JSON التفصيلي:

```
{

  "total": "6",

  "execution_time": "54.79 ms",

  "server_load": "[10.51, 10.42, 9.98]"

}
```

تشمل هذه البيانات:

* **أعداد العناصر** - عدد السجلات المتأثرة
* **وقت التنفيذ** - المدة التي استغرقتها العملية
* **حمل الخادم** - مقاييس أداء الخادم
* **تفاصيل الطلب/الاستجابة** - لاستكشاف أخطاء API

### رموز الخطأ[​](#error-codes "رابط مباشر إلى رموز الخطأ")

تتضمّن العديد من إدخالات السجل **رمز خطأ** (مثل `API02004`، `DB01001`). ترتبط هذه الرموز مباشرةً بوثائق [رموز الأخطاء](/ar/error-codes/.md)، التي تقدّم:

* شرحًا مفصّلًا للخطأ
* الأسباب الشائعة
* خطوات استكشاف الأخطاء

### إدخالات السجل الشائعة[​](#common-log-entries "رابط مباشر إلى إدخالات السجل الشائعة")

#### عمليات المزامنة[​](#sync-operations "رابط مباشر إلى عمليات المزامنة")

```
[info] Fetched all IDs for products    {...} 3 items

[info] Synced new customers            {...} 1 item

[info] Fetched all IDs for taxes       {...} 3 items
```

تشير هذه إلى نشاط مزامنة عادي. يُظهر السياق عدد العناصر التي تمت مزامنتها.

#### أخطاء الأذونات[​](#permission-errors "رابط مباشر إلى أخطاء الأذونات")

```
[error] Sorry, you cannot list resources    {...} API02004
```

يعني هذا عادةً أن المستخدم لا يملك إذن الوصول إلى مورد. تحقّق من أدوار المستخدمين في `WP Admin > POS > Settings > Access`.

#### مشكلات الجلسة[​](#session-issues "رابط مباشر إلى مشكلات الجلسة")

```
[warn] Unable to refresh session    {...} API02007
```

لم تتمكّن نقطة البيع من تحديث جلسة المصادقة. قد يتطلّب ذلك تسجيل الخروج ثم الدخول مرة أخرى.

## صفحة السجلات في WP Admin[​](#wp-admin-logs-page "رابط مباشر إلى صفحة السجلات في WP Admin")

توفّر إضافة نقطة البيع أيضًا صفحة سجلّات على جانب الخادم في منطقة إدارة WordPress. تعرض هذه الصفحة التحذيرات والأخطاء الخاصة بنقطة البيع المسجَّلة على الخادم، مما يساعد في تشخيص المشكلات التي قد لا تظهر في تطبيق نقطة البيع نفسه.

### الوصول إلى صفحة السجلات في WP Admin[​](#accessing-the-wp-admin-logs-page "رابط مباشر إلى الوصول إلى صفحة السجلات في WP Admin")

انتقل إلى **WP Admin > POS > Settings**، ثم اختر علامة التبويب **Tools** وانقر **Logs**.

### شارة غير المقروء[​](#unread-badge "رابط مباشر إلى شارة غير المقروء")

يعرض عنصر قائمة السجلات شارة تشير إلى إدخالات السجل غير المقروءة:

* **شارة حمراء** - توجد إدخالات غير مقروءة بمستوى خطأ
* **شارة كهرمانية** - توجد إدخالات غير مقروءة بمستوى تحذير (لكن دون أخطاء)

تؤدي زيارة صفحة السجلات إلى إعادة تعيين أعداد غير المقروء. تُتتبّع الأعداد لكل مستخدم، فيرى كل مسؤول حالته الخاصة من غير المقروء.

### تصفية الإدخالات[​](#filtering-entries "رابط مباشر إلى تصفية الإدخالات")

استخدم مرشّح المستوى لتضييق إدخالات السجل:

* **All** - عرض جميع إدخالات السجل
* **Errors** - عرض الإدخالات بمستوى خطأ فقط
* **Warnings** - عرض الإدخالات بمستوى تحذير فقط

### الإدخالات القابلة للتوسيع[​](#expandable-entries "رابط مباشر إلى الإدخالات القابلة للتوسيع")

تُقتطع رسائل السجل الطويلة عند نحو 100 حرف. انقر على إدخال لتوسيعه ورؤية الرسالة الكاملة مع أي بيانات سياق إضافية.

### ترقيم الصفحات[​](#pagination "رابط مباشر إلى ترقيم الصفحات")

تُرقّم إدخالات السجل على جانب الخادم. استخدم عناصر التحكم في ترقيم الصفحات للتنقّل بين الإدخالات الأقدم.

### شريط الأخطاء الفادحة[​](#fatal-errors-banner "رابط مباشر إلى شريط الأخطاء الفادحة")

إذا كانت لدى الخادم ملفات `fatal-errors-*.log`، تعرض صفحة السجلات شريط تحذير في الأعلى. يرتبط هذا الشريط بـ **WooCommerce > Status > Logs** حيث يمكنك عرض سجلات الأخطاء الفادحة الكاملة. الأخطاء الفادحة عادةً ما تكون أعطالًا على مستوى PHP تمنع واجهة نقطة البيع البرمجية من الاستجابة.

## استخدام السجلات للدعم[​](#using-logs-for-support "رابط مباشر إلى استخدام السجلات للدعم")

عند طلب الدعم:

1. **إعادة إنتاج المشكلة** - نفّذ الإجراء الذي يسبّب المشكلة
2. **تحقّق من السجلات** - ابحث عن الأخطاء (الحمراء) أو التحذيرات (البرتقالية)
3. **وسّع السياق** - احصل على تفاصيل JSON كاملة
4. **دوّن رمز الخطأ** - ضمّنه في طلب الدعم الخاص بك
5. **انسخ الإدخالات ذات الصلة** - شارك رسائل السجل مع السياق

## مراقبة الأداء[​](#performance-monitoring "رابط مباشر إلى مراقبة الأداء")

تشمل السجلات وقت التنفيذ ومقاييس حمل الخادم. إذا لاحظت:

* **أوقات تنفيذ عالية** - قد يكون الخادم محمّلًا أكثر من اللازم أو بطيئًا
* **قيم حمل خادم عالية** - فكّر في تحسين الخادم
* **انقطاعات متكررة** - تحقّق من الاتصال بالشبكة

## وثائق ذات صلة[​](#related-documentation "رابط مباشر إلى وثائق ذات صلة")

[رموز الأخطاءشروحات مفصّلة للأخطاء](/ar/error-codes/.md)

[استكشاف الأخطاءمشكلات وحلول شائعة](/ar/category/troubleshooting.md)

[الدعمالحصول على المساعدة](/ar/support/.md)