Explaining How a System Works
Walk a colleague and a manager through how your system works, in clear Spanish.
In Spanish tech teams, explanations happen at the whiteboard (la pizarra) with lots of signposting: por un lado, luego, básicamente, para resumir. Technical nouns like API, app and backend stay in English, but the glue is pure Spanish. The cards follow an onboarding session with a new developer in Madrid, then the same system explained in plain terms to a product manager.
- 1
Empiezo por la visión general.
Let me start with the big picture.
- 2
Se compone de tres partes principales.
Our system is made up of three main parts.
- 3
Por un lado está la app y, por otro, el backend.
On one side there's the app, and on the other, the backend.
- 4
Básicamente, funciona así.
Basically, it works like this.
- 5
La app manda una petición al servidor.
The app sends a request to the server.
- 6
El servidor comprueba si el usuario existe.
The server checks whether the user exists.
- 7
Luego los datos se guardan en la base de datos.
Then the data gets saved in the database.
- 8
Todo está conectado a través de una API.
Everything is connected through an API.
- 9
Esta parte es la más crítica.
This part is the most critical one.
- 10
¿Hasta aquí tiene sentido?
Does that make sense so far?
- 11
Espera, te lo dibujo en la pizarra.
Hang on, I'll draw it for you on the whiteboard.
- 12
Dicho de forma sencilla, es como una oficina de correos.
To put it simply, it's like a post office.
- 13
¿Qué pasa si se cae el servidor?
What happens if the server goes down?
- 14
Hay un servidor de respaldo que se pone en marcha solo.
There's a backup server that kicks in automatically.
- 15
¿Dónde están alojados los datos?
Where is the data hosted?
- 16
Todo está en la nube.
It's all in the cloud.
- 17
Luego entro en detalles.
I'll go into the details later.
- 18
¿Alguna duda hasta ahora?
Any questions so far?
- 19
Espera, retrocedo un poco.
Hang on, let me back up a bit.
- 20
Bueno, para resumir: tres partes que hablan entre sí.
So, to sum up: three parts that talk to each other.