SIMSUITEAI - Documentazione

Panoramica del Progetto

SIMSUITEAI è un'estensione avanzata che potenzia SimSuite con capacità di intelligenza artificiale

Estensione di SimSuite

SIMSUITEAI si integra perfettamente con SimSuite, una web app progettata per consentire agli istruttori di creare scenari di simulazione in ambito clinico.

Generazione Automatica

Utilizzando l'intelligenza artificiale, genera automaticamente scenari clinici complessi basati su tipologia, target e descrizione forniti dall'utente. Tutte le operazioni avvengono in background con notifiche automatiche al completamento.

Esami di Laboratorio

Crea automaticamente esami di laboratorio con relativi referti medici pertinenti allo scenario clinico selezionato.

Generazione Materiali

Genera automaticamente tutti i materiali necessari per lo scenario: strumenti diagnostici, dispositivi medici, farmaci, attrezzature di monitoraggio e materiali consumabili.

Referti Diagnostici

Crea referti medici specialistici per esami diagnostici avanzati come Radiografie, TC, Risonanza Magnetica, ECG ed Ecocardiografie, correlati al caso clinico.

Intelligenza Artificiale Avanzata

Il cuore di SIMSUITEAI: tecnologie AI all'avanguardia per la formazione medica

Generazione Intelligente di Scenari

L'AI analizza la tipologia di scenario richiesta, il target di riferimento e la descrizione fornita per creare scenari clinici realistici e didatticamente efficaci.

Livelli di Difficoltà

SIMSUITEAI offre tre livelli di difficoltà per adattare gli scenari al livello di formazione degli studenti:

Livello	Caratteristiche	Target	Complessità Clinica
Facile	Scenari lineari e diretti Sintomi chiari e specifici Procedure diagnostiche standard Timeline semplificata	Studenti principianti Prime esperienze cliniche	Bassa - Casi comuni e ben definiti
Medio	Scenari con più variabili Sintomi parzialmente ambigui Richiede ragionamento clinico Timeline articolata	Studenti intermedi Specializzandi	Media - Casi realistici con qualche complessità
Difficile	Scenari multipli e intrecciati Sintomi ambigui e rari Diagnosi differenziale complessa Timeline con complicazioni	Studenti avanzati Professionisti esperti	Alta - Casi rari e molto complessi

Guarda come l'AI genera automaticamente scenari clinici completi

1 Input: Tipologia, Target e breve Descrizione

2 Elaborazione AI

3 Scenario Completo

Generazione Automatica di Materiali

Crea automaticamente tutti i materiali necessari per lo scenario clinico, inclusi strumenti, dispositivi medici, farmaci e attrezzature specialistiche, adattati al contesto e alla complessità dello scenario.

Scopri come l'AI genera automaticamente tutti i materiali necessari per lo scenario

Tipologie di Materiali Supportati

Strumenti Diagnostici

Dispositivi Medici

Farmaci e Terapie

Attrezzature di Monitoraggio

Materiali Consumabili

Tecnologie Mediche

Lista completa e personalizzata

Quantità appropriate per scenario

Adattamento al livello di difficoltà

Specifiche tecniche dettagliate

1 Analisi Scenario

2 Identificazione Materiali

3 Lista Dettagliata

Creazione Automatica di Esami

Genera automaticamente esami di laboratorio realistici con relativi referti medici, correlati specificamente allo scenario clinico in corso.

Scopri come creare esami di laboratorio con un semplice click

Referti medici accurati

Valori di laboratorio realistici

Generazione Referti Diagnostici

Crea automaticamente referti medici realistici per esami diagnostici avanzati come Radiografie, TC, Risonanza Magnetica, ECG, Ecocardiografie e altri esami strumentali, perfettamente correlati allo scenario clinico.

Scopri come l'AI genera referti diagnostici specialistici accurati

Tipologie di Referti Supportati

Radiografie

TC/CT

Risonanza Magnetica

ECG

Ecocardiografia

Ecografia

Endoscopia

Altri Esami

Referti medici specialistici

Terminologia clinica accurata

Correlazione con patologia

Formati standard professionali

Workflow dell'Intelligenza Artificiale

Input dell'Istruttore

L'istruttore fornisce tipologia, target e descrizione dello scenario desiderato

Elaborazione AI

Gli agenti AI processano le informazioni utilizzando modelli avanzati

Scenario Completo

Viene generato uno scenario dettagliato con esami e referti correlati

Operazioni in Background

Elaborazione Asincrona

Una volta avviata la generazione automatica, tutte le operazioni vengono eseguite in background. Questo significa che puoi continuare a utilizzare l'applicazione normalmente mentre l'AI sta lavorando.

Sistema di Notifiche

Quando l'operazione sarà completata, riceverai una notifica direttamente nell'interfaccia dell'applicazione. Non dovrai controllare manualmente lo stato di avanzamento - ci penserà il sistema ad avvisarti automaticamente.

Produttività Massimizzata

Questo approccio permette di massimizzare la produttività: mentre l'AI genera uno scenario, puoi lavorare su altri aspetti dell'applicazione, gestire altri scenari o svolgere altre attività didattiche.

Stack Tecnologico

Architettura moderna e scalabile con tecnologie all'avanguardia

Backend AI - Python

FastAPI per API performanti e moderne

Agenti Agno per l'intelligenza artificiale

FastAPI Agno Agents Python 3.12+

Documentazione Python

SimSuite - Java

Spring Boot per il backend robusto

Vaadin per il frontend moderno

Spring Boot Vaadin Java 21+

Documentazione Java

Comunicazione

Integrazione seamless tra Python e Java

API RESTful per comunicazione efficiente

REST API JSON HTTP/HTTPS

Documentazione API

Architettura del Sistema

Frontend Vaadin

Interfaccia utente moderna

Backend Spring Boot

Logica di business

Backend AI Python

Agenti AI e FastAPI

Installazione e Configurazione

Guida completa per configurare e avviare SIMSUITEAI

Repository GitHub

Il codice sorgente completo è disponibile su GitHub. Clona il repository per iniziare:

Vai al Repository

1

Configurazione delle API Key

Crea un file .env nella cartella AGENTS con una delle seguenti chiavi (non è necessario configurarle entrambe):

# File: AGENTS/.env
# Scegli UNA delle due opzioni:
GOOGLE_API_KEY=your_google_api_key_here
# OPPURE
ANTHROPIC_API_KEY=your_anthropic_api_key_here

2

Configurazione Environment Python

Prima di avviare il backend, crea (se necessario) e attiva l'environment virtuale:

cd AGENTS
# Se non esiste, crea l'ambiente virtuale
python -m venv aienv
# Attiva l'ambiente virtuale
aienv\Scripts\activate
pip install -r requirements.txt

Nota: Se l'environment virtuale aienv esiste già, puoi saltare il comando di creazione.

3

Avvio del Backend Python

Con l'environment attivato, avvia il backend AI con FastAPI:

python main.py

Il server sarà disponibile su http://localhost:8001

4

Avvio dell'Interfaccia Grafica

Hai due opzioni per avviare l'interfaccia grafica di SimSuite:

Opzione 1: IntelliJ IDEA

Per sviluppatori o utenti che hanno accesso al codice sorgente:

Apri il progetto SimSuite in IntelliJ IDEA

Avvia l'applicazione da IntelliJ

Apri localhost:9090 nel browser

Opzione 2: Installer Windows

Per utenti Windows che preferiscono un'installazione semplice:

Scarica l'installer dedicato per Windows

Esegui l'installer e segui le istruzioni

Avvia dall'icona sul desktop o naviga a localhost:9090

Per dubbi consulta SimSuite.it

Scarica Installer Windows

⚠️ Importante: Posizione Database

Solo per l'Opzione 1 (IntelliJ IDEA): Se avvii l'interfaccia da IntelliJ IDEA, è necessario spostare il file database.db nella cartella padre (fuori da sim-suite-ai/) per garantire la compatibilità con SimSuite.

Per l'Opzione 2 (Installer Windows): Non è necessario spostare il database - l'installer configura automaticamente tutto il necessario.

Requisiti di Sistema

Python 3.12+

Java 21+

Environment virtuale (aienv)

Database compatibile

API Key Google AI o Anthropic (una delle due)

❓ Risoluzione Problemi

Soluzioni alle problematiche più comuni durante l'installazione e l'utilizzo

Il backend non parte?

Verifica che l'ambiente virtuale sia attivo

Controlla che almeno una API key sia configurata

Non riesco ad accedere a SimSuite?

Assicurati che l'interfaccia Java sia avviata sulla porta 9090

Consulta SimSuite.it per supporto sull'interfaccia

Non riesco a creare uno scenario?

Controlla che il file database.db sia posizionato nella cartella padre

Verifica la connessione tra frontend e backend

Errori di generazione?

Controlla che il backend sia attivo sulla porta 8001

Verifica la connessione internet

Controlla la validità della API key configurata

Hai ancora problemi?

Se i problemi persistono, consulta la documentazione completa o contatta il supporto attraverso il repository GitHub.

Repository GitHub SimSuite.it

Il Mio Stage presso Simnova

Il percorso formativo che ha portato allo sviluppo di SIMSUITEAI

Lo Stage che ha Dato Vita al Progetto

SIMSUITEAI è nato durante il mio stage presso Simnova, il Centro di Simulazione dell'Università del Piemonte Orientale. Durante questo percorso formativo, ho avuto l'opportunità di sviluppare SimSuite, la piattaforma base che successivamente è stata potenziata con le funzionalità di intelligenza artificiale.

La Missione di Simnova

Simnova è un centro di eccellenza dedicato alla formazione medica attraverso la simulazione clinica. Il centro utilizza tecnologie all'avanguardia, inclusi manichini ad alta fedeltà e ambienti simulati realistici, per fornire agli studenti di medicina e ai professionisti sanitari un'esperienza di apprendimento sicura ed efficace. Attraverso scenari clinici realistici, Simnova permette di acquisire competenze pratiche senza rischi per i pazienti reali.

Ringraziamenti al tutor Antonio Scalogna, ideatore di SimSuite, per i suggerimenti nella parte AI.

SIMSUITEAI Il Futuro della Simulazione Clinica

AI-Powered

Clinico

Avanzato