> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# تقارير المكتبة وقياس الاستخدام COUNTER وSUSHI
- URL: https://arabroot.io/articles/تقارير-المكتبة-وقياس-الاستخدام-counter/
- Published: 2026-11-18T10:06:11.000Z
- Updated: 2026-11-18T11:03:01.000Z
- Description: كيف تقيس المكتبة استخدام اشتراكاتها وكتبها بأرقام تدافع عنها: معيار COUNTER 5.1 وسحب التقارير بـ SUSHI وتقارير SQL في Koha، مع مختبر لكل منها.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, المكتبات ونظم المعلومات, تطبيقات لفريقك, الاستضافة الذاتية, Koha

في نهاية كل سنة مالية يأتي السؤال نفسه إلى مدير المكتبة: هل نجدد اشتراك قاعدة البيانات هذه؟ وهل اشترينا أجهزة الإعارة الذاتية لشيء؟ وما الكتب التي لا يستعيرها أحد؟ والإجابة المعتادة تأتي من انطباع: «الطلاب يستخدمونها كثيراً»، أو من رقم واحد أرسله الناشر في بريد، أو من جدول جمعه موظف بيده من عشرة مواقع. ثم يجلس المدير أمام لجنة الميزانية، فيسأله أحدهم: كم مرة استخدمت؟ وبكم تكلف كل مرة؟ فلا يجد إجابة يدافع عنها. والأرقام موجودة، ولكنها في أماكن مختلفة، بقواعد عد مختلفة، ولا تجمع نفسها.

وفي هذا المقال سوف نناقش:

- من أين تأتي أرقام المكتبة: نظام المكتبة، وتقارير الناشرين، وسجل الوكيل، وموقع المكتبة، ولماذا لا تتطابق.
- معيار COUNTER في إصداره 5.1: التقارير، والمقاييس مثل Total\_Item\_Requests وUnique\_Item\_Requests، وقواعد العد مثل تصفية النقر المزدوج.
- بروتوكول SUSHI لسحب التقارير آلياً، مع عميل صغير جربناه على خادم مبني من ملف المواصفة الرسمي، والتحقق من تقرير بمخطط JSON الرسمي.
- عد سجل الوكيل بقواعد COUNTER بأنفسنا، على السجل الذي صنعناه في مقال الوصول من خارج الحرم.
- تقارير SQL في Koha على بيانات تجريبية: الإعارات الشهرية ونسبة الجهاز الذاتي، والكتب الأكثر إعارة، والنسخ التي لم تعر، والذيل الطويل.
- كيف تحول هذه الأرقام إلى قرار: تكلفة الاستخدام، والمقارنة بين السنوات، وأخطاء القراءة الشائعة.

وهذا آخر مقال في مرحلة «خدمات المكتبة الحديثة»، ويبني على المقالين قبله:

[![](https://arabroot.io/content/images/2026/11/library-rfid-cover-cover.webp)دليلالإعارة الذاتية RFID ومعيار SIP2 في المكتبةكيف تعمل أجهزة الإعارة الذاتية من الشريحة إلى نظام المكتبة، مع مختبر يشغل خادم SIP2 في Koha ويطبع كل رسالة، ويكشف مشكلتين مع الأسماء العربية.](https://arabroot.io/articles/%D8%A7%D9%84%D8%A7%D8%B9%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D8%B0%D8%A7%D8%AA%D9%8A%D8%A9-rfid-%D9%88%D9%85%D8%B9%D9%8A%D8%A7%D8%B1-sip2-%D9%81%D9%8A-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9/)[![](https://arabroot.io/content/images/2026/11/eresources-access-cover-cover.webp)دليلقواعد البيانات من خارج الحرم: الوكيل Proxy وSSOلماذا يرفض الناشر طالب الجامعة في بيته، وكيف يحل ذلك وكيل يعيد كتابة الروابط أو الدخول الموحد، مع مختبر يبني وكيلاً بـ nginx ودخولاً عبر SAML.](https://arabroot.io/articles/%D8%A7%D9%84%D9%88%D8%B5%D9%88%D9%84-%D8%A7%D9%84%D9%89-%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D9%85%D9%86-%D8%AE%D8%A7%D8%B1%D8%AC-%D8%A7%D9%84%D8%AD%D8%B1%D9%85-proxy-%D9%88-sso/)[![](https://arabroot.io/content/images/2026/11/koha-cover-cover.webp)دليلنظام المكتبة Koha: فهرسة MARC21 بالعربية والإعارةكيف تثبت Koha من حزمه الرسمية بالعربية، وتفهرس كتباً عربية بـ MARC21 وتعيرها، وتصلح البحث العربي الذي لا يعمل في الإعداد الافتراضي.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9-koha-%D9%84%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%83%D8%AA%D8%A8-%D9%88%D8%A7%D9%84%D8%A7%D8%B9%D8%A7%D8%B1%D8%A9/)

## من أين تأتي أرقام المكتبة؟

المكتبة الحديثة فيها أربعة مصادر للأرقام على الأقل، وكل منها يجيب عن سؤال مختلف، كما في الصورة التالية:

![أربعة مصادر لأرقام المكتبة: نظام المكتبة Koha للإعارات والإرجاع والقراء في الجداول statistics وold_issues تملكه أنت بتقارير SQL ومنه نسبة الجهاز الذاتي، والناشرون عبر COUNTER لطلبات المقالات والكتب بتقارير TR_J1 وTR_B1 وPR وDR يحسبها الناشر بقواعد واحدة وتجمع آلياً عبر SUSHI، وسجل الوكيل usage.log لكل طلب من خارج الحرم لا يرى من يقرأ داخل الحرم وفيه أسماء تحتاج سياسة خصوصية، وموقع المكتبة للبحث والزيارات يبين الاهتمام لا الاستخدام وجزء منه روبوتات، وفي الأسفل: لماذا لا تتطابق الأرقام؟ الوكيل يعد كل طلب والناشر يزيل النقر المزدوج خلال 30 ثانية ويعد الفريد في الجلسة، والناشر يعد الحرم والبيت معاً والوكيل يعد البيت فقط وKoha لا يعرف شيئاً عن المقالات، لذلك لا تقارن الأرقام ببعضها مباشرة](https://arabroot.io/content/images/2026/11/library-analytics-01-sources.webp)

كل مصدر يجيب عن سؤال مختلف، والخطأ أن تجمعها في عمود واحد

في الصورة أعلاه لاحظ التالي:

- **نظام المكتبة:** يعرف كل إعارة وإرجاع، ومن أين تمت، من المكتب أم من جهاز الإعارة الذاتية، وهو المصدر الذي تملكه بالكامل وتستعلم منه بـ SQL كما شئت.
- **الناشرون:** يعرفون كم مرة فتحت كل مقالة وكل كتاب إلكتروني من جامعتك، من الحرم ومن البيت، ويرسلون ذلك بمعيار COUNTER، ولكنهم لا يعرفون من قرأ، ولا يعرفون شيئاً عن الكتب المطبوعة.
- **سجل الوكيل:** يعرف من قرأ ماذا، ولكن من خارج الحرم فقط، ويعد كل طلب كما هو دون قواعد COUNTER، إلا إذا طبقتها أنت كما سوف نفعل.
- **موقع المكتبة:** عدد الزيارات وكلمات البحث، وهو مؤشر اهتمام وليس مؤشر استخدام، وجزء كبير منه زيارات روبوتات.

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

## معيار COUNTER: قواعد عد واحدة لكل الناشرين

قبل COUNTER كان كل ناشر يعد بطريقته: واحد يعد كل نقرة، وآخر يعد الجلسات، وثالث يعد الصفحات، فكان من المستحيل أن تقارن قاعدتي بيانات. ومعيار COUNTER، الذي تديره منظمة غير ربحية بالاسم نفسه على [countermetrics.org](https://www.countermetrics.org/?ref=arabroot.io)، وضع مدونة ممارسة Code of Practice يلتزم بها الناشرون: ما الذي يعد، وكيف، وبأي شكل يرسل. والإصدار الحالي هو [Release 5.1](https://cop5.countermetrics.org/en/5.1/?ref=arabroot.io)، الذي نشر في 5 مايو 2023، وأصبح شرط الالتزام بالمعيار ابتداءً من يناير 2025.

### أربعة تقارير رئيسية وعروض جاهزة منها

في الإصدار 5.1 أربعة تقارير رئيسية، كما في [قسم التقارير](https://cop5.countermetrics.org/en/5.1/04-reports/index.html?ref=arabroot.io) من المدونة:

| التقرير                           | ما يعده                                        | العروض الجاهزة Standard Views                       |
| --------------------------------- | ---------------------------------------------- | --------------------------------------------------- |
| PR، تقرير المنصة Platform         | كل الاستخدام على منصة الناشر                   | PR\_P1                                              |
| DR، تقرير قاعدة البيانات Database | الاستخدام لكل قاعدة بيانات، ومنها عمليات البحث | DR\_D1 وDR\_D2                                      |
| TR، تقرير العنوان Title           | لكل مجلة أو كتاب                               | TR\_J1 إلى TR\_J4 للمجلات، وTR\_B1 إلى TR\_B3 للكتب |
| IR، تقرير العنصر Item             | لكل مقالة أو فصل                               | IR\_A1 وIR\_M1                                      |

والعروض الجاهزة تقارير مصفاة بفلاتر ثابتة يفهمها الجميع. فالعرض TR\_J1 مثلاً، كما في عنوانه «Journal Requests (Controlled)»، يعد طلبات النص الكامل للمجلات التي تحتاج اشتراكاً فقط، ويستبعد المقالات المفتوحة، وهو التقرير الذي تبني عليه أغلب قرارات تجديد المجلات، لأنه يقيس استخدام ما تدفع ثمنه بالضبط.

### المقاييس: الاطلاع والطلب، والكلي والفريد

كل رقم في تقرير COUNTER له نوع مقياس Metric\_Type، وأهمها:

- **Total\_Item\_Investigations:** كل تفاعل مع المقالة، حتى لو كان قراءة الملخص فقط.
- **Total\_Item\_Requests:** كل طلب للنص الكامل، HTML أو PDF. وهذا أقرب رقم إلى «القراءة».
- **Unique\_Item\_Requests:** المقالة نفسها تعد مرة واحدة في الجلسة الواحدة، حتى لو فتحها القارئ HTML ثم نزلها PDF.
- **Unique\_Title\_Requests:** الكتاب نفسه يعد مرة واحدة في الجلسة، مهما فتح القارئ من فصوله، وهذا ما يجعل الكتب الإلكترونية المقسمة إلى فصول قابلة للمقارنة مع الكتب التي تأتي ملفاً واحداً.
- **No\_License وLimit\_Exceeded:** محاولات رفضت لأن المكتبة لا تشترك، أو لأن عدد المستخدمين المسموح به اكتمل. وهذان رقمان مهمان لقرار الاشتراك الجديد وليس للتجديد.
- **مقاييس البحث:** مثل Searches\_Regular وSearches\_Platform في تقارير قواعد البيانات والمنصات.

ومعها سمة نوع الوصول Access\_Type، وفيها في الإصدار 5.1 القيم Controlled للمحتوى الذي يحتاج اشتراكاً، وOpen للوصول المفتوح، وFree\_To\_Read للمحتوى المتاح مجاناً للقراءة. والفرق بين Total وUnique هو أول ما يجب أن تفهمه، لأنه الفرق بين «كم مرة فتحت» و«كم مرة احتاجها أحد».

### جلسة قارئ واحدة بعين COUNTER

لنأخذ مثالاً توضيحياً لجلسة باحث واحد على منصة ناشر، ونعدها بالمقاييس، حتى يتضح الفرق بين الاطلاع والطلب والكلي والفريد. يبحث الباحث في المنصة، فيفتح صفحة ملخص المقالة الأولى، ثم يقرأ نصها الكامل HTML، ثم ينزلها PDF، ثم يفتح ملخص مقالة ثانية في المجلة نفسها ويتركها. والعد حسب المدونة يكون كما يلي:

- **Searches\_Platform:** بحث واحد.
- **Total\_Item\_Investigations:** أربعة، لأن كل تفاعل مع مقالة اطلاع، وفيه ملخص الأولى ونصها HTML وPDF وملخص الثانية. وUnique\_Item\_Investigations اثنان، مقالتان مختلفتان.
- **Total\_Item\_Requests:** اثنان، النص الكامل HTML وPDF للمقالة الأولى. وUnique\_Item\_Requests واحد، لأنها المقالة نفسها.
- **Unique\_Title\_Requests:** واحد، لأن المجلة واحدة طلب منها نص كامل.

أي أن الطلب Request جزء من الاطلاع Investigation، فكل طلب اطلاع وليس العكس، وهذا ما يجعل أرقام الاطلاع دائماً أكبر. وفي قرارات التجديد تستخدم أرقام الطلب، لأن قراءة ملخص متاح لأي زائر لا تقيس قيمة الاشتراك.

### الكتب الإلكترونية: الفصل أم الكتاب؟

الكتاب الإلكتروني يأتي من بعض الناشرين ملفاً واحداً، ومن آخرين فصلاً فصلاً، فالطالب الذي يقرأ خمسة فصول من كتاب مقسم يولد خمسة طلبات، والطالب الذي ينزل الكتاب نفسه من ناشر آخر يولد طلباً واحداً. ولهذا يوجد المقياس Unique\_Title\_Requests، الذي يعد الكتاب مرة واحدة في الجلسة مهما كان عدد فصوله، وهو المقياس المناسب للمقارنة بين حزم الكتب من ناشرين مختلفين. وفي الإصدار 5.1، كما في قسم العد الفريد، يعد كل جزء من الكتاب Book\_Segment عنصراً فريداً إذا أمكن تمييزه، وهذا تغيير عن الإصدار 5 يجعل أرقام 2025 للكتب غير قابلة للمقارنة مباشرة بأرقام ما قبلها في Unique\_Item\_Requests، فقارن Unique\_Title\_Requests بين السنوات.

### من يتحقق من أرقام الناشر؟

قد يتساءل البعض: الناشر هو الذي يعد ويرسل، فما الذي يمنعه من تضخيم الأرقام قبل موسم التجديد؟ والإجابة في القسم التاسع من المدونة: الناشر الذي يريد أن يقول إنه ملتزم بالمعيار يخضع لتدقيق مستقل دوري، يختبر فيه المدقق المنصة بجلسات معروفة مسبقاً ويقارن ما عده بما ظهر في التقارير، أي ما فعلناه نحن بسجل الوكيل ولكن على منصة الناشر. والمنصات الملتزمة مدرجة في سجل COUNTER، فإذا أرسل لك ناشر أرقاماً «بصيغة COUNTER» وليس في السجل، فاسأله عن تدقيقه.

### قواعد العد: النقر المزدوج والفريد في الجلسة

ما يجعل أرقام COUNTER قابلة للمقارنة ليس أسماء المقاييس، وإنما قواعد المعالجة التي يجب أن يطبقها كل ناشر على سجلاته قبل العد، وهي في [القسم السابع](https://cop5.countermetrics.org/en/5.1/07-processing/index.html?ref=arabroot.io) من المدونة. وأشهرها [تصفية النقر المزدوج](https://cop5.countermetrics.org/en/5.1/07-processing/02-double-click-filtering.html?ref=arabroot.io): إذا طلب المستخدم نفسه الرابط نفسه مرتين خلال 30 ثانية، عد مرة واحدة، ويحذف الطلب الأول ويبقى الثاني، والسبب أن الاتصال البطيء يجعل الناس ينقرون مرتين أو يعيدون تحميل الصفحة. وقاعدة [العد الفريد](https://cop5.countermetrics.org/en/5.1/07-processing/03-counting-unique-items.html?ref=arabroot.io): العنصر، أي المقالة أو الفصل، يعرف بمعرفه مهما كانت صيغته، HTML أو PDF أو EPUB، ويعد مرة واحدة في الجلسة. ومعهما قواعد لاستبعاد الروبوتات وأدوات التنزيل الجماعي والتنقيب في النصوص.

## المختبر الأول: نعد سجل الوكيل بقواعد COUNTER

أفضل طريقة لتفهم القواعد أن تطبقها بنفسك. وعندنا من مقال الوصول من خارج الحرم وكيل يكتب في سجله اسم كل مستخدم، فصنعنا عليه قراءة معروفة مسبقاً: الطالب student1 والموظف staff1، كل منهما يدخل ثم يفتح المقالة، ويعيد فتحها بعد 5 ثوان كأنه نقر مرتين، وينزل ملف PDF الخاص بها، ثم يفتحها مرة أخيرة بعد 35 ثانية:

```python
"""Make some reading through the proxy of the previous article: python traffic.py USER PASSWORD
Logs in with flow.py, then: the article twice in 5 seconds (a double-click), its PDF, the article again after 35 seconds."""
import sys, time, runpy, io, contextlib
user, pw = sys.argv[1], sys.argv[2]
sys.argv = ["flow.py", user, pw]
with contextlib.redirect_stdout(io.StringIO()):
    g = runpy.run_path("flow.py")
op = g["op"]
base = "http://journals-publisher-test.ezp.lib.test:8090"
def get(path, label):
    r = op.open(base + path); r.read()
    print(f"{time.strftime('%H:%M:%S')} {user:<9} {label:<32} {r.status}")
get("/article/12-3-1.html", "article")
time.sleep(5)
get("/article/12-3-1.html", "article again (double-click)")
get("/pdf/12-3-1.pdf", "PDF of the same article")
time.sleep(35)
get("/article/12-3-1.html", "article after 35 s")
```

```text

10:28:24 student1  article                          200
10:28:29 student1  PDF of the same article          200
10:28:29 student1  article again (double-click)     200
10:29:05 student1  article after 35 s               200
10:29:34 staff1    article                          200
10:29:39 staff1    article again (double-click)     200
10:29:39 staff1    PDF of the same article          200
10:30:14 staff1    article after 35 s               200
```

وهذا ما كتبه الوكيل في سجله، بعد حذف أسطر التحويل 302:

```text
2026-11-18T10:28:24+00:00 172.30.99.30 user=student1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:28:24+00:00 172.30.99.30 user=student1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:28:29+00:00 172.30.99.30 user=student1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:28:29+00:00 172.30.99.30 user=student1 "GET /pdf/12-3-1.pdf HTTP/1.1" 200 35
2026-11-18T10:29:05+00:00 172.30.99.30 user=student1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:29:33+00:00 172.30.99.32 user=staff1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:29:34+00:00 172.30.99.32 user=staff1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:29:39+00:00 172.30.99.32 user=staff1 "GET /article/12-3-1.html HTTP/1.1" 200 472
2026-11-18T10:29:39+00:00 172.30.99.32 user=staff1 "GET /pdf/12-3-1.pdf HTTP/1.1" 200 35
2026-11-18T10:30:14+00:00 172.30.99.32 user=staff1 "GET /article/12-3-1.html HTTP/1.1" 200 472
```

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

```python
"""Count full-text requests in the proxy log the COUNTER way: python count_log.py usage.log
- double-click filtering (CoP 7.2): the same URL by the same user within 30 seconds counts once
- Unique_Item_Requests: an item counts once per user session (here: per user and clock hour)
The HTML page and the PDF of one article are the same item."""
import re, sys, datetime, collections
line_re = re.compile(r'^(\S+) (\S+) user=(\S*) "GET (\S+) [^"]*" (\d{3})')
rows = []
for line in open(sys.argv[1], encoding="utf-8"):
    m = line_re.match(line)
    if not m or m.group(5) != "200" or not m.group(3):
        continue
    t = datetime.datetime.fromisoformat(m.group(1))
    rows.append((t, m.group(3), m.group(4)))
print(f"200 lines with a user: {len(rows)}")
kept, last = [], {}
for t, user, url in sorted(rows):
    key = (user, url)
    if key in last and (t - last[key][0]).total_seconds() <= 30:
        kept.remove(last[key])                          # the first click is removed, the second kept
    entry = (t, user, url)
    kept.append(entry); last[key] = entry
item_of = lambda url: re.search(r"(\d+-\d+-\d+)", url).group(1)
total = collections.Counter(item_of(u) for _, _, u in kept)
unique = collections.Counter(item for item, _ in {(item_of(u), (usr, t.strftime("%Y%m%d%H"))) for t, usr, u in kept})
for item in total:
    print(f"item {item}: Total_Item_Requests={total[item]}  Unique_Item_Requests={unique[item]}")
print("per user:", dict(collections.Counter(usr for _, usr, _ in kept)))
```

```text
200 lines with a user: 10
item 12-3-1: Total_Item_Requests=6  Unique_Item_Requests=2
per user: {'student1': 3, 'staff1': 3}
```

![سجل الوكيل في المختبر بالردود 200 فقط مع قرار كل سطر: طلبا student1 في 10:28:24 للمقالة نقر مزدوج يحذفان، وطلب 10:28:29 للمقالة يعد، وطلب PDF في 10:28:29 يعد، وطلب 10:29:05 يعد بعد 36 ثانية، وطلبا staff1 في 10:29:33 و10:29:34 نقر مزدوج يحذفان، وطلب 10:29:39 للمقالة يعد، وPDF في 10:29:39 يعد، و10:30:14 يعد، والقاعدة 7.2 الرابط نفسه من المستخدم نفسه خلال 30 ثانية يعد مرة واحدة ويحذف الأول ويبقى الثاني، وHTML وPDF للمقالة نفسها طلبان ولكنه عنصر فريد واحد، والنتيجة Total_Item_Requests يساوي 6 أي 3 من كل مستخدم، وUnique_Item_Requests يساوي 2 أي المقالة مرة واحدة في كل جلسة](https://arabroot.io/content/images/2026/11/library-analytics-02-counter-rules.webp)

عشرة أسطر في السجل، وستة طلبات بعد التصفية، وطلبان فريدان

في النتيجة أعلاه لاحظ التالي:

- **من عشرة إلى ستة:** أربعة أسطر حذفت بقاعدة النقر المزدوج، لكل مستخدم سطران: الفتحتان المتقاربتان في البداية حذفتا لأن الفتح الثالث جاء بعدهما خلال 30 ثانية، فبقي الأخير منها فقط.
- **الفتح بعد 35 ثانية يعد:** لأنه خارج النافذة، وهذا ما قصدناه بالانتظار في السكربت.
- **HTML وPDF طلبان:** كلاهما نص كامل، فكلاهما في Total\_Item\_Requests، ولكنهما المقالة نفسها، فيعد Unique\_Item\_Requests مرة واحدة لكل مستخدم.
- **الجلسة هنا تقريب:** اعتبرنا كل مستخدم في ساعة واحدة جلسة، والمدونة تعرف الجلسة بتفصيل أكثر، فهذا السكربت لفهم القواعد وليس بديلاً عن تقارير الناشر.

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

## SUSHI: سحب التقارير آلياً

مكتبة تشترك في عشرين منصة تحتاج كل شهر أن تدخل عشرين موقعاً، وتختار التقرير والفترة، وتنزل ملفاً، وتنسخه إلى جدول. وبروتوكول SUSHI، الموصوف في [القسم الثامن](https://cop5.countermetrics.org/en/5.1/08-sushi/index.html?ref=arabroot.io) من المدونة، يجعل ذلك طلبات HTTP يرسلها برنامج: كل منصة ملتزمة بالمعيار لها عنوان SUSHI، والمكتبة لها معرف عميل customer\_id، وأحياناً معرف طالب requestor\_id ومفتاح api\_key، والتقرير يعود بصيغة JSON بالشكل نفسه من كل الناشرين. وأين تجد عنوان SUSHI لكل منصة؟ في [سجل COUNTER Registry](https://registry.countermetrics.org/?ref=arabroot.io)، الذي يذكر لكل منصة ملتزمة عنوانها وما تطلبه من بيانات الدخول.

### خادم من ملف المواصفة الرسمي

لا يوجد خادم SUSHI عام مفتوح للتجربة دون اشتراك، ولكن منظمة COUNTER تنشر المواصفة نفسها ملف OpenAPI في [مستودعها](https://github.com/Project-Counter/cop5/tree/planned/api-specification?ref=arabroot.io) باسم `COUNTER_API.json`، بالإصدار 5.1.1\. ومن هذا الملف شغلنا خادماً وهمياً Mock Server بأداة [Prism](https://github.com/stoplightio/prism?ref=arabroot.io) 5.15.10، يرد على كل مسار في المواصفة بالأمثلة المكتوبة فيها، ويتحقق من أن الطلب مطابق لها:

```bash
curl -sO https://raw.githubusercontent.com/Project-Counter/cop5/planned/api-specification/COUNTER_API.json
docker run -d --name lb3-sushi -p 127.0.0.1:4010:4010 -v "$PWD:/spec:ro" \
  stoplight/prism:5.15.10 mock -h 0.0.0.0 --multiprocess=false /spec/COUNTER_API.json
```

وفي أول تشغيل دون `--multiprocess=false` توقف Prism فوراً بالخطأ `TypeError: Cannot read properties of undefined (reading 'isPrimary')`، لأن وضع العمليات المتعددة الافتراضي لم يعمل في هذا الإصدار داخل Container، فأوقفناه بهذا الخيار. ولاحظ أن الخادم الوهمي يعيد الأمثلة نفسها مهما كانت الأسئلة، فهو يختبر البروتوكول وعميلك، وليس بيانات حقيقية.

### عميل SUSHI

```python
"""A small COUNTER_SUSHI client: python sushi.py BASE_URL
Asks the server what it supports, then harvests TR_J1 for one customer, and finally sends a request
without customer_id to see how a COUNTER exception looks."""
import json, sys, urllib.request, urllib.parse, urllib.error

BASE = sys.argv[1].rstrip("/")
CREDS = {"customer_id": "lib-1234", "requestor_id": "arabroot-lab", "api_key": "not-a-real-key"}

def get(path, **params):
    url = f"{BASE}{path}?{urllib.parse.urlencode(params)}"
    try:
        with urllib.request.urlopen(url, timeout=30) as r:
            return r.status, json.load(r)
    except urllib.error.HTTPError as e:
        return e.code, json.load(e)

status, body = get("/r51/status")
print(f"GET /r51/status -> {status}")
for s in body:
    print(f"  Service_Active={s['Service_Active']}  Alerts={[a['Alert'] for a in s.get('Alerts', [])]}")

status, body = get("/r51/reports", **CREDS)
print(f"GET /r51/reports -> {status}: {len(body)} reports supported")
print("  " + ", ".join(r["Report_ID"] for r in body))

status, rep = get("/r51/reports/tr_j1", begin_date="2025-01", end_date="2025-12", **CREDS)
h = rep["Report_Header"]
print(f"GET /r51/reports/tr_j1 -> {status}: {h['Report_Name']}, release {h['Release']}, "
      f"{h['Report_Filters']['Begin_Date']}..{h['Report_Filters']['End_Date']}, {len(rep['Report_Items'])} item(s)")
for item in rep["Report_Items"]:
    perf = item["Attribute_Performance"][0]["Performance"]
    tot = sum(perf["Total_Item_Requests"].values()); uniq = sum(perf["Unique_Item_Requests"].values())
    print(f"  {item['Title']}  ISSN {item['Item_ID'].get('Online_ISSN')}  Total_Item_Requests={tot}  Unique_Item_Requests={uniq}")

status, err = get("/r51/reports/tr_j1", begin_date="2025-01")
print(f"GET /r51/reports/tr_j1 without customer_id -> {status}: {json.dumps(err)}")
```

```bash
docker run --rm -v "$PWD:/lab" -w /lab python:3.13-slim python sushi.py http://host.docker.internal:4010
```

```text
GET /r51/status -> 200
  Service_Active=True  Alerts=['Service will be unavailable Sunday midnight.']
GET /r51/reports -> 200: 16 reports supported
  PR, PR_P1, DR, DR_D1, DR_D2, TR, TR_B1, TR_B2, TR_B3, TR_J1, TR_J2, TR_J3, TR_J4, IR, IR_A1, IR_M1
GET /r51/reports/tr_j1 -> 200: Journal Requests (Controlled), release 5.1, 2022-01-01..2022-03-31, 1 item(s)
  Title 3  ISSN 1234-4321  Total_Item_Requests=1451  Unique_Item_Requests=1135
GET /r51/reports/tr_j1 without customer_id -> 400: {"Code": 1030, "Message": "Insufficient Information to Process Request", "Help_URL": "http://example.com", "Data": "string"}
```

![مخطط طلبات SUSHI في المختبر بين عميل sushi.py في المكتبة كمهمة شهرية ببيانات customer_id وrequestor_id وapi_key وخادم COUNTER_SUSHI على المسار r51: GET status يرد 200 بـ Service_Active true وتنبيهات، وGET reports مع customer_id يرد 200 بستة عشر تقريراً PR وDR وTR وIR، وGET reports/tr_j1 مع begin_date 2025-01 وend_date 2025-12 يرد 200 بـ Report_Header وReport_Items بصيغة JSON، وGET reports/tr_j1 دون customer_id يرد 400 بالكود 1030 والرسالة Insufficient Information، وفي الأسفل: في المختبر خادم وهمي Prism مبني من ملف المواصفة الرسمي COUNTER_API.json للإصدار 5.1.1](https://arabroot.io/content/images/2026/11/library-analytics-06-sushi.webp)

أربعة طلبات تكفي لتعرف ما يدعمه الخادم، وتسحب التقرير، وترى شكل الخطأ

في المخرج أعلاه لاحظ التالي:

- **/status:** يقول هل الخدمة تعمل، ومعه تنبيهات Alerts مثل الصيانة المجدولة، والعميل الجيد يقرؤه قبل أي طلب آخر، حتى لا يسجل فشلاً بسبب صيانة.
- **/reports:** قائمة التقارير التي تدعمها المنصة، 16 تقريراً هنا، وهي التقارير الأربعة الرئيسية وعروضها الجاهزة، والمنصة الحقيقية قد لا تدعمها كلها، فاسأل هذا المسار ولا تفترض.
- **/reports/tr\_j1:** طلبنا 2025 كاملة، وجاء التقرير لفترة 2022-01-01 إلى 2022-03-31، لأن الخادم الوهمي يعيد المثال المكتوب في المواصفة. وهذا يذكرك بقاعدة مهمة مع الخوادم الحقيقية أيضاً: اقرأ `Begin_Date` و`End_Date` في رأس التقرير، ولا تفترض أنها الفترة التي طلبتها، فبعض المنصات تقص الفترة أو تعيد ما عندها فقط.
- **الخطأ 1030:** الطلب دون `customer_id` رجع برمز HTTP 400، ومعه استثناء COUNTER Exception بالكود 1030 والرسالة «Insufficient Information to Process Request». ورموز الاستثناءات معرفة في المواصفة، وبعضها لا يعني خطأ عندك، فالكود 3030 مثلاً يعني أنه لا يوجد استخدام في الفترة المطلوبة، والعميل الذي يعامله كخطأ يرسل تنبيهات بلا داع.

### الاستثناءات: متى تعيد المحاولة ومتى تتوقف؟

عميل SUSHI الذي يعمل كل شهر دون مراقبة يجب أن يعرف ماذا يفعل مع كل رد غير ناجح، والمواصفة تعرف لكل حالة استثناء Exception برمز ثابت. كتبنا سكربتاً يقرأ كل الاستثناءات المعرفة في ملف المواصفة نفسه، ثم يطلب من الخادم الوهمي الردود غير الناجحة لتقرير TR\_J1، وPrism يعيدها عندما تطلبها بالترويسة `Prefer`:

```python
"""List every COUNTER exception defined in COUNTER_API.json, then ask the mock server for the
non-200 answers of /r51/reports/tr_j1 (Prism returns them when asked with the Prefer header):
python exceptions.py COUNTER_API.json BASE_URL"""
import json, sys, urllib.request, urllib.error
spec = json.load(open(sys.argv[1], encoding="utf-8"))
for name, s in sorted(spec["components"]["schemas"].items()):
    if name.startswith("Exception_") and "Code" in s.get("properties", {}):
        p = s["properties"]
        code = p["Code"].get("const", p["Code"].get("enum"))
        msg = p.get("Message", {}).get("const", p.get("Message", {}).get("enum"))
        if msg:                                   # skip the generic schemas without a fixed message
            print(f"{str(code):<10} {msg}")
url = sys.argv[2].rstrip("/") + "/r51/reports/tr_j1?customer_id=lib-1234&begin_date=2025-01&end_date=2025-12"
for code in (202, 401, 403, 429, 503):
    req = urllib.request.Request(url, headers={"Prefer": f"code={code}"})
    try:
        r = urllib.request.urlopen(req, timeout=30); status, body = r.status, r.read()
    except urllib.error.HTTPError as e:
        status, body = e.code, e.read()
    print(f"HTTP {status}: {body.decode()[:150]}")
```

```text
1000       Service Not Available
1010       Service Busy
1011       Report Queued for Processing
1020       Client has made too many requests
1030       Insufficient Information to Process Request
2000       Requestor Not Authorized to Access Service
2010       Requestor is Not Authorized to Access Usage for Institution
2011       Global Reports Not Supported
2020       APIKey Invalid
3020       Invalid Date Arguments
3030       No Usage Available for Requested Dates
3031       Usage Not Ready for Requested Dates
3032       Usage No Longer Available for Requested Dates
3040       Partial Data Returned
3050       Parameter Not Recognized in this Context
3060       Invalid ReportFilter Value
3061       Incongruous ReportFilter Value
3062       Invalid ReportAttribute Value
3063       Components Not Supported
3070       Required ReportFilter Missing
HTTP 202: {"Code":1011,"Message":"Report Queued for Processing","Help_URL":"http://example.com","Data":"string"}
HTTP 401: {"Code":2000,"Message":"Requestor Not Authorized to Access Service","Help_URL":"http://example.com","Data":"string"}
HTTP 403: {"Code":2010,"Message":"Requestor is Not Authorized to Access Usage for Institution","Help_URL":"http://example.com","Data":"string"}
HTTP 429: {"Code":1020,"Message":"Client has made too many requests","Help_URL":"http://example.com","Data":"string"}
HTTP 503: {"Code":1000,"Message":"Service Not Available","Help_URL":"http://example.com","Data":"string"}
```

والرموز مقسمة إلى ثلاث عائلات، ولكل عائلة تصرف مختلف في العميل:

- **1000 وما بعدها، الخدمة نفسها:** 1000 الخدمة متوقفة، و1010 مشغولة، و1020 طلبات كثيرة جداً ومعها HTTP 429، و1011 التقرير في الطابور ومعه HTTP 202\. وهذه كلها تعني «حاول لاحقاً»، فالعميل ينتظر ويعيد المحاولة بعدد محدد، كما يفعل الحاصد مع المستودعات في مقال الحصاد.
- **2000 وما بعدها، الصلاحيات:** 2000 الطالب غير مصرح له، و2010 غير مصرح له بهذه المؤسسة، و2020 مفتاح API غير صالح. وهذه لا تحل بإعادة المحاولة، وإنما بإنسان يراجع بيانات الدخول مع الناشر، فالعميل يتوقف ويرسل تنبيهاً.
- **3000 وما بعدها، البيانات:** 3020 تواريخ غير صالحة، و3030 لا يوجد استخدام في الفترة، و3031 البيانات لم تجهز بعد، و3032 البيانات لم تعد متاحة، و3040 بيانات جزئية. ومنها ما هو معلومة وليس خطأ: 3030 يعني صفراً حقيقياً، و3031 يعني أعد المحاولة بعد أيام، و3040 يعني احفظ التقرير وعلمه ناقصاً.

والتصرف الأخطر هو أن يعامل العميل 3030 كفشل فيترك الشهر فارغاً، أو أن يعامل 3040 كنجاح فيحفظ أرقاماً ناقصة دون علامة، وفي الحالتين يصبح الجدول السنوي خاطئاً دون أن يعرف أحد.

ولاحظ في القائمة الرمز 3032 «Usage No Longer Available for Requested Dates». فالمنصات لا تحتفظ بأرقام الاستخدام إلى الأبد، وإذا تذكرت المكتبة في نهاية سنة الاشتراك الثالثة أنها تحتاج أرقام السنة الأولى، فقد تجد أنها لم تعد متاحة. لذلك اسحب التقارير كل شهر واحفظ ملفات JSON كما وصلت في مكان له نسخة احتياطية، حتى لو لم تقرأها شهوراً، فالأرشيف الذي عندك هو الوحيد الذي تضمن بقاءه، وهو الذي يجعل مقارنة ثلاث سنوات ممكنة يوم تحتاجها.

### هل التقرير صالح؟ التحقق بمخطط JSON الرسمي

ملف المواصفة نفسه فيه مخطط JSON Schema لكل تقرير، فتستطيع أن تتحقق من أن ما وصلك من الناشر مطابق للمعيار قبل أن تدخله في جداولك. أخذنا ملف العينة الرسمي `TR_J1_sample_r51.json` من مستودع COUNTER، وتحققنا منه كما هو، ثم أدخلنا فيه خطأين يحدثان فعلاً في الملفات المعدلة يدوياً: اسم مقياس فيه حرف ناقص، وتاريخ بداية محذوف:

```python
"""Validate a COUNTER R5.1 JSON report against the schema in the official COUNTER_API.json:
python validate.py COUNTER_API.json REPORT_ID report.json"""
import json, sys, copy
from jsonschema import Draft202012Validator

spec = json.load(open(sys.argv[1], encoding="utf-8"))
report_id, path = sys.argv[2], sys.argv[3]
schema = {"$schema": "https://json-schema.org/draft/2020-12/schema",
          "$ref": f"#/components/schemas/{report_id}", "components": spec["components"]}
validator = Draft202012Validator(schema)

def check(label, doc):
    errors = sorted(validator.iter_errors(doc), key=lambda e: list(e.absolute_path))
    print(f"{label}: {'valid' if not errors else f'{len(errors)} error(s)'}")
    for e in errors[:4]:
        where = "/".join(str(p) for p in e.absolute_path) or "(root)"
        print(f"  at {where}: {e.message[:140]}")

report = json.load(open(path, encoding="utf-8"))
check(f"{path} as published", report)
broken = copy.deepcopy(report)
perf = broken["Report_Items"][0]["Attribute_Performance"][0]["Performance"]
perf["Total_Item_Request"] = perf.pop("Total_Item_Requests")          # a typo in a metric name
del broken["Report_Header"]["Report_Filters"]["Begin_Date"]            # a missing filter
check(f"{path} with two mistakes", broken)
```

```text
jsonschema 4.25.1
TR_J1_sample_r51.json as published: valid
TR_J1_sample_r51.json with two mistakes: 4 error(s)
  at Report_Header/Report_Filters: 'Begin_Date' is a required property
  at Report_Header/Report_Filters: Unevaluated properties are not allowed ('End_Date' was unexpected)
  at Report_Items/0: Unevaluated properties are not allowed ('Attribute_Performance' was unexpected)
  at Report_Items/0/Attribute_Performance/0/Performance: Additional properties are not allowed ('Total_Item_Request' was unexpected)
```

أي أن العينة الرسمية صالحة، والنسخة المعدلة فشلت بأربعة أخطاء من خطأين: `Begin_Date` مطلوب، ثم أخطاء متتابعة سببها الأول، و`Total_Item_Request` ليس اسم مقياس معروفاً. وقيمة هذا الفحص أن الخطأ في اسم المقياس لا يظهر في جدول Excel، وإنما يجعل عموداً كاملاً يختفي من مجموعك. ولمنظمة COUNTER أداة تحقق كاملة أيضاً في [مستودع counter-validator](https://github.com/Project-Counter/counter-validator?ref=arabroot.io)، تفحص القواعد التي لا يفحصها المخطط، مثل اتساق المجاميع.

### ماذا تقول عينة TR\_J1 الرسمية؟

ملف العينة نفسه فيه مجلة واحدة باسم «Title 3» لسنة 2022 كاملة، شهراً بشهر، والصورة التالية ترسمها:

![رسم خطي من عينة COUNTER الرسمية TR_J1 لسنة 2022 شهراً بشهر من 01 إلى 12: الخط الأزرق Total_Item_Requests يبدأ عند 357 ويصل في ديسمبر إلى 657، والخط البرتقالي Unique_Item_Requests يبدأ عند 283 ويصل في ديسمبر إلى 507، والمجموع لـ Title 3 هو Total_Item_Requests يساوي 5736 وUnique_Item_Requests يساوي 4476، والفرق مقالة فتحت أكثر من مرة في الجلسة نفسها مثل HTML ثم PDF](https://arabroot.io/content/images/2026/11/library-analytics-03-tr-j1.webp)

الفرق بين الخطين هو القراءة المكررة داخل الجلسة نفسها

والمجموع لهذه المجلة 5736 طلباً كلياً و4476 طلباً فريداً، أي أن نحو 22% من الطلبات تكرار داخل الجلسة نفسها. وأي الرقمين تستخدم في قرار التجديد؟ الأكثر استخداماً في المكتبات هو Unique\_Item\_Requests، لأنه أقل تأثراً بتصميم موقع الناشر: الناشر الذي يعرض HTML ثم يطلب منك تنزيل PDF يضاعف Total دون أن يضاعف القراءة.

## المختبر الثاني: تقارير Koha بـ SQL

الآن الجهة الأخرى: الكتب المطبوعة في نظام المكتبة. وفي Koha وحدة تقارير تقبل أي استعلام SELECT على قاعدة البيانات، كما في [دليل التقارير](https://koha-community.org/manual/26.05/en/html/reports.html?ref=arabroot.io)، وهناك [مكتبة تقارير SQL](https://wiki.koha-community.org/wiki/SQL%5FReports%5FLibrary?ref=arabroot.io) يشاركها مستخدمو Koha. والجدول الأهم للإعارة هو `statistics`، الذي يكتب فيه Koha سطراً لكل إعارة وإرجاع وتجديد، ومعه في العمود `interface` الواجهة التي تمت منها: `intranet` لمكتب الإعارة، و`sip` لجهاز الإعارة الذاتية، كما رأينا في مقال الإعارة الذاتية.

### بيانات تجريبية بقصد معلن

مكتبة المختبر فيها ثلاثة كتب فقط، ولا تصلح لتقارير، فكتبنا سكربت Perl يعمل داخل Koha بدوال الإعارة نفسها `AddIssue` و`AddReturn`، فيمر على قواعد الإعارة كما يمر الموظف، ويولد عشرة أشهر من الإعارات: أربعون عنواناً عربياً بنسختين لكل منها، وستون قارئاً من ثلاث فئات، ويبدأ جهاز الإعارة الذاتية العمل في أول أبريل. وهذه بيانات مولدة لهدف واحد، أن تعطي التقارير شيئاً تعده، وليست سجل مكتبة حقيقية، والسكربت نفسه يقول ذلك في أوله:

```perl
#!/usr/bin/perl
# Test data for the report lab (run with koha-shell): 40 titles x 2 copies, 60 readers,
# and ten months of loans; the self-check kiosk (interface "sip") arrives on 1 April 2026.
# The data is generated, not real library history: it only exists to give the reports something to count.
use Modern::Perl;
use C4::Context;
use C4::Biblio qw(AddBiblio);
use C4::Circulation qw(AddIssue AddReturn);
use Koha::Item;
use Koha::Patrons;
use Koha::DateUtils qw(dt_from_string);
use MARC::Record;
use MARC::Field;
srand(2026);
# circulation functions expect a logged-in staff member: act as the librarian at MAIN
C4::Context->set_userenv(4, 'libadmin', 'STAFF-1', '', 'Librarian', 'MAIN', 'MAIN', 1);

my @titles = (
 ['تهافت الفلاسفة','الغزالي'],['إحياء علوم الدين','الغزالي'],['فصل المقال','ابن رشد'],['تهافت التهافت','ابن رشد'],
 ['القانون في الطب','ابن سينا'],['الشفاء','ابن سينا'],['كليلة ودمنة','ابن المقفع'],['الحيوان','الجاحظ'],
 ['البخلاء','الجاحظ'],['ديوان المتنبي','المتنبي'],['رسالة الغفران','أبو العلاء المعري'],['اللزوميات','أبو العلاء المعري'],
 ['الأغاني','أبو الفرج الأصفهاني'],['العقد الفريد','ابن عبد ربه'],['طوق الحمامة','ابن حزم'],['رحلة ابن بطوطة','ابن بطوطة'],
 ['معجم البلدان','ياقوت الحموي'],['الكامل في التاريخ','ابن الأثير'],['وفيات الأعيان','ابن خلكان'],['لسان العرب','ابن منظور'],
 ['الكتاب','سيبويه'],['الخصائص','ابن جني'],['دلائل الإعجاز','عبد القاهر الجرجاني'],['أسرار البلاغة','عبد القاهر الجرجاني'],
 ['الفهرست','ابن النديم'],['حي بن يقظان','ابن طفيل'],['المقابسات','أبو حيان التوحيدي'],['الإمتاع والمؤانسة','أبو حيان التوحيدي'],
 ['مروج الذهب','المسعودي'],['تاريخ الرسل والملوك','الطبري'],['الجبر والمقابلة','الخوارزمي'],['كتاب المناظر','ابن الهيثم'],
 ['زهرة العمر','توفيق الحكيم'],['عودة الروح','توفيق الحكيم'],['زقاق المدق','نجيب محفوظ'],['الثلاثية','نجيب محفوظ'],
 ['موسم الهجرة إلى الشمال','الطيب صالح'],['رجال في الشمس','غسان كنفاني'],['النبي','جبران خليل جبران'],['الأجنحة المتكسرة','جبران خليل جبران'],
);
my @items;
my $n = 0;
for my $t (@titles) {
    my $r = MARC::Record->new; $r->encoding('UTF-8');
    $r->append_fields(MARC::Field->new('100','1',' ', a => $t->[1]), MARC::Field->new('245','1','0', a => $t->[0]));
    my ($bn) = AddBiblio($r, '');
    for my $c (1..2) {
        $n++;
        my $bc = sprintf('RPT-%04d', $n);
        Koha::Item->new({ biblionumber => $bn, homebranch => 'MAIN', holdingbranch => 'MAIN', barcode => $bc, itype => 'BK' })->store;
        push @items, $bc;
    }
}
my @patrons;
for my $i (1..60) {
    my $cat = $i <= 45 ? 'ST' : $i <= 55 ? 'T' : 'S';
    push @patrons, Koha::Patron->new({ branchcode => 'MAIN', categorycode => $cat, surname => "Reader $i",
        cardnumber => sprintf('RD-%03d', $i), dateexpiry => '2030-12-31' })->store;
}
# popularity: a few titles are borrowed a lot, many rarely, some never (the last 10 copies stay on the shelf)
my @weights = map { my $k = $_; $k >= 70 ? 0 : 1 / (1 + $k) ** 0.9 } 0..$#items;
my $sum = 0; $sum += $_ for @weights;
sub pick_item { my $x = rand($sum); for my $k (0..$#items) { $x -= $weights[$k]; return $items[$k] if $x <= 0 } $items[0] }

my ($loans, $kiosk) = (0, 0);
my %free_from;                                   # an item is back on the shelf from this date
my $dbh = C4::Context->dbh;
my $started = dt_from_string()->strftime('%F %T');
# Koha writes statistics with the current time; move each new row to the simulated date
sub backdate { my ($type, $itemnumber, $when) = @_;
    $dbh->do("UPDATE statistics SET datetime = ? WHERE type = ? AND itemnumber = ? AND datetime >= ?",
             undef, $when->strftime('%F %T'), $type, $itemnumber, $started); }
my $day = dt_from_string('2026-01-04');
my $end = dt_from_string('2026-10-29');
while ($day < $end) {
    my $per_day = ($day->month == 6 || $day->month == 7) ? 2 : 6;   # summer is quiet
    for (1..$per_day) {
        my $bc = pick_item();
        my $item = Koha::Items->find({ barcode => $bc });
        next if $item->onloan or ($free_from{$bc} and $day < $free_from{$bc});
        my $patron = $patrons[ int rand @patrons ];
        my $via_sip = $day->month >= 4 && rand() < 0.6;
        C4::Context->interface($via_sip ? 'sip' : 'intranet');
        my $out = $day->clone->set(hour => 9 + int rand 8);
        my $issue = AddIssue($patron, $bc, undef, undef, $out);
        next unless $issue;
        backdate('issue', $item->itemnumber, $out);
        $loans++; $kiosk++ if $via_sip;
        my $back = $out->clone->add(days => 3 + int rand 18);
        $free_from{$bc} = $back->clone->add(days => 1);
        next unless $back < $end;
        C4::Context->interface(rand() < ($day->month >= 4 ? 0.7 : 0) ? 'sip' : 'intranet');
        AddReturn($bc, 'MAIN', undef, $back);
        backdate('return', $item->itemnumber, $back);
    }
    $day->add(days => 1);
    $day->add(days => 1) if $day->day_of_week == 5;   # Friday
}
say "titles: " . scalar(@titles) . ", copies: " . scalar(@items) . ", readers: " . scalar(@patrons);
say "loans: $loans, of which through the kiosk: $kiosk";
```

```text
cleaned 0 biblios
titles: 40, copies: 80, readers: 60
loans: 557, of which through the kiosk: 221
seconds: 380
```

وفي السكربت أمر لم نتوقعه في البداية، وهو الدالة `backdate`. فعندما شغلنا الإعارات بتواريخ قديمة، وجدنا أن Koha يكتب سطر الإحصاءات بوقت التشغيل الحالي وليس بتاريخ الإعارة الذي مررناه، أي أن كل إعارات يناير ظهرت في جدول `statistics` بتاريخ اليوم. وهذا صحيح لمكتبة حقيقية، فالإعارة تسجل وقت حدوثها، ولكنه يعني أن أي ترحيل لإعارات قديمة من نظام سابق لا يمر بهذا الجدول، فتقارير الإحصاءات تبدأ من يوم الترحيل، والتاريخ القديم في جداول `old_issues` فقط. لذلك اعرف قبل الترحيل من أي جدول سوف تبني تقاريرك، وفي المختبر نقلنا كل سطر إلى تاريخه المحاكي.

### أربعة تقارير

```sql
-- 1. Loans per month: at the desk and at the self-check kiosk (SIP2)
SELECT DATE_FORMAT(datetime, '%Y-%m') AS month,
       SUM(interface <> 'sip') AS desk,
       SUM(interface = 'sip')  AS kiosk,
       ROUND(100 * SUM(interface = 'sip') / COUNT(*), 1) AS kiosk_pct
FROM statistics
WHERE type = 'issue' AND datetime >= '2026-01-01' AND datetime < '2026-11-01'
GROUP BY month ORDER BY month;

-- 2. The ten most borrowed titles, with copies and loans per copy (turnover)
SELECT b.title, b.author, COUNT(DISTINCT i.itemnumber) AS copies, COUNT(*) AS loans,
       ROUND(COUNT(*) / COUNT(DISTINCT i.itemnumber), 1) AS loans_per_copy
FROM statistics s
JOIN items i  ON i.itemnumber = s.itemnumber
JOIN biblio b ON b.biblionumber = i.biblionumber
WHERE s.type = 'issue' AND s.datetime >= '2026-01-01' AND s.datetime < '2026-11-01'
GROUP BY b.biblionumber ORDER BY loans DESC LIMIT 10;

-- 3. Loans by reader category
SELECT c.description AS category, COUNT(*) AS loans, COUNT(DISTINCT s.borrowernumber) AS readers
FROM statistics s JOIN categories c ON c.categorycode = s.categorycode
WHERE s.type = 'issue' AND s.datetime >= '2026-01-01' AND s.datetime < '2026-11-01'
GROUP BY c.description ORDER BY loans DESC;

-- 4. Copies never borrowed this year (candidates for weeding or promotion)
SELECT i.barcode, b.title, b.author
FROM items i JOIN biblio b ON b.biblionumber = i.biblionumber
WHERE i.barcode LIKE 'RPT-%'
  AND NOT EXISTS (SELECT 1 FROM statistics s WHERE s.itemnumber = i.itemnumber AND s.type = 'issue'
                  AND s.datetime >= '2026-01-01' AND s.datetime < '2026-11-01')
ORDER BY i.barcode;
```

```bash
koha-mysql library --default-character-set=utf8mb4 --table < reports.sql
```

```text
+---------+------+-------+-----------+
| month   | desk | kiosk | kiosk_pct |
+---------+------+-------+-----------+
| 2026-01 |   63 |     0 |       0.0 |
| 2026-02 |   58 |     0 |       0.0 |
| 2026-03 |   71 |     0 |       0.0 |
| 2026-04 |   25 |    36 |      59.0 |
| 2026-05 |   24 |    34 |      58.6 |
| 2026-06 |   10 |    12 |      54.5 |
| 2026-07 |   13 |    24 |      64.9 |
| 2026-08 |   31 |    43 |      58.1 |
| 2026-09 |   22 |    41 |      65.1 |
| 2026-10 |   19 |    31 |      62.0 |
+---------+------+-------+-----------+
+--------------------------------+---------------------+--------+-------+----------------+
| title                          | author              | copies | loans | loans_per_copy |
+--------------------------------+---------------------+--------+-------+----------------+
| تهافت الفلاسفة                 | الغزالي             |      2 |    43 |           21.5 |
| إحياء علوم الدين               | الغزالي             |      2 |    39 |           19.5 |
| تهافت التهافت                  | ابن رشد             |      2 |    33 |           16.5 |
| فصل المقال                     | ابن رشد             |      2 |    32 |           16.0 |
| القانون في الطب                | ابن سينا            |      2 |    30 |           15.0 |
| الشفاء                         | ابن سينا            |      2 |    25 |           12.5 |
| كليلة ودمنة                    | ابن المقفع          |      2 |    21 |           10.5 |
| الحيوان                        | الجاحظ              |      2 |    21 |           10.5 |
| البخلاء                        | الجاحظ              |      2 |    19 |            9.5 |
| الفهرست                        | ابن النديم          |      2 |    17 |            8.5 |
+--------------------------------+---------------------+--------+-------+----------------+
+----------+-------+---------+
| category | loans | readers |
+----------+-------+---------+
| Student  |   424 |      45 |
| Teacher  |    87 |      10 |
| Staff    |    46 |       5 |
+----------+-------+---------+
+----------+-------------------------------------------+--------------------------------+
| barcode  | title                                     | author                         |
+----------+-------------------------------------------+--------------------------------+
| RPT-0071 | الثلاثية                                  | نجيب محفوظ                     |
| RPT-0072 | الثلاثية                                  | نجيب محفوظ                     |
| RPT-0073 | موسم الهجرة إلى الشمال                    | الطيب صالح                     |
| RPT-0074 | موسم الهجرة إلى الشمال                    | الطيب صالح                     |
| RPT-0075 | رجال في الشمس                             | غسان كنفاني                    |
| RPT-0076 | رجال في الشمس                             | غسان كنفاني                    |
| RPT-0077 | النبي                                     | جبران خليل جبران               |
| RPT-0078 | النبي                                     | جبران خليل جبران               |
| RPT-0079 | الأجنحة المتكسرة                          | جبران خليل جبران               |
| RPT-0080 | الأجنحة المتكسرة                          | جبران خليل جبران               |
+----------+-------------------------------------------+--------------------------------+
```

وحفظنا التقرير الأول في وحدة التقارير في واجهة الموظفين، فظهر هكذا:

![لقطة شاشة حقيقية من واجهة موظفي Koha 26.05: صفحة تشغيل التقرير المحفوظ رقم 1 بعنوان الإعارات الشهرية المكتب والجهاز الذاتي، وفيه الملاحظة statistics.interface = sip وعدد النتائج 10، وجدول بأعمدة month وdesk وkiosk وkiosk_pct من 2026-01 بـ 63 و0 إلى 2026-10 بـ 19 و31 و62.0، وفوقه أزرار التعديل والتشغيل والجدولة والتنزيل وإنشاء رسم بياني](https://arabroot.io/content/images/2026/11/library-analytics-07-koha-report.webp)

التقرير نفسه في وحدة تقارير Koha، ويمكن تنزيله أو جدولته أو رسمه

وفي أول حفظ للتقرير ظهر في هذه الصفحة خطأ SQL يقول `near 'LIMIT 0`، والسبب الفاصلة المنقوطة في آخر الاستعلام: Koha يضيف إلى الاستعلام `LIMIT` ليقسم النتائج إلى صفحات، فإذا انتهى الاستعلام بفاصلة منقوطة أصبح الناتج استعلامين. فاحذف الفاصلة المنقوطة الأخيرة من كل تقرير تنسخه إلى Koha.

### ماذا تقول التقارير؟

![رسم أعمدة مكدسة للإعارات الشهرية في Koha من يناير إلى أكتوبر: يناير 63 من المكتب، فبراير 58، مارس 71، ثم خط متقطع بداية الجهاز الذاتي في 1 أبريل، أبريل 25 من المكتب و36 عبر الجهاز بنسبة 59.0 بالمئة، مايو 24 و34 بنسبة 58.6، يونيو 10 و12 بنسبة 54.5، يوليو 13 و24 بنسبة 64.9، أغسطس 31 و43 بنسبة 58.1، سبتمبر 22 و41 بنسبة 65.1، أكتوبر 19 و31 بنسبة 62.0، وفي الأسفل بيانات تجريبية مولدة للمختبر 557 إعارة لـ 80 نسخة و60 قارئاً والتقرير نفسه يعمل على بيانات مكتبتك](https://arabroot.io/content/images/2026/11/library-analytics-04-kiosk-loans.webp)

بعد أبريل أصبحت نحو 60% من الإعارات عبر الجهاز، في بيانات المختبر التجريبية

في التقارير أعلاه لاحظ التالي، مع التذكير بأن الأرقام من بيانات مولدة، وأن ما يهمنا طريقة القراءة:

- **نسبة الجهاز الذاتي:** بعد أبريل بين 54.5% و65.1% من الإعارات تمت عبر الجهاز. وهذا هو الرقم الذي تجيب به عن سؤال «هل اشترينا الأجهزة لشيء؟»، وهو ممكن فقط لأن Koha يسجل الواجهة في كل سطر، فاطلب من أي نظام تختاره أن يفعل ذلك.
- **الصيف هادئ:** يونيو ويوليو أقل الشهور، فلا تقارن شهراً بالشهر الذي قبله، وإنما بالشهر نفسه من السنة السابقة.
- **الأكثر إعارة:** «تهافت الفلاسفة» بنسختين أعير 43 مرة، أي 21.5 إعارة للنسخة في عشرة أشهر، ومع مدة إعارة 14 يوماً فالنسختان لم تبقيا على الرف تقريباً. وهذا هو التقرير الذي يقول لك اشتر نسخة ثالثة، أو اجعل إحدى النسختين للإعارة القصيرة.
- **الفئات:** الطلاب 424 إعارة من 45 قارئاً، والمعلمون 87 من 10، أي أن المعلم في هذه البيانات يستعير أكثر من الطالب في المتوسط، وهذا النوع من المقارنة يحتاج دائماً عدد القراء بجانب عدد الإعارات.
- **ما لم يعر:** عشر نسخ لخمسة عناوين لم تعر مرة واحدة في عشرة أشهر.

![رسم أعمدة للإعارات لكل عنوان من 40 عنواناً مرتبة من الأكثر إعارة: أعلى عمود 43 ثم تنخفض تدريجياً حتى أعمدة صغيرة، وآخر خمسة عناوين بلا أي إعارة محاطة بقوس برتقالي مكتوب تحته لم تعر، والنص: أكثر عشرة عناوين 280 إعارة من 557 أي 50 بالمئة، وخمسة عناوين أي عشر نسخ لم تعر مرة واحدة هذه السنة، والمصدر استعلام الإعارات لكل عنوان tail.sql في Koha على بيانات المختبر التجريبية من يناير إلى أكتوبر 2026](https://arabroot.io/content/images/2026/11/library-analytics-05-long-tail.webp)

نصف الإعارات لربع العناوين، وخمسة عناوين بلا إعارة: شكل يتكرر في أغلب المكتبات

والرسم أعلاه من استعلام خامس يعد الإعارات لكل عنوان، بما فيها العناوين التي لم تعر:

```sql
-- loans per title this year, all 40 titles of the test set, most borrowed first
SELECT b.title, COUNT(s.itemnumber) AS loans
FROM biblio b JOIN items i ON i.biblionumber = b.biblionumber AND i.barcode LIKE 'RPT-%'
LEFT JOIN statistics s ON s.itemnumber = i.itemnumber AND s.type = 'issue'
     AND s.datetime >= '2026-01-01' AND s.datetime < '2026-11-01'
GROUP BY b.biblionumber ORDER BY loans DESC, b.biblionumber;
```

وهذا الشكل، عدد قليل من العناوين يأخذ أغلب الإعارات وذيل طويل من العناوين القليلة الإعارة، هو ما تراه في أغلب المكتبات الحقيقية أيضاً، وقد صنعناه في البيانات التجريبية عن قصد ليشبهها. وقراءته لا تعني أن تستبعد كل ما في الذيل، فالمرجع الذي يستعار مرة في السنة قد يكون أهم كتاب في رسالة دكتوراه، وإنما تعني أن تسأل عن كل عنوان في آخر الذيل: هل هو في المكان الخطأ، أو بلا فهرسة جيدة تجعله يظهر في البحث، أو أصبح فعلاً بلا حاجة؟

### تقريران آخران: مدة الإعارة والقراء

الإعارات وحدها تقول كم، ولا تقول كيف. وهذان استعلامان يجيبان عن سؤالين يطرحهما مسؤول الإعارة دائماً: هل مدة الإعارة مناسبة؟ وكم من القراء يستخدم المكتبة فعلاً؟ والأول يقرأ من جدول `old_issues`، الذي فيه كل إعارة انتهت بتاريخ إعارتها وتاريخ استحقاقها وتاريخ إرجاعها:

```sql
-- 5. How long do readers keep books, and how many come back late? (returned loans of the test set)
SELECT COUNT(*) AS returned,
       ROUND(AVG(DATEDIFF(o.returndate, o.issuedate)), 1) AS avg_days_kept,
       SUM(o.returndate > o.date_due) AS late,
       ROUND(100 * SUM(o.returndate > o.date_due) / COUNT(*), 1) AS late_pct
FROM old_issues o JOIN items i ON i.itemnumber = o.itemnumber
WHERE i.barcode LIKE 'RPT-%' AND o.returndate IS NOT NULL;

-- 6. Readers: how many borrowed at all, and how loans spread among them
SELECT c.description AS category, COUNT(*) AS readers,
       SUM(n.loans > 0) AS active, SUM(n.loans >= 15) AS heavy, MAX(n.loans) AS max_loans
FROM (SELECT b.borrowernumber, b.categorycode,
             (SELECT COUNT(*) FROM statistics s WHERE s.borrowernumber = b.borrowernumber AND s.type = 'issue'
              AND s.datetime >= '2026-01-01' AND s.datetime < '2026-11-01') AS loans
      FROM borrowers b WHERE b.cardnumber LIKE 'RD-%') n
JOIN categories c ON c.categorycode = n.categorycode
GROUP BY c.description ORDER BY readers DESC;
```

```text
+----------+---------------+------+----------+
| returned | avg_days_kept | late | late_pct |
+----------+---------------+------+----------+
|      534 |          11.4 |  176 |     33.0 |
+----------+---------------+------+----------+
+----------+---------+--------+-------+-----------+
| category | readers | active | heavy | max_loans |
+----------+---------+--------+-------+-----------+
| Student  |      45 |     45 |     3 |        18 |
| Teacher  |      10 |     10 |     0 |        14 |
| Staff    |       5 |      5 |     0 |        13 |
+----------+---------+--------+-------+-----------+
```

في النتائج أعلاه لاحظ التالي:

- **مدة الاحتفاظ:** القراء أبقوا الكتاب 11.4 يوماً في المتوسط، ومدة الإعارة 14 يوماً، وثلث الإعارات عادت متأخرة. وفي مكتبة حقيقية هذا الرقم يفتح نقاشاً عملياً: هل المدة قصيرة على طلاب يحتاجون الكتاب طوال الفصل؟ أم أن التذكير قبل الموعد لا يصل لأن البريد غير مفعل كما رأينا في دليل Koha؟ والسبب في بياناتنا معروف، فالمولد يختار مدة عشوائية حتى 20 يوماً، ولكن الاستعلام نفسه هو الذي سوف يكشف ذلك عندك.
- **القراء النشطون:** كل القراء الستين استعاروا مرة على الأقل، لأن المولد يختار القارئ عشوائياً لكل إعارة. وفي المكتبات الحقيقية هذا العمود هو الأهم في التقرير، لأن نسبة القراء الذين لم يستعيروا شيئاً طوال السنة غالباً كبيرة، وهي التي تقول للمكتبة أين تبذل جهد التوعية: أي كلية، وأي سنة دراسية.
- **القراء الكثيرو الاستعارة:** ثلاثة طلاب استعاروا 15 كتاباً أو أكثر، وأعلى رقم 18\. وهؤلاء أفضل من تسألهم عن تجربة الجهاز الذاتي ومدة الإعارة، لأنهم يستخدمون المكتبة أكثر من غيرهم.

ولاحظ أن الاستعلام الأول يعتمد على `old_issues` وليس على `statistics`، لأن الجدول الثاني لا يحفظ تاريخ الاستحقاق. وكل سؤال في التقارير له جدوله الأنسب، والخطأ الشائع أن يبنى كل شيء على جدول واحد لأنه الوحيد الذي يعرفه من كتب التقرير الأول.

## مكتبة صغيرة بلا فريق تقارير: من أين تبدأ؟

كل ما في هذا المقال يمكن أن يبدو مشروعاً كبيراً، ولكن المكتبة الصغيرة تستطيع أن تبدأ بثلاث خطوات تأخذ يوماً واحداً:

1. **تقرير واحد في Koha:** انسخ التقرير الأول إلى وحدة التقارير، واحذف الفاصلة المنقوطة الأخيرة، وشغله أول كل شهر، وانسخ الصف الجديد إلى جدول. بعد سنة يصبح عندك اتجاه حقيقي.
2. **بيانات SUSHI لأكبر ثلاثة اشتراكات:** اطلبها من الناشرين، فهي جزء من الاشتراك، ثم اسحب TR\_J1 أو DR\_D1 مرة في السنة على الأقل، حتى لو بالتنزيل اليدوي من موقع الناشر.
3. **سطر واحد في كل تقرير:** مصدر الرقم وقاعدة عده. وهذه العادة وحدها تمنع أكثر الأخطاء التي في جدول الأخطاء أدناه.

وبعد ذلك يضاف الباقي واحداً واحداً، كما أضفنا الأنظمة حول نظام المكتبة في خريطة أنظمة المكتبة: كل خطوة تتكلم مع ما قبلها بمعيار، وليس بجدول يعرف سره موظف واحد.

## تكلفة الاستخدام: من الرقم إلى القرار

أشهر مؤشر في قرارات التجديد هو تكلفة الاستخدام Cost per Use: ثمن الاشتراك السنوي مقسوماً على عدد الاستخدامات في السنة نفسها. والسؤال الحقيقي: أي رقم تضعه في المقام؟ والإجابات المعتادة:

- **للمجلات:** Unique\_Item\_Requests من TR\_J1، لأنه يقيس المقالات التي احتاجها أحد من المحتوى الذي تدفع ثمنه، دون تأثير تصميم موقع الناشر.
- **للكتب الإلكترونية:** Unique\_Title\_Requests من TR\_B1، لأن الكتاب الواحد قد يقرأ فصلاً فصلاً.
- **لقواعد البيانات الببليوغرافية:** التي لا نص كامل فيها، عمليات البحث من DR\_D1، لأنها تقيس الاستخدام الوحيد الممكن فيها.
- **للكتب المطبوعة:** عدد الإعارات من Koha مقسوماً على ثمن الشراء وعدد سنوات بقاء الكتاب، وهو حساب مختلف لا يقارن مباشرة بالاشتراكات.

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

## مقارنة سنتين: سجل التغييرات بجانب الأرقام

أكثر خطأ مكلف في تقارير المكتبات ليس في الحساب، وإنما في نسيان ما تغير بين سنتين. فكل رقم في تقرير هذه السنة يتأثر بأحداث لا تظهر في الجدول: إصدار جديد من COUNTER غير طريقة عد الكتب، أو ناشر نقل مجلاته إلى منصة أخرى فانقسمت أرقامها بين تقريرين، أو جهاز إعارة ذاتية بدأ في أبريل، أو الوكيل توقف أسبوعاً، أو الجامعة أغلقت المبنى شهراً للصيانة. لذلك احتفظ بجانب جدول الأرقام بسجل تغييرات بسيط، سطر لكل حدث بتاريخه، واقرأه قبل كتابة أي جملة مقارنة. وفي بياناتنا التجريبية مثال واضح: من يقارن إعارات المكتب في مارس 71 بإعارات المكتب في أبريل 25 دون أن يعرف أن الجهاز بدأ في أبريل، يستنتج أن الإقبال انهار، بينما مجموع أبريل 61 قريب من الشهور التي قبله، وثلاثة أخماسه انتقلت إلى الجهاز فقط.

## من الأرقام المتفرقة إلى تقرير شهري

بعد المختبرين صار عندك كل القطع، والتقرير الشهري الذي يحتاجه مدير المكتبة يجمعها بخطوات ثابتة:

1. **سحب COUNTER:** مهمة مجدولة تشغل عميل SUSHI في الأسبوع الثاني من كل شهر، لأن أغلب المنصات تنشر تقرير الشهر السابق خلال أيامه الأولى، وتحفظ كل تقرير JSON كما وصل، ثم تتحقق منه بالمخطط.
2. **سحب Koha:** التقارير المحفوظة في Koha تشغل وتنزل بالجدولة في وحدة التقارير، أو باستعلام مباشر على نسخة للقراءة فقط من قاعدة البيانات.
3. **تجميع سجل الوكيل:** الأرقام المجمعة بلا أسماء، كما في سياسة الخصوصية التي وصفناها في مقال الوصول من خارج الحرم.
4. **جدول واحد بمصدر لكل رقم:** كل صف فيه الشهر، والمصدر، والمقياس، والقيمة، ولا يجمع عمودان من مصدرين مختلفين.
5. **لوحة واحدة:** أداة مثل [Metabase](https://arabroot.io/articles/metabase-%D9%84%D9%88%D8%AD%D8%A7%D8%AA-%D9%88%D8%AA%D9%82%D8%A7%D8%B1%D9%8A%D8%B1-%D9%85%D9%86-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA%D9%83/) أو Superset فوق هذا الجدول، تعرض الاتجاهات وتكلفة الاستخدام لكل اشتراك.

## الأرقام والخصوصية: متى يصبح العدد اسماً؟

تقارير الاستخدام تبدو مجهولة لأنها أرقام، ولكن الرقم الصغير قد يكشف شخصاً. فإذا قال تقرير شهري إن قاعدة بيانات متخصصة في قسم فيه باحث واحد استخدمت 40 مرة، فقد عرف كل من يقرأ التقرير ماذا يقرأ هذا الباحث. وكذلك تقرير Koha الذي يعرض «إعارات فئة أعضاء هيئة التدريس في قسم صغير حسب العنوان». لذلك هذه قواعد بسيطة قبل نشر أي تقرير خارج فريق المكتبة:

- **جمع قبل النشر:** التقرير المنشور يعد لكل مصدر أو لكل فئة كبيرة، ولا يعرض صفاً لكل قارئ أبداً، حتى بالرقم بدل الاسم.
- **إخفاء الأعداد الصغيرة:** إذا كانت خلية مبنية على أقل من عدد معين من القراء، خمسة مثلاً، فاعرضها «أقل من 5» أو ادمجها مع غيرها، وهي الفكرة نفسها التي شرحناها في مقال إدارة بيانات البحث عن البيانات الحساسة.
- **الاستعلامات التي فيها أسماء:** في Koha صلاحية لكل من ينشئ تقارير SQL، وهذه الصلاحية تعني القدرة على قراءة كل جدول، ومنه سجل إعارات كل قارئ. فلا تعطها إلا لمن يحتاجها، وراجع التقارير المحفوظة دورياً.
- **سجل الإعارة السابقة:** في Koha خيارات لحذف سجل إعارات القارئ القديم أو إخفاء هويته بعد مدة، فإذا فعلتها فاعرف أن تقاريرك عن الماضي سوف تعتمد على الأعداد فقط، وقرر ذلك قبل أن تحتاج تقريراً لا تستطيع بناءه.

## من الجدول إلى الإدارة: ماذا تعرض في صفحة واحدة؟

مدير الجامعة أو لجنة الميزانية لا تقرأ ستة عشر تقريراً، وإنما صفحة واحدة. والصفحة الجيدة فيها ثلاثة أنواع من الأرقام فقط:

1. **الاتجاه:** الاستخدام هذه السنة مقابل السنة السابقة، للمطبوع من Koha وللإلكتروني من COUNTER، كل منهما منفصل، مع جملة تفسر أي تغير كبير، مثل جهاز الإعارة الذاتية أو اشتراك جديد.
2. **القيمة:** تكلفة الاستخدام لأكبر عشرة اشتراكات بالمقياس الفريد، مرتبة، مع اتجاه كل منها.
3. **القرار المطلوب:** ما الذي تقترح المكتبة تجديده أو إلغاءه أو إضافته، وبأي رقم، والبديل لمن يحتاج ما سوف يلغى.

وتجنب الرسوم الكثيرة والنسب دون أعداد، فعبارة «ارتفع الاستخدام 200%» من 2 إلى 6 لا تعني شيئاً. واكتب في أسفل الصفحة مصدر كل رقم وقاعدة عده في سطر واحد، فهذا السطر هو ما يجعل الأرقام قابلة للدفاع عنها عندما يسأل أحد: من أين جئت بهذا؟

## وإذا كانت المكتبة هي الناشر؟

المكتبة الجامعية لا تستهلك تقارير COUNTER فقط، فهي تنشر أيضاً: المستودع على DSpace، والمجلات على OJS. وهنا السؤال معكوس: كم مرة نزلت رسائل جامعتك، ومن أين؟ وأنظمة النشر هذه تسجل التنزيلات وتعرض إحصاءات لكل مادة، وبعضها يقدم تقارير بصيغة COUNTER نفسها، والقواعد نفسها تنطبق عليها: تصفية النقر المزدوج، واستبعاد الروبوتات التي تحصد المستودعات بكثافة، والعد الفريد. والمستودع الذي يعرض عداد تنزيلات دون استبعاد الروبوتات يعرض أرقاماً منتفخة، يقارنها الباحثون ببعضها فيظن بعضهم أن رسالته أكثر قراءة لأنها وجدت في موقع يزحف إليه روبوت أكثر. لذلك اسأل عن قاعدة العد في إحصاءات مستودعك قبل أن تنشرها في تقرير الجامعة، وارجع إلى دليل المستودع وإلى مقال الحصاد لترى من يحصد منك.

## أخطاء شائعة في قراءة الأرقام

| الخطأ                                  | ما الذي يحدث                                  | الصحيح                                                        |
| -------------------------------------- | --------------------------------------------- | ------------------------------------------------------------- |
| مقارنة سجل الوكيل بتقرير الناشر مباشرة | الوكيل أعلى بلا تصفية، وأقل لأنه لا يرى الحرم | عد السجل بقواعد COUNTER، ومقارنة الاتجاه لا الرقم             |
| Total بدل Unique في تكلفة الاستخدام    | الناشر الذي يعرض HTML ثم PDF يبدو أرخص        | Unique\_Item\_Requests للمجلات وUnique\_Title\_Requests للكتب |
| افتراض أن التقرير للفترة المطلوبة      | أرقام شهر ناقص أو فترة أخرى                   | قراءة Begin\_Date وEnd\_Date في رأس كل تقرير                  |
| معاملة كل استثناء SUSHI كخطأ           | تنبيهات لمنصات لا استخدام فيها                | الكود 3030 يعني لا استخدام، وليس فشلاً                        |
| مقارنة شهر بالذي قبله                  | انخفاض الصيف يبدو أزمة                        | الشهر نفسه من السنة السابقة                                   |
| تقرير Koha بفاصلة منقوطة في آخره       | خطأ SQL قرب LIMIT                             | حذف الفاصلة المنقوطة                                          |
| ترحيل إعارات قديمة دون معرفة الجدول    | الإحصاءات تبدأ من يوم الترحيل                 | تقارير التاريخ القديم من old\_issues                          |
| استبعاد كل ما في الذيل الطويل          | خسارة مراجع نادرة الاستخدام عالية القيمة      | مراجعة كل عنوان مع القسم المعني                               |

## قائمة تحقق للتقرير السنوي

- عنوان SUSHI وبيانات الدخول لكل منصة من سجل COUNTER، وعميل يسحب شهرياً ويحفظ الملفات كما وصلت.
- كل تقرير متحقق منه بمخطط JSON الرسمي، وفترته مقروءة من رأسه.
- تقارير Koha محفوظة للإعارات الشهرية حسب الواجهة، والأكثر إعارة، وما لم يعر، والفئات.
- أرقام الوكيل مجمعة بلا أسماء، وسياسة حفظ مكتوبة للسجل الكامل.
- جدول واحد بمصدر وقاعدة عد لكل رقم، ولوحة فوقه.
- تكلفة الاستخدام لكل اشتراك بالمقياس المناسب لنوعه، مع اتجاه ثلاث سنوات.

## تدريب عملي

- شغل التقرير الأول على نسخة من قاعدة بيانات Koha في مكتبتك، وإذا كان عندك جهاز إعارة ذاتية فاحسب نسبته الشهرية.
- اختر منصة واحدة تشترك فيها، واطلب من مسؤول الاشتراكات بيانات SUSHI، وغير عنوان الخادم في `sushi.py`، واسحب TR\_J1 للسنة الماضية، وقارن Total بـ Unique.
- إذا كان عندك وكيل للوصول من الخارج، فخذ أسبوعاً كاملاً واحداً من سجله، وعده بـ `count_log.py` بعد أن تعدل نمط الأسطر ليناسب صيغة سجلك، ثم قارن الناتج بتقرير الناشر للأسبوع نفسه، واكتب سبب كل فرق تجده: النقر المزدوج، أو القراءة من داخل الحرم، أو صفحات لا تعد طلبات.

## الخلاصة

وصلنا لنهاية الموضوع، وأهم ما فيه:

- أرقام المكتبة من أربعة مصادر: نظام المكتبة، والناشرون عبر COUNTER، وسجل الوكيل، وموقع المكتبة، وكل منها يجيب عن سؤال مختلف بقواعد عد مختلفة.
- COUNTER 5.1 هو المعيار الحالي منذ يناير 2025، بأربعة تقارير PR وDR وTR وIR وعروض جاهزة مثل TR\_J1، ومقاييس أهمها Total\_Item\_Requests وUnique\_Item\_Requests.
- تطبيق قاعدتي النقر المزدوج خلال 30 ثانية والعد الفريد على سجل الوكيل حول عشرة أسطر إلى ستة طلبات وطلبين فريدين.
- SUSHI يسحب التقارير بطلبات HTTP، وجربناه على خادم مبني من المواصفة الرسمية، ورأينا الاستثناء 1030 وفترة التقرير التي اختلفت عما طلبناه.
- مخطط JSON الرسمي يكشف التقرير المعدل يدوياً، وعينة TR\_J1 الرسمية فيها 5736 طلباً كلياً و4476 فريداً.
- تقارير SQL في Koha على جدول statistics تعطي نسبة الجهاز الذاتي والأكثر إعارة وما لم يعر، بشرط أن تعرف أن الجدول يسجل وقت حدوث العملية وليس ما ترحله لاحقاً.
- كل عائلة من استثناءات SUSHI لها تصرف: 1000 أعد المحاولة لاحقاً، و2000 أوقف وأبلغ إنساناً، و3000 اقرأ المعنى، فالكود 3030 صفر حقيقي و3040 بيانات ناقصة تحفظ بعلامة.
- احتفظ بسجل تغييرات بجانب الأرقام، فانتقال إعارات أبريل من المكتب إلى الجهاز يبدو انهياراً لمن لا يعرف أن الجهاز بدأ في ذلك الشهر.
- تكلفة الاستخدام تبدأ النقاش ولا تنهيه، وتحسب بالمقياس الفريد المناسب لنوع المصدر.

وبهذا تكتمل مراحل مسار المكتبات ونظم المعلومات التي بدأناها بخريطة أنظمة المكتبة، ومنها مرحلة الفهرسة والبيانات الوصفية:

[![](https://arabroot.io/content/images/2026/11/library-systems-map-cover-cover.webp)دليلخريطة أنظمة المكتبة: ILS والمستودع وبوابة البحثما الأنظمة التي تتكون منها المكتبة الحديثة وكيف تتكلم مع بعضها، مع مختبر ينسخ تسجيلة كتاب من مكتبة الكونغرس عبر Z39.50 ويحصد مستودعاً عبر OAI-PMH.](https://arabroot.io/articles/%D8%AE%D8%B1%D9%8A%D8%B7%D8%A9-%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D9%83%D8%AA%D8%A8%D8%A9-ils-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D9%88%D8%A8%D9%88%D8%A7%D8%A8%D8%A9-%D8%A7%D9%84%D8%A8%D8%AD%D8%AB/)[![](https://arabroot.io/content/images/2026/11/marc21-basics-cover-cover.webp)دليلمعيار MARC21 للمبتدئين: بطاقة الفهرسة في الحاسبنقرأ تسجيلتين حقيقيتين من فهرس مكتبة الكونغرس حقلاً حقلاً، ونرى أين يذهب العنوان العربي، ولماذا ضاعت همزة عند التحويل إلى MARC-8.](https://arabroot.io/articles/%D9%85%D8%B9%D9%8A%D8%A7%D8%B1-marc21-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%83%D9%8A%D9%81-%D9%8A%D9%82%D8%B1%D8%A7-%D8%A7%D9%84%D8%AD%D8%A7%D8%B3%D8%A8-%D8%A8%D8%B7%D8%A7%D9%82%D8%A9-%D8%A7%D9%84%D9%81%D9%87%D8%B1%D8%B3%D8%A9/)[![](https://arabroot.io/content/images/2026/11/oai-pmh-harvesting-cover-cover.webp)دليلالحصاد OAI-PMH: كيف تجمع البوابات سجلات المستودعاتكيف تحصد البوابات تسجيلات المستودعات بالبروتوكول OAI-PMH، مع حاصد صغير جربناه على مستودعين عربيين حقيقيين وما وجدناه فيهما من أخطاء في التواريخ واللغة والحذف.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AD%D8%B5%D8%A7%D8%AF-oai-pmh-%D9%83%D9%8A%D9%81-%D8%AA%D8%AC%D9%85%D8%B9-%D8%A7%D9%84%D8%A8%D9%88%D8%A7%D8%A8%D8%A7%D8%AA-%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9%D8%A7%D8%AA/)

## سجل التحديثات

- 18 نوفمبر 2026: كتابة المقال، وتشغيل عميل SUSHI على خادم Prism 5.15.10 مبني من COUNTER\_API.json للإصدار 5.1.1، والتحقق من عينة TR\_J1 بمخطط JSON، وعد سجل الوكيل بقواعد COUNTER، وأربعة تقارير SQL في Koha 26.05.05 على بيانات تجريبية مولدة.