Руководство по Carino DICOM

Carino DICOM — это шлюз DICOM и устройство непрерывности работы: принимает исследования, маршрутизирует и пересылает их, отдаёт хранимое по Query/Retrieve и DICOMweb и позволяет отделению лучевой диагностики работать, когда PACS или РИС перестают отвечать. Это руководство охватывает развёртывание, повседневные задачи и то, что делать, когда они не получаются, модель безопасности, каждую службу и реальные пределы программы.

Все снимки экрана в этом руководстве сделаны с работающего экземпляра этой программы, а исследования на них придуманы для съёмки. Ни один пациент в руководстве не показан.

1. Что это такое и какую роль играет

Carino DICOM стоит между оборудованием, которое создаёт изображения, и системами, которые их хранят или читают. Он не пытается заменить ваш архив; он пытается быть тем звеном, которое их связывает, и тем, что останется на ногах, когда упадёт что-то из остальных.

У него две роли, и различие между ними важно: именно оно определяет, какие службы вы включите.

• Постоянный шлюз. Принимает по C-STORE, раскладывает на диск по схеме пациент / исследование / серия, пересылает на одно или несколько назначений по правилам, обезличивает уходящую копию, когда его об этом просят, и отдаёт хранимое по Query/Retrieve (для старого оборудования) и DICOMweb (для современных просмотрщиков).
• Страховочная сеть. Если основной PACS перестал отвечать, он может поднять собственный Modality Worklist, чтобы лаборанты продолжали снимать, удержать всё, что придёт во время аварии, и переслать это, как только основной узел вернётся. Он также принимает заявки HL7 по MLLP — или введённые вручную, — когда из строя вышла РИС.

Всем управляет один config.json, и всё работает без графического интерфейса. Веб-панель удобна, но не обязательна.

Порты по умолчанию

2. Начало работы

Выберите вариант развёртывания

Настольное приложение

Скачайте пакет для вашей системы со страницы releases и откройте его. Оно сворачивается в системный трей; по клику открывается панель. Приложение пока не подписано цифровой подписью, поэтому Windows и macOS предупреждают при первом запуске — на главной странице есть точные шаги, как всё-таки его открыть.

При первом запуске оно один раз спрашивает, можно ли проверять на GitHub, не вышла ли более новая версия. Ответ «нет» — или просто закрытое окно вопроса — оставляет проверку выключенной, и так она настроена по умолчанию. Если она включена, новый релиз появляется строкой в меню трея и рядом с версией на панели Обзор; клик по любой из них открывает страницу релиза в вашем браузере. Ничего не скачивается и ничего не устанавливается само. Флажок Проверять обновления в меню трея включает и выключает это в любой момент, и есть он только в настольной сборке — в контейнерных и systemd-развёртываниях его нет.

Docker

git clone https://github.com/MiguelCarino/Carino-DICOM
cd Carino-DICOM
mkdir -p data
echo "PACS_UID=$(id -u)" >> .env
echo "PACS_GID=$(id -g)" >> .env
docker compose up -d --build
docker compose logs -f pacs

При первом запуске создаётся и печатается в журнал токен доступа. Откройте http://127.0.0.1:8042/ и вставьте его, когда панель попросит. Всё — конфигурация, исследования, журналы, индекс — лежит в ./data, и именно с него делается резервная копия.

Служба systemd (Linux)

git clone https://github.com/MiguelCarino/Carino-DICOM.git
cd Carino-DICOM
sudo packaging/systemd/install.sh

Установщик создаёт системного пользователя carino-pacs, копирует код в /opt/carino-pacs, готовит /var/lib/carino-pacs и ставит юнит… но не запускает его. Это не недосмотр: запуск PACS открывает порты, принимающие данные пациентов, и такое решение принимается после чтения конфигурации, а не до. Отредактируйте /var/lib/carino-pacs/config.json, затем:

sudo systemctl enable --now carino-pacs
systemctl status carino-pacs
journalctl -u carino-pacs -f

Повторный запуск установщика обновляет код на месте и никогда не трогает существующий config.json.

Где лежат данные

config.json лежит вместе с данными, а не в /etc, потому что относительные пути в конфигурации ("./received", "./logs", "./index.db") отсчитываются от каталога, в котором лежит сам файл конфигурации. Конфигурация в /etc разбросала бы исследования пациентов по /etc.

Первый запуск, по порядку

1. Выберите службы. Всё поставляется выключенным. Окно выбора служб в панели спрашивает, что должна запускать эта машина; включите только это.
2. Добавьте назначения (имя, хост, порт, AE title) на вкладке Назначения в разделе Конфигурация — именно этой вкладкой раздел и открывается.
3. Проверьте связь, прежде чем передавать хотя бы одно изображение: нажмите Echo в строке назначения. На машине без панели то же самое делает ./run.sh echo --name "Hospital PACS". Если echo не проходит, дело не в Carino — дело в сети, брандмауэре или AE title.
4. Направьте сюда один аппарат по строке Направьте модальность на на карточке приёма и отправьте тестовое исследование (см. Как сделать…).
5. Следите за журналом — вкладка Журнал в разделе Активность. Если что-то не сработало, это появится там и на карточке службы как Последняя проблема; эта программа скорее закричит, чем тихо откажет.

Без графического интерфейса

./run.sh init            # создаёт config.json и его папки
./run.sh init --token    # и генерирует web.auth_token
./run.sh serve           # панель на http://127.0.0.1:8042
./run.sh receive         # только приём
./run.sh send            # только наблюдение за папкой / пересылка
./run.sh qr              # только Запрос/выдача
./run.sh mwl             # только рабочий список
./run.sh ris             # только приём заявок HL7
./run.sh print           # только виртуальная печать
./run.sh echo --host 10.0.0.5 --port 104 --aet REMOTEPACS

Каждая команда принимает -c / --config <путь>. В Windows — run.ps1.

3. Как сделать…

Короткие рецепты для задач, которые возникают в отделении. Каждый заканчивается тем, как понять, что всё получилось; если не получилось, следующая глава — список того, что проверить.

…направить аппарат сюда, чтобы он сохранял изображения

1. Откройте Службы. Если карточка Приём говорит, что служба остановлена, нажмите Пуск.
2. Прочитайте строку карточки Направьте модальность на: AE title, IP-адрес и порт (по умолчанию CARINODICOM и 11112). Кнопка копирования рядом копирует все три. Если у машины несколько адресов, берите тот, что в сети аппарата.
3. На аппарате добавьте назначение для сохранения — производители называют его узлом DICOM, архивом, «Send to» или «Store» — с этими тремя значениями. Собственный AE title аппарата — это вызывающий AE; здесь его вводить не нужно.
4. Если в Конфигурация → Настройки → Этот PACS в поле Принимать только эти AE перечислены AE title, добавьте туда AE title аппарата, иначе приём его отклонит.
5. Запустите собственную проверку связи на аппарате (часто Verify или Echo), затем отправьте одно исследование. Оно появится в Исследования → История.

Кнопка Проверить на карточке проверяет приём с этой же машины. Если Проверить проходит, а аппарат всё равно не может отправить, проблема между ними: адрес, порт, брандмауэр или список разрешённых AE.

…направить аппарат сюда, чтобы он печатал

Для оборудования, единственный вывод которого — плёнка. Carino притворяется плёночным принтером и захватывает каждый лист, чтобы вы его идентифицировали; на бумагу ничего не печатается.

1. Откройте Службы и нажмите Пуск на карточке Приём печати.
2. Прочитайте её строку Направьте модальность на (по умолчанию CARINOPRINT, IP этой машины и порт 11113).
3. На аппарате добавьте принтер DICOM — его иногда называют лазерной камерой или плёночным принтером — с этими тремя значениями. Оттенки серого предлагаются всегда; если аппарат печатает только в цвете, отметьте Принимать также цветные задания печати в Конфигурация → Настройки → Печать.
4. Нажмите Отправить тестовую печать на карточке. Через несколько секунд в Исследования → Ожидают появится лист с пометкой TEST PRINT — safe to discard. Это доказывает, что приём работает; отбросьте лист.
5. Напечатайте одну плёнку с аппарата. Карточка покажет Последняя печать с числом плёнок, AE title аппарата и его адресом, счётчик Захвачено вырастет, а плёнка будет ждать в Ожидают, пока вы её не утвердите (см. ниже).

Сохранять каждую снятую плёнку как (в группе Печать) определяет, чем станет плёнка после утверждения. Многие архивы и просмотрщики хранят PDF, но не показывают его; выберите Изображение (Secondary Capture), если плёнку нужно читать на той стороне.

AE title принтера, набранный на аппарате, не проверяется: с опечаткой печать всё равно пройдёт. Фильтруется только собственный AE title аппарата, и только если заполнено Принимать только эти AE. Если печать не удалась, карточка показывает Последняя проблема; в таблице неполадок печати есть каждое сообщение и способ исправления.

…направить аппарат сюда, чтобы он забирал рабочий список

1. Убедитесь, что заявки есть. Либо РИС шлёт заявки HL7 в службу Аварийная РИС (порт 2575), либо кто-то вводит их в Заявки → Новая заявка.
2. В Конфигурация → Модальности зарегистрируйте кабинет с точным AE title станции. Тогда адресат заявки выбирается из этого списка, а не набирается.
3. Откройте Службы, нажмите Пуск на карточке MWL и прочитайте её строку Направьте модальность на (по умолчанию CARINOMWL и порт 11114).
4. На аппарате укажите эти значения как поставщика рабочего списка (MWL, «HIS/RIS» или «worklist server») и выполните запрос.

Заявка без адресата видна на всех станциях; заявка с адресатом видна только на станции, чей AE title совпадает с ним в точности. Когда исследование возвращается, оно сопоставляется с заявкой по номеру исследования, и заявка закрывается сама.

…утвердить ожидающую плёнку

Снятые плёнки, а также PDF и изображения, найденные рядом с исследованием, ждут в Исследования → Ожидают. Счётчик 📎 рядом с Исследованиями показывает, сколько их.

1. Откройте Просмотр и посмотрите на лист.
2. Если у пациента есть открытая заявка, нажмите Сопоставить с заявкой… и выберите её. ФИО, ID пациента, номер исследования и само исследование берутся из заявки, а заявка закрывается как захваченная.
3. Иначе введите данные сами. ID пациента и ФИО пациента обязательны; номер исследования, дату и описание очень желательно заполнить.
4. Если элемент пришёл рядом с исследованием, а вы сменили пациента, выберите, к чему он относится: Прикрепить к исходному исследованию — только если это исследование действительно принадлежит этому пациенту, иначе Новое исследование. Неверный выбор положит лист одного пациента в исследование другого.
5. Нажмите Утвердить. Элемент превращается в DICOM и пересылается, как любое другое исследование.

Отменить нельзя: после утверждения исходный файл исчезает из «Ожидают», а копия DICOM уже в пути. Ошибку исправляют в архиве. Отбросить убирает элемент, ничего не отправляя.

…исправить застрявшую пересылку

Откройте Исследования → Застряли (счётчик ⚠ рядом с Исследованиями). Строки сгруппированы по исследованию — с пациентом, номером исследования и описанием — и разложены на три вида:

• Повтор идёт автоматически — назначение отказало или не ответило. Прочитайте ошибку в строке: она говорит, отклонил ли нас удалённый узел (и почему, например «add CARINOSCU to the remote's allowed AE titles»), оборвал соединение или вовсе не ответил. Исправьте это, нажмите Echo в строке назначения в Конфигурация → Назначения, затем Повторить сейчас.
• Удержано — ничего не отправляется — удержание из-за обезличивания. Никакой таймер его не снимает; воспользуйтесь двумя кнопками в строке и см. Обезличивание при пересылке.
• Не осталось назначения для повтора — файлы направлены на назначение, которое удалили или выключили. Включите его снова, или нажмите Отправить на… и выберите другое назначение, или Убрать из очереди (спросит подтверждение), смирившись с потерей.

…узнать, почему что-то не сработало

1. Посмотрите на карточку службы. Каждая служба показывает Последняя проблема, если что-то пошло не так; щёлкните по ней, чтобы открыть журнал, уже отфильтрованный по этой службе.
2. На Активность → Журнал пользуйтесь кнопками служб (приём, отправка, печать, рабочий список, Q/R, РИС…), переключателем Только ошибки и предупреждения и текстовым фильтром — AE title, IP-адрес или номер исследования быстро сужают поиск.
3. Чтобы передать проблему кому-то ещё, скопируйте видимые строки или скачайте журнал за целый день.
4. Нажмите Проверить на карточке. Если проверка с этой машины проходит, а аппарат всё равно не может, смотрите на сеть между ними.
5. Если изменилась настройка и никто не знает, кто её изменил, Активность → Аудит называет человека и разделы, которые он менял.

4. Когда что-то идёт не так

Сначала признак, затем где смотреть, затем как исправить. Почти каждая строка начинается в одних и тех же двух местах: карточка службы на панели Службы (её Последняя проблема) и Активность → Журнал.

Отправка, приём и рабочий список

Печать

Каждый отказ и сбой приёма печати — это строка в журнале (кнопка печать), она учитывается в Ошибках карточки и показывается как её Последняя проблема. Удачное задание показывается как Последняя печать.

Две вещи, которые причиной не являются: AE title принтера, набранный на аппарате (он не проверяется), и то, что аппарат оставляет номера сеанса плёнки и плёночного листа принтеру (если их нет, они создаются здесь). Presentation LUT принимается и игнорируется, а аппарат, который сначала запрашивает конфигурацию принтера, получает ответ.

5. Модель безопасности и правило токена

Начнём с главного: панель — это ключ от архива. Любой, кто её откроет, может прочитать каждое сохранённое исследование, скачать файлы DICOM, изменить любую настройку, запустить и остановить службы, удалить исследования и выключить сервер. Из коробки существует один общий секрет, и тот, у кого он есть, может всё — профили необязательны и выключены, пока вы их не включите. Как только вы это сделаете, каждый входит под собой — со своими разрешениями, со своим доступом к идентификаторам пациента и со своим именем в журнале аудита; общий токен продолжает работать как администратор, поэтому ничего из того, что уже им пользуется, не ломается.

Разрешения определяют и то, что панель рисует. Профиль видит только те разделы боковой панели и только те вкладки внутри них, на которые у него есть разрешения: Рентгенолог, у которого есть routing.read, но нет config.read, получает Конфигурацию с Назначениями и Маршрутами и без вкладки Настройки, а Регистратура, не имеющая ни одного из трёх, вообще не видит раздела Конфигурация. Индикаторы служб в верхней шапке — намеренное исключение, см. Веб-панель ниже.

Правило

Причина вполне конкретна. Без аутентификации на 127.0.0.1 контролем доступа служит операционная система: до API дотянется только процесс на этой машине. Это оправданно. Но web.host задаёт оператор, и в тот момент, когда кто-нибудь меняет его на 0.0.0.0, чтобы «зайти с другого ПК» — второпях, во вторник, не думая о безопасности, — тот же API выдаёт любому соседу по локальной сети список исследований, пути хранения, байты DICOM и /api/shutdown. Правило существует потому, что такое изменение занимает десять секунд, а последствия остаются на годы.

Любой контейнер всегда находится именно в этом положении: контейнер по своей природе публикует службу на 0.0.0.0. Поэтому образ при первом запуске создаёт 256-битный токен, если вы не задали свой, — и печатает его. А вот молча он токен не создаёт никогда: секрет, которого никто не видел, — это секрет, который никто не меняет.

Создание и предъявление токена

./run.sh init --token                                  # записывает его в config.json
python3 -c "import secrets; print(secrets.token_urlsafe(32))"
openssl rand -base64 32

Сервер принимает учётные данные тремя способами:

• Authorization: Bearer <token>
• X-Carino-Token: <token>
• сессионный файл cookie, выданный POST /api/login

Файл cookie существует для того, чтобы панель спрашивала токен один раз вместо того, чтобы держать его в JavaScript, где его прочитает любой XSS и любое расширение браузера. Он никогда не несёт сам токен: он несёт HMAC по секрету, созданному при старте и хранимому только в памяти. Поэтому перезапуск завершает все сессии — верный компромисс для устройства с одним оператором: никакого хранилища сессий на диске, нечему утечь, а в худшем случае токен придётся ввести заново раз в смену.

Сторона DICOM

• allowed_aets — список разрешённых вызывающих AE title. Пустой означает «принимать любого». Это полезный фильтр, а не аутентификация: DICOM не проверяет подлинность вызывающей стороны.
• DICOM-TLS — доступен с обеих сторон независимо, включая взаимный TLS с клиентским сертификатом. Используется тот же порт: незашифрованная сторона не договорится с приёмником по TLS, и наоборот. TLS шифрует и аутентифицирует транспорт, а не приложение — для настоящего контроля доступа сочетайте его с allowed_aets или клиентскими сертификатами.
• Брандмауэр — службы DICOM по умолчанию слушают на 0.0.0.0 (хотя ни одна не работает, пока вы её не включите). Для того, до чего должны дотягиваться аппараты, это правильно, а значит, ограничить их подсетью аппаратов — ваша задача.

Что эта модель не защищает

• Профили выключены, пока вы их не включите. До этого на всё устройство один общий секрет и никаких учётных записей, ролей и разрешений. Так и остаётся по умолчанию, потому что молчаливое включение при обновлении сломало бы каждого машинного клиента на площадке.
• Нет интеграции со службой каталогов. Учётные записи живут на самом устройстве. Нет ни LDAP, ни Active Directory, ни единого входа, ни способа централизованно отключить человека, когда он уходит.
• Журнал аудита можно обрезать. Он ловит запись, изменённую на месте, изъятую из середины, переставленные записи и файл, оборванный посреди строки, — каждое из этого ломает хеш, и Проверить целостность называет запись и причину. Он не поймает удаление нескольких последних записей, потому что оставшееся — по-настоящему корректная цепочка, и он не остановит полную перезапись тем, у кого есть доступ на запись в папку аудита. Если вам нужна неотказуемость, скопируйте вершину цепочки туда, куда эта машина писать не может, и сравните позже.
• Шифрования на диске нет. Исследования — это обычные файлы DICOM, индекс sqlite хранит имена и идентификаторы в открытом виде, заявки — это JSON, а config.json содержит токен открытым текстом. Шифруйте том под ними (LUKS, BitLocker, FileVault) и ограничьте права на каталог данных.
• У приёмника HL7/MLLP нет ни TLS, ни учётных данных. Это сокет TCP с обрамлением MLLP. Его единственный контроль — allowed_hosts, проверка адреса подключающейся стороны, а такой адрес можно подделать. Любой, кто может открыть соединение с этим портом, может внедрить заявки, которые появятся в рабочем списке. Держите его в доверенном клиническом сегменте и закройте брандмауэром.
• Обезличивание не трогает пиксели. См. эту службу ниже: впечатанные в изображение данные пациента переживают любой профиль.

6. Службы, одна за другой

Всё, что открывает порт, поставляется выключенным. Правильный вопрос не «что оно умеет?», а «что должна делать эта машина?». Каждая включённая служба — это ещё один открытый порт. Индекс ниже — единственное исключение: он запускается сам, потому что это локальный кеш sqlite, который ничего не слушает.

У каждой службы один выключатель. Пуск на её карточке запускает её и оставляет включённой после перезапуска; Стоп сначала спрашивает, затем останавливает её и оставляет выключенной. В Конфигурация → Настройки тот же выключатель — это флажок Запускать эту службу (и при старте), поэтому карточка и настройка никогда не расходятся. Сохранение настроек перезапускает только те службы, чьи собственные настройки изменились, и панель говорит, какие именно.

Приём — Storage SCP

Порт 11112 · C-STORE, C-ECHO

Что делает

Принимает исследования, которые присылают аппараты, и раскладывает их на диск — при желании по схеме пациент / исследование / серия. Он принимает все синтаксисы передачи и сохраняет сжатые объекты как есть — без перекодирования, поэтому по пути внутрь ничего не меняется.

Включайте, когда

Сюда что-либо должно отправлять изображения: аппараты, другой PACS, рабочая станция. Это основная служба.

Оставьте выключенным, когда

Эта машина только пересылает то, что кто-то другой кладёт в папку.

Автоотправка — Storage SCU и правила маршрутизации

Исходящий клиент · C-STORE

Что делает

Наблюдает за папкой и пересылает каждый новый файл на те назначения, которые подходят. Файл уходит, только когда он стабилен (размер не изменился между двумя сканированиями), поэтому недописанный файл никогда не пересылается. Прогресс отслеживается по каждому назначению: файл считается обработанным, только когда его приняло каждое включённое назначение, а отправка на недоступные узлы повторяется на следующем сканировании. При успехе оригинал можно оставить, переместить или удалить.

Правила

При включённой маршрутизации правило выбирает назначения по модальности, вызывающему AE title, станции, ID пациента или описанию исследования (шаблоны * и ?, без учёта регистра). Например: CT из ER_* — в учебный архив, обезличенно.

Гарантия

Исследование никогда не может остаться неотправленным. Маршрутизация выключена, ни одно правило не совпало, заголовок не читается, правило называет назначение, которого больше нет, — в каждом из этих случаев файл уходит на все включённые назначения. Лишняя отправка раздражает оператора; недостаточная теряет изображение.

Единственное исключение

Правило, которое требует обезличивания для назначения, когда очистку выполнить нельзя, удерживает это назначение: ему не отправляется ничего, вместо того чтобы отправить с данными пациента. Очистке мешают две вещи — профиль в состоянии off или профиль включён, но из настроек не удаётся построить деидентификатор, — и исправляются они по-разному. Ничего не теряется ни в том, ни в другом случае; см. Обезличивание при пересылке ниже.

Включайте, когда

Эта машина должна доставлять изображения дальше: в центральный PACS, на рабочую станцию врача или копиями в учебный архив.

Зарегистрированные модальности

Без порта · Конфигурация → Модальности

Что делает

Список кабинетов, которые обслуживает этот узел: имя, понятное человеку, AE title станции, который рабочий список сверяет посимвольно, код модальности и, если нужно, имя станции. Это не список разрешений: аппарату не обязательно быть здесь, чтобы отправлять снимки, и его присутствие здесь ничего ему не разрешает. Выигрыш в том, что адресат заявки выбирается из списка, а не набирается руками, и что именно отсюда проверка рабочего списка одалживает AE title.

Заполняйте, когда

Вы раздаёте рабочий список или вводите заявки вручную. Пока не зарегистрирована ни одна станция, адресат заявки набирается руками, и опечатку нечем поймать.

Проверка рабочего списка — спросить чужую РИС

Исходящий клиент · C-FIND рабочего списка · Конфигурация → Модальности

Что делает

Отвечает на вопрос «почему этот аппарат не видит свой список», не трогая сам аппарат. Задайте адрес настоящей больничной РИС — или её брокера — в Настройках и нажмите Проверить рабочий список в строке модальности: Carino задаёт этой РИС тот вопрос, который задала бы сама модальность, её же AE title, и складывает каждый ответ в Активность → Проверки рабочего списка. Один прогон задаёт один и тот же вопрос пять раз, снимая по одному ключу — станция, дата и модальность; затем без модальности; без даты; без станции, — потому что место неисправности показывает именно разница между ответами. Не вернулось ничего ни на один — у чужой РИС попросту нет записей; пустым вернулся только самый узкий — неверен AE title станции.

Прежде чем нажать

Сначала снимите модальность с сети. Проверка обращается как эта модальность, а две вещи, отвечающие на один AE title в одной РИС, — это путаница, которую потом придётся идти и разбирать.

Чего не делает

Это не служба, не расписание и не очередь. Во вкладке Проверки рабочего списка лежит запись о том, что ответил кто-то другой: эти заявки никогда не раздаются в собственном рабочем списке этого узла, и он ни на одну из них не претендует. Очистить опустошает эту запись и только её.

Аварийная РИС — заявки HL7

Порт 2575 · HL7 ORM^O01 поверх MLLP

Что делает

Принимает заявки HL7 по MLLP, а также позволяет вводить их вручную в панели, когда выше по цепочке ничего живого не осталось. Когда исследование возвращается по C-STORE, оно сопоставляется со своей заявкой по номеру исследования (запасной вариант — ID пациента), и заявка закрывается и уходит в архив для аудита — но не стирается.

Включайте, когда

РИС недоступна или вы проверяете интеграцию.

Что гарантирует

Доставка изображений никогда не зависит от совпадения с заявкой. Исследование без подходящей заявки всё равно сохраняется и пересылается; заявка просто остаётся открытой для ручного сопоставления.

Ни TLS, ни учётных данных. См. раздел о безопасности: любой, кто может открыть сокет на этот порт, может внедрить заявки. Доверенная клиническая сеть и брандмауэр — или совсем не включать.

Виртуальная печать

Порт 11113 · DICOM Print, вывод в PDF или Secondary Capture

Что делает

Представляется принтером DICOM (по умолчанию AE title CARINOPRINT) и захватывает каждый присланный лист плёнки. Для оборудования, единственный вывод которого — плёнка, это способ сохранить хоть что-то, что можно подшить. Надёжных данных пациента плёнка не несёт, поэтому каждая ждёт в Ожидают, пока человек её не идентифицирует; ничего напечатанное само дальше не уходит.

Включайте, когда

У вас есть аппарат, умеющий только печатать, чей вывод вы хотите спасти. Шаги — в Как сделать… печать.

Настройки

В Конфигурация → Настройки → Печать: AE title и порт, Принимать только эти AE (аппараты, которым разрешено печатать; пусто — любые), Принимать также цветные задания печати и Сохранять каждую снятую плёнку как PDF или изображение. Выбирайте изображение, когда принимающий PACS или просмотрщик не показывает PDF, — а многие не показывают.

Как понять, что работает

Отправить тестовую печать на карточке прогоняет через приём целое задание печати и кладёт в Ожидают лист с пометкой «TEST PRINT — safe to discard». После настоящего задания карточка показывает Последняя печать (сколько плёнок, с какого AE и адреса) и счётчик Захвачено. Отказ или сбой показывается как Последняя проблема; см. таблицу неполадок печати.

Что допускает

Аппараты, оставляющие номера сеанса плёнки и плёночного листа принтеру, Presentation LUT (принимается и игнорируется) и AE title принтера, набранный на аппарате иначе: вызываемый AE не проверяется.

Веб-панель

Порт 8042 · HTTP, по умолчанию 127.0.0.1

Что делает

Состояние каждой службы, назначения, заявки, живой журнал активности, настройки и встроенный редактор DICOM. Всё, что делает панель, есть и в CLI.

Как ориентироваться

В боковой панели шесть разделов: Обзор, Службы, Исследований, Заявки, Конфигурация и Активность — и седьмой, Тестовый узел, только в процессе, запущенном с --dev-peer. Три вопроса, задаваемые одной и той же куче файлов, — это вкладки раздела Исследований: История, Ожидают и Застряли; то, что задаётся при вводе машины в работу, — это вкладки Конфигурации: Назначения, Маршруты, Настройки, Модальности и Люди, и открывается она на Назначениях, а не на Настройках; а записи — это вкладки Активности: Журнал, Подключения, Аудит и Проверки рабочего списка. Подключения перечисляют недавние DICOM-подключения в обе стороны и говорят, почему одно из них не удалось и что изменить, на какой машине; кнопка Что принимает в строке назначения спрашивает этот узел о каждом типе изображений, хранящемся здесь. Проверки рабочего списка — то, что ответила чужая РИС, когда этот узел спросил её как одну из ваших модальностей. У Заявок своя полоса открытых и закрытых. Раздел Исследований несёт два счётчика, которые сами по себе являются кнопками, 📎 ожидающих и ⚠ застрявших, и каждый открывает свою вкладку: поэтому попасть в Застряли — один клик, пока что-то застряло, и два (раздел, затем вкладка), когда не застряло ничего, потому что нулевой счётчик прячется. Счётчик, постоянно показывающий 0, — это вечно включённая сигнализация, а на такие никто не смотрит. У Заявок свой счётчик на тех же условиях. У каждой панели и вкладки есть свой адрес — #studies/stuck, #configuration/routing, #activity/logs, — поэтому место в панели можно занести в закладки, продиктовать по телефону во время аварии и покинуть кнопкой «Назад» в браузере; старые ссылки вида #dlgStuck по-прежнему работают. Обзор — единственное исключение: он откликается на #overview, если его набрать, но никогда не пишется в адресную строку и не оставляет записи в истории, потому что он печатает имя пациента, а оставленный без присмотра экран не должен возвращаться к нему после перезагрузки.

Индикаторы служб в шапке

Индикаторы служб вдоль верхнего края не меняются для тех, кому можно запускать и останавливать службы. Профиль без services.control по-прежнему их видит — как индикаторы, — но они неактивны: состояние службы не является привилегированным (регистратура должна видеть, что приём не работает), а переключатель, который сервер всё равно отклонит, предлагать незачем.

Уводите с петлевого адреса, когда

Только при конкретной причине — и тогда с токеном (обязательно) и с HTTPS впереди. См. правило токена.

7. Это не медицинское изделие

Сказано прямо, потому что это полезнее сноски:

• Если вы его разворачиваете, валидация — ваша. Соответствие нормативным требованиям, оценка рисков, защита данных и клиническая ответственность лежат на организации, которая вводит его в эксплуатацию, а не на проекте.
• Он распространяется без каких-либо гарантий, как и сказано в его лицензии AGPL-3.0.
• Он не заменяет ни ваш PACS, ни вашу РИС. Он — шлюз между ними и то, что позволяет отделению работать во время аварии, пока они не вернутся.
• И всё же относитесь к нему как к клинической инфраструктуре. То, что он не медицинское изделие, не делает его безобидным: он перемещает данные пациентов. Шифрование тома, брандмауэр, TLS, токен и резервные копии обязательны.
• Если от него зависит помощь пациенту, ответственность за это ваша, а не этой программы.

Всё это не пессимизм. Проект всерьёз исходит из того, что изображение, которое молча так и не пришло, хуже, чем сбой, — поэтому он скорее откажется запускаться, будет явно считать неудавшиеся подоперации и отправит лишнее, чем недоотправит. Он придерживает доставку ровно в одном случае, громко и обратимо: назначение, для которого правило требует обезличивания, когда обещанную очистку выполнить нельзя, — потому что профиль выключен или потому что профиль включён, но деидентификатор построить не удалось. И он говорит, что именно из двух, потому что чинятся они по-разному. Но программа может отвечать только за то, что делает сама; остальное — на вас.

8. Лицензия и где получить помощь

Carino DICOM выпускается под AGPL-3.0-or-later. Поскольку это сетевой сервер, применяется §13: если вы запускаете изменённую версию как сервис, вы обязаны предложить её исходный код тем, кто им пользуется. Сохраняйте файл LICENSE и ссылку на исходный код при любом изменённом развёртывании.

• Исходный код и трекер задач на GitHub
• Политика безопасности — что защищено, что нет и как сообщить об уязвимости
• Как внести вклад

Нашли ошибку в этом руководстве — или перевод, который врач-рентгенолог никогда не произнёс бы? Заведите issue. Руководства на русском, испанском, португальском и японском — часть проекта, а не дополнение.

Carino DICOM · главная страница · часть мастерской carino.systems · AGPL-3.0-or-later.