Construcción de APIs GraphQL de grado empresarial con Diseño Guiado por el Dominio y Arquitectura Limpia

Rate this content
Bookmark
Slides

En esta charla, exploraremos cómo construir APIs GraphQL escalables y mantenibles para aplicaciones empresariales utilizando patrones de Diseño Guiado por el Dominio y Arquitectura Limpia. Discutiremos la importancia de modularizar su API en torno al dominio empresarial y una mejor organización de subdominios. Pasaremos brevemente por los componentes principales de una API GraphQL, incluyendo resolvers, capa de dominio y capa de base de datos y cómo hemos evolucionado hacia nuestra nueva arquitectura.

This talk has been presented at React Day Berlin 2023, check out the latest edition of this React Conference.

FAQ

Una API GraphQL es un enfoque de diseño de API que permite a los clientes especificar exactamente qué datos necesitan, lo cual es útil para crear interfaces de usuario eficientes y mejorar el rendimiento de la red. Es importante para los negocios porque centraliza toda la lógica relacionada con el negocio, facilitando la refactorización y el diseño de la base de datos.

El diseño guiado por el dominio (DDD) es una metodología de desarrollo de software que enfatiza la importancia de comprender el dominio empresarial para centrar a los equipos en la lógica empresarial central. Se utiliza para alinear el software con los requisitos empresariales y facilitar una mejor colaboración entre los involucrados en el proyecto.

La arquitectura limpia es un tipo de arquitectura de software que organiza el diseño en capas con responsabilidades bien definidas, promoviendo la independencia entre ellas. Los beneficios incluyen una mejor separación de responsabilidades, facilidad de mantenimiento y testeo, aunque puede requerir un esfuerzo de ingeniería adicional para su implementación.

En el contexto de un negocio, las APIs de GraphQL se implementan definiendo esquemas y resolutores que mapean los tipos de GraphQL con los tipos de dominio del negocio. Esto permite a los clientes recuperar datos de múltiples contextos de negocio de manera eficiente a través de un único punto final HTTP.

En DDD, el lenguaje ubicuo es un vocabulario común utilizado por todos los involucrados en el proyecto para garantizar una comunicación clara. Un contexto delimitado es un límite lógico que define la separación de funcionalidades dentro del dominio, permitiendo que los equipos tengan una comprensión compartida y trabajen más eficientemente.

La adopción de TypeScript en la construcción de APIs GraphQL mejora la escalabilidad y mantenibilidad del código al proporcionar tipado estático, lo que ayuda a detectar errores temprano en el desarrollo y mejora la calidad del código al hacerlo más legible y mantenible.

Petar Ivanov
Petar Ivanov
22 min
12 Dec, 2023

Comments

Sign in or register to post your comment.

Video Summary and Transcription

La charla de hoy se centra en la construcción de APIs GraphQL de grado empresarial con diseño guiado por el dominio y arquitectura limpia. El orador comparte su experiencia y enfatiza la importancia de entender el dominio empresarial y alinear el software con los requisitos empresariales. Discuten el enfoque por capas de la arquitectura limpia y los beneficios que proporciona para la separación de preocupaciones y pruebas. La charla también cubre el uso de la fusión de esquemas GraphQL y mapeadores para crear un esquema unificado. El orador concluye destacando la importancia de la observación constante, la evaluación y la mejora en el desarrollo de software.

1. Introducción a la construcción de APIs GraphQL

Short description:

Hoy, voy a hablar sobre la construcción de APIs GraphQL de grado empresarial con diseño orientado al dominio y arquitectura limpia. Compartiré mi experiencia en la construcción de una API GraphQL escalable y mantenible al adoptar TypeScript, diseño orientado al dominio y arquitectura limpia. Puedes encontrarme en las redes sociales y echar un vistazo a mi blog y boletín informativo. Trabajo para Ant, S6, una empresa de consultoría de outsourcing con sede en Sofía, Bulgaria.

Hola a todos. Soy Peter, y hoy voy a hablar sobre la construcción de APIs GraphQL de grado enterprise con diseño orientado al dominio y arquitectura clean. Así que unas pocas palabras sobre mí. Como dije, soy Peter Ivanov. Aquí está mi identificador, así que puedes encontrarme en las redes sociales con este identificador. Y también me considero un desarrollador en forma de T. Si no estás seguro de qué es un desarrollador en forma de T, puedes consultar una de mis últimas entradas en el blog en mi sitio web personal, peterivanov.me. Y también tengo un boletín informativo, el Dev en forma de T. Así que si estás interesado, puedes echarle un vistazo. Y sí, aquí están mis enlaces a LinkedIn y mi cuenta de GitHub. Soy Ant, S6 es la empresa para la que trabajo. Somos una empresa de consultoría de outsourcing con sede aquí en Sofía, Bulgaria. Y el propósito de mi presentación es compartir mi experiencia en la construcción de una API GraphQL escalable y mantenible al adoptar TypeScript, diseño orientado al dominio y arquitectura clean.

2. Introducción a la Arquitectura y la API GraphQL

Short description:

No tomes todo lo que comparto en esta presentación como absoluto. No entraremos en mucho detalle sobre qué es GraphQL, DDD y arquitectura limpia. Estamos hablando de backstadium.com, piénsalo como DigitalOcean o AWS para infraestructura Mac. Comenzaremos con la primera versión de nuestra arquitectura, dos aplicaciones web, una pública y una interna. La segunda versión es la versión actual, con toda la lógica de negocio dentro de la API GraphQL. La API GraphQL es el lugar central para toda la lógica relacionada con el negocio. Tenemos un único usuario, la API GraphQL, lo que facilita refactorizar y mejorar el diseño de toda la base de datos.

Y me gustaría comenzar con algunas aclaraciones. Y la primera es que no tomes todo lo que comparto en esta presentación como absoluto, porque el software puede construirse de múltiples maneras. Y también, dado que solo tenemos 20 minutos para esta presentación, no entraremos en mucho detalle sobre qué es GraphQL, DDD y la arquitectura limpia, porque nos centraremos en cómo diseñar y construir nuestra API.

Y ahora, algunas palabras sobre ello para darte algún contexto y qué tipo de software y qué tipo de negocio estamos hablando. Así que estamos hablando de backstadium.com, y puedes pensar en ello como DigitalOcean o AWS para la infraestructura Mac. Así que si no quieres comprar el Mac físico, el hardware real, pero quieres ejecutar algo en Mac, puedes ir allí y puedes comprar virtualmente el Mac y su infraestructura. Así que básicamente, tenemos las mismas cosas que tenemos en DigitalOcean o AWS. Así que tenemos facturación, tenemos cuentas, empresas, usuarios y cosas así. Solo para darte qué tipo de contexto y qué tipo de software vamos a construir y de lo que vamos a hablar a lo largo de la presentación.

Y ahora comencemos con la primera versión de nuestra arquitectura. Y aquí está. Así que tenemos dos aplicaciones web, una pública y una interna. La pública está construida con React, KXPHP, y la otra está construida solo con KXPHP. Y estos dos servicios llaman directamente a la base de datos o a servicios de terceros. Muy, muy simple. Y ahora pasemos a la segunda versión de la arquitectura, y esta es la versión actual de la arquitectura. Y aquí está. De nuevo, tenemos esas dos aplicaciones web, pero ahora toda la lógica de negocio está dentro de la llamada API GraphQL. Y aquí puedes ver la API GraphQL. Tenemos una gestión de cuentas, gestión de facturación, verás lo que es. Y aquí tenemos la API que llama a la base de datos o a servicios de terceros. No te preocupes. Ahora vamos a profundizar y explorar cómo logramos hacer esto y cómo lo hicimos.

La primera pregunta que tenemos que responder es por qué necesitamos la API GraphQL y cuál es su propósito. Y una de las razones principales es que es el lugar central para toda la lógica relacionada con el negocio. Esta es la API GraphQL. Y también en esto, al introducir la API GraphQL, tenemos en este caso la base de datos. Tenemos un único usuario, en nuestro caso la API GraphQL, lo que facilitará la refactorización y la mejora del diseño de toda la base de datos. Como viste en la primera versión de la arquitectura, teníamos dos clientes, pero la mayoría de las veces son más antiguos. Y ahora unas palabras sobre las tecnologías que decidimos usar.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

De GraphQL Zero a GraphQL Hero con RedwoodJS
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
De GraphQL Zero a GraphQL Hero con RedwoodJS
Top Content
Tom Pressenwurter introduces Redwood.js, a full stack app framework for building GraphQL APIs easily and maintainably. He demonstrates a Redwood.js application with a React-based front end and a Node.js API. Redwood.js offers a simplified folder structure and schema for organizing the application. It provides easy data manipulation and CRUD operations through GraphQL functions. Redwood.js allows for easy implementation of new queries and directives, including authentication and limiting access to data. It is a stable and production-ready framework that integrates well with other front-end technologies.
Estado Local y Caché del Servidor: Encontrando un Equilibrio
Vue.js London Live 2021Vue.js London Live 2021
24 min
Estado Local y Caché del Servidor: Encontrando un Equilibrio
Top Content
This Talk discusses handling local state in software development, particularly when dealing with asynchronous behavior and API requests. It explores the challenges of managing global state and the need for actions when handling server data. The Talk also highlights the issue of fetching data not in Vuex and the challenges of keeping data up-to-date in Vuex. It mentions alternative tools like Apollo Client and React Query for handling local state. The Talk concludes with a discussion on GitLab going public and the celebration that followed.
Baterías Incluidas Reimaginadas - El Resurgimiento de GraphQL Yoga
GraphQL Galaxy 2021GraphQL Galaxy 2021
33 min
Baterías Incluidas Reimaginadas - El Resurgimiento de GraphQL Yoga
Envelope is a powerful GraphQL plugin system that simplifies server development and allows for powerful plugin integration. It provides conformity for large corporations with multiple GraphQL servers and can be used with various frameworks. Envelope acts as the Babel of GraphQL, allowing the use of non-spec features. The Guild offers GraphQL Hive, a service similar to Apollo Studio, and encourages collaboration with other frameworks and languages.
Aplicaciones sólidas de React y GraphQL para personas con prisa
GraphQL Galaxy 2022GraphQL Galaxy 2022
29 min
Aplicaciones sólidas de React y GraphQL para personas con prisa
The Talk discusses the challenges and advancements in using GraphQL and React together. It introduces RedwoodJS, a framework that simplifies frontend-backend integration and provides features like code generation, scaffolding, and authentication. The Talk demonstrates how to set up a Redwood project, generate layouts and models, and perform CRUD operations. Redwood automates many GraphQL parts and provides an easy way for developers to get started with GraphQL. It also highlights the benefits of Redwood and suggests checking out RedwoodJS.com for more information.
Adoptando GraphQL en una Empresa
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
Adoptando GraphQL en una Empresa
Today's Talk is about adopting GraphQL in an enterprise. It discusses the challenges of using REST APIs and the benefits of GraphQL. The Talk explores different approaches to adopting GraphQL, including coexistence with REST APIs. It emphasizes the power of GraphQL and provides tips for successful adoption. Overall, the Talk highlights the advantages of GraphQL in terms of efficiency, collaboration, and control over APIs.
Deja paso a los resolvers: un nuevo enfoque para la ejecución de GraphQL
GraphQL Galaxy 2022GraphQL Galaxy 2022
16 min
Deja paso a los resolvers: un nuevo enfoque para la ejecución de GraphQL
GraphQL has made a huge impact in the way we build client applications, websites, and mobile apps. Despite the dominance of resolvers, the GraphQL specification does not mandate their use. Introducing Graphast, a new project that compiles GraphQL operations into execution and output plans, providing advanced optimizations. In GraphFast, instead of resolvers, we have plan resolvers that deal with future data. Graphfast plan resolvers are short and efficient, supporting all features of modern GraphQL.

Workshops on related topic

Construir con SvelteKit y GraphQL
GraphQL Galaxy 2021GraphQL Galaxy 2021
140 min
Construir con SvelteKit y GraphQL
Top Content
Featured WorkshopFree
Scott Spence
Scott Spence
¿Alguna vez has pensado en construir algo que no requiera mucho código de plantilla con un tamaño de paquete pequeño? En esta masterclass, Scott Spence irá desde el hola mundo hasta cubrir el enrutamiento y el uso de endpoints en SvelteKit. Configurarás una API de GraphQL en el backend y luego usarás consultas de GraphQL con SvelteKit para mostrar los datos de la API de GraphQL. Construirás un proyecto rápido y seguro que utiliza las características de SvelteKit, y luego lo desplegarás como un sitio completamente estático. Este curso es para los curiosos de Svelte que no han tenido una experiencia extensa con SvelteKit y quieren una comprensión más profunda de cómo usarlo en aplicaciones prácticas.

Tabla de contenidos:
- Inicio e introducción a Svelte
- Inicializar el proyecto frontend
- Recorrido por el proyecto esqueleto de SvelteKit
- Configurar el proyecto backend
- Consultar datos con GraphQL
- Recuperación de datos en el frontend con GraphQL
- Estilización
- Directivas de Svelte
- Enrutamiento en SvelteKit
- Endpoints en SvelteKit
- Despliegue en Netlify
- Navegación
- Mutaciones en GraphCMS
- Envío de mutaciones GraphQL a través de SvelteKit
- Preguntas y respuestas
Construye Aplicaciones Modernas Utilizando GraphQL y Javascript
Node Congress 2024Node Congress 2024
152 min
Construye Aplicaciones Modernas Utilizando GraphQL y Javascript
Featured Workshop
Emanuel Scirlet
Miguel Henriques
2 authors
Ven y aprende cómo puedes potenciar tus aplicaciones modernas y seguras utilizando GraphQL y Javascript. En este masterclass construiremos una API de GraphQL y demostraremos los beneficios del lenguaje de consulta para APIs y los casos de uso para los que es adecuado. Se requiere conocimiento básico de Javascript.
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
React Advanced Conference 2022React Advanced Conference 2022
95 min
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
Featured WorkshopFree
Sabin Adams
Sabin Adams
En este masterclass, obtendrás una visión de primera mano de lo que es la seguridad de tipo de extremo a extremo y por qué es importante. Para lograr esto, construirás una API de GraphQL utilizando herramientas modernas y relevantes que serán consumidas por un cliente de React.
Prerrequisitos: - Node.js instalado en tu máquina (12.2.X / 14.X)- Se recomienda (pero no es obligatorio) utilizar VS Code para las tareas prácticas- Un IDE instalado (se recomienda VSCode)- (Bueno tener) *Un conocimiento básico de Node.js, React y TypeScript
GraphQL para Desarrolladores de React
GraphQL Galaxy 2022GraphQL Galaxy 2022
112 min
GraphQL para Desarrolladores de React
Featured Workshop
Roy Derks
Roy Derks
Hay muchas ventajas en utilizar GraphQL como fuente de datos para el desarrollo frontend, en comparación con las API REST. Nosotros, los desarrolladores, por ejemplo, necesitamos escribir mucho código imperativo para recuperar datos y mostrarlos en nuestras aplicaciones y manejar el estado. Con GraphQL, no solo puedes reducir la cantidad de código necesario para la obtención de datos y la gestión del estado, sino que también obtendrás una mayor flexibilidad, mejor rendimiento y, sobre todo, una mejor experiencia de desarrollo. En este masterclass aprenderás cómo GraphQL puede mejorar tu trabajo como desarrollador frontend y cómo manejar GraphQL en tu aplicación frontend de React.
Construye una aplicación WordPress sin cabeza con Next.js y WPGraphQL
React Summit 2022React Summit 2022
173 min
Construye una aplicación WordPress sin cabeza con Next.js y WPGraphQL
Top Content
WorkshopFree
Kellen Mace
Kellen Mace
En esta masterclass, aprenderás cómo construir una aplicación Next.js que utiliza Apollo Client para obtener datos de un backend de WordPress sin cabeza y usarlo para renderizar las páginas de tu aplicación. Aprenderás cuándo debes considerar una arquitectura de WordPress sin cabeza, cómo convertir un backend de WordPress en un servidor GraphQL, cómo componer consultas usando el IDE GraphiQL, cómo colocar fragmentos GraphQL con tus componentes, y más.
Modelado de Bases de Datos Relacionales para GraphQL
GraphQL Galaxy 2020GraphQL Galaxy 2020
106 min
Modelado de Bases de Datos Relacionales para GraphQL
Top Content
WorkshopFree
Adron Hall
Adron Hall
En esta masterclass profundizaremos en el modelado de datos. Comenzaremos con una discusión sobre varios tipos de bases de datos y cómo se mapean a GraphQL. Una vez que se haya establecido esa base, el enfoque se desplazará a tipos específicos de bases de datos y cómo construir modelos de datos que funcionen mejor para GraphQL en varios escenarios.
Índice de contenidosParte 1 - Hora 1      a. Modelado de Datos de Bases de Datos Relacionales      b. Comparando Bases de Datos Relacionales y NoSQL      c. GraphQL con la Base de Datos en menteParte 2 - Hora 2      a. Diseño de Modelos de Datos Relacionales      b. Relación, Construcción de Tablas Multijoin      c. Complejidades de Consulta de Modelado de Datos Relacionales y GraphQL
Prerrequisitos      a. Herramienta de modelado de datos. El formador utilizará dbdiagram      b. Postgres, aunque no es necesario instalar esto localmente, ya que estaré utilizando una imagen de Dicker de Postgres, de Docker Hub para todos los ejemplos      c. Hasura