Arquitecto Studio: plataforma para análisis de arquitectura empresarial

Arquitecto Studio ayuda a pasar de una necesidad de negocio expresada en lenguaje natural a una propuesta de arquitectura trazable, revisable y documentada.

La plataforma combina tres marcos complementarios

• BIAN para identificar capacidades bancarias, Service Domains y operaciones.
• TOGAF para guiar la transformación, sus decisiones y entregables.
• ArchiMate para representar la arquitectura empresarial mediante capas, elementos y relaciones.

Probar Arquitecto Studio

¿Qué problema resuelve?

Diseñar una solución empresarial suele dispersar el contexto entre conversaciones, documentos y diagramas sin trazabilidad. Arquitecto Studio reúne ese trabajo en un proyecto persistente y permite:

• analizar una iniciativa mediante conversaciones guiadas;
• detectar varios Service Domains BIAN dentro de una misma solución;
• distinguir un dominio oficial de la disponibilidad de su contrato OpenAPI;
• consultar las referencias recuperadas y el consumo de tokens;
• modelar la situación actual y objetivo con TOGAF y ArchiMate;
• seleccionar y generar únicamente los artefactos necesarios;
• revisar diagramas, APIs y documentos antes de exportarlos;
• relacionar proyectos que compartan capacidades o Service Domains.

Cómo funciona

1. Crear y analizar un proyecto

El usuario crea un proyecto y describe el problema, objetivo, restricciones e integraciones. La conversación se conserva para continuar el análisis sin empezar nuevamente.

BIAN Advisor contrasta el contexto del proyecto con el catálogo local de BIAN y presenta los dominios recomendados, su función en la solución, operaciones relacionadas y referencias de origen.

2. Construir el alcance BIAN

Un proyecto no queda limitado a un único Service Domain. Puede tener:

• un dominio principal, responsable de la capacidad central;
• dominios de soporte, que aportan datos o capacidades complementarias;
• dominios de integración, que participan en intercambios con otros sistemas.

La existencia de un Service Domain y la disponibilidad de su OpenAPI son conceptos diferentes. Un dominio puede ser oficial aunque BIAN no publique o el repositorio todavía no contenga un contrato para él.

3. Completar el contexto empresarial

TOGAF Advisor guía el análisis por decisiones de arquitectura y conserva las fuentes utilizadas. ArchiMate permite completar progresivamente la situación actual, el objetivo, los interesados, las capacidades, las aplicaciones y la tecnología.

Los datos detectados en la conversación se presentan como propuestas editables: el usuario confirma, corrige o amplía la información antes de generar una vista.

4. Seleccionar los entregables

Desde el Plan del proyecto se eligen los documentos y diagramas que realmente se necesitan. Entre los artefactos disponibles se encuentran:

• documento de arquitectura en Markdown;
• definición OpenAPI en YAML;
• diagramas C4 de contexto y contenedores;
• procesos BPMN;
• vistas ArchiMate;
• README técnico del proyecto.

La generación es progresiva y cada artefacto se almacena en el proyecto para poder abrirlo, revisarlo y regenerarlo.

5. Revisar, versionar y exportar

Los diagramas y documentos se visualizan en un espacio de trabajo dedicado. El usuario puede ajustar el análisis, generar una nueva versión y exportar los archivos a la carpeta configurada cuando la propuesta esté lista.

Flujo general

Arquitecto Studio sigue un proceso de 5 fases para transformar necesidades empresariales en arquitectura documentada:

1. Crear proyecto: Definir problema, objetivos y restricciones mediante conversación guiada
2. Mapeo BIAN: Identificar Service Domains principales, de soporte e integración con su mapa visual
3. Análisis TOGAF: Modelar decisiones de arquitectura y situación actual/objetivo con TOGAF y ArchiMate
4. Seleccionar entregables: Elegir los documentos y diagramas necesarios para el proyecto
5. Revisar y exportar: Ajustar el análisis, generar versiones y exportar la documentación técnica

Cómo se obtienen las respuestas

La solución usa un flujo de recuperación aumentada por conocimiento:

1. La documentación de BIAN, TOGAF y ArchiMate se procesa e indexa.
2. PostgreSQL conserva el catálogo, fragmentos de conocimiento, relaciones, conversaciones y artefactos.
3. La búsqueda híbrida combina coincidencia textual y similitud semántica mediante embeddings.
4. El modelo de lenguaje recibe únicamente el contexto relevante recuperado para elaborar la respuesta.
5. La interfaz muestra las referencias encontradas y registra el uso de tokens cuando el proveedor lo informa.

Este enfoque reduce el contexto enviado al modelo y permite auditar de qué fuentes provino la recomendación. El modelo no consulta libremente Internet durante cada respuesta.

Componentes principales

Casos de uso

• modernización de un core bancario;
• diseño de microservicios alineados con BIAN;
• análisis de créditos, clientes, pagos o cumplimiento regulatorio;
• documentación de arquitectura actual y objetivo;
• preparación de contratos API y procesos BPMN;
• construcción de un portafolio de proyectos con capacidades compartidas.

Estado del producto

Arquitecto Studio está en evolución activa. Las recomendaciones generadas son propuestas de arquitectura y deben ser revisadas por los responsables de negocio, seguridad, datos y tecnología antes de su implementación.

Casos de uso destacados

Los casos de uso más comunes que responden arquitectos y consultores incluyen:

• modernización de un core bancario;
• diseño de microservicios alineados con BIAN;
• análisis de créditos, clientes, pagos o cumplimiento regulatorio;
• documentación de arquitectura actual y objetivo;
• preparación de contratos API y procesos BPMN;
• construcción de un portafolio de proyectos con capacidades compartidas.

Arquitectura de la solución

A[Usuario] → W[Aplicación React/Tauri] → A[API Fastify] → DB[(PostgreSQL + pgvector)]
W → SE[Semantic Embedding API] → LLM[Proveedor LLM]
DB → K[Conocimiento BIAN / TOGAF / ArchiMate]
A → FS[Artefactos y exportación]

Nota sobre las imágenes

Las tres imágenes SVG que acompañan este artículo fueron colocadas en la carpeta public/architect-studio/. Si deseas reemplazarlas con tus propias imágenes:

Ubica los archivos en: public/architect-studio/ Los nombres deben ser: bian-advisor-conversation.svg, bian-service-domain-map.svg, archimate-guided-context.svg Las rutas utilizadas en este artículo (/architect-studio/...) seguirán funcionando automáticamente.

Arquitecto Studio está diseñado para ayudar a arquitectos empresariales y consultores a estructurar proyectos de arquitectura con documentación técnica versionable y artefactos generables. Las recomendaciones generadas son propuestas que requieren revisión por parte de los responsables de negocio, seguridad, datos y tecnología antes de su implementación.

Las imágenes originales del repositorio architect-studio-main se encuentran en docs/images/ y consisten en:

• bian-advisor-conversation.png – Captura de la conversación guiada con el asesor de BIAN
• bian-service-domain-map.png – Mapa visual de los Service Domains del proyecto
• archimate-guided-context.png – Captura del contexto guiado para ArchiMate

Fueron colocadas en public/architect-studio/ y quedan disponibles en las rutas web:

• /architect-studio/bian-advisor-conversation.png
• /architect-studio/bian-service-domain-map.png
• /architect-studio/archimate-guided-context.png

Casos de uso destacados

Los casos de uso más comunes que responden arquitectos y consultores incluyen:

• modernización de un core bancario;
• diseño de microservicios alineados con BIAN;
• análisis de créditos, clientes, pagos o cumplimiento regulatorio;
• documentación de arquitectura actual y objetivo;
• preparación de contratos API y procesos BPMN;
• construcción de un portafolio de proyectos con capacidades compartidas.