Informe de revisión de arquitectura
Un ejemplo abreviado del informe que recibe al final de una revisión de arquitectura. Los informes reales tienen las mismas secciones; los hallazgos se apoyan en ejemplos de código, planes de consulta y capturas de pantalla.
Esto es un ejemplo. La empresa, el sistema y todas las cifras son ficticios; nada se basa en datos de ningún cliente. El escenario: una empresa que desarrolla software B2B de pedidos e inventario, con un equipo de software de 8 personas.
1. Resumen ejecutivo
- El sistema soporta la carga actual, pero cuando se duplique el número de clientes, los informes y el flujo de pedidos se convertirán previsiblemente en un cuello de botella.
- El riesgo más urgente está en la seguridad y la continuidad: las copias de seguridad de la base de datos nunca se han probado restaurándolas y el panel de administración es accesible para cualquiera.
- No hace falta reconstruirlo. La vía recomendada es dividir el monolito actual en módulos y reforzarlo paso a paso en 6 meses.
2. Alcance y método
- Duración
- 5 días laborables
- Revisado
- Código de la aplicación principal (~120.000 líneas), esquema de la base de datos, infraestructura de servidores y despliegue
- Entrevistas
- 4 entrevistas con el tech lead, dos desarrolladores y el responsable de operaciones
- Herramientas
- Revisión de código, planes de consulta (EXPLAIN ANALYZE), análisis de dependencias y seguridad, perfilado de carga
3. Hallazgos
Ordenados por impacto y urgencia.
- #1CríticoContinuidadEsfuerzo estimado: 1 día
Se hace una copia de seguridad diaria, pero nunca se ha probado restaurándola; las copias están en el mismo servidor.
Impacto: Si falla el disco, se pierden tanto los datos como las copias de seguridad.
Recomendación: Trasladar las copias de seguridad a otra ubicación y hacer una prueba de restauración mensual.
- #2CríticoSeguridadEsfuerzo estimado: 2 días
El panel de administración es accesible desde internet, sin autenticación de dos factores y sin límite de intentos de inicio de sesión.
Impacto: Con un ataque de fuerza bruta se puede acceder a todos los datos de los clientes.
Recomendación: Poner el panel detrás de una VPN o una restricción por IP y añadir 2FA y limitación de intentos.
- #3AltoRendimientoEsfuerzo estimado: 3 días
La consulta del informe mensual recorre de principio a fin una tabla sin índice (38 s de media).
Impacto: Mientras se genera el informe, las pantallas de pedidos se vuelven lentas.
Recomendación: Dos índices compuestos, y que el informe lea de una tabla resumen preparada por la noche.
- #4AltoArquitecturaEsfuerzo estimado: 4-6 semanas
El código de pedidos, inventario y facturación escribe directamente en las tablas de los demás.
Impacto: Un cambio en un módulo rompe los otros; cada nueva funcionalidad cuesta más.
Recomendación: Definir límites entre módulos y hacer pasar toda la comunicación entre ellos por una única capa de servicios.
- #5MedioMantenimientoEsfuerzo estimado: 2 semanas
El framework va dos versiones principales por detrás; 14 dependencias tienen vulnerabilidades conocidas.
Impacto: No se pueden aplicar las actualizaciones de seguridad y la actualización se complica cada mes.
Recomendación: Actualizar primero las dependencias y después el framework, versión a versión.
- #6MedioEquipoEsfuerzo estimado: 2-3 semanas
La cobertura de tests automatizados es del 8 %; el despliegue es manual y depende de una sola persona.
Impacto: Si esa persona no está, no se puede publicar nada; los errores los descubren los clientes.
Recomendación: Tests E2E para los flujos críticos y un pipeline de despliegue automatizado.
4. Arquitectura objetivo
- Sigue siendo una sola aplicación (monolito modular); pedidos, inventario, facturación e informes son módulos separados.
- Los informes leen de tablas resumen que no cargan la base de datos principal.
- El panel de administración está en la red interna; el despliegue está automatizado y se puede revertir.
5. Plan de migración
Primeros 30 días
Cerrar los riesgos
- Copias de seguridad y prueba de restauración
- Seguridad del panel de administración
- Acelerar la consulta del informe
1-3 meses
Reforzar la base
- Actualización de dependencias y framework
- Tests para los flujos críticos
- Pipeline de despliegue automatizado
3-6 meses
Dividir en módulos
- Separar los módulos de pedidos e inventario
- Llevar la facturación a la capa de servicios
- Documentación de arquitectura y traspaso al equipo
¿Quiere este informe para su propio software? Una revisión de arquitectura dura 5-7 días laborables.