> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés. # Diagramas de referencia **Especificación del Meta-Universo** **ID del documento:** MU-V2-REFARCH-009 **Título:** Diagramas canónicos **Clase de documento:** informativo **Versión:** 2.0 (borrador) **Estado:** borrador de trabajo **Referencias normativas:** Constitución del Meta-Universo (MUC), MMAS, MUFP **Referencias informativas:** Architecture, Meta-Universe Stack, Interaction Patterns, Federation Patterns **Copyright:** © Orkestron.AI **Licencia:** Apache-2.0 --- # 1. Propósito Este documento define los diagramas canónicos de referencia recomendados para las especificaciones conformes con el Meta-Universo. Los diagramas de referencia ofrecen representaciones visuales estandarizadas de los conceptos arquitectónicos. Mejoran la coherencia entre repositorios y permiten que tanto las personas como los sistemas de IA interpreten la intención arquitectónica de forma predecible. --- # 2. Principios de diseño Los diagramas de referencia DEBERÍAN ser: - semánticamente exactos; - independientes de la tecnología; - simples; - reutilizables; - conscientes de las versiones; - trazables. Los diagramas DEBERÁN ilustrar la arquitectura semántica y no los detalles de implementación. --- # 3. Conjunto canónico de diagramas Una especificación completa del Meta-Universo DEBERÍA incluir diagramas de: - Arquitectura general - Pila del Meta-Universo - Conceptos fundamentales - Panorama de la federación - Vínculo de identidad - Modelo de proyecciones - Flujo de eventos - Ciclo de vida - Patrones de interacción - Patrones de federación - Meta-modelo de dominio (cuando proceda) --- # 4. Diagrama de arquitectura Propósito Ilustra la relación entre: - Fundamentos - Estándares de arquitectura - Federación - Conceptos fundamentales - Meta-modelos de dominio - Implementaciones Disposición recomendada: Fundamentos ↓ Arquitectura ↓ Federación ↓ Conceptos fundamentales ↓ Meta-modelos de dominio ↓ Implementaciones --- # 5. Diagrama de la pila Ilustra las capas arquitectónicas y la dirección de las dependencias. Las dependencias DEBERÁN apuntar siempre hacia las capas inferiores. Implementaciones ↓ Perfiles de federación ↓ Meta-modelos de dominio ↓ Conceptos fundamentales ↓ Federación ↓ Arquitectura ↓ Fundamentos --- # 6. Diagrama de federación Ilustra la cooperación entre Universos soberanos. Elementos recomendados: - Universo A - Universo B - Confianza - Contrato de federación - Vínculo de identidad - Correspondencia semántica - Intercambio de proyecciones - Eventos La propiedad DEBERÁ permanecer dentro de cada Universo. --- # 7. Diagrama de proyecciones Estructura recomendada: Meta-objeto │ ├── Proyección pública ├── Proyección interna ├── Proyección para IA └── Proyección para socios Cada proyección DEBERÁ referirse a la misma identidad canónica. --- # 8. Diagrama de vínculo de identidad Ilustra una identidad canónica enlazada con varias identidades locales. Identidad canónica │ ┌──────┼──────┐ │ │ │ Local A Local B Local C Los vínculos DEBERÁN preservar la autoridad semántica. --- # 9. Diagrama de flujo de eventos Ilustra la evolución semántica inmutable. Meta-objeto │ Evento de creación │ Evento de actualización │ Evento de aprobación │ Evento de archivo El estado DEBERÁ poder explicarse a través de los eventos. --- # 10. Diagrama de ciclo de vida Ciclo de vida recomendado: Creado ↓ Borrador ↓ Propuesto ↓ Activo ↓ Obsoleto ↓ Archivado ↓ Retirado PUEDEN insertarse estados opcionales sin alterar la semántica del ciclo de vida. --- # 11. Diagrama de interacción Ilustra la interacción canónica: Descubrimiento ↓ Confianza ↓ Contrato ↓ Proyección ↓ Procesamiento ↓ Eventos ↓ Sincronización --- # 12. Diagrama de meta-modelo de dominio Los diagramas de dominio DEBERÍAN incluir: - espacios de nombres; - objetos; - relaciones; - eventos; - contratos; - proyecciones. Los detalles de implementación DEBERÍAN omitirse. --- # 13. Convenciones de diagrama Convenciones recomendadas: - Rectángulos para los artefactos semánticos. - Rectángulos redondeados para los procesos. - Flechas continuas para las relaciones semánticas. - Flechas discontinuas para las referencias. - Bordes dobles para los elementos autoritativos. El estilo visual DEBERÍA mantenerse coherente en todo el repositorio. --- # 14. Validación Los diagramas de referencia DEBERÍAN revisarse en cuanto a: - corrección semántica; - coherencia con los documentos normativos; - coherencia terminológica; - completitud arquitectónica; - compatibilidad de versiones. Los diagramas DEBERÁN complementar a las especificaciones textuales. --- # 15. Invariantes arquitectónicas Los diagramas de referencia DEBERÁN: - preservar los principios constitucionales; - preservar la autoridad semántica; - permanecer independientes de la implementación; - evitar notaciones ligadas a una tecnología, salvo que se exijan expresamente. --- # 16. Lenguaje de diagramas del Meta-Universo (MUDL) La especificación completa de MUDL está en [MUDL](MUDL.md), y los diagramas canónicos renderizados como fuentes Mermaid viven en [`assets/`](../assets/). Los diagramas anteriores estandarizan el *significado* de las imágenes del Meta-Universo, pero todavía no su *forma legible por máquina*: hoy la intención de un diagrama es canónica mientras que su dibujo se hace a mano. El **lenguaje de diagramas del Meta-Universo (MUDL)** cierra esta brecha estandarizando una representación legible por máquina de los diagramas, de modo que un diagrama pasa a ser simplemente otra proyección del meta-modelo y no un artefacto aparte mantenido a mano. MUDL define: - Los **tipos de nodo** - los elementos semánticos que puede contener un diagrama: - Universe - Namespace - Object - Projection - Contract - Event - Los **tipos de arista** - las conexiones semánticas entre nodos: - `owns` - `projects` - `binds` - `governs` - `mapsTo` - `synchronizes` - `federatesWith` - La **notación visual** - las formas, bordes y estilos de flecha canónicos (coherentes con las convenciones de diagrama de la sección 13) a los que se renderiza cada tipo de nodo y de arista. - La **serialización** - una codificación YAML/JSON para que un diagrama pueda redactarse, versionarse, validarse y compararse como datos estructurados. - La **generación** - el renderizado determinista de esa serialización a SVG, Mermaid o PlantUML, de modo que la misma fuente produzca la misma imagen en distintas herramientas. Un ejemplo mínimo de MUDL: ```yaml mudl: 1.0 nodes: - id: u_acme type: Universe label: "Acme Corp" - id: emp_employee type: Object label: "Employee" - id: emp_public type: Projection label: "EmployeePublicProjection" edges: - from: u_acme to: emp_employee type: owns - from: emp_employee to: emp_public type: projects ``` Como un documento MUDL se genera a partir del modelo subyacente, y se valida contra él, el diagrama es una proyección de verdad: no puede alejarse de la semántica que representa. MUDL desempeña para el Meta-Universo un papel análogo al de BPMN para los procesos, UML para el software o ArchiMate para la arquitectura empresarial: un lenguaje visual dedicado y estandarizado, pero cuya fuente de verdad es el propio meta-modelo semántico. --- # Direcciones futuras Se espera que **MUDL** madure hasta convertirse en una especificación informativa independiente que cubra el vocabulario completo de nodos y aristas, la notación visual canónica, el esquema YAML/JSON y los generadores conformes a SVG, Mermaid y PlantUML. Su propiedad definitoria es que un diagrama pasa a ser otra proyección del meta-modelo - redactado como datos, validado en cuanto a conformidad y renderizado de forma determinista - de modo que la documentación visual de miles de repositorios se mantenga coherente y siempre al paso de los modelos que ilustra. --- # Declaración final Los diagramas de referencia aportan un lenguaje visual compartido para el Meta-Universo. Al estandarizar la representación de los conceptos arquitectónicos, los mecanismos de federación y las estructuras semánticas, estos diagramas mejoran la comprensión, la interoperabilidad y la mantenibilidad a largo plazo, garantizando que la documentación visual evolucione de forma coherente con las especificaciones normativas.