Diagrama de secuencia para darle like a un post en el feed :p

Los diagramas de secuencia son la forma más clara de visualizar cómo interactúan usuarios, capas y bases de datos dentro de una aplicación. Si estás diseñando software y necesitas explicar un flujo de usuario sin perderte en código, esta técnica te ahorra horas de explicaciones y reuniones.
Aprenderás a leer, construir y compartir diagramas de secuencia usando una herramienta gratuita llamada Sequence Diagram, ideal para desarrolladores, diseñadores y product managers que quieran comunicar interacciones de forma visual.
¿Para qué sirve un diagrama de secuencia en flujos de usuario?
Un diagrama de secuencia te permite representar de forma gráfica y resumida cómo reaccionan todas las entidades involucradas ante una acción del usuario. En lugar de describir con palabras qué pasa cuando alguien hace clic en un botón, lo dibujas.
Piensa en la venta de un ticket de metro [0:30]. El usuario paga, escoge el tipo de ticket, el sistema lo crea y finalmente el usuario lo retira. Con un diagrama, esas cuatro acciones se ven en segundos y queda claro qué capa hace qué.
¿Qué es un diagrama de secuencia? Es una representación gráfica que muestra cómo interactúan actores, capas y bases de datos a lo largo del tiempo cuando se ejecuta una acción del usuario.
¿Cuáles son los elementos básicos del diagrama?
Todo diagrama de secuencia se construye con cuatro piezas fundamentales [1:08]:
No hay un límite estricto. Puedes agregar todos los elementos que necesites, siempre que el diagrama se mantenga claro y representativo.
¿Cómo se ve un flujo de login real?
Vamos al ejemplo del primer login del usuario [1:30]. El actor hace clic en login y esa acción llega al login fragment, que es la representación visual con la que el usuario interactúa. El fragment le pide al repository ejecutar el método doLogin, y el repository a su vez se comunica con la capa de networking para hablar con el backend.
Cuando el backend responde con éxito, el repository notifica al fragment, y este decide navegar al feed fragment mediante navigateTo. Una vez en el feed, el fragment pide los datos al repository, que los obtiene de la red y los guarda en la base de datos local antes de devolverlos para mostrarlos en pantalla.
Ese paso de guardar antes de mostrar es clave: garantiza que el contenido esté disponible incluso sin conexión.
¿Cómo crear diagramas de secuencia con Sequence Diagram?
Sequence Diagram es una herramienta gratuita que se usa escribiendo texto plano. La buscas en Google, abres el primer resultado y empiezas a tipear [4:30]. El sistema renderiza el diagrama en tiempo real.
Las palabras reservadas más importantes son:
title para definir el título del diagrama, por ejemplo Primer login del usuario.actor para crear la figura del usuario o entidad externa.participant para declarar cada capa, como loginFragment, feedFragment o repository.database para representar la base de datos con su ícono característico.Si necesitas un ícono distinto, puedes usar Font Awesome 5 Solid y referenciar el código del ícono que quieras, como F0C2 para la nube. Eso te da flexibilidad para representar servicios externos, colas, cachés o lo que tu arquitectura requiera.
¿Cómo dibujar las interacciones entre capas?
Las flechas se crean con guion y mayor que (->). La sintaxis es: origen, flecha, destino, dos puntos y el nombre del método. Por ejemplo, user->loginFragment: clickLogin genera una flecha del usuario hacia el login fragment con la etiqueta del método.
Repites ese patrón para cada paso del flujo y el diagrama se arma solo. Es la forma más rápida de iterar cuando todavía estás definiendo la arquitectura de una feature.
¿Por qué escribir los diagramas en inglés? Porque la mayoría de la documentación técnica, librerías y equipos distribuidos trabajan en inglés. Mantener consistencia entre código y diagramas evita confusiones.
¿Cómo compartir y exportar tus diagramas?
Una de las ventajas más prácticas de Sequence Diagram es la portabilidad [7:50]. Como todo el diagrama vive en texto, puedes copiarlo y pegarlo en un mensaje para que un compañero lo abra y lo siga editando.
Si prefieres entregar el resultado final, tienes tres opciones de exportación:
Esa flexibilidad lo convierte en una herramienta útil tanto para discusiones rápidas como para documentación formal de proyectos.
Ahora te toca a ti. Diseña un diagrama de secuencia para el flujo en el que un usuario, ya estando en el feed, le da like a un post. Piensa qué capas intervienen, en qué orden se comunican y dónde se guarda el cambio. Comparte tu diagrama en los comentarios para verlo y discutirlo con el resto de la comunidad.
Los diagramas de secuencia son la forma más clara de visualizar cómo interactúan usuarios, capas y bases de datos dentro de una aplicación. Si estás diseñando software y necesitas explicar un flujo de usuario sin perderte en código, esta técnica te ahorra horas de explicaciones y reuniones.
Aprenderás a leer, construir y compartir diagramas de secuencia usando una herramienta gratuita llamada Sequence Diagram, ideal para desarrolladores, diseñadores y product managers que quieran comunicar interacciones de forma visual.
Un diagrama de secuencia te permite representar de forma gráfica y resumida cómo reaccionan todas las entidades involucradas ante una acción del usuario. En lugar de describir con palabras qué pasa cuando alguien hace clic en un botón, lo dibujas.
Piensa en la venta de un ticket de metro [0:30]. El usuario paga, escoge el tipo de ticket, el sistema lo crea y finalmente el usuario lo retira. Con un diagrama, esas cuatro acciones se ven en segundos y queda claro qué capa hace qué.
¿Qué es un diagrama de secuencia? Es una representación gráfica que muestra cómo interactúan actores, capas y bases de datos a lo largo del tiempo cuando se ejecuta una acción del usuario.
Todo diagrama de secuencia se construye con cuatro piezas fundamentales [1:08]:
No hay un límite estricto. Puedes agregar todos los elementos que necesites, siempre que el diagrama se mantenga claro y representativo.
Vamos al ejemplo del primer login del usuario [1:30]. El actor hace clic en login y esa acción llega al login fragment, que es la representación visual con la que el usuario interactúa. El fragment le pide al repository ejecutar el método doLogin, y el repository a su vez se comunica con la capa de networking para hablar con el backend.
Cuando el backend responde con éxito, el repository notifica al fragment, y este decide navegar al feed fragment mediante navigateTo. Una vez en el feed, el fragment pide los datos al repository, que los obtiene de la red y los guarda en la base de datos local antes de devolverlos para mostrarlos en pantalla.
Ese paso de guardar antes de mostrar es clave: garantiza que el contenido esté disponible incluso sin conexión.
Sequence Diagram es una herramienta gratuita que se usa escribiendo texto plano. La buscas en Google, abres el primer resultado y empiezas a tipear [4:30]. El sistema renderiza el diagrama en tiempo real.
Las palabras reservadas más importantes son:
title para definir el título del diagrama, por ejemplo Primer login del usuario.actor para crear la figura del usuario o entidad externa.participant para declarar cada capa, como loginFragment, feedFragment o repository.database para representar la base de datos con su ícono característico.Si necesitas un ícono distinto, puedes usar Font Awesome 5 Solid y referenciar el código del ícono que quieras, como F0C2 para la nube. Eso te da flexibilidad para representar servicios externos, colas, cachés o lo que tu arquitectura requiera.
Las flechas se crean con guion y mayor que (->). La sintaxis es: origen, flecha, destino, dos puntos y el nombre del método. Por ejemplo, user->loginFragment: clickLogin genera una flecha del usuario hacia el login fragment con la etiqueta del método.
Repites ese patrón para cada paso del flujo y el diagrama se arma solo. Es la forma más rápida de iterar cuando todavía estás definiendo la arquitectura de una feature.
¿Por qué escribir los diagramas en inglés? Porque la mayoría de la documentación técnica, librerías y equipos distribuidos trabajan en inglés. Mantener consistencia entre código y diagramas evita confusiones.
Una de las ventajas más prácticas de Sequence Diagram es la portabilidad [7:50]. Como todo el diagrama vive en texto, puedes copiarlo y pegarlo en un mensaje para que un compañero lo abra y lo siga editando.
Si prefieres entregar el resultado final, tienes tres opciones de exportación:
Esa flexibilidad lo convierte en una herramienta útil tanto para discusiones rápidas como para documentación formal de proyectos.
Ahora te toca a ti. Diseña un diagrama de secuencia para el flujo en el que un usuario, ya estando en el feed, le da like a un post. Piensa qué capas intervienen, en qué orden se comunican y dónde se guarda el cambio. Comparte tu diagrama en los comentarios para verlo y discutirlo con el resto de la comunidad.
Diagrama de secuencia para darle like a un post en el feed :p


Les recomendaria usar mermaid para los diagramas UML ya que se les permitirá escribir en un script muy basico los diferentes diagramas (de clases, de estado, ER…) . Lo mas chevere es que podrán escribir dicho script en un archivo markdown (clasicos README) y adjuntarlo en la documentación del código ya que este script mostrara la imagen en automatico en GitHub, gitlab etc… Ahora estas plataformas ya entienden por defecto este script. De esta forma podrán versionar a tra ves de git tambien estos scripts sin necesidad de exportar las imágenes estáticas. Recomendaria tambien, según el IDE que usan, instalar el plugin mermaid para escribir en este script y ver en real-time el diagrama que se veràn en el README directamente desde el IDE. . Como desarrolladores, nunca debemos subestimar el poder de la documentación, especialmente para las partes mas cruciales de la aplicación. Por si tienen pereza en escribir la documentación, un diagrama UML suele explicarse por si mismo para los nuevos desarrolladores u otros que tendrán q leer y entender el código. . Les dejo un ejemplo del script ( y lo q se mostrarà en el README)
classDiagram
Class01 <|-- AveryLongClass : Cool
<<interface>> Class01
Class09 --> C2 : Where am i?
Class09 --* C3
Class09 --|> Class07
Class07 : equals()
Class07 : Object[] elementData
Class01 : size()
Class01 : int chimp
Class01 : int gorilla
class Class10 {
<<service>>
int id
size()
}
Documentacion: https://mermaid.js.org/intro/
Cristian en caso de que la respuesta del login no sea satisfactoria, es decir que dio error al iniciarse sesión, como fallas de comunicación, el caso de bloqueo de usuario, clave no válida o el usuario o no existe, como lo representas
Diagrama de secuencia, darle like a un post.

Está genial esta clase y la herramienta. Me sirve bastante para el desarrollo actual en nuestra empresa.
Consulta es recomendable si estoy realizando una aplicación por ejemplo :punto de venta, realizar todo el flujo (login, productos, lista de precios,clientes, metodos de pagos,etc) ? para aterrizar el alance?
Aún no entiendo como funciona la capa de Repository y Network.
igualemente dejo mi logica aca
Estoy abierto a recibir feedback =D

