Interfaces de utilizador para a saúde

Um guia para as equipas que criam software clínico com Lily: portais clínicos, resultados e relatórios, prescrição e administração de medicamentos, apoio à decisão e painéis hospitalares.

Esta tradução é um rascunho automático não revisto. A página em inglês é a versão de referência.

O que o Lily faz, e o que não faz

O Lily dá-lhe contratos de apresentação: marcação semântica, ARIA, comportamento de teclado e ganchos de classe para aquilo que os ecrãs clínicos repetem. Não lhe dá lógica clínica, conteúdo clínico nem uma alegação regulamentar.

O que o Lily fornece, e o que você fornece
O Lily fornece Você fornece
observation-view: um valor, uma unidade, um indicador por extenso, um intervalo e os estados em falta O valor, a decisão do indicador, o intervalo de referência
allergy-record-list e allergy-record-list-item: um estado que nunca fica vazio O registo de alergias e a sua terminologia
medication-view: nome, dosagem, forma, via e frequência, nada truncado Os dados do medicamento, os segmentos tall man, a dosagem formatada
decision-support-card: a forma de cartão do CDS Hooks As regras, as ações sugeridas, o registo do resultado
early-warning-score-view: uma pontuação, um nível e uma escalada, apresentados O sistema de pontuação e o seu cálculo validado
age-view e ageParts(): uma idade nas unidades adequadas As palavras para as unidades (Intl.DurationFormat ou as suas próprias etiquetas)
formatQuantity(): 5 mg, nunca 5,0 mg; 0,5 mg, nunca ,5 mg O número, a unidade e a localização
A composição da faixa do doente Cada etiqueta e cada valor, e quem pode ver a informação clínica

Regulamentação. Um software que calcula uma pontuação, um percentil, uma dose ou uma interação medicamentosa é normalmente um dispositivo médico. O Lily não calcula nada disto, de propósito. Se o seu produto é regulamentado, é seu o respetivo processo de engenharia de usabilidade (IEC 62366-1, as orientações da FDA sobre fatores humanos, o MDR da UE). Os testes do Lily, o seu relatório de conformidade de acessibilidade autoavaliado e a sua matriz de leitores de ecrã podem ser evidência nesse processo; nenhum deles é uma declaração de conformidade, e a matriz ainda não tem resultados.

Alertas: interromper só para o que é crítico

A fadiga de alertas é um problema de segurança: quando todos os alertas interrompem, as pessoas acabam por ignorá-los todos. A AHRQ recomenda hierarquizar os alertas por gravidade e tornar interruptivos apenas os graves.

  • Informação (indicator="info"): integrado, junto à tarefa, um cartão de apoio à decisão na página.
  • Aviso (indicator="warning"): visível sem bloquear, o mesmo cartão, com um estilo que se destaque; sem janela modal.
  • Crítico (indicator="critical"): coloque o cartão dentro de uma caixa de diálogo de alerta e ofereça overrideReasons para que dispensá-lo peça um motivo.
  • Um cartão de apoio à decisão nunca é, por si só, uma região dinâmica. Anuncie um novo cartão crítico movendo o foco para a caixa de diálogo, e não com aria-live.
  • Retire um cartão quando o evento a que respondia voltar a acontecer, e registe cada resultado (aceite, ou ignorado com o seu motivo).

Erros de doente: identificar, não restringir

  • Mostre dois identificadores sempre que surgirem dados de um doente: o nome com a data de nascimento, e o identificador nacional com o seu componente de visualização (The Joint Commission, Quick Safety 45).
  • Use a faixa do doente em todos os ecrãs que atuam sobre o processo de um doente, e mantenha-a visível.
  • Antes de uma ação num processo diferente do que está na faixa, confirme-a com o nome, a data de nascimento e o identificador.
  • Uma entrada sobre alguém que não é o doente (o historial de um progenitor, um feto, um dador) diz primeiro de quem é, por palavras: dê aos itens do registo um subjectLabel («Mãe»), para que o diagnóstico de um familiar nunca seja lido como o do doente (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Não limite quantos processos um clínico pode abrir: um ensaio aleatorizado com 3356 clínicos (JAMA, 2019) concluiu que isso não reduzia as prescrições no doente errado, e as pessoas contornam-no.
  • Um menu de ações sobre um registo nomeia primeiro esse registo, com subjectLabel em context-menu ou dropdown-menu («Ada Lovelace, tensão arterial 3 nov.»): uma primeira parte não interativa que é também o nome acessível do menu.
  • Classifique cada ação pelo que faz e torne o nível visível antes de ser executada. Rotina (ver, imprimir) é executada logo. Documentada diz o que vai escrever no registo («Acrescenta uma nota ao episódio»). Clínica (suspender, cancelar uma prescrição) pede uma segunda confirmação, num alert-dialog cujo botão de confirmação é o verbo («Suspender»), nunca «OK» nem «Sim». Divulgadora (acesso de emergência, partilha fora da equipa de cuidados) pede primeiro um motivo e regista-o.
  • Quando vários registos estão abertos (separadores, janelas, painéis divididos), o texto visível e o nome acessível de cada separador incluem o nome do doente e um segundo identificador, o painel ativo repete a faixa, e nenhuma ação se aplica a um doente que não seja o do seu painel.
  • Mostre como texto no cabeçalho da página o local a que os registos serão atribuídos (o serviço, a consulta ou a instituição escolhida no início de sessão), e torne a sua mudança uma ação explícita.
  • Mostre a visita ativa, ou «Sem visita ativa», na faixa. Um formulário que precisa de uma visita di-lo e propõe iniciar uma, em vez de falhar ao guardar.

A faixa do doente

A composição está documentada com medical-banner, com uma página funcional em /patient-banner na aplicação de exemplo SvelteKit:

  • dois identificadores, e a idade junto à data de nascimento;
  • as alergias através de uma lista de alergias, para que «sem alergias conhecidas», «não registado» e «indisponível» nunca se pareçam;
  • um valor em falta escreve-se por palavras («Desconhecido»), nunca com um ponto de interrogação, um traço ou uma célula vazia;
  • um doente falecido: data-deceased para o tema, e uma linha de texto visível, nunca só a cor;
  • nenhum campo truncado, cortado ou escondido em qualquer largura; passa para a linha seguinte.
  • os alertas do doente («Precisa de intérprete», «Risco de infeção») são um tag-group rotulado de palavras, nunca ícones ou cor sozinhos, e continuam visíveis quando a faixa quebra a linha.

Resultados

  • Uma única apresentação para um resultado, venha do sistema que vier: a vista de observação.
  • O indicador são palavras da sua tradução (flagLabel), com o código de interpretação FHIR como data-interpretation para o tema.
  • Separe os resultados novos dos anteriores e mostre uma tendência (um minigráfico, ou um gráfico de linhas com a sua tabela de dados): os clínicos procuram uma alteração significativa, não apenas o intervalo.
  • Um resultado que nunca foi registado e um que está indisponível são estados diferentes, com palavras diferentes.
  • Desconhecido não é normal. Um resultado cujo intervalo de referência falta, ainda está a carregar ou é ilegível não tem interpretação e di-lo; observation-view nunca a deduz, por isso um resultado com intervalo e sem interpretation não mostra nenhuma marca.
  • Um resultado fora da escala é o limite do instrumento com um comparador («> 33,3 mmol/L»: formatQuantity com ">") e a sua marca de valor crítico, nunca um número sozinho. Um valor aproximado mantém o seu ≈ ("~").
  • Dê outros intervalos com nome («Crítico: abaixo de 2,5») como ranges, cada um na sua própria parte.
  • Um resultado corrigido ou alterado mantém o valor que substituiu, num <del>, com as suas palavras para quando mudou (previousValue, previousLabel), para que um clínico que leu o valor antigo saiba que mudou.
  • Uma medição de intervalo diz a sua duração e função («Média, 24 horas»), e o estado e o método de uma medição («Sentado, braçadeira grande») são texto visível ao lado, nunca apenas uma dica flutuante (openEHR INTERVAL_EVENT, state, protocol).
  • Uma tendência precisa de pontos comparáveis: não desenhe linha abaixo do seu mínimo, interrompa a linha onde o método ou o ensaio mudou, e diga a direção e o significado por palavras («a descer, a melhorar»).
  • Sinais vitais introduzidos num sistema de unidades podem mostrar o outro ao lado, como texto seu («70 kg (154 lb)»); o Lily não converte nada, por isso indique o seu arredondamento. Introduza uma quantidade com quantity-input-div, cujo número segue os limites de cada unidade.
  • Uma curva de crescimento é um line-chart com as suas linhas de percentis como séries, os pontos da criança e a sua tabela de dados de idade e valor; o Lily não calcula percentis nem traz referências de crescimento.

Medicamentos

  • Nomes genéricos em minúsculas, exceto as letras tall man das listas da FDA e do ISMP ou do seu país (a Austrália e o Canadá publicam as suas). Marque-as em nameSegments; o Lily nunca as adivinha.
  • Escreva a dosagem com formatQuantity: sem zero final, com zero inicial, com um espaço inseparável antes da unidade.
  • Mantenha o comparador de um resultado: formatQuantity(5, "mmol/L", locale, "<") escreve «<5 mmol/L». O Quantity.comparator do FHIR escreve-se <, ≤, ≥ ou >; omiti-lo transforma «menos de 5» em «5».
  • Escreva mL, nunca cc, e evite todas as abreviaturas da lista de abreviaturas propensas a erro do ISMP.
  • Nunca trunque o nome ou a dose de um medicamento.

Datas e horas

  • Escreva o mês por extenso para que uma data não possa ser lida de duas formas (Intl.DateTimeFormat com month: "short").
  • Escolha o relógio de propósito: passe hourCycle explicitamente. O NHS pede o relógio de 24 horas; é uma regra britânica, não mundial, por isso o Lily nunca o escolhe por si.
  • As idades seguem os escalões da Common User Interface através de ageParts(); um serviço com outra convenção fornece as suas próprias palavras.
  • Uma data conhecida só até ao mês ou ao ano fica assim: peça-a com date-field precision="month" ou "year", guarde 2019-03 ou 2019e escreva-a com formatPartialDate(). Nunca invente um dia.
  • Uma duração é duration-view, um <time datetime="P3DT4H"> com as suas palavras, a partir de durationParts() e Intl.DurationFormat.

Painéis

  • Um quadro de enfermaria ou um ecrã de centro de comando atualiza-se com frequência. Nunca anuncie cada alteração: mantenha uma única região de resumo cortês («3 camas livres, 2 altas previstas») e deixe as pessoas ler o quadro.
  • Cada estado num quadro (cama limpa, ocupada, bloqueada) é texto ou um estado data-* com palavras, nunca só a cor.
  • Nada pisca (WCAG 2.2.2, 2.3.1), e um quadro que se atualiza com um temporizador tem um controlo de pausa ou só se atualiza a pedido; as atualizações nunca movem o foco. Uma entrada em atraso di-lo por palavras («À espera há mais de 20 minutos») com data-overdue.
  • Uma contagem ou taxa mostra o seu denominador («12 de 68») e liga à lista por trás dela.
  • Uma lista ou cronologia diz de que é uma vista: o que mostra, a sua ordem e período, o que está escondido e porquê, e que fontes não responderam. Uma lista vazia de uma fonte que não respondeu não prova que nada existe.
  • Uma lista de lembretes é uma record-list cujos itens têm uma data-limite (review-date) e um estado de prazo por palavras, com data-due; a regra que a produziu é sua.

Formulários

  • Uma pergunta respondida com «sim», «não» ou «não perguntado» é um radio-group de três respostas, nenhuma escolhida à partida, nunca uma caixa de verificação: uma caixa não distingue «negado» de «nunca perguntado». Uma revisão por sistemas é um fieldset por sistema, e um botão «todos os outros ausentes» define apenas os que não têm resposta.
  • Uma pergunta com uma lista de respostas (medicamentos, moradas) é um repeatable-fieldset: um item é acrescentado ou removido, o foco acompanha, e cada botão de remover tem o nome do seu item.
  • Um número com vírgula decimal: mostre-o com Intl.NumberFormat e, onde type="number" não aceita a vírgula, receba-o num campo de texto com inputmode="decimal" e analise-o no seu código. Nunca altere um valor que a pessoa escreveu, nem para o limitar a um intervalo: um valor fora do intervalo é um erro que ela consegue ver.
  • Uma lista longa que só apresenta parte das opções de cada vez define aria-setsize e aria-posinset em cada opção, e lembra que a pesquisa na página não vê o resto.

Registos, notas e a sua proveniência

  • Diga de que é uma vista uma lista ou uma grelha antes das linhas: o período e a ordem, o que deixa de fora e porquê, e que fontes não responderam («Últimos 12 meses, mais recentes primeiro. O registo do médico de família não respondeu.»). Dê a record-list e a timeline-list um coverageLabel, e ao ajudante data-grid o seu coverageLabel. Uma lista vazia de uma fonte que não respondeu di-lo por palavras, para nunca ser lida como «nada registado».
  • Diga de onde veio um registo e se é definitivo com record-provenance-view: assinado, a aguardar assinatura, alterado, guardado neste dispositivo e ainda não enviado. Um rascunho não assinado nunca pode parecer assinado.
  • Uma entrada sobre outra pessoa (um progenitor, um feto, um dador) diz primeiro de quem é, com o subjectLabel.
  • Uma entrada retida fica na lista com as suas palavras («Restrito: não disponível para si»), e uma entrada feita por erro fica riscada com «Introduzido por erro»: dê a record-list-item ou timeline-list-item um entryState e um entryStateLabel. Nunca remova nenhuma das duas em silêncio, porque uma lacuna é lida como «nada aconteceu».
  • Numa nota clínica, marque a origem de cada passagem (escrita, ditada, modelo, copiada de nota anterior, gerada) com data-source e palavras visíveis, para que texto copiado ou gerado nunca seja tomado pelo exame de hoje.
  • Uma secção que não consegue carregar é unavailable nas suas palavras, com um botão para tentar de novo; um código técnico, se for mostrado, fica atrás de uma divulgação. Uma falha causada por uma ação da pessoa é anunciada, com o valor que o registo agora tem; uma falha ao carregar a página não.
  • O histórico de uma prescrição é uma timeline-list, um item por etapa (planeada, agendada, ativa, suspensa, concluída, cancelada) com a hora e o motivo, e o estado atual também no item.

Do FHIR ao Lily

O Lily não lê recursos FHIR; o seu código mapeia-os para as props do Lily. Estas tabelas mapeiam o HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). O mapeamento dos códigos é uma sugestão: a sua revisão de segurança clínica decide-o, e as palavras de cada estado são suas.

Secções do IPS e os componentes do Lily correspondentes
Secção do IPS Lily
Alergias e intolerâncias (48765-2) allergy-record-list e os seus itens
Resumo da medicação (10160-0) medication-record-list, com cada item a conter um medication-view
Lista de problemas (11450-4) problem-record-list e os seus itens
Imunizações (11369-6) immunization-record-list e os seus itens
Resultados (30954-2) observation-view, numa tabela de dados ou numa lista de resumo
Histórico de procedimentos (47519-4) procedure-record-list e os seus itens
Dispositivos médicos (46264-8) device-record-list e os seus itens
Alertas (104605-1) Um texto de aviso ou um alerta, nunca atrás de um controlo recolhido
Qualquer outra secção record-list e os seus itens
Uma secção obrigatória que o documento omite A lista da secção com status="omitted"
Códigos FHIR e os valores do Lily correspondentes
FHIR Lily
emptyReason nilknown O status="none-known" da lista
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", com palavras que digam qual
Os códigos IPS no-known-allergies, no-known-medications e semelhantes status="none-known"
Os códigos IPS no-allergy-info, no-medication-info e semelhantes status="not-recorded"
AllergyIntolerance.criticality criticality, à parte o severity de uma reação
clinicalStatus, verificationStatus As mesmas props nos itens de alergia e de problema, com os mesmos códigos
MedicationStatement.status O status do item de medicação
Dosage.text medication-view dosageText
Observation.status observation-view status, com os mesmos códigos
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (também nas listas de registos)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Mapeie um registo entered-in-error para o seu estado entered-in-error, com palavras, em vez de o descartar em silêncio: se se mostra ou não é uma decisão do seu serviço.

Do openEHR ao Lily

O Lily também não lê composições openEHR. A correspondência para os tipos de dados e códigos do modelo de referência openEHR, como uma sugestão que a sua revisão de segurança clínica decide:

Tipos de dados e códigos openEHR, e os valores Lily correspondentes
openEHR Lily
DV_QUANTITY (introdução) quantity-input-div; unidades como códigos UCUM com as suas palavras
DV_QUANTITY (apresentação), magnitude_status observation-view com formatQuantity(value, unit, locale, comparator) (~ é ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges com um meaning observation-view ranges
DV_DATE parcial (ano, ano e mês) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view com durationParts()
DV_PROPORTION formatProportion() dentro de observation-view
DV_ORDINAL, DV_SCALE um radio-group cujos rótulos têm o número e as suas palavras
DV_CODED_TEXT o padrão de valores codificados abaixo
DV_BOOLEAN checkbox-input, só quando «não perguntado» não pode acontecer
ELEMENT.null_flavour 253 desconhecido, 271 sem informação status="not-recorded" ou "unavailable", com palavras que digam qual
null_flavour 272 mascarado observation-view status="masked"
null_flavour 273 não aplicável status="not-applicable"
PARTY_RELATED sujeito subjectLabel nos itens do registo
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Etapas da máquina de estados das instruções uma timeline-list de etapas, com o estado atual no item
um item de arquétipo com ocorrências 0..* repeatable-fieldset

Valores codificados

  • Mostre Coding.display; se não existir, CodeableConcept.text; se não existir nenhum, system|code. Nunca uma célula vazia.
  • Ofereça um controlo que revele o sistema de codificação e o código junto de cada valor, como um botão de alternância que diga «Mostrar códigos». Os códigos ocultos ficam fora da ordem de leitura até serem mostrados.
  • Marque o texto clínico com o idioma do documento (lang), que pode diferir do da interface. Traduza a interface; nunca traduza o conteúdo clínico.
  • O Lily não inclui terminologia: nenhuma consulta de SNOMED CT, LOINC, ATC ou UCUM. Escreva o que o documento diz. A página /patient-summary do exemplo SvelteKit mostra o padrão.

O que o Lily não fará

  • Calcular uma pontuação de alerta precoce, um percentil de crescimento, uma dose ou um intervalo de referência.
  • Incluir uma base de dados de medicamentos, uma lista tall man, ou códigos SNOMED CT, CID, LOINC ou UCUM.
  • Reproduzir um instrumento licenciado (Wong-Baker FACES) ou o design de outra entidade (o gráfico NEWS2).
  • Limitar o número de processos abertos ao mesmo tempo.
  • Deduzir uma interpretação a partir de um intervalo, converter uma unidade ou interpretar uma data relativa («na próxima terça-feira»).
  • Usar um interruptor para «sim, não ou desconhecido»: o switch do ARIA não tem terceiro estado, por isso são três botões de opção.

A investigação, as fontes e as decisões por trás deste guia estão em spec/healthcare-ui.