Hub analítico · vocabulário
Pedido, teste, analito, resultado
Dez palavras que a conversa do laboratório usa de forma intercambiável e que, num sistema, são dez entidades com cardinalidades diferentes. Um perfil lipídico é um item no pedido, três dosagens no equipamento e um quarto valor que ninguém mediu — e o modelo precisa saber disso antes da primeira tela.
01As dez entidades
| Entidade | O que é | Exemplo |
|---|---|---|
| Atendimento | a visita do paciente, num dia, com um número | atendimento 88213 |
| Pedido | a requisição médica registrada | a receita que o paciente trouxe |
| Exame solicitado | cada item do pedido, no vocabulário comercial | “Perfil lipídico” |
| Painel ou perfil | um item que se decompõe em vários testes | perfil lipídico, hemograma, função tireoidiana |
| Teste analítico | a medição concreta que alguém executa | dosagem de colesterol total |
| Analito | a substância medida | colesterol |
| Método | a técnica usada para medir | enzimático colorimétrico |
| Equipamento | o instrumento onde a medição acontece | o analisador da bioquímica |
| Amostra | o material em que se mede | o tubo de soro daquele atendimento |
| Resultado | o valor produzido, com unidade e classificação | 196 mg/dL, normal |
A distinção que mais custa quando falta: exame solicitado × teste analítico. O primeiro é o que o médico pediu e o que o convênio paga; o segundo é o que o equipamento executa. Modelar só o primeiro impede saber em qual analisador cada dosagem rodou; modelar só o segundo quebra o faturamento e o laudo. Os dois precisam existir, com uma relação entre eles.
02O perfil lipídico, decomposto
O exemplo que torna a diferença concreta. Um item no pedido, três medições e um valor que ninguém mediu — foi calculado a partir dos outros três.
| Colesterol total | HDL | Triglicerídeos | LDL | |
|---|---|---|---|---|
| Origem | medido | medido | medido | calculado |
| Tem equipamento? | sim | sim | sim | não |
| Tem método? | sim | sim | sim | a fórmula é o método |
| Pode ser repetido sozinho? | sim | sim | sim | não — recalcula quando as fontes mudam |
| Depende de outro resultado? | não | não | não | dos três anteriores |
| Se uma fonte for retificada | independente | independente | independente | precisa ser recalculado e também retificado |
A armadilha do recálculo: se o triglicerídeo for repetido e mudar, o LDL está errado a partir daquele instante — e, se o laudo já saiu, ele precisa ser retificado junto. Sistemas que guardam o calculado como um número solto, sem registrar de quais resultados ele veio, não conseguem nem detectar isso.
03As cardinalidades
Onde os modelos ingênuos quebram: quase nenhuma dessas relações é de um para um.
| Relação | Cardinalidade | Por quê |
|---|---|---|
| Pedido → exame solicitado | 1 : N | um pedido tem vários itens |
| Exame solicitado → teste analítico | 1 : N | um painel vira várias medições |
| Teste analítico → amostra | N : 1 | vários testes rodam na mesma amostra |
| Amostra → teste analítico | 1 : N | a recíproca: um tubo atende vários testes |
| Teste analítico → resultado | 1 : N | cada repetição e cada diluição produz um resultado; o último é o vigente |
| Resultado → resultado | N : N | resultados calculados dependem de outros resultados |
| Teste analítico → equipamento | N : 1 por execução | mas pode mudar de equipamento entre uma execução e outra |
| Exame solicitado → laudo | N : 1 | vários itens compõem um laudo; e um laudo pode sair parcial |
Guarde: a relação que mais surpreende é teste analítico → resultado como 1 : N. A intuição diz que um teste tem um resultado. Na prática, ele tem a primeira medição, a repetição, a medição diluída — e o sistema precisa guardar todas, marcando qual é a vigente. Guardar só a última é perder a história que a auditoria pede.
04A máquina de estados
Vinte e seis estados possíveis, em três naturezas: o fluxo que todo exame percorre, os laços que o fazem voltar e as exceções que o tiram do caminho.
O erro de modelagem mais comum: tratar os laços e as exceções como valores do mesmo campo de status. Um exame pode estar “em processamento” e ter uma “repetição solicitada” ao mesmo tempo; pode estar “validado” e ter um “reflexo aberto” correndo em paralelo. Um único campo de estado não representa isso — e a operação passa a manter a informação fora do sistema.
Resumo do guia: dez entidades distintas, com o par exame solicitado × teste analítico como a separação mais cara de ignorar; o resultado calculado como caso que quebra modelos ingênuos; cardinalidades quase nunca de um para um; e vinte e seis estados em três naturezas que não cabem num campo só. Com o vocabulário em pé, começa a orquestração: organizar o trabalho.
Ver listas de trabalho e filas →Continue no hub de processamento analítico