Hub analítico · motor de regras
Anatomia de um motor de regras
Toda a automação deste hub — autoverificação, repetição, diluição, reflexo, alerta — é a mesma peça de software aplicada a condições diferentes. Vale entender essa peça, porque a escolha entre regra declarativa configurável e código escrito para cada caso decide se o laboratório depende do fornecedor para mudar um critério técnico.
01As quatro partes de uma regra
| Parte | A pergunta | Exemplo de conteúdo |
|---|---|---|
| Escopo | a que isto se aplica? | todos os resultados, ou só de um setor, exame, parâmetro ou grupo |
| Condição | quando isto vale? | uma ou mais comparações sobre campos avaliáveis |
| Ação | o que fazer? | conferir, reter, repetir, diluir, pedir reflexo, alertar, comentar |
| Metadados | quem respondeu por isto? | ordem, estado, versão, autor, aprovação, comentário |
02O vocabulário avaliável
Este é o ponto que decide o alcance do motor: quais campos a condição consegue ler. Um motor que lê três campos só pode escrever regras sobre três coisas, independentemente de quão elegante seja o resto.
| Campo | O que permite escrever | Sem ele, o que não dá para automatizar |
|---|---|---|
| Classificação do valor | normal, alterado, crítico, fora de faixa | praticamente nada — é o campo mínimo |
| Valor numérico e faixa | comparações diretas com limites | regras finas, específicas de um analito |
| Delta em relação ao anterior | salto absoluto ou percentual | proteção contra troca de amostra |
| Estado do controle de qualidade | bloqueio quando o CQ do período não passou | o bloqueio mais importante de todos |
| Flags do equipamento | respeitar o que a máquina sinalizou | a informação da própria medição fica inerte |
| Índices de interferência | decidir por hemólise, icterícia, lipemia | regra de interferente, e todo o elo com o pré-analítico |
| Coerência entre analitos | comparar dois resultados da mesma amostra | detecção de incoerência interna |
| Atributos do paciente | idade, sexo, gestação, contexto declarado | regra pediátrica, obstétrica, ou qualquer segmentação |
| Equipamento e método | regra específica de plataforma | tratar diferente o que foi medido diferente |
| Origem e prioridade | regra distinta para urgência ou unidade | política diferenciada por contexto de atendimento |
O sintoma de um vocabulário curto: o sistema captura flags e interferentes — eles estão gravados, aparecem na tela — mas a condição da regra não consegue lê-los. O dado existe e é invisível para a automação. É a lacuna mais comum, porque captura e avaliação são construídas em momentos diferentes e ninguém volta para conectar as duas.
03Escopo
Escopo é o que impede que uma regra escrita para um analito se aplique a todos. Quanto mais níveis de escopo, mais fina a política — e mais fácil ligar uma regra sem susto.
Global
Vale para tudo. Útil para bloqueios universais — CQ reprovado, valor impossível.
Por setor
Permite política diferente entre hematologia e bioquímica, que têm naturezas distintas.
Por exame ou parâmetro
O nível onde vive a maior parte das regras úteis, porque o critério técnico é por analito.
Por grupo
Um conjunto nomeado de exames, para escrever a regra uma vez e aplicar a muitos sem repetir.
04Ordem e conflito
Duas regras podem casar no mesmo resultado e pedir coisas opostas: uma libera, outra retém. O motor precisa ter uma resposta previsível — e a previsibilidade importa mais que a esperteza.
| Estratégia | Como funciona | Consequência |
|---|---|---|
| Primeira que casar | avalia em ordem e para na primeira | simples e previsível; exige disciplina na ordem |
| Todas, ação mais restritiva vence | avalia tudo e aplica a ação mais conservadora | seguro por padrão; pode reter demais |
| Por prioridade declarada | cada regra tem peso; o maior vence | flexível; fica difícil prever o efeito de uma regra nova |
| Acumulativa | ações compatíveis se somam (reter + comentar) | expressiva; exige definir quais ações são compatíveis |
Guarde: qualquer das quatro serve, desde que a pessoa que escreve a regra saiba qual é e possa simular o resultado antes de ligar. Um motor sem simulação obriga a descobrir o efeito das regras em produção, com resultados de pacientes reais.
05As ações
O repertório de ações define o que a automação pode fazer. Sete cobrem a rotina de um laboratório clínico.
| Ação | O que faz | Quem toca no resultado depois |
|---|---|---|
| Conferir automaticamente | marca como tecnicamente em ordem | ninguém — segue para validação clínica |
| Reter | para o resultado e exige decisão humana | quem tem competência para decidir |
| Repetir | solicita nova medição da mesma amostra | a bancada, ao executar |
| Diluir | solicita nova medição com fator | a bancada |
| Pedir reflexo | acrescenta outro exame ao pedido | depende da autorização |
| Alertar | gera notificação sem parar o fluxo | quem recebe o alerta |
| Comentar | anexa texto ao resultado, com ou sem saída no laudo | ninguém, se for só ressalva |
A ação que costuma faltar: alertar sem parar. Muitos motores só sabem liberar ou reter, e isso força uma escolha ruim: ou o caso passa sem ninguém saber, ou ele para a entrega. O alerta sem bloqueio cobre a faixa do meio — “siga, mas alguém precisa ver isso” — que é onde mora a maior parte dos achados realmente úteis.
06Declarativo ou código
| Aspecto | Regra declarativa | Código por caso |
|---|---|---|
| Quem altera | o responsável técnico, na tela | quem desenvolve o sistema |
| Prazo de uma mudança | minutos | o ciclo de entrega do fornecedor |
| Auditoria | versão e autor por construção | precisa ser construída à parte |
| Expressividade | limitada ao vocabulário do motor | ilimitada |
| Risco de erro grave | contido pelo formato e pela simulação | alto, e nem sempre visível antes |
| Onde cada um cabe | a esmagadora maioria das regras de rotina | o caso raro e genuinamente complexo |
Guarde: o critério de decisão não é elegância: é de quem é a caneta. Critério técnico de liberação é responsabilidade do responsável técnico do laboratório. Um sistema que exige um chamado para mudar um limiar transferiu essa caneta para o fornecedor — e isso não é uma escolha de arquitetura, é uma troca de responsável.
Resumo do guia: escopo, condição, ação e metadados; o alcance do motor é o tamanho do seu vocabulário avaliável, e a lacuna típica é capturar flags que a regra não lê; escopo nasce estreito; conflito precisa de resposta previsível e de simulação; falta quase sempre a ação de alertar sem parar; e regra declarativa mantém a caneta com quem responde tecnicamente. Uma dessas condições merece guia próprio: o controle de qualidade da corrida.
Ver o CQ dentro da corrida →Continue no hub de processamento analítico