El propósito es implementar una solución de documentación automática con IA Gen capaz de analizar, documentar y explicar el código fuente de manera exhaustiva y precisa.
CLIENTE
Líder en el sector del juego privado
Compañía con más de 40 años de experiencia operando máquinas de juego, puestos de bingo, terminales de apuestas deportivas, casinos y apuestas online. Presente en varios países de Europa y Latinoamérica, que necesita mantener y evolucionar plataformas tecnológicas complejas con equipos distribuidos.
RETO
Gestión eficiente del conocimiento técnico que permita acelerar la adaptación a las necesidades del negocio y mejorar el time to market.
La compañía necesita tener documentado sus aplicaciones core para mejorar la mantenibilidad y su correcta evolución. Su código se encuentra en distintos repositorios, microservicios y aplicaciones heredadas y recientes.
SOLUCIÓN
Para enfrentar este reto, es crucial que la compañía establezca una estrategia de documentación automatizada adaptada a sus necesidades específicas, que le permita afrontar la complejidad del código y mejorar la operatividad y el conocimiento del producto.
Desde un punto de vista de negocio
Se ha aportado una solución técnica innovadora basada en IA Gen facilitando al negocio tanto su visión global del producto que desarrollan como la posibilidad de acelerar los cambios que se quieren implantar, redundando además en eficiencias de costes de forma inmediata.
Desde un punto de vista tecnológico
La generación automática de documentación se ha realizado mediante agentes inteligentes basados en modelos de Meta, Alibaba y Deepseek. El reto tecnología se estructura en cuatro etapas:
- Ingesta: organización de la información en grafos de relaciones para definir la estrategia de documentación.
- Documentación automática: generación de información, estadísticas y casos de uso a partir del análisis del grafo.
- Documentación de código: comentario del código usando LLM’s especializados.
- RAG Documental: vectorización de toda la información generada.
Diseño de una arquitectura que integra modelos de IA avanzados con herramientas de análisis de código, proporcionando capacidades conversacionales y de generación
de documentación automatizada.
Proceso integral que permite analizar repositorios completos, extraer relaciones entre componentes y generar documentación de alto nivel, reduciendo la carga manual de los equipos de desarrollo.
Prediseño para facilitar la incorporación de nuevos repositorios y lenguajes mediante una capa de abstracción que unifica el análisis sintáctico independientemente del lenguaje origen.
BENEFICIOS
 |
Rápida adaptación al negocio: la plataforma permite conocer rápidamente las funcionalidades implementadas, acelerando el time to market. |
|
Mejor experiencia de usuario: el sistema conversacional permite interactuar consultando cualquier aspecto sobre el scope de código. |
|
Mayor trazabilidad: proporciona los casos de uso y relaciona las piezas de software implicadas. |
|
Reducción del riesgo: el sistema facilita el mantenimiento y la evolución del sistema. |
|
Onboarding acelerado: mejora en un 50% el tiempo que se dedicará a la adaptación de nuevas incorporaciones. |
BENEFICIOS
- Rápida adaptación al negocio: la plataforma permite conocer rápidamente las funcionalidades implementadas, acelerando el time to market.
- Mejor experiencia de usuario: el sistema conversacional permite interactuar consultando cualquier aspecto sobre el scope de código.
- Mayor trazabilidad: proporciona los casos de uso y relaciona las piezas de software implicadas.
- Reducción del riesgo: el sistema facilita el mantenimiento y la evolución del sistema.
- Onboarding acelerado: mejora en un 50% el tiempo que se dedicará a la adaptación de nuevas incorporaciones.
Eficiencia y transformación para su negocio
- Mejora en la toma de decisiones técnicas: conocimiento más detallado del producto desarrollado.
- Aceleración del time to market: permite implementar cambios con mayor agilidad.
- Reducción de costes: automatización de la generación de documentación y análisis estadístico del código que redunda en reducción de costes.
- Mayor agilidad y flexibilidad: capacidad para adaptarse rápidamente a cambios del negocio.
- Eficiencia en onboarding: reducción del 50% en tiempo de incorporación de nuevos desarrolladores.
- Confiabilidad: sistema conversacional robusto que reduce el riesgo de pérdida de conocimiento.
Valor diferencial que nuestra solución aporta al cliente desde un punto de vista de impacto a negocio
Comprensión detallada de su base de código, facilitándole la toma de decisiones estratégicas y mejorando la velocidad de desarrollo. Además, esta solución le permite identificar casos de uso empresariales a partir del código existente y optimizar procesos.
Nos enfocamos en la creación de una visión unificada del código, lo cual implica mejorar la comprensión de las relaciones entre componentes. Para ello, utilizamos modelos de IA avanzados que pueden interpretar y documentar el código automáticamente. Además, buscamos mejorar la interacción con esta documentación mediante interfaces conversacionales que permiten consultas en lenguaje natural.
Eligiendo una solución de IA Generativa
Se apuesta por esta solución como confirmación del business case asociado a la automatización con IA. Se han evaluado modelos de Alibaba Cloud, Meta, IBM y Deepseek para seleccionar los más adecuados para cada tarea específica:
- Generación de casos de uso: Llama 3.2
- Diagramas C2: Qwen 2.5 Coder
- Respuesta chat: Deepseek r1
Con esta solución dotamos al cliente de herramientas para comprender y evolucionar su código de manera efectiva.
TECNOLOGÍAS
- Analizador estático y compliador: permite dividir el código en nodos sintácti-cos y representarlo como un grafo de entidades.
- LangChain: integración con diversas herramientas, fuentes de datos y modelos de IA para crear soluciones escalables.
- Langflow: plataforma de desarrollo visual basada en LangChain.
- n8n: plataforma de automatización de flujos, prototipado rápido y generación de PoCs.