Manual do Carino DICOM

Receptor — Storage SCP

Porta 11112 · C-STORE, C-ECHO

O que faz

Aceita estudos enviados pelas modalidades e grava em disco, opcionalmente organizados por Paciente / Estudo / Série. Aceita todas as sintaxes de transferência e guarda o que vem comprimido como está: não há transcodificação, então nenhum dado é alterado na entrada.

Quando ligar

Sempre que algo precisar enviar imagens para cá: modalidades, outro PACS, uma estação. É o serviço central.

Quando não

Se esta máquina só encaminha o que outra deixa numa pasta.

Encaminhamento automático — Storage SCU e regras de roteamento

Cliente de saída · C-STORE

O que faz

Monitora uma pasta e encaminha cada arquivo novo para os destinos que couberem. Um arquivo só é enviado quando está estável (o tamanho não mudou entre duas varreduras), então nunca se encaminha arquivo pela metade. O progresso é registrado por destino: só conta como concluído quando todos os destinos habilitados aceitaram, e os que falharam são repetidos na varredura seguinte. Ao concluir, o original pode ser mantido, movido ou excluído.

Regras

Com roteamento ligado, uma regra decide os destinos por modalidade, AE title de origem, estação, ID do paciente ou descrição do estudo (curingas * e ?, sem diferenciar maiúsculas). Exemplo: TC vinda de ER_* para o arquivo de ensino, anonimizada.

A garantia

Um estudo nunca pode ficar sem destino. Se o roteamento estiver desligado, se nenhuma regra casar, se o cabeçalho não puder ser lido ou se uma regra citar um destino que não existe mais, o arquivo vai para todos os destinos habilitados. Enviar demais incomoda o operador; enviar de menos perde uma imagem.

A única exceção

Uma regra que pede anonimização para um destino, quando a limpeza não pode de fato ser feita, deixa aquele destino retido: nada é enviado a ele, em vez de mandar o estudo identificado. Duas coisas impedem a limpeza — o perfil estar em off, ou o perfil estar ligado e nenhum anonimizador poder ser construído com as configurações atuais — e elas se resolvem de maneiras diferentes. Nos dois casos nada se perde; veja Anonimização no encaminhamento abaixo.

Quando ligar

Quando esta máquina tiver que entregar imagens a outro sistema: encaminhar ao PACS central, alimentar uma estação de laudo, mandar cópias para um arquivo de ensino.

A aba tem ainda uma terceira seção, Sem destino para tentar, que esta captura não mostra porque este equipamento não tem nenhum caso: são os arquivos encaminhados a um nome que deixou de ser um destino habilitado — apagado ou desligado na aba Destinos depois de a rota já ter sido decidida. Não sobrou nó para discar, então nada os tenta de novo e nenhum relógio corre a favor deles; o remédio também é outro, restaurar um destino com o mesmo nome. Cada linha diz o que será dos arquivos, e a distinção importa: uma cópia que a retenção e encaminhamento já prometeu àquele nó espera indefinidamente na pasta de saída, sem ser arquivada nem apagada, enquanto uma que ninguém prometeu é reencaminhada na varredura seguinte sem aquele nome e então arquivada ou apagada conforme o seu Ao enviar, sem nunca ter chegado lá — restaurar o nó só ajuda antes dessa varredura.

Anonimização no encaminhamento

Perfil PS3.15 Anexo E · aplicado só à cópia que sai

O que faz

Aplica o Basic Application Level Confidentiality Profile ao objeto enviado, declarando em (0012,0064) exatamente quais opções de retenção foram usadas, para que quem recebe possa conferir o que foi mantido. O original arquivado nunca é reescrito: essa assimetria é a ideia inteira.

Perfis

basic mantém datas (completas ou deslocadas), características do paciente, identidade do equipamento e da instituição. strict remove identidade de equipamento e instituição e apaga atributos privados mesmo que você peça para manter.

Quando ligar

Quando as imagens saírem do ambiente clínico: ensino, pesquisa, um fornecedor, uma segunda opinião externa.

Ao desligar

O perfil decide se alguma limpeza acontece; a marcação anonimizar de uma regra decide quais destinos recebem a cópia limpa. Se você puser o perfil em off enquanto uma regra continua pedindo, o Carino retém aquele destino em vez de mandar uma cópia identificada para um nó cujo responsável acredita não receber nenhuma.

Índice

sqlite · index.db

O que faz

Mantém uma linha por arquivo armazenado e deriva dali as respostas de paciente, estudo e série, para que o resumo de um estudo nunca fique fora de sincronia com as instâncias que ele resume. É a camada de consulta por baixo do Query/Retrieve e do DICOMweb.

Quando ligar

Sempre que usar Query/Retrieve ou DICOMweb. É a única dependência dos dois.

O que ele garante

O índice é cache, nunca a fonte da verdade. Perdê-lo custa uma nova varredura, nunca uma imagem.

Query/Retrieve — C-FIND, C-MOVE, C-GET

Porta 11115 · Patient Root e Study Root

O que faz

Permite que outro sistema pergunte «quais estudos você tem deste paciente?» e depois «manda para mim / para aquela estação». É a metade do PACS com a qual o equipamento antigo consegue conversar: um ultrassom de 2009 ou um digitalizador de CR nunca vão falar DICOMweb, mas falam DIMSE.

Quando ligar

Quando estações ou modalidades precisarem puxar estudos daqui, ou quando você estiver servindo de arquivo temporário durante uma queda do PACS principal.

O que ele garante

Um C-MOVE nunca inventa a lista de instâncias: resolve pelo índice. O que o índice conhece mas não pode ser lido do disco é contado como sub-operação falha e nomeado na lista de UIDs que falharam. Nunca é descontado em silêncio: um C-MOVE que reporta sucesso enviando menos imagens do que encontrou é a pior falha possível deste software.

DICOMweb — QIDO-RS, WADO-RS, STOW-RS

HTTP, sob /dicom-web na porta do painel

O que faz

Deixa visualizadores modernos (OHIF, Weasis e afins) consultarem, baixarem e enviarem estudos por HTTP sem negociar uma associação DICOM. O que entra por STOW-RS passa pelo mesmo arquivamento de um C-STORE, então um estudo enviado por um visualizador é indistinguível de um enviado por uma modalidade.

Quando ligar

Quando quiser plugar um visualizador web no acervo. Lembre que o token também protege essas rotas.

CORS

cors_origins é comparado de forma exata (esquema + host + porta) e vem vazio, então nada é devolvido a uma origem que não esteja na lista. Não há sintaxe de curinga, mas um * literal é respeitado, e só porque você o digitou: dali em diante toda origem é refletida e qualquer página que o operador visite poderia ler o acervo desta máquina. Prefira nomear o visualizador.

O que ele não faz

/rendered, /thumbnail, URIs de bulkdata e conversão entre sintaxes de transferência não estão implementados e respondem 406. Um visualizador pela metade é pior que um recurso ausente: o que não pode ser produzido não é fingido.

Modality Worklist (MWL)

Porta 11114 · C-FIND de worklist

O que faz

Serve os pedidos às modalidades para o técnico não digitar os dados do paciente à mão. Cada pedido carrega um Study Instance UID pré-gerado que é gravado no exame, de modo que o estudo devolvido pela modalidade concilia exatamente com o pedido. O campo AE de destino direciona um pedido para uma estação específica; em branco, todas enxergam.

Quando ligar

Quando o RIS não chega até as modalidades: porque caiu, porque o destino simplesmente não tem RIS, ou para testar um fluxo RIS→PACS sem um RIS de verdade.

Modalidades registradas

Sem porta · Configuração → Modalidades

O que faz

A lista de salas que este equipamento atende: um nome que uma pessoa reconhece, o AE title da estação que a worklist compara exatamente, o código de modalidade e, se você quiser, o nome da estação. Não é uma lista de permissões: um aparelho não precisa estar aqui para enviar imagens, e estar aqui também não o autoriza. O que se ganha é que o destino de um pedido passa a ser escolhido numa lista em vez de digitado, e é dela que a sonda de worklist toma emprestado um AE title.

Preencha quando

Você serve a worklist ou digita pedidos à mão. Enquanto não houver nenhuma estação registrada, o destino de um pedido é digitado e um erro de digitação não tem como ser pego.

Sonda de worklist — perguntar ao outro RIS

Cliente de saída · C-FIND de worklist · Configuração → Modalidades

O que faz

Responde “por que este aparelho não está vendo a lista dele?” sem encostar no aparelho. Dê um endereço ao RIS real do hospital — ou ao broker dele — em Configurações e aperte Testar worklist na linha de uma modalidade: o Carino faz àquele RIS a pergunta que aquela modalidade faria, usando o AE title dela mesma, e arquiva cada resposta em Atividade → Capturados. Uma execução faz a mesma pergunta cinco vezes, alargando uma chave por vez — estação, data e modalidade; depois sem a modalidade; sem a data; sem a estação — porque o que localiza a falha é a diferença entre as respostas. Se nada volta em nenhuma delas, o outro RIS não tem nada agendado; se só a mais estreita volta vazia, o que está errado é o AE title da estação.

Antes de apertar

Tire a modalidade da rede primeiro. A sonda chama como aquela modalidade, e duas coisas atendendo pelo mesmo AE title num mesmo RIS é uma confusão que alguém depois tem que ir desfazer.

O que não é

Não é serviço, não é agenda e não é fila. O que fica em Capturados é o registro do que outro respondeu: esses pedidos nunca são servidos na worklist deste equipamento, que não reivindica nenhum deles. Limpar esvazia esse registro e nada mais.

RIS de emergência — pedidos HL7

Porta 2575 · HL7 ORM^O01 sobre MLLP

O que faz

Recebe pedidos HL7 por MLLP e também permite digitá-los à mão no painel quando não sobrou nada vivo do lado de cima. Quando o estudo volta por C-STORE, ele é conciliado com o pedido pelo accession number (com o ID do paciente como reserva) e o pedido é fechado e arquivado para a trilha — nunca apagado.

Quando ligar

Durante uma queda do RIS, ou em testes de integração.

O que ele garante

A entrega das imagens nunca depende de existir um pedido. Um estudo sem pedido correspondente é armazenado e encaminhado do mesmo jeito; o pedido apenas fica em aberto para conciliação manual.

Failover de emergência

Vigilância por C-ECHO do PACS marcado como principal

O que faz

Marque um destino como principal e arme o monitor: o Carino faz C-ECHO periodicamente e observa as falhas de encaminhamento. Se ele seguir inalcançável além do limite, você recebe o aviso e a oferta de ativar o RIS de emergência. Ao ativar, sobe a worklist local para os técnicos continuarem examinando, segura o que chega durante a queda e encaminha automaticamente quando o principal volta. Você decide quando voltar ao normal.

Quando ligar

Na máquina que faz de gateway para um PACS do qual você depende. É por isso que a palavra «continuidade» aparece na primeira linha deste manual.

Avisos — webhook e e-mail

Só de saída · webhook HTTP, SMTP

O que faz

Alcança quem não está com o painel aberto. O aviso na tela basta para quem está olhando um envio e não serve para o caso que justifica isto: o principal cai às 03:00 e o radiologista de plantão não está diante de tela nenhuma. Dois canais, independentes um do outro, os dois mortos enquanto a chave geral estiver desligada.

O que envia

Só eventos de failover: disparado, ativado, resolvido. Nenhuma outra parte do equipamento gera aviso. Isto não é um sistema de alertas geral e não vira um só por ser ligado.

Quem recebe o e-mail

Perfis, não endereços. A mensagem vai para cada perfil ativo que o failover esteja configurado para avisar e que tenha um endereço de e-mail preenchido. Com SMTP configurado e nenhum endereço em perfil nenhum não sai nada, e sem barulho: é a primeira coisa a conferir quando “o e-mail está ligado e ninguém foi avisado”. O texto muda conforme o papel de cada um, e o endereço do destino que falhou só aparece para quem já pode ver a tabela de destinos: um e-mail sai do prédio e não tem como ser recolhido.

O que nunca vai fazer

Atrasar ou quebrar aquilo que está reportando. Cada envio é entregue a uma thread separada, a fila tem teto — o mais antigo é descartado e o descarte é contado, porque um “o principal caiu” entregue depois da recuperação é pior que o silêncio — e uma falha vira um contador e uma linha de registro, não uma exceção. Enviados, falhados, descartados, na fila e o último erro são todos legíveis, então “ligado e nunca entregou nada” aparece antes da queda que depende disso. Teste numa tarde tranquila, não durante uma.

Impressão virtual

Porta 11113 · DICOM Print, saída em PDF

O que faz

Se apresenta como uma impressora DICOM e captura em PDF o que mandarem. Para equipamentos cuja única saída é o filme, é a forma de guardar algo arquivável.

Quando ligar

Quando você tiver uma modalidade que só sabe imprimir e quiser resgatar o resultado dela.

Painel web

Porta 8042 · HTTP, 127.0.0.1 por padrão

O que faz

Estado de cada serviço, destinos, pedidos, registro de atividade ao vivo, configurações e um editor DICOM embutido. Tudo o que o painel faz também existe na CLI.

Como se navega

A lateral tem seis linhas: Resumo, Serviços, Estudos, Pedidos, Configuração e Atividade — e uma sétima, Nó de teste, só em um processo iniciado com --dev-peer. As três perguntas que se fazem sobre o mesmo monte de arquivos são as abas de Estudos — Histórico, Pendentes e Travados; o que se ajusta ao comissionar o equipamento são as abas de Configuração — Destinos, Rotas, Configurações, Modalidades e Pessoas, e ela abre em Destinos, não em Configurações; e os três registros são as abas de Atividade — Registro, Auditoria e Capturados, esta última o que outro RIS respondeu quando este equipamento perguntou a ele como uma das suas modalidades. Pedidos mantém a própria faixa de abertos e fechados. A linha Estudos carrega dois contadores que são botões, 📎 pendentes e ⚠ travados, e cada um abre a sua aba direto, então chegar aos travados é um clique enquanto houver algo travado: um contador em zero fica escondido, porque um contador que marca 0 é um alarme sempre ligado, e sem ele o caminho é o de sempre — a linha, depois a aba, dois cliques. Pedidos tem o seu próprio contador. Cada painel e cada aba tem endereço na URL — #studies/stuck, #configuration/routing, #activity/logs —, então um lugar do painel pode ir para os favoritos e ser ditado por telefone durante uma queda, que é por que esses endereços são palavras e não ids de elemento; o botão «voltar» do navegador funciona e os endereços antigos no estilo #dlgStuck continuam resolvendo. Resumo é a exceção: ele atende por #overview se você digitar, mas nunca é escrito na barra de endereços nem deixa entrada no histórico, porque imprime o nome de um paciente e uma tela sem ninguém na frente não pode voltar sozinha para ele depois de um recarregamento.

Os chips do cabeçalho

Os chips de serviço no alto continuam iguais para quem pode iniciar e parar serviços. Um perfil que não pode continua enxergando-os como indicadores, mas desabilitados: o estado de um serviço não é informação privilegiada, e a recepção precisa ver um receptor morto sem receber um interruptor que o servidor recusaria.

Quando tirar do loopback

Só com um motivo concreto — e então com token obrigatório e HTTPS na frente. Veja a regra do token.

O nó de teste — um segundo arquivo descartável

Só loopback · pacs serve --dev-peer · nunca em uma versão distribuída

O que faz

Cria um segundo arquivo completo dentro deste mesmo processo, apenas em 127.0.0.1, com AE title próprio, portas próprias de recepção e de Query/Retrieve e armazenamento próprio em uma pasta temporária — e deixa neste equipamento um destino já apontado para ele. É um lugar de verdade para um estudo ir enquanto você comprova que o encaminhamento, uma regra de roteamento, a anonimização no encaminhamento ou um C-MOVE fazem o que você acha que fazem. Ao lado dele é criado um destino “buraco negro” desativado: ative-o e os envios falham de propósito, que é como se enche a aba de travados na hora que você quiser e se vê a cara de um travamento antes que ele aconteça de verdade.

Como abrir um

Suba o motor com pacs serve --dev-peer — ele avisa na linha abaixo da URL do painel —, escolha 🧪 Nó de teste na lateral e aperte Criar nó. O painel passa a mostrar o AE title dele, as duas portas, a pasta e o que já recebeu. Sem esse parâmetro a linha não existe, a API responde 404 e nenhuma configuração do config.json a traz de volta. Isso é proposital: uma configuração pode ser mudada por qualquer um que tenha o token do painel, e um parâmetro de inicialização não é alcançável por HTTP.

Quem pode

Um perfil com permissão para criar e descartar o arquivo de teste descartável. Entre os perfis de fábrica, isso é TI e um administrador: provar onde um encaminhamento está morrendo é trabalho de bancada. A recepção e o radiologista não têm, porque um segundo arquivo é ferramenta de bancada, não clínica. Criar e descartar ficam os dois escritos na auditoria.

O que acontece com o que ele guardou

Vai tudo embora — a pasta e as duas linhas de destino deste equipamento — quando você aperta Descartar, quando o processo para e na próxima inicialização depois de uma queda ou de falta de luz. Nada sobrevive, que é exatamente o motivo de usar isto em vez de escrever à mão uma segunda configuração e esquecer a pasta. Uma coisa a esperar: se você descartar com envios ainda na fila contra ele, esses envios ficam sem para onde tentar de novo; limpe-os em Estudos → Travados.