Progettazione e sviluppo di un sistema automatizzato per la generazione di documentazione di sistemi software

Il presente documento descrive l'attività di tirocinio svolta presso M31, un'azienda che sviluppa software e opera spesso con architetture complesse basate su microservizi. L'obiettivo principale del progetto di tirocinio era di progettare ed implementare un sistema software di documentazione unificato, centralizzato e ben definito. I contributi hanno incluso un'attenta fase di ricerca di soluzioni open source, seguita dallo sviluppo completo di un motore di automazione DevOps. Nello specifico, si è creato un sistema centralizzato basato su script Python eseguiti in container Docker, capace di generare documentazione da file Open API e pubblicarla direttamente sui wiki aziendali. In una seconda fase, l'attività si è focalizzata sull'integrazione di tecnologie avanzate di Intelligenza Artificiale (IA) per facilitare ed automatizzare la documentazione. Nello specifico è stato realizzato un agent con la ADK (Agent Development Kit) di Google; l'agent doveva generare e pubblicare documentazione su Confluence e Gitlab. La pipeline viene gestita da un file di configurazione scritto in YAML su Gitlab che lo script creato consulta ad ogni aggiornamento del codice.