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 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çaoverrideReasonspara 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelemcontext-menuoudropdown-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-dialogcujo 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-deceasedpara 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-grouprotulado 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 comodata-interpretationpara 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-viewnunca a deduz, por isso um resultado com intervalo e seminterpretationnão mostra nenhuma marca. -
Um resultado fora da escala é o limite do instrumento com um comparador («> 33,3 mmol/L»:
formatQuantitycom">") 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-chartcom 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». OQuantity.comparatordo 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.DateTimeFormatcommonth: "short"). - Escolha o relógio de propósito: passe
hourCycleexplicitamente. 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-fieldprecision="month"ou"year", guarde2019-03ou2019e escreva-a comformatPartialDate(). Nunca invente um dia. -
Uma duração é
duration-view, um<time datetime="P3DT4H">com as suas palavras, a partir dedurationParts()eIntl.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-listcujos itens têm uma data-limite (review-date) e um estado de prazo por palavras, comdata-due; a regra que a produziu é sua.
Formulários
-
Uma pergunta respondida com «sim», «não» ou «não perguntado» é um
radio-groupde 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 é umfieldsetpor 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.NumberFormate, ondetype="number"não aceita a vírgula, receba-o num campo de texto cominputmode="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-setsizeearia-posinsetem 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-liste atimeline-listumcoverageLabel, e ao ajudantedata-grido seucoverageLabel. 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-itemoutimeline-list-itemumentryStatee umentryStateLabel. 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-sourcee palavras visíveis, para que texto copiado ou gerado nunca seja tomado pelo exame de hoje. -
Uma secção que não consegue carregar é
unavailablenas 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çã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" |
| 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:
| 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-summarydo 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
switchdo 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.