Un vocabulario de errores que convierte un resultado técnico en un siguiente paso útil
Un usuario ve «error», vuelve a hacer clic y no sabe si algo ha cambiado. En tu cliente de SimAggregator, separa la situación observada de la acción disponible. Se trata de un vocabulario local de la interfaz; no sustituye las respuestas documentadas de la API ni crea estados de la plataforma.
Para cada situación, anota qué se sabe, qué sigue sin saberse, qué puede hacer el usuario y qué comprobará la aplicación. Una respuesta que no llega significa incertidumbre sobre el resultado, no un permiso automático para repetir la compra. Una opción no disponible y una conexión perdida necesitan explicaciones distintas.
Vincula el registro técnico con una frase legible mediante la referencia interna de tu aplicación. Da contexto a los traductores, en lugar de palabras sueltas. «Inténtalo más tarde» no ayuda cuando un botón activo sigue pareciendo un siguiente paso obligatorio.
Prueba el vocabulario con casos sintéticos. Un compañero de equipo que no haya leído el código debería poder explicar qué ha ocurrido y qué acción se ofrece. Conserva la causa técnica original en los diagnósticos protegidos, para que una redacción más clara no borre distinciones necesarias durante la investigación. Revisa todos los idiomas admitidos cada vez que cambie la acción sugerida.