FarmatodoBrand Manual
Sección 05

Producto

Tokens, componentes y patrones para construir interfaces consistentes — del e-commerce a la app de farmacia.

Bloque A

Elementos generales

Las piezas fundacionales: tokens de diseño, botones, inputs, tarjetas, header y reglas de accesibilidad. Todo lo que se reutiliza dentro de cualquier componente más complejo.

5.1 Tokens

Espaciado · Radio · Sombra

Spacing — escala 4pt
space-14px
space-28px
space-312px
space-416px
space-624px
space-832px
space-1248px
space-1664px
Radius
radius-none0
radius-sm6px
radius-md10px
radius-lg16px
radius-xl24px
radius-full9999px
Shadow
shadow-sm
shadow-md
shadow-lg
5.2 Botones

Variantes y estados

Default
Hover
Focus
Disabled
Primario
Secundario
Brillante
Acción
Ghost
Outline
Soft

Cuándo usar cada botón

VarianteCuándo usarEvitarEjemplos
buttonClass("primary")
Acción principal de la pantalla (1 por vista). Convierte o avanza el flujo.No usar más de uno por sección. No para acciones destructivas.Comprar · Continuar · Guardar cambios
buttonClass("bright")
CTA promocional o de alta visibilidad sobre fondos claros y banners.No mezclar con Primario en el mismo bloque (compiten por atención).Aprovechar oferta · Ver promoción
buttonClass("action")
Botón flotante o de asistente IA donde se necesita azul cobalto vivo y sombra elevada.No usar en formularios densos: su saturación domina la jerarquía.Pedir al asistente · Generar con IA
buttonClass("secondary")
Acción complementaria al Primario (cancelar, volver, alternativa).No usar sola como CTA principal.Cancelar · Ver detalles
buttonClass("outline")
Acciones terciarias con jerarquía media en superficies blancas.Evitar sobre fondos de color: el stroke gris pierde contraste.Descargar PDF · Exportar
buttonClass("soft")
Botones agrupados en toolbars, tablas o filtros donde un border duplicaría líneas.No usar como CTA principal ni sobre fondos oscuros.Filtrar · Ordenar · Columnas
buttonClass("ghost")
Acciones de bajo énfasis dentro de cards o como link visual.No combinar dos Ghost seguidos: parecen texto plano.Ver más · Saltar paso
5.3 Inputs

Campos y formularios

CuidadoBellezaBebésVitaminas
5.4 Patrón

Tarjeta de producto

Más vendido
Cuidado personal
Vitamina C 1000mg
$ 38.900
Nuevo
Cuidado personal
Protector solar SPF 50
$ 64.500
Genérico
Cuidado personal
Acetaminofén 500mg x20
$ 12.300
5.5 Header

Patrón de navegación e-commerce

FARMATODO
Envío gratis desde $50.000·Recoge en tienda en 1 hora
5.6 Accesibilidad

Reglas mínimas

  • Contraste mínimo 4.5:1 para texto cuerpo, 3:1 para texto grande.
  • Focus ring visible siempre — outline 2px Azul Brillante con offset 2px.
  • Áreas táctiles ≥ 44×44 px en mobile.
  • Iconos sin texto deben llevar aria-label descriptivo.
  • Estados disabled comunicados además de por opacidad (cursor, aria).
5.7 Toasts

Mensajes y notificaciones

Patrones de toast para confirmar acciones, reportar errores, mostrar progreso y notificar eventos. Usa colores de marca: azul profundo para éxito, naranja para advertencias, rojo para errores. Nunca uses verde.

0
Acción confirmada

Para confirmar una acción del usuario. Glass + gradient azul, pill blanca con check. Reemplaza al toast.success plano.

1
Estados básicos

Cuatro severidades con iconografía clara. Nunca uses verde — azul profundo para éxito.

2
Toast con acción

Cuando hay una acción reversible o un siguiente paso claro, ponla a un click de distancia.

3
Promesa / carga

Para operaciones asíncronas, usa toast.promise. El usuario ve progreso sin bloquear la UI.

4
Contenido rico

Cuando necesitas mostrar datos estructurados, un toast custom mantiene todo compacto.

5
Secuencia de eventos

Cuando ocurren varios cambios en cascada, notifica el resumen, no cada micro-paso.

6
Posiciones y duración

Los toasts de error deben persistir más tiempo. Los de éxito pueden desaparecer rápido.

Bloque B

Componentes

Patrones compuestos listos para usar: formularios asistidos por IA, jerarquías, grids editables y tableros para gestión. Cada uno se apoya en los elementos generales del bloque anterior.

5.8 Formulario AI

Patrones de formulario asistido por IA

Demuestra los buenos patrones cuando un agente acompaña al usuario: stepper visible para reducir carga cognitiva, autocomplete con predicción inline (ghost text + Tab para aceptar), sugerencias contextuales del agente, validación con propuesta de corrección, y resumen final tipeado por el agente. El usuario siempre puede sobrescribir cualquier valor sugerido.

Reabastecimiento asistido

Nueva orden de reabastecimiento

El agente sugiere, tú decides. Cada campo se pre-llena con razón visible — siempre puedes sobrescribir.

Paso 1

¿A qué tienda enviamos?

El agente prioriza tiendas con stock bajo en tu región.

Sugerencias
Paso 1 / 4
1
Jerarquía clara

Un solo H4 por paso, eyebrow mono para contexto, hint del agente debajo. El usuario sabe siempre dónde está.

2
Auto-completion + ghost text

La predicción aparece atenuada dentro del input. Tab acepta, ↵ confirma de la lista. Nunca bloquea escritura libre.

3
Sugerencia, no decisión

El agente pre-llena con razón visible (“Aceptar sugerencia” / “Editar antes de aceptar”). Cero magia oculta.

4
Validación constructiva

Cuando algo se sale del rango, el sistema muestra el problema y propone la corrección en un solo click.

5.9 Formulario AI · denso

Variante con múltiples campos por pantalla

Misma promesa que el formulario por pasos, pero optimizado para usuarios expertos que quieren ver y editar todo de una. La IA aporta un CTA de auto-completado global, asistencia campo por campo (autocomplete con ghost text, sugerencias inline, presets) y un panel lateral con resumen en vivo. La validación es local: nunca bloquea otros campos.

Reabastecimiento · vista densa

Nueva orden — todos los campos en una pantalla

Para usuarios expertos. La IA puede pre-llenar todo o solo asistir campo por campo.

Progreso2/8 · 25%
Sección 1
Tienda y responsable
Sección 2
Producto y cantidad
Sección 3
Vigencia y notas
Faltan 6 campos
1
Densidad con jerarquía

Secciones agrupadas con ícono + eyebrow + título corto. Sin stepper: una progress bar fina comunica avance.

2
Auto-fill con razón visible

Un solo CTA pre-llena todos los campos. Aparece un panel lateral explicando por qué eligió cada valor.

3
Asistencia campo a campo

Cada input mantiene su patrón: ghost text en autocomplete, suffix con valor sugerido, presets para fechas.

4
Resumen IA en vivo

El panel lateral re-tipea el resumen cada vez que cambia un campo crítico. Cero magia escondida.

5.10 Field feedback

Cuando un campo no está bien

El feedback útil es contextual: aparece donde el ojo ya está, dice qué está mal y, cuando es posible, ofrece la corrección en un solo click. Severidad jerarquizada (info → warn → error), validación blanda mientras escribe y firme al salir, nunca un muro de errores rojos para el usuario.

1
Validación blanda mientras escribe

No grites antes de tiempo. Mientras el usuario escribe, sólo da hints en gris. La firmeza llega al onBlur o submit.

Mínimo 6 caracteres
2
Error con sugerencia de corrección

Si puedes adivinar la intención (typo de email, formato de teléfono), ofrécelo como un click.

¿Quisiste decir ana@gmail.com?
3
Reglas en vivo (checklist)

Cuando hay varios criterios (password, código), muéstralos como checklist que se llena en tiempo real.

Buena
  • Mínimo 8 caracteres
  • 1 mayúscula
  • 1 número
  • 1 símbolo (!@#$…)
4
Async · validación con servidor

Estados claros: idle → cheking → ok / taken. Nunca dejes el usuario sin saber qué pasó.

farmatodo.co/
5
Rango fuera de contexto

Cuando el valor es válido sintácticamente pero raro en contexto, muestra warning con cifra de referencia y opción de ajuste.

unidades
0sugerido 240máx 400
6
Resumen al submit

Si hay varios errores, listálos arriba con anchor a cada campo. El usuario nunca debe cazar errores.

No pudimos enviar la orden — 3 campos con problemas

Resuélvelos y reintenta. El resto del formulario está OK.

  • Tiendaok
  • Email del responsablerequiere atención
  • Cantidadrequiere atención
  • Vigenciaok
  • Loterequiere atención
5.11 Jerarquía

Vista de empleados en lista

Lista jerárquica expandible para visualizar la estructura del equipo: tags por rol y ubicación, y métricas clave (tamaño de equipo, OKR con tendencia, antigüedad y performance) leíbles en una sola línea. La indentación + línea vertical comunican profundidad sin saturar.

Organización · Producto
Jerarquía de equipo
  • CR
    Carolina RestrepoProductoC-LevelBogotá
    Chief Product Officer
    • MV
      Mateo VélezDiseñoLeadHíbrido
      Head of Design
    • AG
      Ana María GómezIngenieríaLeadRemoto
      Head of Engineering
    • JM
      Julián MoraInvestigaciónLeadMedellín
      Head of Research
5.12 Spreadsheet

Tabla editable tipo Excel

Grid navegable por teclado: flechas para moverte, Enter o doble-click para editar, Tab para saltar a la siguiente columna, Esc para cancelar. Cabeceras tipo A, B, C y barra de fórmula con la celda activa — el patrón mental que cualquier usuario de Excel ya conoce.

A1
text
Acetaminofén 500mg x20
AProductotext
BSKUtext
CCategoríaselect
DStocknumber
EPrecionumber
FEstadoselect
GTagstags
1Acetaminofén 500mg x20FT-0021
Medicamentos
1.240$ 12.300
Activo
GenéricoTop
2Vitamina C 1000mgFT-0044
Vitaminas
860$ 38.900
Activo
Top
3Protector solar SPF 50FT-0118
Belleza
312$ 64.500
Activo
ImportadoNuevo
4Crema corporal hidratanteFT-0231
Cuidado
540$ 29.900
Activo
Promo
5Pañal etapa 3 x40FT-0309
Bebés
180$ 54.200
Bajo stock
Top
6Shampoo anticaspa 400mlFT-0412
Belleza
0$ 27.800
Agotado
7Ibuprofeno 400mg x10FT-0577
Medicamentos
2.100$ 8.900
Activo
RecetaGenérico
8Multivitamínico adultosFT-0688
Vitaminas
470$ 45.600
Activo
Nuevo
9Jabón antibacterialFT-0790
Cuidado
1.320$ 6.500
Activo
Promo
10Fórmula infantil 800gFT-0815
Bebés
92$ 78.900
Bajo stock
Importado
11Mascarilla facial x5FT-0902
Belleza
640$ 19.900
Activo
NuevoPromo
12Termómetro digitalFT-1010
Cuidado
210$ 32.000
Activo
13
14
Celda A1·14 filas × 7 columnas↑ ↓ ← → mover · Enter abrir · Esc cerrar · Tab siguiente
5.13 Project Management

Kanban con filtros

Primera vista de la suite de gestión de proyectos: tablero kanban con columnas de flujo (Backlog → En curso → Revisión → Listo), tarjetas con proyecto, prioridad, responsables, due-date y progreso de subtareas. Los filtros combinables (proyecto, prioridad, responsable) y la búsqueda libre permiten cortar el tablero sin perder el contexto visual. Vencimientos vencidos en rojo, prioridad y proyecto codificados en azules de la marca.

3 junAlta

Rediseño de carrito de compras móvil

CRLL
#UX#Mobile
5/983T-128
6 junMedia

Notificaciones push de recordatorio de medicamento

LL
#Mobile#Notif
2/741T-142
9 junMedia

Dashboard de SLA last-mile en tiempo real

DS
#Dashboard#SLA
4/862T-150
5.14 Project Management

Kanban de contratación

Segundo ejemplo de la suite: pipeline de hiring con etapas (Aplicaciones → Screening → Entrevistas → Oferta → Contratado). Tarjetas con foto-iniciales, posición, seniority, ubicación, rango salarial, calificación y próximo paso. Filtros por posición, seniority y fuente; los candidatos que llevan más de 10 días en una etapa se marcan en rojo para evitar que se enfríen.

VR

Valentina Ríos

Frontend Engineer
C-401
SeniorLinkedInReactDesign systems
Bogotá · Híbrido
$9.5M – $11M
Próximo: Panel técnico 4 jun
2d en etapa
CR
JC

Juan D. Castaño

Data Scientist
C-404
LeadHeadhunterMLPersonalización
Cali · Remoto
$13M – $15M
Próximo: Case study
8d en etapa
MV
Bloque C

Project management

Vistas para planear y dar seguimiento: timeline con dependencias, calendario, roadmap por trimestres y planeación de sprint. Comparten paleta y atomos con los kanbans para sentirse parte de un mismo sistema.

5.15 Project Management

Timeline · Gantt con dependencias

Barras por proyecto con relleno proporcional al progreso, línea vertical de “hoy” y agrupación por proyecto con color propio. El filtro superior recorta a un solo proyecto para hacer foco. Pensado para horizontes de 4 semanas; escala bien para roadmaps tácticos sin volverse Microsoft Project.

Proyecto
Hoy · día 11
Tarea
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
App móvil
4 tareas
MR
100%
JC
80%
LP
40%
DR
10%
Pricing IA
3 tareas
AN
100%
AN
60%
SC
0%
Loyalty
3 tareas
VR
100%
VR
50%
MM
0%
Ops
2 tareas
RC
75%
RC
20%
Arrastra la barra para mover · bordes para redimensionar · doble click para editar·Línea azul = hoy
5.16 Project Management

Calendario · mensual y semanal

Misma data, dos densidades: una vista de mes para ver volumen y ritmo, y una de semana con franjas horarias para coordinar reuniones y bloques de trabajo. Cada evento hereda el color de su proyecto para reconocerse de un vistazo.

Mayo 2026
Lun
Mar
Mié
Jue
Vie
Sáb
Dom
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
productaiopsloyaltyArrastra eventos · click para editar · click en día vacío para crear
5.17 Project Management

Roadmap por trimestres

Swimlanes por equipo, columnas por trimestre y barras que abarcan uno o varios Q. Los hitos se marcan con un diamante bajo la barra. La columna actual tiene un tinte azul muy sutil para anclar el presente sin robar protagonismo a lo que viene.

Equipo
Q1 · 2026
Q2 · 2026Actual
Q3 · 2026
Q4 · 2026
Producto
Rediseño checkout
Wishlist v2
App tabletas tienda
Lanzamiento wishlist
IA
Pricing dinámico
Recomendador home
Agente farmacéutico
Pricing en producción
Loyalty
Tiers + reglas puntos
Piloto Bogotá
Rollout nacional
Rollout nacional
Ops
Auditoría tiendas
Plan optimización
Nueva CD norte
Hito· En curso·Arrastra tarjetas entre trimestres y equipos · click para editar · click en el badge para cambiar estado
5.18 Project Management

Sprint · capacity planner

Carga por persona en story points con barra de ocupación: si alguien se pasa de su capacidad, la barra cambia a naranja y aparece un aviso. La tabla de historias permite reasignar en vivo para balancear el sprint antes de empezar.

Sprint 14 · 26 may → 9 jun
51 pts planeados · 54 pts capacidad
Ocupación del equipo94%
MR
Mariana R.
10 / 13 pts
JC
Julián C.
8 / 10 pts
LP
Laura P.
5 / 8 pts
DR
Diego R.
18 / 13 pts
Sobrecargado +5 pts
AN
Ana N.
10 / 10 pts
Historias del sprint
Edita puntos, prioridad y asignación · todo se refleja en la capacidad
HistoriaPuntosPrioridadAsignado a
Buscador con autocomplete IA
5
MR
Modal de detalle de producto
3
JC
Filtros guardados
5
JC
A/B test pricing
8
AN
Empty states catálogo
2
LP
Notificaciones push
5
DR
Onboarding tarjetas
3
LP
Migración API v2
13
DR
Reglas de puntos
5
MR
Métricas evento checkout
2
AN
∙ Spec

Guía agent-friendly

Agent spec
Producto · anatomía y estados