Construir · Criterio KATA
Componentes que sirven
Un componente creado antes de tiempo acaba con diez parámetros y sirviendo mal a todos los casos.
Cómo se ha elaborado esta guía
Qué estás leyendo
Es cuándo crea KATA un componente. Criterio propio.
Qué es criterio propio y qué es estándar externo
- Criterio propio: Las decisiones de construcción, los umbrales y el orden son metodología de KATA.
- Experiencia observada: Lo aprendido en proyectos propios. No se cuantifica ni se presenta como dato del sector.
- Estándar externo: Cuando se cita una norma o un umbral de un tercero, se identifica su fuente oficial con entidad y fecha.
La metodología completa está en el Método KATA.
Respuesta directa
Nuestro criterio: un componente nace a la tercera aparición, no a la primera. Con dos casos no se distingue el patrón de la coincidencia.
Y nace del patrón observado, no de una previsión. Los componentes diseñados por anticipación acumulan opciones para casos que nunca llegan.
Qué se convierte en componente y qué no
| Situación | Decisión |
|---|---|
| Aparece tres veces igual. | Componente. |
| Aparece tres veces parecido pero con diferencias de fondo. | Dos componentes distintos, no uno con opciones. |
| Aparece dos veces. | Todavía no. Se duplica y se espera. |
| Aparece una vez y «seguro que se repetirá». | No. Es previsión, no patrón. |
| Requiere más de tres o cuatro opciones para cubrir sus usos. | Señal de que son varios componentes mezclados. |
Duplicar a veces es lo correcto
Duplicar tiene mala fama y a veces es la decisión correcta. Un fragmento duplicado dos veces es fácil de unificar después; un componente equivocado es difícil de deshacer porque ya tiene usuarios.
Nuestro criterio es preferir la duplicación temprana a la abstracción prematura. La primera cuesta un poco de repetición; la segunda cuesta arquitectura.
La señal de que un componente está mal
- Tiene una opción llamada
variant,tipoomodocon cinco valores. - Hay condicionales dentro que cambian su estructura, no su apariencia.
- Para usarlo hay que leer su código.
- Cada nuevo uso añade una opción más.
- Nadie se atreve a tocarlo porque no sabe quién lo usa.
Dónde este criterio NO aplica
- Bibliotecas de componentes para varios proyectos, donde la generalización sí es el objetivo.
- Equipos grandes donde la duplicación tiene un coste de coordinación mayor.
- Sistemas de diseño consolidados con componentes ya validados por uso.
Preguntas frecuentes
¿Por qué tres y no dos?
Es un criterio propio, no una ley. Con dos apariciones es difícil saber qué parte es común y qué parte es circunstancial. A la tercera suele verse con claridad.
¿Los componentes hacen la web genérica?
La hacen coherente. Genérica la hace no decidir nada dentro del sistema y aceptar los valores por defecto. Un botón coherente en todo el sitio es una virtud; un botón idéntico al de todos los sitios es otra cosa.
Siguiente decisión
Continúa con una pregunta concreta
Reconstrucción y mejora de webs existentes
Qué podemos abordar contigo y cómo delimitamos el trabajo.
Reconstrucción y mejora de webs existentes →
Ilustraciones conceptuales; no son fotografías de clientes.