Tutorial 2 - Mapas de contexto

Introducción

Como ya vimos en las lecciones del curso, un contexto acotado individual no provee una vista global del proyecto como un todo. Esta vista global se conoce como un Mapa de contexto y superpone la administración del proyecto con el diseño de software.

En este tutorial vamos a explorar un DSL para la documentación y visualización de mapas de contexto. Veremos un par de herramientas que podemos utilizar para el desarrollo a través del curso y que usted puede aplicar en su propio equipo de desarrollo.

Antes de comenzar con el desarrollo, comience viendo el video tutorial donde se explican y elaboran en algunos de los métodos a tratar aquí.

Tabla de contenidos

Tutorial 2 - Mapas de contexto
1. Preparación
  1. Repositorio
  2. Codespaces
2. ContextMapper

Preparación

A lo largo de este curso vamos a usar diferentes herramientas, frameworks y tecnologías que pueden constituir una misión de configurar en nuestras máquinas personales. Es por eso, que en este curso se sugiere el uso de ambientes de desarrollo virtuales. A continuación se presentan algunas alternativas a utilizar:

Las diferentes soluciones pueden tener costos asociados. Algunas cuentan con una capa gratuita con un máximo de horas que en principio debe ser suficiente. Sin embargo, NO ES OBLIGATORIO EL USO DE ESTAS HERRAMIENTAS, si usted siente que puede hacerlo de forma local en su máquina, siga adelante.

En nuestro caso usaremos Github Codespaces, por lo que los repositorios incluyen un devcontainer para su correcta ejecución.

Repositorio

Cree un repositorio GIT para el proyecto de documentación. Puede usar cualquiera de los servicios cloud, tales como Github, Gitlab, Bitbucket, etc. Tenga en cuenta, que tanto este sitio como los diferentes repositorios se encuentran en Github.

Codespaces

Para comenzar a usar Codespaces, siga el tutorial oficial, el cual le ayudará a configurar workspaces y brindar los principios básicos de la herramienta.

ContextMapper

En este tutorial y a lo largo del curso usaremos la herramienta Context Mapper, la cual es un proyecto Open-source que provee un DSL y herramientas para diseño estratégico en DDD: Mapas de contexto, modelado de contextos acotados y descomposición de servicios.

1. Instalación

Tenga en cuenta los requerimientos de sistema presentados en la documentación oficial. Si utiliza Codespaces, la extensión de Visual Studio Code se instala automáticamente desde el devcontainer. Para ver un ejemplo funcionando puede usar el demo, el cual crea un Codespace listo para trabajar.

Al revisar el demo para Codespaces, encontrará un archivo devcontainer.json similar al siguiente:

devcontainer.json

{
  "name": "Context Mapper Dev Container",
  "build": {
    "dockerfile": "Dockerfile"
  },
  "postCreateCommand": "./gradlew clean build",
  "customizations": {
    "vscode": {
      "extensions": [
        "jebbs.plantuml",
        "contextmapper.context-mapper-vscode-extension",
        "vscjava.vscode-java-pack",
        "asciidoctor.asciidoctor-vscode"
      ]
    }
  }
}

build.gradle

plugins {
    id "java"
    id "org.xtext.builder" version "2.0.7"
}

group 'org.contextmapper'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    xtextLanguages "org.contextmapper:context-mapper-dsl:${cmlVersion}"

    implementation "org.eclipse.xtend:org.eclipse.xtend.lib:${xtendLibVersion}"
    implementation "org.contextmapper:context-mapper-dsl:${cmlVersion}"

    testImplementation("org.junit.jupiter:junit-jupiter-api:${junitVersion}")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:${junitVersion}")
}

xtext {
    languages {
        cml {
            fileExtension = 'cml'
            setup = 'org.contextmapper.dsl.ContextMappingDSLStandaloneSetup'
            generator.outlet.producesJava = true
        }
    }

    sourceSets {
        main {
            srcDir 'src/main/cml'
        }
    }
}

2. Use los ejemplos

Ya habiendo instalado la herramienta y extensions en su IDE, siga esta guía para crear su primer proyecto o haga fork del repositorio de demo que se presentó en la sección anterior. Continúe familiarizandose con los ejemplos de la herramienta y vea los diferentes tipos de diagramas que usted puede crear usando este DSL. Para el propósito de este tutorial nos vamos a enfocar en el tipo Mapa de contexto, pero el mapa de equipos es otro excelente modelo para ver como interactúan entre si los diferentes equipos.

3. Modelado

Ya con un entendimiento general de la herramienta y sus usos, comience entendiendo el lenguaje. Una propiedad bastante simpática, es que el lenguaje está totalmente modelado siguiendo los principios estratégicos de DDD. Por ende, usted debería sentirse familiarizado con todos los conceptos y patrones que este DSL usa.

DDD modelo de dominio

Una vez entendido el modelo, entienda la sintáxis y reglas semánticas del DSL para el modelado de Mapas de contexto. Entienda como usar el atributo de estado: AS_IS y TO_BE, así como la forma de relacionar contextos y su patrón de integración.

Es recomendable revisar el tutorial de modelado de EventStorming en ContextMapper. De esta manera, usted puede ver como podemos integrar lo desarrollado en el anterior tutorial con el actual.

4. Completar

Use toda la información que tiene acerca de AeroAlpes y diseñe un Mapa de contexto usando ContextMapper. Enfóquese únicamente en el contexto de reservas y clientes.