Sistema de diseño

Una sola fuente de tokens (assets/css/tokens.css) para la portada y la aplicación. Esta página carga las mismas hojas y los mismos scripts de la app: cada ejemplo usa sus clases, sin estilos copiados. Lo que se ve aquí es lo que se ve en consulta.

Al día con la 0.11: íconos de módulo, riel V-A-L-A-D grande, y frase de la decisión. Sin datos de pacientes.

VALAD es una herramienta de referencia y cálculo para profesionales de la salud. Con los datos que escribes, aplica escalas y fórmulas publicadas y muestra lo que dicen las guías y las fichas técnicas, con la fuente a la vista. No está dirigida a pacientes ni al público general.

Color

Neutros fríos con leve matiz verde y un solo acento: petróleo. El acento va en el logo, el botón primario (uno por vista), los enlaces, el foco, lo activo o seleccionado y las fichas V-A-L-A-D; nunca como adorno. Los bordes de los controles usan --control, con 3:1 o más sobre toda superficie. Cada valor se lee del tema actual.

Riesgo clínico

Seis rellenos, cada uno con su tinta legible (--risk-* y --risk-*-ink). Solo dicen riesgo clínico o seguridad de un fármaco; nunca decoran. La cifra de cada muestra es el contraste de la tinta sobre el relleno en el tema actual.

Riesgo bajo Moderado Alto Muy alto Máximo Sin ajusteAjustar/precauciónEvitar

Se usa en

  • La píldora del resultado de cada escala (riesgo cardiovascular, riesgo renal combinado, FINDRISC…).
  • La píldora de riesgo renal combinado (.h-v a .h-rr) y el ajuste de dosis por función renal (.dz-*).
  • El estado del fármaco «Preferido» y «Evitar» (.st-pref, .st-no) y la gravedad de las interacciones.

Nunca en

  • Íconos de módulo, el riel V-A-L-A-D, botones ni enlaces.
  • Recuadros de alerta: usan --danger-* y --warn-*.
  • Fondos, bordes o adornos. En una pantalla de conducta, un color que no dice riesgo sobra.

Tipografía

Geist para interfaz y titulares; Geist Mono para cifras de referencia, unidades, letras del riel y metadatos. Ambas autoalojadas en assets/fonts (licencia SIL OFL). Solo pesos 400, 500 y 600; cifras tabulares en todo resultado. El tamaño junto a cada muestra se mide en este ancho de pantalla.

42 mL/min/1,73 m²
Enfermedad renal crónica
Modo consulta
Tratamiento según comorbilidades
Controlar TFGe y ACR 3 veces al año. Con albuminuria, la guía sugiere IECA o ARA II a la dosis máxima tolerada.
Creatinina (mg/dL)
KDIGO 2024 · doi:10.1016/j.kint.2023.10.018

Forma y espacio

Etiquetas de evidencia y teclas con --r-xs; controles, filas y chips con --r-sm; tarjetas, paleta, diálogos y vista previa con --r-md. Las fichas V-A-L-A-D usan --r-token (×4/3 en el riel). La píldora queda para estados clínicos y contadores. Espaciado en base 4.

Íconos de módulo

Un sprite (assets/img/modulos.svg) con un símbolo por módulo, en el estilo de las infografías: lienzo de 100 × 100, trazo grueso redondeado y rellenos planos. Dos tonos de la marca que cambian con el tema: --ico-1 (trazo y rellenos plenos) e --ico-2 (relleno suave). Nunca rojo, ámbar ni piel. assets/js/iconos.js los pone solos junto al nombre de cada fila.

Los 21 símbolos

En contexto

Filas .home-row con su ícono de 22 px, como en Recientes. Abren su módulo en la app.
  • Tamaños: 20 px en el menú lateral; 22 px en el índice de módulos, Favoritas, Recientes y la portada. No agrandan la fila: se centran en la línea del nombre.
  • Son decorativos: el nombre ya dice qué es (aria-hidden="true", fuera del orden de foco).
  • Sin animación ni transición. En alto contraste de Windows toman los colores del sistema.
  • Un módulo nuevo necesita su símbolo en el sprite y en el mapa de iconos.js (lo comprueba tests/iconos.test.js).
<svg class="mod-ico" aria-hidden="true" focusable="false">
  <use href="assets/img/modulos.svg#ico-rinon"></use>
</svg>

Componentes

Botones, campos, etiquetas de estado y de evidencia, recuadros y el panel de resultado, tal como los pinta la aplicación.

PreferidoOpciónPrecaución / ajustarEvitar / contraindicadoEspecialista [Evidencia][Inferencia][Especulación][No verificado]
Qué calcula: recuadro informativo estándar de cada módulo.
Alerta: contraindicaciones y banderas rojas.
Correcto: metas alcanzadas o conducta preferida.
Referencia: umbrales o tablas de una guía.

CalculadoraPatrón de herramienta: datos, resultado e interpretación

Datos básicos

Estado de error: valor fuera de rango.

Factores

TFGe CKD-EPI 2021
42
mL/min/1,73 m²
G3b A3 · riesgo muy alto
Conducta
  • La guía sugiere IECA o ARA II a la dosis máxima tolerada [Evidencia]
  • Remisión a Nefrología

Riel V-A-L-A-D

El mapa de Modo consulta: Variables, Análisis, Lógica, Acción y Decisión, siempre en ese orden, en mayúscula y con tilde. Es una navegación, no pestañas ni un asistente: todo está en la página y tocar una letra solo desplaza. Cada letra se enciende según lo resuelto, sin chulos ni «completo». Toca una letra: la pastilla de la parte visible salta, no se desliza.

Mismo marcado que #wsRail de app.html: nav.valad-rail con botones .vr-step (.vr-tile, .vr-name, .vr-n). El número no se muestra cuando vale 0. Cambia el ancho de la ventana para ver sus tres formas.

Estados de la ficha

El contorno de «en curso» la distingue de «vacío» por la forma, no solo por el color. La cifra es el contraste de la letra en el tema actual.

VacíoLa parte no tiene nada ·
En cursoHay algo sin resolver ·
ListoResuelto ·

Análisis

5
Cabecera de cada parte (.ws-ph): la misma ficha y el mismo estado que en el riel, a la izquierda del título, y el número a la derecha.

Medidas

--rail-h es el alto visible del riel pegado bajo la barra superior; por debajo de 1100 px va encima la leyenda (--rail-cap, 20 px). Para videos e infografías la especificación completa está en docs/riel-valad.md.

AnchoRiel visibleLeyendaFichaPaso
≥1100 px64 pxOculta36 px, letra 1752 px de alto, en fila con conectores de 2 px
768 a 1099 px64 px20 px36 px, letra 1756 px; ficha a la izquierda, nombre y número a la derecha
376 a 767 px68 px20 px36 px, letra 1764 px; ficha arriba y nombre debajo
341 a 375 px64 px20 px32 px, letra 1560 px
≤340 px64 px20 px32 px, letra 1560 px; nombre de 11,5 px y sin número

Decisión: la frase fija y el lenguaje

VALAD muestra lo que dice la evidencia; la decisión es del médico. Todo panel de decisión lleva esta frase en negrilla, con el texto exacto y a la vista sin desplegar nada.

Única fuente del texto: assets/js/frase-decision.js (VALAD.fraseDecision), que pinta esta muestra. Estilo .frase-decision de app.css: 14 px, peso 600, --ink.

Dónde va

Cómo habla VALAD

AsíNo así
«Disposición que sugiere la guía: Observación»«Observación» o «Dejar en observación»
«La guía sugiere…», con la guía y la recomendación que lo dicen«Haga…», «Debe…», «Inicie…»
Al pie de la nota: «[Inferencia]… No es una orden médica»Una nota sin esa etiqueta ni ese aviso
«Persona con hipertensión», «fuma actualmente»Nombrar a la persona por su condición

Movimiento

El movimiento orienta y confirma, nunca decora. Solo se animan transform, opacity y colores. Con movimiento reducido todo pasa al estado final de inmediato.

Cambio de móduloEntrada con desplazamiento de 8 px. 420 ms · ease-out
Resultado actualizadoEl número cambiado sube y aparece. 420 ms · ease-out
PulsaciónEscala de 0,96 a 0,98 al presionar. 90 ms
Hover y focoColor y borde. 150 ms
Riel V-A-L-A-DLa ficha cambia de color en 230 ms y el paso en 150 ms. La pastilla salta: no se desliza. ease-out
Llegada a una parteAnillo de 2 px en la ficha del título que se abre de 0 a 8 px y se desvanece. 600 ms · ease-out
Regreso a Modo consultaLa fila de la que se salió se ilumina con --accent-soft 1 s y se desvanece. 600 ms
Menú lateral del celularHoja desde el borde con velo. 420 ms · ease-out