Análisis de Arquitectura
El análisis con IA de Archyl detecta problemas potenciales de arquitectura y proporciona recomendaciones para mejorar el diseño de tu sistema.
¿Qué Análisis Detecta Archyl?
Problemas Críticos
| Problema | Descripción |
|---|---|
| Punto Único de Fallo (SPOF) | Elementos con demasiadas dependencias que podrían causar fallos a nivel de sistema |
| Problemas de Seguridad | Acceso directo a base de datos desde sistemas externos, límites de seguridad faltantes |
| Dependencias Circulares | Ciclos de dependencia que complican mantenimiento y despliegue |
Alta Prioridad
| Problema | Descripción |
|---|---|
| Alto Acoplamiento | Componentes con conexiones excesivas a otros componentes |
| Elementos Sobre-conectados | Elementos con demasiadas relaciones entrantes o salientes |
| Redundancia Faltante | Servicios críticos sin mecanismos de respaldo o failover |
Prioridad Media
| Problema | Descripción |
|---|---|
| Elementos Huérfanos | Elementos aislados sin relaciones con otros componentes |
| Documentación Faltante | Elementos sin descripciones o documentación enlazada |
| Nomenclatura Inconsistente | Elementos que no siguen convenciones de nomenclatura |
Baja Prioridad
| Problema | Descripción |
|---|---|
| Oportunidades de Optimización | Mejoras potenciales para reducir complejidad |
| Sugerencias de Mejores Prácticas | Recomendaciones basadas en convenciones del modelo C4 |
Ejecutando Análisis de Arquitectura
Análisis de Proyecto Individual
- Ve a la sección Análisis desde la barra lateral
- Selecciona tu proyecto
- Haz clic en Analizar
- Espera a que el análisis termine
- Revisa hallazgos por severidad
Análisis a Nivel de Organización
Para analizar todos los proyectos a la vez:
- Ve a Análisis desde la navegación principal
- Haz clic en Analizar Todos los Proyectos
- Revisa hallazgos agregados a través de tu organización
Entendiendo los Análisis
Cada análisis incluye:
Nivel de Severidad
- Crítico: Requiere atención inmediata
- Alto: Debería abordarse pronto
- Medio: Considerar abordar cuando sea posible
- Bajo: Mejoras deseables
Elementos Afectados
El análisis lista todos los elementos involucrados, con enlaces directos para verlos en el diagrama.
Recomendaciones
Pasos accionables para resolver el problema:
Recomendación: Agregar una capa de caché entre el API Gateway
y la Base de Datos para reducir conexiones directas a la base
de datos y mejorar la resiliencia.
Documentación Relacionada
Enlaces a mejores prácticas y patrones arquitectónicos relevantes.
Gestionando Análisis
Silenciando Análisis
Si un análisis es intencional o un falso positivo:
- Haz clic en el análisis para expandirlo
- Haz clic en Silenciar este análisis
- Opcionalmente agrega una razón
- El análisis se ocultará de la vista principal
Viendo Análisis Silenciados
Para revisar análisis silenciados:
- Ve a la sección de Análisis
- Activa Mostrar silenciados
- Revisa y opcionalmente reactiva elementos
Acciones Masivas
Selecciona múltiples análisis para:
- Silenciar todos los seleccionados
- Asignar a miembro del equipo
- Exportar como reporte
Mejores Prácticas
Análisis Regular
- Ejecuta análisis después de cambios importantes de arquitectura
- Incluye revisión de análisis en planificación de sprint
- Rastrea tendencias de análisis a lo largo del tiempo
Prioriza por Impacto
No todos los análisis necesitan acción inmediata:
- Enfócate primero en severidad Crítica y Alta
- Considera el impacto de negocio al priorizar
- Documenta desviaciones intencionales
Comparte con el Equipo
- Exporta reportes de análisis para revisiones de arquitectura
- Asigna análisis a miembros del equipo
- Rastrea resolución en tu herramienta de gestión de proyectos
Análisis Comunes y Soluciones
Punto Único de Fallo
Problema: Un solo servicio maneja toda la autenticación.
Solución:
- Agregar servicio de auth redundante
- Implementar patrón circuit breaker
- Usar almacenamiento de sesión distribuido
Alto Acoplamiento
Problema: El frontend llama directamente a 10+ servicios backend.
Solución:
- Introducir API Gateway
- Implementar patrón Backend for Frontend (BFF)
- Usar comunicación basada en eventos
Dependencias Circulares
Problema: Servicio A depende de B, B depende de C, C depende de A.
Solución:
- Extraer lógica compartida a nuevo servicio
- Usar arquitectura basada en eventos
- Refactorizar para romper el ciclo
Elementos Huérfanos
Problema: Base de datos sin conexiones mostradas.
Solución:
- Agregar relaciones a servicios que la usan
- Eliminar si ya no se usa
- Enlazar a documentación explicando uso
Personalizar Reglas de Análisis
Cada organización tiene estándares de arquitectura diferentes. Archyl te permite personalizar las reglas que generan análisis para que coincidan con los requisitos de tu equipo.
Acceder a la Configuración de Reglas
- Ve a la sección Análisis
- Haz clic en la pestaña Reglas
- Ajusta la configuración para cada regla
- Haz clic en Guardar para aplicar los cambios
Cuando guardas los cambios, Archyl re-analiza automáticamente tu arquitectura con la nueva configuración.
Reglas Disponibles
Punto Único de Fallo (SPOF)
Detecta elementos con demasiadas dependencias entrantes que podrían causar fallos en todo el sistema si dejan de funcionar.
| Configuración | Rango | Por defecto |
|---|---|---|
| Umbral | 1-20 | 3 |
Aumenta el umbral si tu arquitectura centraliza intencionalmente ciertas preocupaciones. La infraestructura crítica como las bases de datos recibe escrutinio adicional independientemente de tu configuración de umbral.
Alto Acoplamiento
Identifica componentes con conexiones excesivas en cualquier dirección.
| Configuración | Rango | Por defecto |
|---|---|---|
| Umbral entrante | 1-50 | 4 |
| Umbral saliente | 1-50 | 6 |
El umbral entrante captura elementos de los que muchos otros componentes dependen. El umbral saliente captura elementos que dependen de demasiados otros componentes.
Elementos Sobre-conectados
Marca elementos con demasiadas conexiones totales (entrantes + salientes combinadas).
| Configuración | Rango | Por defecto |
|---|---|---|
| Umbral | 2-100 | 8 |
Esto captura un problema diferente al alto acoplamiento: componentes que son difíciles de entender porque tocan demasiadas partes del sistema.
Dependencias Circulares
Detecta ciclos de dependencia donde A depende de B, B depende de C, y C depende de A.
| Configuración | Opciones |
|---|---|
| Habilitado | On/Off |
Las dependencias circulares complican las pruebas, crean problemas de inicialización y señalan límites poco claros. La mayoría de los equipos dejan esto habilitado.
Elementos Huérfanos
Encuentra elementos de arquitectura sin conexiones con otros componentes.
| Configuración | Opciones |
|---|---|
| Habilitado | On/Off |
Los elementos huérfanos pueden indicar brechas de documentación o servicios obsoletos que deberían eliminarse.
Problemas de Seguridad
Detecta patrones preocupantes como sistemas externos con acceso directo a la base de datos.
| Configuración | Opciones |
|---|---|
| Habilitado | On/Off |
Estos hallazgos son de severidad crítica y la mayoría de los equipos quieren saber sobre ellos inmediatamente.
Documentación Faltante
Reporta elementos sin descripciones.
| Configuración | Rango | Por defecto |
|---|---|---|
| Límite de componentes | 1-500 | 20 |
Para evitar reportes abrumadores en bases de código grandes, las verificaciones de documentación para componentes solo se ejecutan si tu conteo total de componentes está por debajo de este umbral.
Configuración a Nivel de Organización
Las reglas de análisis se aplican en toda tu organización, no por proyecto. Esto asegura estándares de gobernanza consistentes en todos los equipos y proyectos.
Restablecer a Valores Por Defecto
Haz clic en Restablecer a valores por defecto en la pestaña Reglas para restaurar todas las reglas a su configuración original.
Próximos Pasos
- Descubrimiento con IA - Mantener arquitectura actualizada
- Documentación - Documentar decisiones arquitectónicas
- Exportar - Exportar reportes de análisis