Cambiar valores con contextos
Un escenario decide qué pasa. Un contexto decide cómo se ven los valores.
Cada proveedor trae uno, así que un backend responde con datos con forma del proveedor en cuanto arranca: un descriptor de extracto en el formato que usa Stripe, referencias que parecen las de ese proveedor, monedas en las que de verdad liquida. Un contexto tuyo reemplaza las partes de eso que te importan.
Cuándo necesitas uno
Los valores incluidos son realistas pero genéricos. Escribe un contexto cuando tus tests, tus fixtures o tus capturas de pantalla necesiten que los valores sean tuyos:
- Tu propia cuenta de comercio, tienda o identificadores de cuenta, para que las respuestas coincidan con lo que espera tu sistema de staging.
- Una lista de monedas acotada a las que de verdad vendes.
- Formatos de referencia que tu código de parseo o de conciliación ya da por sentados.
Dónde viven
Abre el backend, ve a Contextos, elige un proveedor y usa la pestaña Este backend.
El documento es un mapa de nombres de campos a valores. Un nombre coincide con ese campo donde sea que aparezca en una respuesta, a cualquier profundidad, así que currency cubre cada campo de moneda que devuelva el proveedor. Anida un nombre dentro de un objeto para acotar una palabra común como name, code o value a un solo lugar.
Solo se reemplazan los nombres que escribas. Todo lo demás cae a lo que trae el proveedor, así que un documento de tres líneas es un contexto perfectamente válido.
Ver sobre qué estás encimando
La pestaña De fábrica muestra el contexto propio del proveedor: los nombres que vale la pena reemplazar, y los formatos en los que vienen. Léela antes de escribir sobre una parte de ella.
Copiar este documento lo lleva entero a tu pestaña, que es la forma fácil de partir de algo que funciona.
Alcance
Un contexto pertenece a un alcance de proveedor: una marca, una API de ella, o una versión exacta.
Cada alcance que coincida se aplica, del más fino al más ancho. Un nombre escrito a nivel de versión gana para ese nombre, y el contexto de la marca igual aporta cada nombre que el de la versión deja afuera.
Escribe a nivel de marca los valores que valen para un proveedor, y recurre a una versión solo donde esa versión de verdad se diferencie.
Qué se revisa
Nada revisa un contexto cuando lo guardas. Un escenario se revisa contra el vocabulario del build antes de guardarse; un contexto no, porque es un mapa libre de nombres a valores.
El backend igual mantiene sus respuestas atadas a la spec del proveedor. Un valor que no encaja con el tipo del campo, o que no es uno de los valores que ese campo permite, no se usa: el backend genera uno que encaje en su lugar. Así que un contexto puede guardarse sin problemas y aun así producir valores que no escribiste.
Un nombre que el proveedor nunca devuelve tampoco es un error. Simplemente nunca coincide con nada.
Si un valor no vuelve como esperabas, las causas habituales son un tipo o un valor permitido que el campo no acepta, un nombre que no aparece en esa respuesta, o un nombre tan común que necesitaba anidarse.
Ponerlo en marcha
Guardar almacena el documento. Desplegar lo pone sobre el backend en marcha.
Quitar la sobrescritura devuelve a ese proveedor a los valores que trae.