Saltar para o conteúdo
Entre em contacto

O modelo de dados

Cada valor traz o seu contexto

Por si só, “4.1” não diz nada a ninguém. Potássio, 4.1 mmol/L, deste doente, neste internamento, colhido às 08:15, no laboratório central, final e não corrigido: isso é algo com que um profissional clínico pode agir e em que uma aplicação pode confiar. O monaOS associa esse contexto a cada valor antes de alguém o ler, e a API devolve o valor com todo ele.

atributos em cada valor, listados abaixo
9
marcas temporais em cada valor: quando era verdade e quando chegou
2
a um dia: a resolução da API de séries temporais
1 min
valores alguma vez apagados: um valor errado é marcado, nunca removido
0

Sem contexto, um valor é um risco.

Um resultado laboratorial no internamento errado, uma marca temporal que regista quando a mensagem chegou e não quando o sangue foi colhido, um valor na unidade errada que parece normal, um artefacto que distorce discretamente uma tendência e um score. Cada aplicação que lê dados hospitalares em bruto tem de resolver estes problemas de novo, e cada erro chega a um doente. O monaOS resolve-os uma vez, no registo, antes de qualquer aplicação ver o valor.

O que acompanha cada valor

Sete atributos em cada valor

Desde o momento em que entra na plataforma até ao momento em que uma aplicação o lê.

  1. 01Associação

    Doente e internamento

    De quem é o valor e em que internamento.

    Cada valor está associado ao seu doente e, dentro do historial desse doente, ao episódio a que pertence. Uma creatinina de uma admissão há dois anos e uma desta manhã descrevem situações diferentes; o registo mantém-nas separadas e permite ler um internamento como um todo.

  2. 02Cronologia

    Hora clínica

    Representado no momento em que era verdadeiro, não no momento em que chegou.

    Uma amostra colhida às 08:15 cujo resultado chega às 08:30 pertence às 08:15. Os resultados que chegam fora de ordem são colocados onde pertencem na cronologia, pelo que a tendência mostra a evolução pela ordem em que aconteceu.

  3. 03Normalização

    Unidade e significado

    A unidade faz parte do valor.

    O mesmo analito chega em unidades diferentes de laboratórios diferentes, e um valor na unidade errada pode parecer normal sendo crítico. Os valores transportam a sua unidade e o seu conceito, e uma correção manual converte unidades automaticamente em vez de confiar num número reintroduzido.

  4. 04Configuração ou medição

    Contexto do dispositivo

    O que foi definido no ventilador e o que ele mediu são valores diferentes.

    Um ventilador reporta os seus parâmetros e o resultado medido: volume corrente definido face ao medido, pressões definidas face às medidas, e a mecânica pulmonar medida. O monaOS mantém-nos separados, porque um parâmetro lido como medição altera o significado clínico do gráfico. Os valores hemodinâmicos avançados de equipamento de monitorização especializado são captados da mesma forma. O monaOS recebe dados de dispositivos médicos sem os controlar.

  5. 05Nada é apagado

    Introduzido por erro

    Um valor errado é marcado, nunca apagado.

    Uma sonda solta produz uma saturação de 62 por cento que não reflete o doente. Nada no registo é alguma vez apagado: o valor é marcado como introduzido por erro, com um motivo clínico que é obrigatório. A partir daí, tendências, balanços hídricos, scores e relatórios deixam-no de fora. O próprio valor continua rastreável: quem rever o registo pode vê-lo, bem como quem o marcou, quando e porquê.

  6. 06Histórico

    Correções

    Uma correção mantém ambos os valores e indica quem a fez.

    Uma correção manual preserva o valor original e o valor corrigido. Cada entrada tem um histórico de versões: o campo alterado, o valor antes e depois, quando, e o profissional que o alterou. O modo de revisão abre o registo de um doente com alta.

  7. 07API de séries temporais

    Resolução

    De um minuto a um dia, através da API de séries temporais.

    Os dados de alta frequência dos dispositivos são mantidos na resolução em que foram medidos e servidos a partir de um repositório de séries temporais concebido para isso. Através da API de séries temporais, uma aplicação pede detalhe ao minuto numa situação aguda ou visões gerais horárias e diárias, sem perder o que aconteceu entretanto.

Anatomia de um valor

O que a API devolve para um resultado laboratorial

Atributo a atributo, e porque cada um importa a jusante.

Doente
A quem pertence o valor. No doente errado, um valor correto torna-se um risco de segurança.
Episódio
O internamento a que pertence, que separa esta admissão do historial do doente.
Observação
O conceito e o tipo de afirmação: uma medição, um parâmetro de dispositivo, um score calculado ou uma avaliação.
Valor e unidade
4,1 mmol/L. A unidade acompanha o valor e é convertida explicitamente em vez de presumida.
Hora clínica
08:15, quando a amostra foi colhida. É aqui que o valor é representado.
Hora de chegada
08:30, quando o resultado chegou à plataforma. Registado, mas não representado no gráfico.
Fonte
Laboratório central, fluxo de resultados. Proveniência para interpretação e para resolução de problemas.
Estado
Final, sem correção. Os valores invalidados ficam no histórico e saem das tendências e dos scores.
Histórico
Cada alteração com o campo, o valor antes e depois, a hora e o profissional.

Perguntas frequentes

O que os programadores perguntam primeiro

Recebemos dados em bruto ou dados preparados?

Preparados. Cada valor chega associado ao seu doente e internamento, com a sua unidade, hora clínica, origem e estado, e com os códigos locais já mapeados para sistemas de codificação internacionais. Os valores marcados como introduzidos por erro são assinalados, pelo que uma aplicação nunca tem de adivinhar.

Como obtemos dados de alta frequência dos dispositivos?

Através da API de séries temporais, na resolução de que uma aplicação precisa, de um minuto a um dia. O registo clínico guarda o que foi documentado, com o seu histórico de versões.

Os dados chegam a ser apagados?

Não. Um valor que não deve contar é marcado como introduzido por erro, nunca removido. Os cálculos e relatórios deixam-no de fora, e fica no registo para revisão, com quem o marcou, quando e porquê.

Podemos ver o que um valor era antes de ser corrigido?

Sim. O histórico de versões guarda cada valor anterior com a alteração ao nível do campo, a hora e o profissional, e um valor marcado como introduzido por erro fica no registo de auditoria.

Como são tratados os resultados tardios?

São colocados na hora clínica que descrevem e não na hora em que chegaram, pelo que resultados tardios ou fora de ordem ficam onde pertencem na cronologia.

Uma correção altera os scores?

Sim. Um valor invalidado é excluído das tendências, dos balanços hídricos e dos cálculos de scores, pelo que tudo o que é calculado depois assenta no que era verdadeiro.

Os dados baseiam-se em normas?

Sim. O monaOS é nativo em FHIR: o registo é guardado como recursos HL7 FHIR normalizados, e os diagnósticos têm códigos ICD-10-GM e SNOMED CT.

Veja a API com os seus próprios dados

Traga um internamento que conheça bem. Mostramos como cada valor lá chegou, a que está associado, o que a API devolve e o que acontece quando alguém o corrige.