/layers-conceptual-model
Asume que /layers-intro ha sido cargado para obtener el contexto del marco de trabajo.
El modelo conceptual es la capa de carga estructural más descuidada. Define los objetos que el producto reconoce, sus relaciones, los estados que pueden alcanzar y el vocabulario empleado para todo ello. Reside en el espacio de solución: no es una captura de los modelos mentales existentes de los usuarios (que son contradictorios y desordenados — esa es la labor de la capa de dominio), sino una decisión de diseño deliberada sobre cómo el producto modelará su dominio.
Lo que es — y no es:
- Una decisión de diseño que resuelve el dominio desordenado en una estructura coherente y con opinión.
- No es un esquema de base de datos — los ingenieros toman sus propias decisiones sobre los datos, pero la brecha entre este modelo y lo que construyen es importante. Una brecha grande y no examinada es tanto deuda de UX (los usuarios encuentran un producto que contradice el modelo) como deuda técnica (el sistema es más difícil de evolucionar).
- No es un wireframe ni un flujo — no hay pantallas ni navegación. Eso pertenece a las capas superiores.
- No es neutral — cada decisión de nomenclatura, cada límite de relación, cada objeto incluido o excluido refleja un punto de vista.
Decisiones que esta capa debe tomar:
- ¿Qué objetos reconocerá este producto y cuáles son sus límites?
- ¿Cómo se relacionan esos objetos entre sí?
- ¿Qué pueden hacer los usuarios con cada objeto?
- ¿Qué estados puede alcanzar cada objeto y qué transiciones son importantes?
- ¿Cuál es el vocabulario del producto? — un nombre por concepto, elegido y asumido.
Métodos:
| Método | Cuándo usarlo |
|---|---|
| Recolección de nombres + OOUX (Sophia Prater) | Por defecto cuando se dispone de investigación o notas de dominio para explotar. Extrae objetos del lenguaje natural. |
| Diseño de interacción semántica / gramática de acciones (Daniel Rosenberg) | Cuando hay muchas acciones sobre muchos objetos y se quiere auditar la consistencia y precisión de los verbos. |
| Event storming — fase de comandos/políticas (Brandolini) | El dominio tiene procesos complejos. Empezar por lo que ocurre y trabajar hacia atrás hasta los objetos involucrados. |
| Card sorting | El vocabulario no está claro o es motivo de controversia entre usuarios o equipos. |
| Mapeo de contextos delimitados (DDD) | Varios tipos de usuarios usan las mismas palabras con significados diferentes — revela dónde el modelo tiene costuras naturales. |
| Recorrer el producto existente | Rediseño. La interfaz actual revela el modelo implícito; compararlo con cómo piensan realmente los usuarios. |
Por defecto: recolección de nombres y definición de objetos.
Señales de calidad — cómo se ve un buen modelo:
- Cada objeto es significativo de forma independiente para el usuario — no un elemento de interfaz, no una abstracción vaga.
- Los roles de las relaciones se nombran explícitamente cuando un objeto puede desempeñar varios roles.
- Los atributos que en realidad son relaciones han sido cuestionados y convertidos.
- Sin adiciones especulativas — cada objeto, atributo y relación se remonta a una necesidad del usuario.
- Las transiciones de estado están definidas para objetos cuyo estado cambia materialmente lo que los usuarios pueden hacer.
- Se abordan las decisiones temporales: semántica de eliminación, temporalidad de relaciones, historial.
- Se establece un lenguaje ubicuo: un nombre por concepto, un concepto por nombre.
Sesión guiada
Dime qué producto o característica estás definiendo un modelo, o di "guíame" para empezar la recolección de nombres y la definición de objetos.
Pregunta: "¿Dónde debo capturar el trabajo de esta sesión?" (consulta /layers-intro para opciones)
Comprueba qué tiene el diseñador del espacio del problema: notas de dominio, investigación, necesidades de usuario. Si no hay nada: continúa, pero advierte que un modelo construido sin conocimiento del dominio a menudo refleja suposiciones más que la realidad de los usuarios.
Si es un rediseño: "Describe el modelo actual, aunque sea informalmente — ¿qué modelo implícito tiene el producto existente?"
Fase 1 — Enmarcar el alcance
- ¿Para qué producto o característica estamos definiendo un modelo conceptual?
- ¿Cuál es la tarea principal que los usuarios intentan realizar con él?
- ¿Con qué material cuentas?
Fase 2 — Descubrir objetos
A partir de la investigación o notas de dominio: Extrae cada nombre — cosas, personas, roles, documentos, lugares, estados, conceptos, eventos. Amplía el alcance; no filtres aún. Presenta la lista en bruto, luego pregunta: ¿faltan nombres? ¿Mismas cosas con nombres diferentes?
A partir de un producto existente: Recórranlo juntos. "¿Qué está viendo un usuario aquí? ¿Cómo se llama esta cosa?"
A partir de primeros principios: "Si un usuario pudiera alcanzar y pasar algo a un colega, ¿qué pasaría?"
Clasifica en:
- Objetos — cosas que persisten, tienen sus propios atributos y son importantes para el usuario por derecho propio.
- Atributos — propiedades que describen un objeto, no objetos en sí mismos.
- Apartar — elementos de interfaz, abstracciones vagas, acciones disfrazadas de nombres.
Un objeto verdadero debe ser significativo de forma independiente para el usuario, no solo una propiedad de otra cosa.
Fase 3 — Definir cada objeto
Trabaja con cada objeto central:
Objeto: [Nombre]
Quées: [una frase desde la perspectiva del usuario]
Atributos: [propiedades que un usuario conoce o le importan]
Relaciones: [conexiones con otros objetos — cardinalidad y nombres de roles]
Acciones (CTAs): [lo que un usuario puede hacer con o a este objeto]
Cinco comprobaciones de disciplina:
-
Roles de relación: Cuando una relación se conecta a un objeto que puede desempeñar varios roles (por ejemplo, un Usuario que es tanto referente como referido), nombra el rol explícitamente: "pertenece a un Usuario (como referente)" no "pertenece a un Usuario".
-
Atributos que en realidad son relaciones: Si un atributo es solo el nombre o ID de otro objeto en el modelo, es una relación — modelízalo, no lo dupliques como atributo.
-
Sin adiciones especulativas: No añadas atributos, relaciones o acciones que no estén fundamentados en una necesidad de usuario declarada. La expansión del alcance en la capa del modelo conceptual se propaga a todas las capas superiores.
-
Implementación vs. decisiones de diseño: Cuando la conversación derive hacia cómo se genera, almacena o computa algo — redirige: "Cómo se genera es ingeniería. Lo que importa aquí: ¿puede un usuario cambiar esto? ¿Qué sucede con las cosas que ya lo referenciaban?"
-
Precisión del verbo: Para cada acción, pregúntate si el verbo le dice al usuario con qué se encontrará o qué operación del mundo real está realizando. "Introducir un PIN" falla porque implica que el PIN ya existe — "Crear" es preciso. Más críticamente: comprueba si un verbo genérico (Editar, Eliminar, Actualizar) está ocultando operaciones con consecuencias del mundo real significativamente diferentes. "Editar dirección" confunde corregir un error tipográfico con registrar un cambio de domicilio — dos operaciones donde una conserva el historial y la otra no, requiriendo un comportamiento del sistema diferente y una intención del usuario diferente. Una interfaz deductiva usa verbos genéricos y pide a los usuarios que mapeen su intención a ellos; una interfaz inductiva nombra la operación del mundo real ("Registrar cambio de domicilio") y preserva su significado. Cuando un verbo genérico podría significar cosas distintas dependiendo de lo que el usuario realmente está tratando de hacer, nombra las operaciones por separado.
Fase 4 — Mapa de objetos
Genera un mapa relacional de objetos: entidades como nodos, relaciones como líneas etiquetadas con marcadores de cardinalidad. Sin orientación fija — sigue lo que haga las relaciones más legibles. En Mermaid: erDiagram.
Al presentar, explica la cardinalidad: || = exactamente uno, o{ = cero o muchos, |{ = uno o muchos. La pata de cuervo siempre está en el lado "muchos". Las etiquetas de relación se leen en la dirección declarada (primera entidad → segunda entidad).
Pregunta: "¿Esto refleja cómo piensas acerca de estas cosas? ¿Faltan relaciones, direcciones invertidas, conexiones que no deberían estar?"
Fase 5 — Transiciones de estado y decisiones temporales
Para cada objeto donde el ciclo de vida o el estado importe: "¿Qué estados puede tener un [Objeto]? ¿Qué lo mueve entre estados? ¿Qué se vuelve imposible en cada estado?"
Genera un diagrama de estado: estados como nodos, transiciones como flechas etiquetadas, con un estado inicial claro. De arriba a abajo o de izquierda a derecha según el número de estados. En Mermaid: stateDiagram-v2.
También explora las decisiones temporales (de /layers-intro): estados de acción intermedia, desfase del modelo de lectura, temporalidad de relaciones, semántica de eliminación, historial. Para preguntas entrelazadas con la implementación, no fuerces una respuesta prematura — articula el requisito de experiencia de usuario y márcalo como una pregunta abierta nombrada para una conversación con ingeniería.
Fase 6 — Lenguaje ubicuo
El lenguaje ubicuo cubre tanto nombres (objetos, atributos) como verbos (acciones). El mismo principio se aplica a ambos: una palabra por concepto, un concepto por palabra.
Nombres: Enumera cada nombre de objeto y atributo elegido. Para cualquier nombre con sinónimos o conflictos de nomenclatura:
Término: [nombre elegido]
Alternativas rechazadas: [otros nombres que aparecieron]
Decisión: [por qué se eligió este término]
Verbos — vocabulario de acciones: Compila todos los verbos de acción en todos los objetos. Aplica dos pruebas:
Comprobación de sinónimos: ¿Se están usando varios verbos para la misma operación? "Crear" y "Añadir" para el mismo tipo de acción deberían consolidarse. Minimizar el vocabulario de verbos reduce lo que los usuarios tienen que aprender — el mismo verbo funcionando de forma idéntica en todos los objetos (como cortar/copiar/pegar) significa que los usuarios aprenden una vez y transfieren a todas partes. Cada sinónimo es algo nuevo que memorizar.
Comprobación de aplanamiento: El riesgo opuesto — un verbo que cubre operaciones que son genuinamente diferentes. "Editar dirección" suena simple hasta que te das cuenta de que combina dos cosas: corregir un error tipográfico (sobrescribir está bien) y registrar un cambio de domicilio (que debería crear un nuevo registro y preservar el anterior). El dominio trata estas cosas de manera diferente; la interfaz no debería ocultarlo. Para cada verbo CRUD genérico (Editar, Eliminar, Actualizar, Crear), pregúntate: ¿podría cubrir operaciones con consecuencias del mundo real diferentes — implicaciones de historial diferentes, efectos secundarios diferentes, cosas que el usuario realmente intenta lograr diferentes? Si es así, dales nombres separados. "Registrar cambio de domicilio" y "Corregir dirección" no son verbosos — son precisos.
Verbo: [nombre de acción elegido]
Se aplica a: [qué objetos]
Alternativas rechazadas: [otros verbos considerados]
Decisión: [por qué este verbo; qué operación del mundo real nombra]
"Este es el lenguaje ubicuo de tu producto. Usa estos términos de manera consistente — en la interfaz, en el texto de ayuda, en los nombres de las API, en la conversación interna. Cada inconsistencia entre este modelo y la superficie crea carga cognitiva para los usuarios."
Finalización
Produce:
- Definiciones de objetos — atributos, relaciones y acciones.
- Mapa de objetos —
erDiagram. - Diagramas de transición de estado — para objetos con ciclos de vida significativos.
- Lenguaje ubicuo — nombres y verbos elegidos con conflictos resueltos y decisiones.
- Preguntas abiertas — decisiones aplazadas, objetos que parecían endebles, cualquier cosa señalada pero no resuelta.
Cierra con: "El modelo conceptual define lo que existe en este producto. Siguiente: diseñar cómo los usuarios interactúan con esos objetos. Ejecuta /layers-interaction-flow."
Si no se ha realizado trabajo de dominio: "Este modelo se construyó sin investigación de dominio — es una hipótesis. Planifica revisitarlo una vez que tengas evidencia."