> ## 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.

# أرشيف الصور الطبية PACS على سيرفرك مع Orthanc
- URL: https://arabroot.io/articles/ارشيف-الصور-الطبية-pacs-على-سيرفرك-مع-orthanc/
- Published: 2026-11-18T14:36:12.000Z
- Updated: 2026-11-18T15:36:24.000Z
- Description: كيف تشغل أرشيف صور طبية يستقبل من أجهزة الأشعة ويخدم غرفة القراءة وقوائم العمل، مع قياس الضغط وإغلاق الأرشيف أمام الأجهزة المجهولة.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, التقنية في الصحة, الاستضافة الذاتية

في مقال [كيف تعمل أنظمة الصور الطبية](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D8%B5%D9%88%D8%B1-%D8%A7%D9%84%D8%B7%D8%A8%D9%8A%D8%A9-dicom-%D9%88-pacs/) شغلنا Orthanc مع عارض OHIF، ورفعنا إليه فحص أشعة مقطعية عبر HTTP، وقرأنا وسوم الملف بأنفسنا، واختبرنا صيغ النقل على شريحة واحدة. وكان ذلك كافياً لنفهم ملف DICOM من الداخل، ولكنه ليس أرشيفاً يعمل في مركز أشعة. فالجهاز في الواقع لا يرفع الملفات عبر HTTP، وإنما يرسلها ببروتوكول DICOM على الشبكة فور انتهاء التصوير، ويسأل الأرشيف قبل ذلك عن قائمة المرضى المجدولين له اليوم حتى لا يكتب الفني الاسم بيده، والطبيب في غرفة القراءة يطلب الفحص القديم للمريض ليقارنه بالجديد، والفهرس الذي كان في ملف SQLite صغير يجب أن ينتقل إلى قاعدة بيانات تحتمل سنوات من الفحوص، والقرص يمتلئ أسرع مما تتوقع.

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

- خدمات DICOM على الشبكة DIMSE، وأسماء الأجهزة AET، ولماذا يختلف C-MOVE عن بقية الخدمات.
- تشغيل Orthanc مع فهرس PostgreSQL، وجهاز أشعة نحاكيه بأدوات dcmtk، وغرفة قراءة فيها Orthanc ثان.
- إرسال الصور بالأمر C-STORE من بيانات عامة مرخصة، والبحث C-FIND، والاسترجاع C-MOVE، وأخطاء حقيقية في كل منها.
- قائمة العمل Modality Worklist من الطلب إلى الجهاز، ومشكلة الأسماء العربية التي وصلت إلى الجهاز علامة ^ فقط، وكيف حللناها.
- كم يأخذ فحص من القرص دون ضغط ومع zlib وJPEG-LS وJPEG 2000، بأرقام قسناها.
- إخفاء الهوية Anonymization لفحص كامل، والأقفال التي تمنع أي جهاز من الإرسال إلى الأرشيف.
- النسخ الاحتياطي، وماذا يحدث للأرشيف عندما تتوقف قاعدة البيانات، ولماذا لم يرجع إلى العمل وحده.

## ما الذي يتغير عندما يصبح Orthanc أرشيفاً حقيقياً؟

شرحنا في المقال السابق ملف DICOM والهرم المريض والفحص والسلسلة والصورة، وصيغ النقل Transfer Syntax، وواجهات DICOMweb الثلاث QIDO وWADO وSTOW، وإزالة الهوية من الوسوم، فلن نعيدها هنا. وما يضيفه هذا المقال هو الجزء الذي لا تراه عندما ترفع ملفاً من المتصفح، وهو أن الأرشيف في مستشفى أو مركز أشعة عقدة في شبكة من الأجهزة، وكل جهاز له اسم ودور. والجدول التالي يلخص الفرق:

| الموضوع                 | في مختبر المقال السابق    | في أرشيف يعمل                                     |
| ----------------------- | ------------------------- | ------------------------------------------------- |
| وصول الصور              | رفع عبر HTTP أو STOW      | الجهاز يرسل بالأمر C-STORE على المنفذ 4242 أو 104 |
| بيانات المريض في الجهاز | موجودة في الملفات مسبقاً  | الجهاز يأخذها من قائمة العمل Worklist قبل التصوير |
| الفهرس Index            | SQLite داخل الـ Container | PostgreSQL أو MySQL بنسخ احتياطي                  |
| القراءة                 | عارض في المتصفح           | محطات قراءة تطلب الفحوص بالأمر C-MOVE أو C-GET    |
| الحماية                 | المنفذ على 127.0.0.1 فقط  | أجهزة كثيرة على الشبكة، وكل منها يجب أن يعرف      |
| التخزين                 | 90 ميغابايت لفحص واحد     | تيرابايتات تتراكم سنوياً                          |

والمشروع نفسه هو [Orthanc](https://www.orthanc-server.com/?ref=arabroot.io)، سيرفر DICOM خفيف مكتوب بلغة C++ برخصة GPLv3، وتوزعه شركة Orthanc Team في [Docker Image جاهزة](https://hub.docker.com/r/orthancteam/orthanc?ref=arabroot.io) فيها أغلب الإضافات Plugins، وكل إضافة تفعل بمتغير بيئة أو بقسم في ملف الإعداد كما يشرح [توثيق الـ Image](https://orthanc.uclouvain.be/book/users/docker-orthancteam.html?ref=arabroot.io). وقد تحدثنا عن رخص الإضافات (وبعضها AGPLv3) في المقال السابق، فراجعها قبل أن تبني عليها خدمة تبيعها.

### أي أرشيف مفتوح المصدر تختار؟

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

|                | Orthanc                                                                | dcm4chee Archive                                                     |
| -------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------- |
| اللغة والتشغيل | C++، عملية واحدة خفيفة، وتبدأ في ثوان                                  | Java على خادم WildFly، ومعه LDAP لإعداد الأجهزة وقاعدة بيانات        |
| الإعداد        | ملف JSON أو متغيرات بيئة                                               | واجهة إدارة وسجلات LDAP، وإعداد أكثر تفصيلاً                         |
| القوة          | سهل التشغيل والتطوير عليه، وواجهة REST شاملة، وإضافات بلغة Python وLua | مصمم للمستشفيات الكبيرة، ويدعم كثيراً من ملفات IHE وسير العمل المعقد |
| الضعف          | بعض المزايا المؤسسية تأتي كإضافات منفصلة أو بلغة برمجة تكتبها بنفسك    | منحنى تعلم أعلى، ويحتاج ذاكرة وخبرة Java                             |

و[dcm4chee-arc-light](https://github.com/dcm4che/dcm4chee-arc-light?ref=arabroot.io) هو الإصدار الحالي من مشروع dcm4che الذي بدأ قبل أكثر من عشرين سنة، وتجده خلف كثير من الأنظمة الوطنية والتجارية. أما Orthanc فهو الأنسب لمركز صغير أو متوسط، ولمطور يريد أن يبني خدمة فوق الأرشيف، ولمن يريد جسراً بين الأجهزة القديمة والتطبيقات الحديثة، ولذلك اخترناه لهذا المختبر. وإذا كان مركزك جزءاً من شبكة مستشفيات تلتزم بملفات [IHE](https://www.ihe.net/resources/technical%5Fframeworks/?ref=arabroot.io) مثل مشاركة الصور بين المنشآت، فاقرأ وثيقة المطابقة لكل خيار قبل أن تقرر، فهذا ما سوف تسأل عنه الجهة التي تربطك بالشبكة.

## خدمات DICOM على الشبكة DIMSE: الأسماء AET والاتفاق Association

معيار DICOM لا يعرف الملف فقط، وإنما يعرف أيضاً كيف يتكلم جهازان على الشبكة، وهذا هو الجزء الذي يسمى خدمات الرسائل DIMSE ويشرحه [الجزء PS3.7 من المعيار](https://dicom.nema.org/medical/dicom/current/output/chtml/part07/PS3.7.html?ref=arabroot.io). وقبل أي خدمة يفتح الطرفان اتفاقاً يسمى Association على TCP، يقدم فيه كل طرف اسمه، ويقترح الطالب أنواع البيانات وصيغ النقل التي يريدها، ويقبل الآخر بعضها أو يرفض الاتفاق كله.

واسم الجهاز في DICOM يسمى عنوان الكيان التطبيقي Application Entity Title واختصاراً AET، وهو نص لا يزيد عن 16 حرفاً مثل `CT1` أو `HI2PACS`. وفي كل اتفاق اسمان: اسم الطالب Calling AET، واسم من يناديه Called AET. فإذا اتصل جهاز الأشعة المقطعية بالأرشيف فهو يقول: أنا CT1 وأنادي HI2PACS. وقد يتساءل البعض: لماذا لا يكفي عنوان IP كما في أي خدمة شبكة؟ والإجابة أن المعيار صمم في التسعينات لأجهزة تتغير عناوينها وتعمل خلف أنظمة وسيطة، فاختار الاسم كهوية منطقية للجهاز، وهذا القرار له أثر أمني كبير سوف نراه في قسم الحماية.

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

- C-ECHO: اختبار اتصال، مثل ping ولكن على مستوى DICOM.
- C-STORE: إرسال صورة واحدة لتحفظ، والجهاز يرسل صور الفحص صورة صورة بعد التصوير.
- C-FIND: البحث، على مستوى المريض أو الفحص أو السلسلة أو الصورة، وهو نفسه الذي تستخدمه قائمة العمل بشكل خاص.
- C-MOVE: طلب نقل فحص إلى جهاز ثالث، وهنا يقع أكثر الناس في الخطأ.

![مخطط خدمات DICOM الأربع: C-ECHO طلب ورد يثبت الاتصال فقط، وC-STORE يرسل فيه الجهاز CT1 كل صورة إلى HI2PACS ويرد الأرشيف على كل ملف، وC-FIND يحمل مستوى البحث وقيم المطابقة ويرد بسطر Pending لكل نتيجة ثم Success، وC-MOVE يطلب فيه CT1 من الأرشيف أن يرسل الفحص إلى WS فيفتح الأرشيف اتصالاً ثانياً إلى عنوان WS المسجل عنده، ومعه ملاحظة أن الطلب يحمل اسم الوجهة فقط وأن الطلب إلى LAPTOP7 فشل لأن الاسم غير مسجل](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-02-dimse.webp)

الخدمات الأربع، ولماذا يحتاج C-MOVE أن يعرف الأرشيف عنوان الوجهة مسبقاً

والفرق المهم في C-MOVE أن الطالب لا يستقبل الصور على نفس الاتصال، وإنما يقول للأرشيف: أرسل هذا الفحص إلى الجهاز الذي اسمه WS. والأرشيف يبحث عن هذا الاسم في قائمته ليعرف عنوانه ومنفذه، ثم يفتح هو اتصالاً جديداً إليه ويرسل الصور بالأمر C-STORE. وهذا يعني أن كل وجهة يجب أن تكون مسجلة في الأرشيف، وأن جدار الحماية Firewall يجب أن يسمح بالاتصال في الاتجاه المعاكس من الأرشيف إلى الوجهة. وهناك خدمة أحدث اسمها C-GET تستقبل الصور على نفس الاتصال، ولكن كثيراً من الأجهزة القديمة لا تدعمها، لذلك ما زال C-MOVE هو السائد.

## تجهيز المختبر: Orthanc مع PostgreSQL وجهاز أشعة وغرفة قراءة

المختبر أربع Containers على شبكة واحدة، والصورة التالية تبينها قبل أن نكتب أي إعداد:

![مخطط المختبر: جهاز الأشعة Container فيها أدوات dcmtk 3.6.9 واسمها في DICOM CT1 وعنوانها الثابت 172.31.42.10، يرسل إلى الأرشيف Orthanc 1.13.1 باسم HI2PACS على المنفذ 4242 مع واجهة HTTP على 127.0.0.1:9581 بكلمة مرور، والأرشيف يحفظ الفهرس في PostgreSQL 18 والملفات على Volume اسمه hi2-pacs-files، وغرفة القراءة Orthanc ثان باسم WS تستقبل الفحوص بأمر C-MOVE وفيها عارض OHIF على 127.0.0.1:9582](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-01-lab.webp)

مكونات المختبر: جهاز أشعة نحاكيه، وأرشيف بفهرس PostgreSQL، وغرفة قراءة

نبدأ بملف Compose. والإعداد التالي هو الشكل النهائي بعد كل ما سوف نصلحه في المقال، وسوف نشير إلى كل سطر غيرناه في موضعه:

```yaml
name: hi2-pacs
services:
  db:
    image: postgres:18-alpine
    container_name: hi2-pacs-db
    environment:
      POSTGRES_DB: orthanc
      POSTGRES_USER: orthanc
      POSTGRES_PASSWORD: ${DB_PASSWORD:?set DB_PASSWORD in .env}
    volumes:
      - hi2-pacs-pg:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U orthanc -d orthanc"]
      interval: 5s
      retries: 10

  pacs:
    image: orthancteam/orthanc:26.11.1
    container_name: hi2-pacs
    depends_on:
      db:
        condition: service_healthy
    environment:
      ORTHANC__POSTGRESQL__PASSWORD: ${DB_PASSWORD}
      ORTHANC__REGISTERED_USERS: '{"admin": "${ADMIN_PASSWORD:?set ADMIN_PASSWORD in .env}"}'
      DICOM_WEB_PLUGIN_ENABLED: "true"
      STONE_WEB_VIEWER_PLUGIN_ENABLED: "true"
      OHIF_PLUGIN_ENABLED: "true"
    volumes:
      - ./orthanc.json:/etc/orthanc/orthanc.json:ro
      - hi2-pacs-files:/var/lib/orthanc/db
    ports:
      - "127.0.0.1:9581:8042"

  modality:
    image: hi2-modality:1
    container_name: hi2-modality
    command: sleep infinity
    volumes:
      - ../data:/data:ro
      - .:/lab
    networks:
      default:
        ipv4_address: 172.31.42.10

  ws:
    image: orthancteam/orthanc:26.11.1
    container_name: hi2-ws
    environment:
      ORTHANC__NAME: reading-room
      ORTHANC__DICOM_AET: WS
      ORTHANC__AUTHENTICATION_ENABLED: "false"
      ORTHANC__DICOM_MODALITIES: '{"pacs": ["HI2PACS", "hi2-pacs", 4242]}'
      DICOM_WEB_PLUGIN_ENABLED: "true"
      STONE_WEB_VIEWER_PLUGIN_ENABLED: "true"
      OHIF_PLUGIN_ENABLED: "true"
    ports:
      - "127.0.0.1:9582:8042"

volumes:
  hi2-pacs-pg:
    name: hi2-pacs-pg
  hi2-pacs-files:
    name: hi2-pacs-files

networks:
  default:
    name: hi2-pacs-net
    ipam:
      config:
        - subnet: 172.31.42.0/24
```

في الإعداد أعلاه لاحظ التالي:

- الوسم `26.11.1` هو إصدار حزمة Orthanc Team وليس إصدار Orthanc نفسه، وبداخلها Orthanc 1.13.1 كما سوف يظهر في السجل. ولا تستخدم `latest` في أرشيف طبي، فالترقية يجب أن تكون قراراً تختبره قبل أن يحدث.
- بيانات الدخول لا تكتب في الملف، وإنما تأتي من ملف `.env`، وكلمة مرور واجهة الإدارة تمر بالمتغير `ORTHANC__REGISTERED_USERS`. والشرطتان السفليتان تعنيان مستوى في ملف الإعداد، فالمتغير `ORTHANC__POSTGRESQL__PASSWORD` هو الحقل `Password` داخل القسم `PostgreSQL`.
- المنفذ 4242 لبروتوكول DICOM غير منشور خارج شبكة Docker، لأن الجهاز في نفس الشبكة. وفي مركز حقيقي هذا المنفذ يفتح فقط على شبكة الأجهزة الطبية، وليس على شبكة الموظفين ولا على الإنترنت.
- الشبكة لها نطاق ثابت `172.31.42.0/24` والجهاز له عنوان ثابت، ولم يكن هذا في الإعداد الأول، وإنما أضفناه بعد مشكلة حقيقية في قسم الحماية.
- غرفة القراءة Orthanc ثان دون كلمة مرور ودون قاعدة بيانات خارجية، لأنه محطة مؤقتة على 127.0.0.1 فقط، ولا تقم بذلك على محطة في مستشفى.

والملف الثاني `orthanc.json` هو إعداد الأرشيف نفسه، وهذه نسخته الأولى قبل أي تعديل:

```json
{
  "Name": "hi2-pacs",
  "DicomAet": "HI2PACS",
  "DicomPort": 4242,
  "StorageDirectory": "/var/lib/orthanc/db",
  "PostgreSQL": {
    "EnableIndex": true,
    "EnableStorage": false,
    "Host": "hi2-pacs-db",
    "Port": 5432,
    "Database": "orthanc",
    "Username": "orthanc"
  },
  "DicomModalities": {
    "ct1": ["CT1", "hi2-modality", 4243],
    "ws":  ["WS", "hi2-ws", 4242]
  },
  "Worklists": {
    "Enable": true,
    "SaveInOrthancDatabase": true
  },
  "StableAge": 20
}
```

والقرار المهم هنا هو `EnableIndex` مع `EnableStorage: false`، أي أن PostgreSQL يحفظ الفهرس فقط، والملفات نفسها تبقى على القرص في `StorageDirectory`. وقد يتساءل البعض: لماذا لا نحفظ الصور في القاعدة أيضاً فيصبح النسخ الاحتياطي أمراً واحداً؟ والإجابة أن [توثيق إضافة PostgreSQL](https://orthanc.uclouvain.be/book/plugins/postgresql.html?ref=arabroot.io) يسمح بذلك، ولكن قاعدة فيها تيرابايتات من الملفات الثنائية تصبح بطيئة في النسخ والاستعادة والترقية، والقرص أو التخزين الكائني Object Storage أنسب للملفات الكبيرة، فاترك القاعدة للفهرس. أما `DicomModalities` فهي قائمة الأجهزة التي يعرفها الأرشيف: الاسم الداخلي، ثم AET، ثم المضيف والمنفذ. و`StableAge` هو عدد الثواني دون صور جديدة الذي بعده يعد الفحص مكتملاً، وقيمته الافتراضية 60 وقللناها لنرى أثرها في المختبر.

### جهاز الأشعة: Container فيها dcmtk

لا يوجد لدينا جهاز أشعة، ولكن أدوات [dcmtk](https://dicom.offis.de/dcmtk.php.en?ref=arabroot.io) التي تطورها مؤسسة OFFIS هي المرجع الذي يستخدمه مهندسو الأجهزة أنفسهم لاختبار الاتصال، وفيها أداة لكل خدمة. وهذا ملف بناء الـ Image:

```dockerfile
FROM debian:trixie-slim
RUN apt-get update && apt-get install -y --no-install-recommends dcmtk curl jq ca-certificates postgresql-client \
    && rm -rf /var/lib/apt/lists/*
WORKDIR /lab
```

```bash
docker build -t hi2-modality:1 -f modality.Dockerfile .
docker run --rm hi2-modality:1 storescu --version | head -1
echo "DB_PASSWORD=$(openssl rand -hex 16)" > .env
echo "ADMIN_PASSWORD=$(openssl rand -hex 12)" >> .env
docker compose up -d
docker logs hi2-pacs 2>&1 | grep -E "Orthanc version|Registering plugin|schema|listening"
```

```text
$dcmtk: storescu v3.6.9 2024-12-11 $
W1118 12:12:08.776456             MAIN main.cpp:2545] Orthanc version: 1.13.1
W1118 12:12:08.972734             MAIN PluginsManager.cpp:287] Registering plugin 'orthanc-explorer-2' (version 1.15.1)
W1118 12:12:09.121874             MAIN PluginsManager.cpp:287] Registering plugin 'dicom-web' (version 1.24)
W1118 12:12:09.123646             MAIN PluginsManager.cpp:287] Registering plugin 'ohif' (version 1.8)
W1118 12:12:09.157787             MAIN PluginsManager.cpp:287] Registering plugin 'gdcm' (version 1.8)
W1118 12:12:09.159380             MAIN PluginsManager.cpp:287] Registering plugin 'postgresql-storage' (version 11.0)
W1118 12:12:09.160605             MAIN PluginsManager.cpp:287] Registering plugin 'postgresql-index' (version 11.0)
W1118 12:12:09.161820             MAIN PluginsManager.cpp:287] Registering plugin 'stone-webviewer' (version mainline)
W1118 12:12:09.164896             MAIN PluginsManager.cpp:287] Registering plugin 'orthanc-worklists' (version 1.0.0)
W1118 12:12:09.227030             MAIN postgresql-index:/PostgreSQLIndex.cpp:138] PostgreSQL is creating the database schema
W1118 12:12:13.168102             MAIN main.cpp:1531] DICOM server listening with AET HI2PACS on port: 4242
W1118 12:12:13.180481             MAIN HttpServer.cpp:2028] HTTP server listening on port: 8042 (HTTPS encryption is disabled, remote access is allowed)
```

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

- الأرشيف جاهز في خمس ثوان، وأنشأ مخطط القاعدة بنفسه في أول تشغيل، فلا توجد سكربتات SQL تشغلها بيدك.
- إضافة PostgreSQL مسجلة مرتين: للفهرس وللتخزين، والثانية معطلة كما طلبنا، وقد كتب السجل ذلك صراحة في سطر لم نعرضه.
- إضافة قوائم العمل `orthanc-worklists` بالإصدار 1.0.0 هي الإضافة الجديدة التي حلت مكان الإضافة التجريبية القديمة، وتحفظ القوائم في قاعدة Orthanc وتقدم لها واجهة REST كما يشرح [توثيقها](https://orthanc.uclouvain.be/book/plugins/worklists-plugin-new.html?ref=arabroot.io)، وسوف نستخدمها بعد قليل.
- السطر الأخير يقول إن HTTPS معطل، فواجهة الإدارة يجب أن تكون خلف Reverse Proxy فيه TLS كما شرحنا في مقال [تطبيقك خلف Reverse Proxy](https://arabroot.io/articles/%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%83-%D8%AE%D9%84%D9%81-reverse-proxy/).

## أول اتصال C-ECHO ثم إرسال الصور C-STORE

الصور من أرشيف [The Cancer Imaging Archive](https://www.cancerimagingarchive.net/?ref=arabroot.io) واختصاراً TCIA، وكلها أزيلت هويتها قبل النشر، واخترنا ثلاثة فحوص من ثلاثة أنواع، وتحققنا من رخصة كل سلسلة في حقل `LicenseName` الذي ترجعه واجهة الأرشيف:

| النوع                  | المجموعة                                                                                    | المريض في المجموعة | الصور | الرخصة    |
| ---------------------- | ------------------------------------------------------------------------------------------- | ------------------ | ----- | --------- |
| أشعة مقطعية CT للبطن   | [Pancreas-CT](https://www.cancerimagingarchive.net/collection/pancreas-ct/?ref=arabroot.io) | PANCREAS\_0051     | 185   | CC BY 3.0 |
| أشعة صدر رقمية DX      | [LIDC-IDRI](https://www.cancerimagingarchive.net/collection/lidc-idri/?ref=arabroot.io)     | LIDC-IDRI-0002     | 1     | CC BY 3.0 |
| رنين مغناطيسي MR للبطن | [CMB-CRC](https://www.cancerimagingarchive.net/collection/cmb-crc/?ref=arabroot.io)         | MSB-06489          | 9     | CC BY 4.0 |

والرخصة CC BY تسمح بالاستخدام والتعديل بشرط ذكر المصدر، وكل مجموعة لها طريقة استشهاد في صفحتها، و[سياسة الاستخدام](https://www.cancerimagingarchive.net/data-usage-policies-and-restrictions/?ref=arabroot.io) تمنع أي محاولة للتعرف على أصحاب الصور. ولا تقم بتجربة أي شيء في هذا المقال على صور مرضى حقيقيين من مركزك، فهي بيانات صحية حساسة. والآن أول اتصال من الجهاز:

```bash
docker exec hi2-modality echoscu -v -aet CT1 -aec HI2PACS hi2-pacs 4242
```

```text
I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Sending Echo Request (MsgID 1)
I: Received Echo Response (Success)
I: Releasing Association
```

الخيار `-aet` هو اسم الطالب و`-aec` اسم الأرشيف. والأسطر الخمسة هي دورة الحياة الكاملة لأي خدمة: طلب اتفاق، وقبوله مع أكبر حجم لكل جزء من البيانات PDV يقبله الأرشيف، ثم الطلب والرد، ثم إنهاء الاتفاق. والآن نرسل الفحوص الثلاثة، والخيار `+sd` يقرأ كل ملفات المجلد و`+r` يدخل المجلدات الفرعية:

```bash
docker exec hi2-modality storescu -v -aet CT1 -aec HI2PACS +sd +r hi2-pacs 4242 /data/dx
```

```text
I: Received Store Response (Success)
I: Sending file: /data/dx/LICENSE
E: DcmElement: Unknown Tag & Data (694c,6563) larger (543519598) than remaining bytes in file
E: Bad DICOM file: /data/dx/LICENSE: I/O suspension or premature end of stream
E: Store SCU Failed: 0001:000a I/O suspension or premature end of stream
I: Aborting Association
```

هذا خطأ حقيقي سوف تقابله: أرشيف TCIA يضع ملف `LICENSE` نصياً مع كل تنزيل، والأداة حاولت قراءته كملف DICOM. والرقم الغريب `(694c,6563)` ليس وسماً وإنما الحروف `Lice` من كلمة License قرأتها الأداة كأرقام، وبعد الخطأ أنهت الاتفاق كله، فلو كان الملف النصي في بداية المجلد لما وصلت أي صورة. والحل أن نحدد نمط أسماء الملفات بالخيار `+sp`، ونقيس الوقت معه:

```bash
docker exec hi2-modality bash -c 'time storescu -aet CT1 -aec HI2PACS +sd +r +sp "*.dcm" hi2-pacs 4242 /data/ct /data/dx /data/mr'
curl -s -u admin:$ADMIN_PASSWORD 127.0.0.1:9581/statistics
```

```text
real	0m25.526s
user	0m0.327s
sys	0m0.932s
{
   "CountInstances" : 195,
   "CountPatients" : 3,
   "CountSeries" : 3,
   "CountStudies" : 3,
   "TotalDiskSize" : "105345396",
   "TotalDiskSizeMB" : 100,
   "TotalUncompressedSize" : "105345396",
   "TotalUncompressedSizeMB" : 100
}
```

195 صورة هي 185 و1 و9، أي أن الأرشيف لم يكرر صور الأشعة السينية والرنين التي وصلت في المحاولة الأولى قبل الخطأ، والسبب أن كل صورة لها معرف فريد SOPInstanceUID، والإعداد الافتراضي `OverwriteInstances` يرفض استبدال صورة موجودة. وهذا سلوك تريده، لأن الأجهزة تعيد الإرسال كثيراً عند انقطاع الشبكة. أما 25 ثانية لمئة ميغابايت فهي بطيئة نسبياً، لأن كل صورة طلب ورد منفصلان، وكل صورة تكتب في القاعدة قبل الرد، وسوف نعود إلى الأداء في جدول الإنتاج.

## ماذا يحفظ PostgreSQL في الفهرس Index؟

قبل أن نبحث في الأرشيف من المفيد أن نرى ما وضعه في القاعدة، لأن البحث C-FIND لا يقرأ ملفات DICOM، وإنما يستعلم من الجداول:

```bash
docker exec hi2-pacs-db psql -U orthanc -d orthanc -c "select resourcetype, count(*) from resources group by 1 order by 1" \
  -c "select filetype, count(*), pg_size_pretty(sum(compressedsize)) from attachedfiles group by 1" \
  -c "select count(*) from maindicomtags" -c "select pg_size_pretty(pg_database_size('orthanc'))"
```

```text
 resourcetype | count
--------------+-------
            0 |     3
            1 |     3
            2 |     3
            3 |   195

 filetype | count | pg_size_pretty
----------+-------+----------------
        1 |   195 | 100 MB
     4301 |     3 | 19 kB

 count
-------
  1062

 pg_size_pretty
----------------
 11 MB
```

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

- الجدول `resources` فيه سطر لكل عنصر في الهرم: 0 للمريض، و1 للفحص، و2 للسلسلة، و3 للصورة. والعلاقة بين الأب والابن هي ما يجعل حذف فحص يحذف سلاسله وصوره.
- الجدول `attachedfiles` لا يحفظ الصورة، وإنما يقول إن الصورة الفلانية ملفها على القرص بالمعرف الفلاني وحجمه كذا، والنوع 1 هو ملف DICOM نفسه. أما النوع 4301 فهو بيانات وصفية تحفظها إضافة DICOMweb لكل سلسلة حتى تسرع العارض، وحجمها صغير.
- الجدول `maindicomtags` فيه الوسوم الرئيسية فقط مثل الاسم ورقم المريض وتاريخ الفحص والنوع، وليس كل الوسوم. فإذا بحثت بوسم ليس فيه، اضطر Orthanc أن يفتح الملفات نفسها، وقد رأينا في سجله تحذيرات من نوع `W001: Accessing DICOM tags from storage` عندما طلب العارض وسماً خارج الفهرس، وهذا ما يبطئ البحث في أرشيف كبير.
- 11 ميغابايت للقاعدة مقابل 100 ميغابايت للصور، أي أن الفهرس يكبر ببطء، ولكن لا تحكم على النسبة من مختبر صغير، لأن جزءاً من الـ 11 هو المخطط نفسه.

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

## البحث في الأرشيف C-FIND

محطة القراءة أو جهاز آخر يريد أن يعرف ما في الأرشيف، فيرسل طلب C-FIND على مستوى الفحص STUDY، والمفاتيح التي تكتبها بالخيار `-k` نوعان: مفتاح بقيمة للمطابقة، ومفتاح فارغ يعني «أرجع لي هذا الحقل»:

```bash
docker exec hi2-modality findscu -S -aet CT1 -aec HI2PACS -k QueryRetrieveLevel=STUDY \
  -k PatientName -k PatientID -k StudyDate -k ModalitiesInStudy -k StudyInstanceUID -k NumberOfStudyRelatedInstances hi2-pacs 4242
```

```text
I: Find Response: 1 (Pending)
I: (0008,0020) DA [19590902]                               #   8, 1 StudyDate
I: (0008,0061) CS [MR]                                     #   2, 1 ModalitiesInStudy
I: (0010,0010) PN [MSB-06489 ]                             #  10, 1 PatientName
I: (0010,0020) LO [MSB-06489 ]                             #  10, 1 PatientID
I: (0020,1208) IS [9 ]                                     #   2, 1 NumberOfStudyRelatedInstances
I: Find Response: 2 (Pending)
I: (0008,0020) DA [20000101]                               #   8, 1 StudyDate
I: (0008,0061) CS [DX]                                     #   2, 1 ModalitiesInStudy
I: (0010,0010) PN (no value available)                     #   0, 0 PatientName
I: (0010,0020) LO [LIDC-IDRI-0002]                         #  14, 1 PatientID
I: (0020,1208) IS [1 ]                                     #   2, 1 NumberOfStudyRelatedInstances
I: Find Response: 3 (Pending)
I: (0008,0020) DA [20151124]                               #   8, 1 StudyDate
I: (0008,0061) CS [CT]                                     #   2, 1 ModalitiesInStudy
I: (0010,0010) PN [PANCREAS_0051 ]                         #  14, 1 PatientName
I: (0010,0020) LO [PANCREAS_0051 ]                         #  14, 1 PatientID
I: (0020,1208) IS [185 ]                                   #   4, 1 NumberOfStudyRelatedInstances
```

حذفنا من المخرج أسطر معرفات الفحوص الطويلة حتى يقرأ. وفيه ثلاث ملاحظات من الواقع: تاريخ فحص الرنين 1959 والأشعة السينية الأول من يناير 2000، والسبب أن أدوات إزالة الهوية في TCIA تزيح التواريخ أو تستبدلها حتى لا تكشف المريض، فلا تبن أي منطق على أن تاريخ الفحص منطقي. واسم مريض الأشعة السينية فارغ تماماً، ومحطة القراءة التي تفترض وجود اسم سوف تعرض سطراً فارغاً. والمسافة بعد القيم مثل `[9 ]` ليست خطأ، فالمعيار يجعل طول كل قيمة زوجياً ويكمله بمسافة.

والآن بحث بشرط، فيه نجمة للمطابقة الجزئية ونوع الفحص، ثم نزول إلى مستوى السلسلة:

```bash
docker exec hi2-modality findscu -S -aet CT1 -aec HI2PACS -k QueryRetrieveLevel=STUDY \
  -k "PatientID=PANCREAS*" -k ModalitiesInStudy=CT -k StudyInstanceUID hi2-pacs 4242
docker exec hi2-modality findscu -S -aet CT1 -aec HI2PACS -k QueryRetrieveLevel=SERIES \
  -k StudyInstanceUID=1.2.826.0.1.3680043.2.1125.1.26661117508834397948676763221432807 \
  -k SeriesInstanceUID -k Modality -k NumberOfSeriesRelatedInstances hi2-pacs 4242
```

```text
I: Find Response: 1 (Pending)
I: (0010,0020) LO [PANCREAS_0051 ]                         #  14, 1 PatientID
I: (0020,000d) UI [1.2.826.0.1.3680043.2.1125.1.26661117508834397948676763221432807] #  64, 1 StudyInstanceUID
---
I: Find Response: 1 (Pending)
I: (0008,0060) CS [CT]                                     #   2, 1 Modality
I: (0020,000e) UI [1.2.826.0.1.3680043.2.1125.1.77419915248783746629465382576486048] #  64, 1 SeriesInstanceUID
I: (0020,1209) IS [185 ]                                   #   4, 1 NumberOfSeriesRelatedInstances
```

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

## الاسترجاع C-MOVE إلى غرفة القراءة

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

```bash
docker exec hi2-modality movescu -v -S -aet CT1 -aec HI2PACS -aem WS -k QueryRetrieveLevel=STUDY \
  -k StudyInstanceUID=1.3.6.1.4.1.14519.5.2.1.1.22050652398321395965781337593832924983 hi2-pacs 4242
```

```text
I: Sending Move Request (MsgID 1)
I: Received Move Response 1 (Pending)
I: Received Move Response 2 (Pending)
I: Received Move Response 3 (Pending)
I: Received Move Response 4 (Pending)
I: Received Move Response 5 (Pending)
I: Received Move Response 6 (Pending)
I: Received Move Response 7 (Pending)
I: Received Move Response 8 (Pending)
I: Received Final Move Response (Success)
I: Releasing Association
```

تسع صور، فثمانية ردود Pending بعدد الصور المتبقية في كل مرة ثم رد نهائي، وكل رد يحمل عدد الصور المرسلة والمتبقية والفاشلة. والصور لم تصل إلى CT1، وإنما إلى WS الذي فتح له الأرشيف اتصالاً جديداً. والآن نفس الطلب إلى وجهة لا يعرفها الأرشيف، كأن يكتب طبيب اسم حاسوبه المحمول:

```bash
docker exec hi2-modality movescu -v -S -aet CT1 -aec HI2PACS -aem LAPTOP7 -k QueryRetrieveLevel=STUDY \
  -k StudyInstanceUID=1.3.6.1.4.1.14519.5.2.1.1.22050652398321395965781337593832924983 hi2-pacs 4242
docker logs hi2-pacs 2>&1 | grep LAPTOP7
```

```text
W: Move response with error status (Failed: UnableToProcess)
I: Received Final Move Response (Failed: UnableToProcess)
E1118 12:14:59.104876          DICOM-3 OrthancException.cpp:144] Accessing an inexistent item: Unknown modality for AET: LAPTOP7
```

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

## قائمة العمل Modality Worklist: الطلب يصل إلى الجهاز

في المراكز التي لا تستخدم قوائم العمل يكتب الفني اسم المريض ورقمه على شاشة الجهاز قبل التصوير، وهذه أكثر نقطة تدخل منها الأخطاء إلى الأرشيف: اسم بحروف مختلفة، أو رقم ملف ناقص، أو مريض بفحصين لأن الرقم كتب مرتين بشكلين. وقائمة العمل تحل ذلك: نظام الأشعة RIS ينشئ عند حجز الموعد سجلاً فيه بيانات المريض ورقم الطلب Accession Number والجهاز والموعد، والجهاز يسأل بخدمة C-FIND خاصة بقوائم العمل، فيختار الفني المريض من القائمة، وكل الصور تخرج بنفس المعرفات. ويعرف المعيار هذه الخدمة في [الملحق K من الجزء PS3.4](https://dicom.nema.org/medical/dicom/current/output/chtml/part04/chapter%5FK.html?ref=arabroot.io).

والإضافة الجديدة تقبل إنشاء القائمة بطلب REST، فنكتب ملفاً لمريض وهمي باسم عربي:

```json
{
  "Tags": {
    "SpecificCharacterSet": "ISO_IR 192",
    "PatientID": "MRN-30412",
    "PatientName": "الحربي^سلمان",
    "PatientBirthDate": "19790214",
    "PatientSex": "M",
    "AccessionNumber": "ACC-2026-0918",
    "RequestedProcedureDescription": "CT abdomen with contrast",
    "ScheduledProcedureStepSequence": [
      {
        "Modality": "CT",
        "ScheduledStationAETitle": "CT1",
        "ScheduledProcedureStepStartDate": "20261118",
        "ScheduledProcedureStepStartTime": "103000",
        "ScheduledProcedureStepDescription": "CT ABDOMEN W CONTRAST"
      }
    ]
  }
}
```

واسم المريض في DICOM بالشكل العائلة ثم `^` ثم الاسم الأول، و`ISO_IR 192` هو اسم UTF-8 في المعيار. ثم نرسله ونسأل من الجهاز:

```bash
curl -s -u admin:$ADMIN_PASSWORD -X POST 127.0.0.1:9581/worklists/create --data-binary @worklist.json
docker exec hi2-modality findscu -W -aet CT1 -aec HI2PACS -k "ScheduledProcedureStepSequence[0].Modality=CT" \
  -k "ScheduledProcedureStepSequence[0].ScheduledProcedureStepStartDate=20261118" \
  -k "ScheduledProcedureStepSequence[0].ScheduledStationAETitle=CT1" \
  -k PatientName -k PatientID -k PatientBirthDate -k AccessionNumber -k StudyInstanceUID -k SpecificCharacterSet hi2-pacs 4242
```

```text
{
   "ID" : "143c093f-7eea-430c-b4fa-996f53c0c7c3",
   "Path" : "/worklists/143c093f-7eea-430c-b4fa-996f53c0c7c3"
}
I: Find Response: 1 (Pending)
I: (0008,0005) CS [ISO_IR 100]                             #  10, 1 SpecificCharacterSet
I: (0008,0050) SH [ACC-2026-0918 ]                         #  14, 1 AccessionNumber
I: (0010,0010) PN [^ ]                                     #   2, 1 PatientName
I: (0010,0020) LO [MRN-30412 ]                             #  10, 1 PatientID
I: (0010,0030) DA [19790214]                               #   8, 1 PatientBirthDate
I: (0020,000d) UI [1.2.276.0.7230010.3.1.2.1684431971.1.1795004116.780192] #  54, 1 StudyInstanceUID
```

كل شيء وصل إلا الاسم، فقد وصل إلى الجهاز `^` ومسافة فقط. والسبب في السطر الأول من الرد: الأرشيف أجاب بالترميز `ISO_IR 100` وهو Latin-1 الذي لا يحتوي حروفاً عربية، فحذفها وأبقى الفاصل. والقائمة نفسها محفوظة صحيحة بالترميز الذي أرسلناه، كما تأكدنا بطلب `GET /worklists/`، ولكن Orthanc يكتب الرد بترميزه الافتراضي. وجربنا أولاً أن يطلب الجهاز UTF-8 صراحة بالمفتاح `SpecificCharacterSet=ISO_IR 192` في الطلب، فرجع نفس الرد. والحل الذي نجح هو الإعداد `DefaultEncoding`، فأضفناه إلى `orthanc.json` وأعدنا تشغيل الأرشيف:

```json
  "StableAge": 20,
  "DefaultEncoding": "Utf8"
```

```text
I: (0008,0005) CS [ISO_IR 192]                             #  10, 1 SpecificCharacterSet
I: (0010,0010) PN [الحربي^سلمان ]               #  24, 1 PatientName
I: (0010,0020) LO [MRN-30412 ]                             #  10, 1 PatientID
```

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

![مخطط قائمة العمل بأربع خطوات: نظام الأشعة ينشئ القائمة بطلب POST /worklists/create للمريض MRN-30412 ورقم الطلب ACC-2026-0918، ثم الجهاز CT1 يسأل بالأمر findscu -W ويأخذ الاسم وتاريخ الميلاد ورقم الطلب ومعرف الفحص، ثم يرسل الصور بنفس StudyInstanceUID ونفس SeriesInstanceUID لكل صور السلسلة، ثم بعد StableAge 20 ثانية يعد الفحص مكتملاً ومهمة الصيانة كل 60 ثانية تحذف القائمة. وتحتها مقارنة: الاسم العربي وصل [^ ] بالترميز ISO_IR 100، وبعد الإعداد DefaultEncoding Utf8 وصل كاملاً بالترميز ISO_IR 192](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-03-worklist.webp)

مسار الطلب من نظام الأشعة إلى الجهاز ثم إلى الأرشيف، ومشكلة الترميز في الطريق

### الجهاز يصور ويرسل: خطأ السلاسل العشرين

لنحاكي التصوير نأخذ 20 شريحة من فحص البطن، ونكتب عليها بيانات قائمة العمل بالأداة `dcmodify`، ثم نرسلها. وهذه النسخة الأولى من السكربت:

```bash
dcmodify -nb -gse -gin \
  -m "(0008,0005)=ISO_IR 192" \
  -m "PatientID=MRN-30412" -m "PatientName=الحربي^سلمان" -m "PatientBirthDate=19790214" -m "PatientSex=M" \
  -m "AccessionNumber=ACC-2026-0918" \
  -m "StudyInstanceUID=$1" -m "StudyDate=20261118" \
  /tmp/scan/*.dcm
curl -s -u admin:$ADMIN_PASSWORD 127.0.0.1:9581/tools/find \n  -d '{"Level":"Study","Query":{"AccessionNumber":"ACC-2026-0918"},"Expand":true}' \n  | jq -c '.[] | {ID, Patient: .PatientMainDicomTags.PatientName, Acc: .MainDicomTags.AccessionNumber, IsStable, Series: (.Series|length)}'
```

```text
sent 20 files
{"ID":"7e7b8002-af86952c-33a94d0b-4cc28d2a-d7d6fac0","Patient":"الحربي^سلمان","Acc":"ACC-2026-0918","IsStable":false,"Series":20}
```

الاسم صحيح ورقم الطلب صحيح، ولكن الفحص فيه 20 سلسلة لكل منها صورة واحدة. والسبب أن الخيار `-gse` يولد معرف سلسلة جديداً لكل ملف على حدة، وليس معرفاً واحداً لكل الملفات. والنتيجة في الواقع أن العارض يعرض عشرين صورة مصغرة بدل سلسلة واحدة يتنقل الطبيب بين شرائحها، ولا يستطيع بناء مقطع ثلاثي الأبعاد منها. وهذا الخطأ نفسه يحدث في سكربتات التحويل والاستيراد التي يكتبها المطورون من الصفر، لذلك حذفنا الفحص وأنشأنا قائمة عمل جديدة، ثم ولدنا معرف السلسلة مرة واحدة خارج الأمر:

```bash
STUDY_UID="$1"
SERIES_UID="$STUDY_UID.$(date +%s)"       # one series UID for all the files
dcmodify -nb -gin \
  -m "(0008,0005)=ISO_IR 192" \
  -m "PatientID=MRN-30412" -m "PatientName=الحربي^سلمان" -m "PatientBirthDate=19790214" -m "PatientSex=M" \
  -m "AccessionNumber=ACC-2026-0918" -m "StudyDate=20261118" \
  -m "StudyInstanceUID=$STUDY_UID" -m "SeriesInstanceUID=$SERIES_UID" \
  /tmp/scan/*.dcm
```

```text
sent 20 files
{"ID":"b48ef293-395fa753-663ad3d0-8d16360f-4d388e55","Patient":"الحربي^سلمان","Acc":"ACC-2026-0918","IsStable":false,"Series":1}
```

سلسلة واحدة الآن. والخيار `-gin` بقي، لأن كل صورة يجب أن يكون لها معرف SOPInstanceUID جديد، وإلا رفضها الأرشيف كصور موجودة. والطريقة التي بنينا بها معرف السلسلة هنا، أي معرف الفحص ثم الوقت، تكفي لمختبر، أما في الإنتاج فاستخدم جذراً مسجلاً لمؤسستك كما شرحنا في مقال [المعرفات الفريدة](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D8%B9%D8%B1%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D8%AF%D8%A9-uuid-%D9%88-ulid-%D9%88-snowflake/). وبعد قرابة دقيقة سألنا عن القائمة والفحص:

```bash
curl -s -u admin:$ADMIN_PASSWORD "127.0.0.1:9581/worklists/?format=Simplify" | jq length
```

```text
0
```

القائمة اختفت وحدها، لأن الإعداد الافتراضي `DeleteWorklistsOnStableStudy` يحذف القائمة عندما يجد فحصاً مستقراً بنفس `StudyInstanceUID`، ومهمة الصيانة تعمل كل 60 ثانية. وهذا يمنع أن يرى الفني غداً مريضاً صوره بالأمس. والصورة التالية من واجهة Orthanc Explorer 2 في قسم قوائم العمل، بعد أن أنشأنا قائمة لمريضة ثانية حتى لا تكون فارغة، ولاحظ أن الاسم العربي يظهر فيها بشكل صحيح:

![لقطة من واجهة Orthanc Explorer 2 في الأرشيف hi2-pacs على قسم Worklists، وفيها قائمة عمل واحدة للمريضة القحطاني^هند بتاريخ الميلاد 19910630 ورقم الملف MRN-30588 وتاريخ الموعد 20261118 والوصف CT ABDOMEN W CONTRAST والنوع CT ورقم الطلب ACC-2026-0921](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-07-worklists-ui.webp)

قسم قوائم العمل في Orthanc Explorer 2، والبيانات وهمية

## DICOMweb فوق نفس الأرشيف

شرحنا QIDO وWADO وSTOW في المقال السابق، ونكتفي هنا بشيء واحد يخص هذا الأرشيف: أن نفس الفحص الذي وصل بالبروتوكول التقليدي يقرأ عبر HTTP دون أي نسخ، وأن الاسم العربي يرجع سليماً في JSON:

```bash
curl -s -u admin:$ADMIN_PASSWORD "127.0.0.1:9581/dicom-web/studies?PatientID=MRN-30412&includefield=00081030" \
  | jq -c '.[] | {acc: .["00080050"].Value[0], name: .["00100010"].Value[0].Alphabetic, n: .["00201208"].Value[0]}'
```

```text
{"acc":"ACC-2026-0918","name":"الحربي^سلمان","n":20}
```

وهذا ما يجعل Orthanc مناسباً كجسر: الأجهزة القديمة تتكلم DIMSE، والتطبيقات الجديدة والعارض في المتصفح وخدمات الذكاء الاصطناعي تتكلم DICOMweb، والأرشيف واحد. ولاحظ في سجل التشغيل تحذيراً من الإضافة نفسها: `STOW and WADO chunked transfers will be entirely stored in RAM`، أي أن رفع فحص كبير جداً عبر STOW يحمل كله في الذاكرة، فضع حداً لحجم الطلب في الـ Reverse Proxy.

## الواجهات والعارض: Orthanc Explorer 2 وOHIF

الواجهة الافتراضية في هذه الـ Image هي Orthanc Explorer 2، وفيها قائمة الفحوص والبحث وإرسال الفحص إلى جهاز مسجل والحذف وقوائم العمل. والصورة التالية منها بعد كل ما أرسلناه، ولاحظ الفحص الذي أرسله «الجهاز» بالاسم العربي ورقم الطلب، وبجانبه الفحوص الثلاثة من TCIA:

![لقطة من Orthanc Explorer 2 في الأرشيف hi2-pacs تعرض أربعة فحوص: الحربي^سلمان برقم MRN-30412 وتاريخ 20261118 ونوع CT ورقم الطلب ACC-2026-0918 وسلسلة واحدة بعشرين صورة، وPANCREAS_0051 بفحص CT من 185 صورة، وMSB-06489 رنين MR بتسع صور، وLIDC-IDRI-0002 أشعة DX بصورة واحدة](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-08-explorer.webp)

قائمة الفحوص في الأرشيف بعد الإرسال من الجهاز

أما العارض فقد فعلنا إضافتي OHIF وStone في الأرشيف وفي غرفة القراءة، وفتحنا فحص البطن في OHIF على غرفة القراءة بعد أن وصلها بالأمر C-MOVE. والعارض يعمل في المتصفح ويطلب الصور عبر DICOMweb من نفس الأصل Origin، فلا تحتاج إعداد CORS الذي احتجناه في المقال السابق عندما كان العارض في Container مستقلة:

![لقطة من عارض OHIF في غرفة القراءة يعرض شريحة محورية من فحص الأشعة المقطعية للبطن PANCREAS_0051 بتاريخ 24 نوفمبر 2015، مع العمود الفقري في الوسط، وفي الأسفل قيم النافذة W 2339 وL 146 ورقم الشريحة 185 من 185](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-09-ohif.webp)

فحص البطن في OHIF على غرفة القراءة، والصور من مجموعة Pancreas-CT في TCIA برخصة CC BY 3.0

وتذكر أن هذه العارضات مكتوب عليها صراحة أنها ليست للتشخيص: OHIF يعرض عند فتحه «for investigational use only»، وStone يكتب «Not for diagnostic usage». والعارض الذي يقرأ منه الطبيب التقرير الرسمي جهاز طبي يحتاج اعتماداً من الجهة التنظيمية، وهذا موضوع مقال قادم عن الذكاء الاصطناعي كجهاز طبي.

## كم يأخذ الفحص من القرص؟ الضغط Compression بالأرقام

في المقال السابق قسنا الضغط على شريحة واحدة. والسؤال الذي يسأله المدير مختلف: كم قرصاً أحتاج في السنة؟ لذلك أرسلنا نفس فحص البطن كاملاً (185 شريحة) خمس مرات، وفي كل مرة إلى Orthanc جديد بإعداد مختلف، وقرأنا الحجم والوقت. والإعداد `IngestTranscoding` يجعل Orthanc يحول كل صورة إلى صيغة النقل المحددة عند استلامها، أما `StorageCompression` فيضغط الملف كله بخوارزمية zlib قبل كتابته دون أن يغير محتوى DICOM:

```bash
run() { name=$1; shift
  docker rm -f hi2-ctest >/dev/null 2>&1
  docker run -d --name hi2-ctest --network hi2-pacs-net -e ORTHANC__AUTHENTICATION_ENABLED=false "$@" orthancteam/orthanc:26.11.1 >/dev/null
  sleep 8
  docker exec hi2-modality bash -c '
    s=$(date +%s%N); storescu -aet CT1 -aec ORTHANC +sd +sp "*.dcm" hi2-ctest 4242 /data/ct; e=$(date +%s%N); sleep 2
    st=$(curl -s http://hi2-ctest:8042/statistics | jq -r "\"\(.CountInstances) \(.TotalDiskSize)\"")
    id=$(curl -s http://hi2-ctest:8042/instances | jq -r ".[0]")
    ts=$(curl -s http://hi2-ctest:8042/instances/$id/metadata/TransferSyntax)
    echo "$st $ts $(( (e - s) / 1000000 ))ms"' | sed "s/^/$name /"
}
run none
run zlib      -e ORTHANC__STORAGE_COMPRESSION=true
run jpeg-ls   -e ORTHANC__INGEST_TRANSCODING=1.2.840.10008.1.2.4.80
run j2k       -e ORTHANC__INGEST_TRANSCODING=1.2.840.10008.1.2.4.90
run j2k-lossy -e ORTHANC__INGEST_TRANSCODING=1.2.840.10008.1.2.4.91
```

```text
none 185 97223568 1.2.840.10008.1.2.1 22765ms
zlib 185 56324751 1.2.840.10008.1.2.1 73233ms
jpeg-ls 185 36415638 1.2.840.10008.1.2.4.80 37247ms
j2k 185 36044642 1.2.840.10008.1.2.4.90 20145ms
j2k-lossy 185 36044642 1.2.840.10008.1.2.4.91 25014ms
```

والصورة التالية تضع الأرقام بجانب بعضها:

![رسم أعمدة لحجم فحص الأشعة المقطعية من 185 شريحة: دون ضغط 97.2 ميغابايت بنسبة 100 بالمئة ووقت استقبال 22.8 ثانية، وzlib داخل Orthanc 56.3 ميغابايت بنسبة 58 بالمئة و73.2 ثانية، وJPEG-LS دون فقدان 36.4 ميغابايت بنسبة 37 بالمئة و37.2 ثانية، وJPEG 2000 دون فقدان 36.0 ميغابايت بنسبة 37 بالمئة و20.1 ثانية، وJPEG 2000 بالرمز 4.91 بنفس الحجم 36.0 ميغابايت و25.0 ثانية. وتحتها ملاحظتان: الضغط دون فقدان وفر قرابة 63 بالمئة دون تغيير أي بكسل، والرمز 4.91 يسمح بالنوعين فخرج بنفس حجم الضغط دون فقدان](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-04-compression.webp)

نفس الفحص بخمسة إعدادات: الحجم الذي حفظه الأرشيف ووقت الاستقبال

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

- الصيغة في الحالة الأولى `1.2.840.10008.1.2.1` أي Explicit VR Little Endian، مع أن ملفات TCIA الأصلية Implicit كما رأينا في المقال السابق. والسبب أن `storescu` يقترح عند الاتفاق صيغة Explicit أولاً، والأرشيف قبلها، فحولت الأداة الملفات أثناء الإرسال. أي أن ما يحفظه الأرشيف يتأثر بما يقترحه الجهاز، وليس بالملف الأصلي فقط.
- الضغط دون فقدان Lossless بصيغة JPEG-LS أو JPEG 2000 قلل الحجم إلى 37% تقريباً، أي توفير قرابة 63% دون تغيير أي بكسل. وفي فحوص الأشعة المقطعية ينجح هذا الضغط جيداً لأن مساحة كبيرة من الصورة هواء بقيمة واحدة حول الجسم.
- zlib وفر أقل بكثير، 42% فقط، لأنه لا يعرف أن البيانات صورة، ويضغطها كأي ملف، ومع ذلك يبقى خياراً إذا كانت الأجهزة أو العارضات عندك لا تفهم صيغ JPEG، لأن الأرشيف يفك zlib قبل أن يرسل فلا يراه أحد.
- الرمز `1.2.840.10008.1.2.4.91` اسمه في المعيار JPEG 2000 Image Compression وليس «مع فقدان»، فهو يسمح بالنوعين، والبرنامج الذي يضغط يقرر. وفي تجربتنا خرج بنفس حجم الضغط دون فقدان تماماً بالبايت. فلا تفترض من رقم الصيغة وحده أن الصورة فقدت شيئاً أو لم تفقد، واقرأ الوسم `LossyImageCompression` في الملف.
- الأوقات على جهاز مشترك ومع شبكة Docker، فلا تعتمد عليها كقياس أداء، ولكن الاتجاه واضح: الضغط يحدث عند الاستلام فيأخذ وقتاً من المعالج، وzlib كان الأبطأ في تجربتنا.

وقد يتساءل البعض: لماذا لا نضغط مع فقدان فنوفر 90% أو أكثر؟ والإجابة أن قرار الضغط مع فقدان في الصور التشخيصية قرار طبي وتنظيمي يتخذه أطباء الأشعة والجهة التنظيمية، وليس قراراً يتخذه فريق التقنية لتوفير المساحة. والأسلوب الشائع أن يحفظ الأصل دون فقدان، وتولد نسخ أصغر للعرض السريع على الهاتف أو للمشاركة. ولحساب القرص لمركزنا الافتراضي: إذا كان يجري 40 فحص أشعة مقطعية يومياً بحجم قريب من فحصنا، فهذه قرابة 3.9 غيغابايت يومياً دون ضغط، أي قرابة 1.4 تيرابايت في السنة، وقرابة 520 غيغابايت مع الضغط دون فقدان، ثم تضاعف ذلك للنسخة الاحتياطية. والفحوص الحديثة بشرائح أرق أكبر بكثير من فحصنا، فاحسب بأرقام أجهزتك أنت.

## إخفاء الهوية Anonymization لفحص كامل

شرحنا في المقال السابق لماذا لا يكفي حذف الاسم، وأن المعيار يعرف ملف تعريف لإزالة الهوية في الجزء PS3.15\. والحالة العملية هنا: باحث أو شركة ذكاء اصطناعي تطلب فحص المريض الذي صورناه، فننشئ نسخة مخفية الهوية بطلب واحد إلى [واجهة الإخفاء في Orthanc](https://orthanc.uclouvain.be/book/users/anonymization.html?ref=arabroot.io):

```bash
S=$(curl -s -u admin:$ADMIN_PASSWORD 127.0.0.1:9581/tools/find \
  -d '{"Level":"Study","Query":{"AccessionNumber":"ACC-2026-0918"}}' | jq -r '.[0]')
curl -s -u admin:$ADMIN_PASSWORD -X POST 127.0.0.1:9581/studies/$S/anonymize \
  -d '{"Keep":["StudyDescription"],"Replace":{"PatientName":"ANON^TEACHING"},"Force":true,"Synchronous":true}' | jq -c '{ID, Path}'
```

```text
{"ID":"86a7a4c3-ebdfb8b9-195bf00c-0990b7c7-1368bf21","Path":"/studies/86a7a4c3-ebdfb8b9-195bf00c-0990b7c7-1368bf21"}
```

ثم نقرأ الفحصين من `/studies/{id}`، ووسوم أول صورة في النسخة الجديدة من `/instances/{id}/tags?simplify`:

```text
{"id":"86a7a4c3","pid":"ad0a7afe-6bcb-4df1-912f-947fef0ed064","name":"ANON^TEACHING","birth":"","acc":"","uid":"1.2.276.0.7230010.3.1.2.943141"}
{"id":"b48ef293","pid":"MRN-30412","name":"الحربي^سلمان","birth":"19790214","acc":"ACC-2026-0918","uid":"1.2.276.0.7230010.3.1.2.168443"}
{"PatientIdentityRemoved":"YES","DeidentificationMethod":"Orthanc 1.13.1","PatientName":"ANON^TEACHING","PatientID":"ad0a7afe-6bcb-4df1-912f-947fef0ed064","AccessionNumber":"","StudyDate":"","InstitutionName":null}
```

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

- الأصل بقي كما هو، والنسخة فحص جديد بمعرف فحص جديد، فالإخفاء لا يعدل الأرشيف، وإنما ينسخ منه. وهذا يعني أن كل نسخة مخفية تأخذ مساحة كاملة، فاحذفها بعد التصدير.
- رقم المريض صار معرفاً عشوائياً، ورقم الطلب وتاريخ الفحص فارغان، والوسمان `PatientIdentityRemoved` و`DeidentificationMethod` يسجلان أن الملف أخفي ومن أخفاه، وهذا ما تطلبه أغلب لجان الأخلاقيات.
- تاريخ الفحص حذف تماماً، وبعض الأبحاث تحتاج الفاصل الزمني بين فحصين للمريض نفسه، وعندها تحتاج إزاحة التواريخ بثابت لكل مريض بدل حذفها، وهذا ما تفعله أدوات TCIA كما رأينا في تاريخ 1959.
- الإخفاء على الوسوم فقط. فإذا كان اسم المريض محروقاً داخل البكسلات، كما في بعض صور الموجات فوق الصوتية والصور الملتقطة من الشاشة، فلن يحذفه هذا الطلب، ولذلك أضاف Orthanc Team إضافة منفصلة لإخفاء مناطق من البكسلات.

## من يحق له أن يرسل إلى الأرشيف؟

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

```bash
docker exec hi2-modality sh -c 'storescu -v -aet ANYONE -aec HI2PACS hi2-pacs 4242 /data/mr/00000001.dcm 2>&1 | grep -E "Association|Response"
  curl -s -o /dev/null -w "no password: %{http_code}\n" http://hi2-pacs:8042/patients'
```

```text
I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Received Store Response (Success)
I: Releasing Association
no password: 401
```

واجهة HTTP محمية بكلمة المرور، ولكن بروتوكول DICOM قبل صورة من جهاز اسمه ANYONE لم نسجله أبداً، والسبب أن الإعداد الافتراضي `DicomAlwaysAllowStore` قيمته true. وهذا مفهوم في مختبر، أما في مستشفى فيعني أن أي حاسوب على الشبكة يستطيع أن يضع صوراً باسم أي مريض في الأرشيف، وصورة بمعرف مريض خطأ في أرشيف طبي أخطر من صورة مفقودة. لذلك أضفنا إلى `orthanc.json` ما يلي وأعدنا التشغيل:

```json
  "DicomAlwaysAllowEcho": false,
  "DicomAlwaysAllowStore": false,
  "DicomAlwaysAllowFind": false,
  "DicomAlwaysAllowMove": false,
  "DicomCheckModalityHost": true,
  "DicomCheckCalledAet": true
```

ثم جربنا ثلاث حالات: الاسم المجهول، والجهاز الصحيح ينادي الأرشيف باسم خطأ، والجهاز الصحيح بالاسم الصحيح:

```text
F: Association Rejected:
F: Result: Rejected Permanent, Source: Service User
F: Reason: Calling AE Title Not Recognized
---
F: Association Rejected:
F: Result: Rejected Permanent, Source: Service User
F: Reason: Called AE Title Not Recognized
---
I: Requesting Association
F: Association Rejected:
```

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

```text
W1118 12:20:26.518817     DICOM-SERVER OrthancConfiguration.cpp:1062] Forbidding access from AET "CT1" given its hostname (172.24.0.5) does not match the "DicomModalities" configuration option (hi2-modality was expected)
```

فالإعداد `DicomCheckModalityHost` يقارن عنوان IP الذي جاء منه الاتصال بالنص المكتوب في قائمة الأجهزة كما هو، ولا يحول اسم المضيف `hi2-modality` إلى عنوان. والحل الذي يناسب الواقع هو أن يكون للجهاز عنوان ثابت، وهذا هو الحال في أي جهاز طبي حقيقي، فأعطينا الجهاز في ملف Compose العنوان `172.31.42.10` كما رأيت في البداية، وكتبناه في القائمة بدل الاسم:

```json
    "ct1": ["CT1", "172.31.42.10", 4243],
```

```text
I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Received Store Response (Success)
I: Releasing Association
F: Association Rejected:
F: Result: Rejected Permanent, Source: Service User
F: Reason: Calling AE Title Not Recognized
echo from ANYONE exit=1
```

الجهاز الصحيح يرسل، والاسم المجهول لا يستطيع حتى اختبار الاتصال. والصورة التالية تجمع ما جربناه:

![جدول الأقفال: الإعداد الافتراضي DicomAlwaysAllowStore قبل صورة من الاسم ANYONE، وبعد DicomAlwaysAllowStore false رفض ANYONE بالسبب Calling AE Title Not Recognized، وDicomCheckCalledAet true رفض CT1 عندما نادى PACS بدل HI2PACS بالسبب Called AE Title Not Recognized، وDicomCheckModalityHost true رفض الجهاز الصحيح لأن المقارنة بالعنوان 172.24.0.5 وليس بالاسم hi2-modality، وبعد العنوان الثابت 172.31.42.10 قبل الصورة، وواجهة HTTP دون كلمة مرور رجعت 401، وتحتها تذكير بأن اسم AET ليس كلمة مرور](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-05-security.webp)

كل قفل جربناه والطلب الذي رفضه

وتذكر أن اسم AET ليس كلمة مرور، فهو مكتوب في إعداد كل جهاز ويستطيع أي فني أن يقرأه، وفحص العنوان أقوى منه ولكنه ليس كافياً على شبكة مسطحة يستطيع فيها أي أحد أن يغير عنوانه. والطبقات التي تكمل الحماية هي شبكة معزولة للأجهزة الطبية، وTLS لبروتوكول DICOM إذا كان الجهاز يدعمه (Orthanc يدعمه بالإعداد `DicomTlsEnabled`)، وواجهة HTTP خلف Reverse Proxy بشهادة، وإضافة الصلاحيات Authorization التي تربط Orthanc بمزود هوية مثل Keycloak حتى لا تكون هناك كلمة مرور واحدة مشتركة. وقد شرحنا المفهوم في مقال [OAuth وOpenID Connect](https://arabroot.io/articles/%D8%B4%D8%B1%D8%AD-oauth-%D9%88-openid-connect-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/).

## النسخ الاحتياطي Backup وماذا يحدث عندما تتوقف القاعدة

الأرشيف الآن في مكانين، والصورة التالية تبين ما في كل منهما:

![مخطط الفهرس والملفات: في PostgreSQL الجدول resources بسطر لكل مريض وفحص وسلسلة وصورة بالأعداد 3 و3 و3 و195، والجدول maindicomtags بالوسوم الرئيسية في 1062 سطراً، والجدول attachedfiles برقم كل ملف وحجمه، والجدول keyvaluestores بقوائم العمل، ونسخة pg_dump بحجم 169 كيلوبايت. وفي الـ Volume كل صورة ملف DICOM كامل باسم UUID داخل مجلدين من حرفين، ونسخة tar بحجم 127 ميغابايت و240 ملفاً. وتحتها: عندما توقفت القاعدة نجح C-ECHO ورجع C-STORE بالحالة Refused OutOfResources وبقي كذلك حتى إعادة تشغيل Orthanc](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-06-index-storage.webp)

الفهرس والملفات نسختان يجب أن تتطابقا، وما رأيناه عندما توقفت القاعدة

وأخذنا نسخة من كل منهما:

```bash
docker exec hi2-pacs-db sh -c 'pg_dump -U orthanc -Fc orthanc > /tmp/orthanc.dump && ls -l /tmp/orthanc.dump'
docker run --rm -v hi2-pacs-files:/src:ro debian:trixie-slim sh -c 'cd /src && tar -cf - . | wc -c; find . -type f | wc -l'
```

```text
-rw-r--r--    1 root     root        169088 Nov 18 12:39 /tmp/orthanc.dump
126781440
240
```

نسخة القاعدة 169 كيلوبايت بالصيغة المضغوطة لـ pg\_dump، ونسخة الملفات 127 ميغابايت و240 ملفاً، وهي أكثر من 195 لأن الأرشيف أصبح فيه الفحص الذي صورناه ونسخته المخفية. والمهم هنا ترتيب النسخ: إذا نسخت الملفات أولاً ثم القاعدة بعد ساعة، فقد تحتوي القاعدة على صور وصلت بعد نسخ الملفات، فتشير بعد الاستعادة إلى ملفات غير موجودة. والترتيب الأسلم هو نسخ القاعدة أولاً ثم الملفات، فتكون في الملفات صور زائدة لا يعرفها الفهرس، وهذه أهون، ويمكن استيرادها مرة أخرى. وقد شرحنا النسخ المتسق في مقال [نسخ قواعد البيانات بشكل متسق](https://arabroot.io/articles/%D9%86%D8%B3%D8%AE-%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-%D8%A8%D8%B4%D9%83%D9%84-%D9%85%D8%AA%D8%B3%D9%82-pg%5Fdump-%D8%A7%D9%88-mysqldump/)، وقاعدة النسخ الثلاث في مقال [النسخ الاحتياطي بقاعدة 3-2-1](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/).

### نجرب العطل: نوقف قاعدة البيانات

ماذا يرى الجهاز إذا توقفت القاعدة أثناء العمل؟ أوقفناها وأرسلنا صورة واختبرنا الاتصال:

```bash
docker stop hi2-pacs-db
docker exec hi2-modality sh -c 'storescu -v -aet CT1 -aec HI2PACS hi2-pacs 4242 /data/mr/00000003.dcm 2>&1 | grep -vE "XMIT|checking|Sending"
  echoscu -aet CT1 -aec HI2PACS hi2-pacs 4242; echo echo-exit=$?'
```

```text
I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Received Store Response (Refused: OutOfResources)
I: Releasing Association
echo-exit=0
```

الاختبار C-ECHO نجح، والإرسال رفض بالحالة `Refused: OutOfResources`، وفي السجل `The database is not available, closing the connection`. والدرس الأول هنا أن C-ECHO الأخضر لا يعني أن الأرشيف يعمل، فلا تجعله فحص الصحة الوحيد في المراقبة. ثم أعدنا تشغيل القاعدة وانتظرنا حتى أصبحت `healthy`، وأرسلنا نفس الصورة ثلاث مرات بفاصل 15 ثانية:

```text
I: Received Store Response (Refused: OutOfResources)
I: Received Store Response (Refused: OutOfResources)
I: Received Store Response (Refused: OutOfResources)
E1118 12:40:33.985169  DB HOUSEKEEPING postgresql-index:/PostgreSQLDatabase.cpp:47] PostgreSQL error: no connection to the server
```

الأرشيف لم يرجع إلى العمل وحده بعد أكثر من دقيقتين من عودة القاعدة، وكتب في سجله 527 سطراً من نوع `no connection to the server`، و`docker ps` يعرضه بالحالة Up طوال الوقت. وبعد `docker restart hi2-pacs` رجع الإرسال بالحالة Success مباشرة. والدرس الثاني أهم: إذا كانت المراقبة تفحص أن العملية تعمل فقط، فسوف يبقى الأرشيف يرفض صور الأجهزة ساعات دون أن ينبهك أحد، والجهاز في الغالب يحفظ الصور في ذاكرته ويعيد المحاولة، حتى تمتلئ. لذلك افحص المسار الحقيقي، أي إرسال صورة اختبار أو طلب يقرأ من القاعدة مثل `/statistics`، واجعل فشله يعيد تشغيل الأرشيف أو ينبه المناوب. والـ Image فيها سكربت `/probes/test-aliveness.py` لهذا الغرض، فاقرأ ما يفحصه قبل أن تعتمد عليه.

## من المختبر إلى الإنتاج Production

الجدول التالي يجمع ما رأيناه وما يقابله في مركز حقيقي:

| البند        | ما رأيناه في المختبر                         | ماذا تفعل في الإنتاج                                          |
| ------------ | -------------------------------------------- | ------------------------------------------------------------- |
| الفهرس       | PostgreSQL 18، و11 MB لـ 195 صورة            | قاعدة على قرص سريع، ونسخ يومي، واختبار استعادة                |
| الملفات      | Volume محلي، 100 MB لثلاثة فحوص              | تخزين منفصل يكبر، أو تخزين كائني بإضافة S3، ونسخة في مكان آخر |
| الضغط        | JPEG 2000 وJPEG-LS دون فقدان وفرا 63%        | ضغط دون فقدان عند الاستلام بعد اختباره مع كل العارضات         |
| الترميز      | الاسم العربي وصل ^ حتى أضفنا DefaultEncoding | UTF-8، واختبار المسار العربي على شاشة كل جهاز                 |
| قبول الأجهزة | الافتراضي يقبل أي اسم                        | قائمة أجهزة بعناوين ثابتة، وDicomAlwaysAllow\* معطلة          |
| الاسترجاع    | وجهة مجهولة رجعت UnableToProcess             | كل محطة مسجلة، وجدار الحماية يسمح بالاتجاه المعاكس            |
| قوائم العمل  | حذفت وحدها بعد استقرار الفحص                 | RIS ينشئها بالـ REST، ومراقبة القوائم القديمة التي لم تحذف    |
| المراقبة     | القاعدة عادت والأرشيف بقي يرفض               | فحص صحة يرسل أو يقرأ فعلاً، وليس C-ECHO أو حالة الـ Container |
| واجهة HTTP   | كلمة مرور واحدة دون TLS                      | Reverse Proxy بشهادة، وإضافة الصلاحيات مع مزود هوية           |
| العارض       | OHIF وStone للعرض فقط                        | عارض معتمد للتشخيص، وهذه للمراجعة والتعليم                    |

## أخطاء شائعة

- **ترك `DicomAlwaysAllowStore` على الافتراضي:** أي جهاز على الشبكة يضع صوراً في الأرشيف، ورأينا ذلك بالاسم ANYONE.
- **كتابة اسم المضيف في قائمة الأجهزة مع فحص العنوان:** Orthanc يقارن العنوان بالنص كما هو، فيرفض الجهاز الصحيح.
- **الحكم على الأرشيف بنجاح C-ECHO:** نجح الاختبار والقاعدة متوقفة والصور مرفوضة.
- **نسخ الملفات دون القاعدة أو العكس:** نسخة واحدة منهما لا تستعيد شيئاً.
- **توليد معرف سلسلة لكل ملف في سكربت استيراد:** فحص واحد بعشرين سلسلة لا يقرأ.
- **إرسال مجلد تنزيل كما هو:** ملف نصي واحد مثل `LICENSE` أنهى الإرسال كله.
- **اختبار الأسماء بالإنجليزية فقط:** مشكلة الترميز لا تظهر إلا مع اسم عربي.
- **الضغط مع فقدان على الأصل لتوفير المساحة:** قرار طبي وتنظيمي، والضغط دون فقدان يوفر أغلب المساحة دون هذا الخطر.

## تنظيف المختبر

```bash
docker compose down -v
docker rm -f hi2-ctest 2>/dev/null
docker rmi hi2-modality:1
```

الخيار `-v` يحذف الـ Volumes وفيها الفهرس والصور، فلا تستخدمه على أرشيف فيه بيانات تريدها.

## تدريب عملي

- فعل في غرفة القراءة قائمة أجهزة بالأرشيف، ثم اطلب منها بحثاً C-FIND على الأرشيف من واجهة Orthanc Explorer 2، واقرأ في سجل الأرشيف ما الذي يمنعه أو يسمح به.
- أنشئ قائمة عمل لجهاز الأشعة السينية باسم AET آخر، ثم اسأل من CT1 دون شرط على `ScheduledStationAETitle`، وجرب الإعداد `FilterIssuerAet` في قسم قوائم العمل.
- أعد تجربة الضغط على فحص الأشعة السينية الوحيد، وقارن نسبة التوفير بنسبة الأشعة المقطعية، وفسر الفرق.
- اكتب فحص صحة يرسل صورة اختبار صغيرة كل دقيقة ويحذفها، ثم أوقف القاعدة وتأكد أنه يكتشف المشكلة التي لم يكتشفها C-ECHO.

## الخلاصة

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

- الأرشيف عقدة في شبكة أجهزة، وكل جهاز له اسم AET، والخدمات الأربع C-ECHO وC-STORE وC-FIND وC-MOVE هي ما يتكلم به الجهاز ومحطة القراءة، وC-MOVE يحتاج أن يعرف الأرشيف عنوان الوجهة مسبقاً.
- Orthanc 1.13.1 مع PostgreSQL يحفظ الفهرس في القاعدة والصور على القرص، و195 صورة احتاجت 11 MB في القاعدة و100 MB على القرص.
- قائمة العمل تنقل بيانات المريض من الطلب إلى الجهاز، والاسم العربي وصل علامة ^ حتى ضبطنا `DefaultEncoding` على UTF-8، والقائمة حذفت وحدها بعد استقرار الفحص.
- الضغط دون فقدان بصيغة JPEG-LS أو JPEG 2000 قلل فحص الأشعة المقطعية من 97 إلى 36 ميغابايت، وzlib إلى 56، والرمز 4.91 لا يعني فقداً بالضرورة.
- الإعداد الافتراضي يقبل الصور من أي اسم، والأقفال التي جربناها رفضت كل طلب خطأ بعد أن أعطينا الجهاز عنواناً ثابتاً.
- عندما توقفت القاعدة نجح C-ECHO ورفضت الصور، ولم يرجع الأرشيف وحده بعد عودتها حتى أعدنا تشغيله، فراقب المسار الحقيقي.

[![](https://arabroot.io/content/images/2026/10/medical-imaging-cover-cover.webp)دليلكيف تعمل أنظمة الصور الطبية؟ DICOM وPACS من الداخلكيف تحفظ المستشفيات صور الأشعة وتنقلها بمعيار DICOM، وكيف تشغل أرشيفاً وعارضاً على سيرفرك وتجربهما على صور حقيقية.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D8%B5%D9%88%D8%B1-%D8%A7%D9%84%D8%B7%D8%A8%D9%8A%D8%A9-dicom-%D9%88-pacs/)[![](https://arabroot.io/content/images/2026/11/health-interop-cover-cover.webp)دليلتبادل البيانات الصحية بين الأنظمة: HL7 وFHIRكيف تنتقل نتائج المختبر وبيانات المريض بين أنظمة المستشفى برسائل HL7 وواجهات FHIR، وكيف تبني ذلك وتختبره بنفسك.](https://arabroot.io/articles/%D8%AA%D8%A8%D8%A7%D8%AF%D9%84-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%B5%D8%AD%D9%8A%D8%A9-hl7-%D9%88-fhir/)[![](https://arabroot.io/content/images/2026/11/fhir-lab-cover-cover.webp)دليلخادم FHIR على سيرفرك: تجربة عملية مع HAPI FHIRكيف تشغل سيرفر FHIR يحفظ في PostgreSQL ويتحقق من البيانات بدليل نفيس، مع البحث بالأسماء العربية والنسخ والمعاملات.](https://arabroot.io/articles/%D8%AE%D8%A7%D8%AF%D9%85-fhir-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-%D9%85%D8%B9-hapi-fhir/)[![](https://arabroot.io/content/images/2026/11/health-it-map-cover-cover.webp)دليلالمستشفى من الداخل: خريطة الأنظمة HIS وEMRما هي أنظمة المستشفى من التسجيل والسجل الطبي إلى المختبر والأشعة والصيدلية والفوترة، وكيف تتصل ببعضها، ومن أين تبدأ.](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%B4%D9%81%D9%89-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84-%D8%A7%D9%86%D8%B8%D9%85%D8%A9-his-%D9%88-emr/)[![](https://arabroot.io/content/images/2026/11/openemr-lab-cover-cover.webp)دليلالسجل الصحي الإلكتروني EMR مع OpenEMR وOpenMRSكيف تشغل سجلاً سريرياً مفتوح المصدر بواجهة عربية، وتسجل فيه مريضاً وزيارة ووصفة، ثم تتكامل معه عبر OAuth2 وFHIR وتعرف ما يتغير في الطريق.](https://arabroot.io/articles/%D8%A7%D9%84%D8%B3%D8%AC%D9%84-%D8%A7%D9%84%D8%B5%D8%AD%D9%8A-%D8%A7%D9%84%D8%A7%D9%84%D9%83%D8%AA%D8%B1%D9%88%D9%86%D9%8A-emr-%D9%85%D8%B9-openemr-%D9%88-openmrs/)[![](https://arabroot.io/content/images/2026/11/open-source-lis-cover-cover.webp)دليلنظام المختبر LIS مفتوح المصدر: SENAITE وOpenELISكيف تمر العينة في نظام مختبر مفتوح المصدر من الطلب والملصق إلى النتيجة والاعتماد والتقرير، وكيف تصل نتائج الأجهزة برسائل HL7 v2 عبر برنامج وسيط.](https://arabroot.io/articles/%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%AE%D8%AA%D8%A8%D8%B1-lis-%D9%85%D9%81%D8%AA%D9%88%D8%AD-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-senaite-%D9%88-openelis/)[![](https://arabroot.io/content/images/2026/11/health-data-privacy-cover-cover.webp)دليلخصوصية البيانات الصحية وإخفاء الهوية De-identificationما يقوله النظام السعودي عن البيانات الصحية، ومن يحق له أن يراها، وكيف تخفي هوية المرضى وتقيس أن البيانات لم تعد تدل عليهم.](https://arabroot.io/articles/%D8%AE%D8%B5%D9%88%D8%B5%D9%8A%D8%A9-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%B5%D8%AD%D9%8A%D8%A9-%D9%88%D8%A7%D8%AE%D9%81%D8%A7%D8%A1-%D8%A7%D9%84%D9%87%D9%88%D9%8A%D8%A9-de-identification/)[![](https://arabroot.io/content/images/2026/10/backup-321-cover-cover.webp)دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/)

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

- 2026-11-18: كتابة المقال، وتنفيذ المختبر على Orthanc 1.13.1 (orthancteam/orthanc:26.11.1) مع إضافات PostgreSQL 11.0 وDICOMweb 1.24 وWorklists 1.0.0 وOHIF 1.8 وOrthanc Explorer 2 1.15.1، وPostgreSQL 18.6، وأدوات dcmtk 3.6.9 على debian:trixie-slim، وصور من TCIA (Pancreas-CT وLIDC-IDRI وCMB-CRC)، على Docker Engine 29.8.0.