Guía de diseño EVODAv0.0.8

Tokens y componentes de erpia/web/static/diseno.css con la identidad EVODA, cada uno en tema claro y oscuro con su código. Esta página se genera con python3 -m erpia.web.construir.

Masa, bosque y brasa

60 % crema «masa» de fondo, 30 % verde Canelo, 10 % brasa y azafrán juntos. Sin azul ni morado: EVODA se ve como el rubro al que sirve.

Una acción principal por pantalla

Solo un botón lleva el relleno brasa de acción. Las demás acciones van con borde verde o sin borde. El verde marca lo elegido, los enlaces y los datos.

La barra y el punto

La cabecera es una barra bosque profundo con el logo inverso. Barras de 8 px con extremos redondos y un punto del mismo diámetro son el motivo gráfico.

Texto en frase, tuteando

Mayúscula solo al inicio en títulos, botones y menús. Frases cortas, verbo primero, palabras del local y no del software. Sin emoji.

Cifras en mono, a la chilena

Montos, cantidades y porcentajes en IBM Plex Mono con numerales tabulares, alineados a la derecha en tablas: $ 1.284.500, 12,5 %, 14-11-2026.

El estado se dice con palabras

Correcto, alerta y error llevan siempre una palabra o un ícono además del color. El error se distingue del verde también por la forma: solo contorno.

Bordes suaves, sombra mínima

Tarjetas con borde de línea y una sombra de 1 px. La sombra grande queda para lo que flota. Radios de 8 px en controles y 14 px en tarjetas: nada interactivo con esquinas rectas.

Movimiento que responde

Solo transiciones breves ante una acción. Nada se anima al cargar y prefers-reduced-motion lo apaga todo.

Color

La paleta mezcla el bosque del sur de Chile con el calor de una cocina. Los valores se leen en vivo del tema activo de esta página: cambia el tema arriba para ver el otro juego.

Marca

Superficies, tinta y estados

Nombres del sistema

Las páginas usan estos nombres, que apuntan a la paleta. Son los que una marca de cliente puede cambiar.

Tipografía

Bricolage Grotesque para títulos y titulares, Instrument Sans para toda la interfaz y el texto, IBM Plex Mono para montos, cantidades, porcentajes y códigos. Los títulos de tarjeta van en Instrument Sans: el display queda para el título de la página y los titulares grandes.

  • título · display 600 · --t-xl

    Inventario de cocina

  • subtítulo · interfaz 600 · --t-md

    Resumen del turno

  • cuerpo · interfaz 400 · --t-baseRevisa tus ventas, costos y mermas en un solo lugar.
  • etiqueta · interfaz 500 · --t-smLocal · Centro de producción
  • nota · interfaz 400 · --t-xsFuente: caja del local, actualizado a las 06:10.
  • cifra grande · mono 500 · --t-2xl$ 1.284.500
  • cifra · mono 400 · 14 px31,4 % · 128 boletas · 14-11-2026

Voz y cifras

Español de Chile, neutro y profesional, tuteando. Frases cortas, verbo primero, el dato antes que el adjetivo. Los errores dicen qué hacer; las celebraciones son sobrias.

SituaciónEscribeEvita
BotónCerrar cajaCerrar Caja · ¡Cerrar!
Estado vacíoAún no hay ventas importadas. Conecta tu caja y en minutos verás el día de hoy.No hay datos disponibles.
ErrorNo pudimos conectar con la caja. Revisa la clave en Sistema → Conectores.Error 500
AlertaTe quedan 3 kg de harina. Al ritmo de esta semana alcanza hasta el jueves.¡ALERTA DE STOCK!
ListoListo. Cerraste el turno con $ 842.300 en ventas.¡Genial!
Cifras$ 1.284.500 · 12,5 % · 14-11-2026 · 21:30$1,284,500 · 12.5% · 11/14/2026 · 9:30 PM

Espaciado, radios y sombras

Base de 4 px. Radios de 8 px en botones y campos, 14 px en tarjetas y paneles, píldora en las pastillas. La sombra 1 acompaña el borde de las tarjetas; la sombra 2 es solo para menús y diálogos.

--e-1 · 4
--e-2 · 8
--e-3 · 12
--e-4 · 16
--e-5 · 24
--e-6 · 32
--e-7 · 48
--e-8 · 64

--r-1 · 4--r-2 · 8--r-3 · 14--r-total

--sombra-1--sombra-2

Barra de marca

La cabecera de cada página (.cabecera, y .anotar-barra en las páginas del iPad) va en bosque profundo de borde a borde, con el logo inverso y el texto «sobre bosque». Los campos y botones que lleva dentro conservan su fondo claro y el anillo de foco cambia a brasa sobre oscuro. En tema oscuro la barra es casi negra y se funde con la página.

Botones

Tres jerarquías. El principal (.primario) lleva el relleno de acción y hay uno solo por pantalla. El secundario es el botón por defecto (cualquier <button> lo hereda): borde y texto en verde. El sutil no tiene borde y va en tinta, para acciones terciarias dentro de tablas y listas. El texto es un verbo en infinitivo y dice lo que pasa al tocarlo.

Campos de formulario

Etiqueta arriba, en frase. El campo va sobre la superficie hundida con borde de control (3:1). La ayuda va debajo y el error la reemplaza, nunca se suman. La estrella marca lo obligatorio; un borde verde indica que el valor se detectó solo y conviene revisarlo.

Tabla de datos

Encabezado fijo en frase y filas de 1 px. Las cifras van con .num: en mono tabular y alineadas a la derecha, para que las columnas cuadren. El envoltorio .tabla-env da el borde y el desplazamiento horizontal; la tabla nunca rompe el ancho de la página. Datos de ejemplo.

Tarjeta

El contenedor de todo bloque de trabajo: superficie elevada, borde de línea, radio de 14 px y sombra 1. El marcador .n solo se usa cuando las tarjetas forman una secuencia real (pasos). .inactiva atenúa lo que todavía no aplica; .compacta reduce el relleno para listas laterales.

Pastilla de estado

Una píldora con una o dos palabras que nombran el estado: el color nunca va solo. Correcto usa brote con tinta; alerta, azafrán con tinta; error es solo contorno, para distinguirse del verde por forma y no solo por tono. Sin clase es neutra y .gris, un contorno para estados sin juicio, como «esqueleto».

Cifra destacada

Una regla lateral de 3 px en verde, el número en mono con numerales tabulares y la etiqueta debajo, en lenguaje del negocio. Se agrupan en .cifras. La regla puede ser brasa (.acento) o semántica; .grande es para la cifra principal de una portada. La variación dice si es buena o mala (.sube, .baja) y el signo dice la dirección. En columnas angostas el tamaño baja para que el monto no se parta. Datos de ejemplo.

Barra de pasos

Resume un flujo secuencial: hechos en verde, el actual con doble borde, los pendientes en gris. En pantallas angostas se apila. Es un <ol> para que el orden también exista para lectores de pantalla.

Bloques de aviso y zona de arrastre

El bloque dice qué pasó y qué hacer, sin disculparse y con la palabra del estado en el texto. La zona de arrastre usa borde discontinuo y se tiñe de brote al pasar un archivo por encima.

Indicadores de hoy

La zona «Hoy» de la Portada: una regla lateral como la cifra, nombre arriba y valor en mono. Un indicador sin fuente todavía lleva la regla punteada y gris con «sin datos aún: los trae X»: la estructura dice que falta el módulo, sin ícono ni color de alerta. .aviso solo cuando la cifra pide mirar (mermas). El catálogo vive en comun.js (C.CATALOGO_INDICADORES) y la lista por rol en portada_config/indicadores. Datos de ejemplo.

Baldosas de módulos

Navegación por rol: una baldosa por módulo, agrupadas por área (.modulos-grupo), el enlace entero es el blanco y mide al menos 44 px. El dispositivo y el estado van como pastillas; .esqueleto atenúa el nombre de lo que todavía no está. Lo que cada rol ve lo decide permisos.json (C.modulosVisibles).

Resumen del día

En cada módulo operativo, administración y editor ven primero lo anotado hoy por lugar y persona; el equipo entra directo a anotar. C.resumenDia(registros, {lugares, personas}) agrupa, cuenta por persona y lista las filas con hora y nombre, todo con textContent. Sin registros, estado vacío en una línea. Datos de ejemplo.

C.resumenDia(registros, { lugares: ["Local Norte", "Fábrica"], personas: ["Persona Uno"], montar: "#aqui" })
// registros: [{ lugar, persona, cuando (ISO) | hora ("HH:MM"), fecha (AAAA-MM-DD), texto, detalle }]

Quién anota

Botonera de nombres para el iPad: cada persona toca el suyo antes de anotar y cada registro lleva persona, lugar y hora. Botones de 44 px con aria-pressed, en tinta; el elegido queda en verde. Sin personas, el estado vacío dice de dónde salen (Horarios › Personas activas → *_personas). C.quienAnota(personas, {actual, alElegir}) devuelve {elemento, elegido(), elegir(id)}.

Deshacer (5 minutos)

Tras guardar, una franja con borde verde dice qué se guardó y quién, y ofrece «Deshacer» con cuenta regresiva (5 minutos por defecto). Vencido el plazo desaparece sola; después solo queda «Borrar con motivo». La acción puede ser asíncrona y, si falla, el error se muestra en la misma franja. C.deshacer(accion, {texto, quien, duracion}).

Borrar con motivo

Confirmación dentro de la página, nunca confirm(): motivos frecuentes como botones, texto libre y «Borrar» en rojo que solo se habilita con un motivo de 4 caracteres o más. El módulo no borra físicamente: guarda el motivo, la persona y la hora en el historial. C.borrarConMotivo(callback(motivo), {texto, motivos}).

Táctil y tamaño de letra

C.barraTactil() marca <html data-tactil> cuando el puntero es grueso (iPad, celular): todos los botones pasan a 44 px y los campos a 16 px, y devuelve una barra de acciones si se le pasan botones. C.tamanoLetra() es el botón «Aa» de la cabecera: automático (grande en tabletas, normal en el resto), chico, normal, grande y muy grande, guardado en localStorage con try/catch. Escala los tokens --t-* bajo <html data-letra>; los tokens base no cambian. Esta muestra fuerza el modo táctil dentro del panel.

App instalable por página

Cada página se instala por separado (erpia/web/pwa.py): un manifest.<pagina>.webmanifest con nombre corto, el bosque profundo como color del tema y la masa como fondo de carga; el ícono de EVODA en SVG, normal y «maskable»; el bloque <!-- pwa --> en el <head>; sw.js, que no guarda páginas ni datos y solo muestra sin-conexion.html cuando no hay red. Las páginas «por lugar» no declaran start_url para que el #lugar instalado se conserve. Con una marca de cliente el ícono lleva su logo o su inicial sobre su color, y el nombre corto de la página al pie.

Marca por cliente

Sin marca de cliente, todo lo anterior es EVODA. Una marca es un JSON en erpia/web/static/marcas/<id>.json (plantilla: _plantilla.json). Al generar con --marca <id>, aplicar_marca() cambia solo el nombre, el logo y estas variables; los estados, la escala y los componentes no cambian. Las variantes hover, suave, texto encima y tema oscuro se derivan si la marca no las declara.

CampoQué cambia
nombreTítulo de la pestaña, cabecera, pie y nombre de la app instalada.
color_primarioOcupa el lugar del verde y de la acción de EVODA: --primario y sus variantes, --bosque, --bosque-texto, --accion (botón principal y foco) y, en tema claro, la barra de marca. Debe contrastar con blanco (4,5:1). Opcional color_primario_oscuro.
color_acento--acento y sus variantes. Realces, nunca acciones.
tipografia_display--fuente-display (títulos). Con tipografia_display_url se carga la hoja de Google Fonts. Las cifras siguen en mono.
logo_data_uriImagen de 28 px de alto junto al nombre en la cabecera, y centro del ícono de la app. Sin logo, la marca de cliente va solo con su nombre.
tonodata-tono="formal|cercano" en <html> y en .envoltura, como gancho para ajustar textos.