Panoramica

L'Analista geopolitico strutturale è uno strumento per condurre analisi geopolitiche rigorose seguendo il metodo strutturale, fase per fase. Ogni fase compone un aspetto dell'analisi (ammissibilità, parametri, classificazione, proprietà dello spazio, relazioni/attori, scenari, ecc.).

Quando l'app si ferma dopo una fase, sei tu a decidere se proseguire, ottenere informazioni sullo stato corrente, o ricalibrare elementi precedenti.

In breve

  • Scrivi qualcosa per proseguire alla fase successiva
  • Usa slash-comandi (/stato, /compara, ecc.) per azioni specifiche
  • Leggi le correzioni di P10 se suggerite, ma sono informative, non obbligatorie
  • Il report finale (P13) può essere generato con /report dopo P12
💡 Tip: Usa /stato in qualsiasi momento per verificare dove sei nella pipeline e quanti token hai consumato fino a quel punto.

Comandi disponibili

Fai click su questi comandi slash (/comando) in qualsiasi momento durante l'analisi per eseguire azioni specifiche.

Comando Quando usarlo Effetto
/stato In qualsiasi momento Mostra fase corrente, fasi completate, lacune dichiarate e totale token consumati
/tipo Dopo P04 Visualizza la classificazione corrente (tipo A, B, C, SOSPESO)
/riclassifica [nota] Dopo P04, massimo 1 volta Rifà la classificazione (P04) se non sei soddisfatto del tipo assegnato. Puoi scrivere una nota facoltativa dopo il comando (es. /riclassifica secondo me lo spazio non è affatto conteso): verrà letta da P04 come indicazione con priorità, insieme agli eventuali problemi già rilevati da P10
/report Dopo P12 Genera il report narrativo assemblato (P13)
/compara [caso] Dopo P11 Confronta l'analisi con un altro caso (es: /compara geopolitica del Pacifico)
/abbandona In qualsiasi momento Azzera l'analisi corrente e ne inizia una nuova — stesso effetto del bottone "Nuova analisi", ma senza dover uscire dalla chat. Nessuna conferma richiesta: l'analisi in corso si perde subito.

Avanzamento automatico

Se non usi un comando slash, scrivi un testo libero per proseguire alla fase successiva:

  • Una frase, una domanda, un'osservazione
  • Anche solo continua o ok
  • Il testo viene passato come contesto (l'insieme di dati, informazioni e messaggi precedenti che un sistema usa per capire una richiesta e dare una risposta coerente) alla fase successiva
✓ Consiglio: Se vuoi passare al passo successivo senza aggiungere contesto, digita o fai click su continua o premi invio dopo aver letto l'output.

Modalità di conoscenza

Se l'amministratore ha collegato la base di conoscenza certificata EIL (Evidence Intelligence Layer — un archivio di documenti caricati e verificati), in sidebar compare un selettore Conoscenza con quattro opzioni. Come la Modalità (automatica/semi-automatica), si sceglie prima del primo messaggio e non è più modificabile a metà analisi.

OpzioneDa dove attinge l'analisiQuando usarla
Web Ricerca autonoma di Gemini sul web, come sempre. EIL non viene interrogato. Il comportamento predefinito. Nessuna base documentale dedicata.
Certificata Solo EIL. La ricerca web di Gemini è forzata spenta e la "Ricerca approfondita" è disattivata. Ciò che EIL non copre resta una lacuna dichiarata, non viene colmato a memoria. Quando vuoi un'analisi che poggi esclusivamente su documenti verificati. Più conservativa: se EIL ha poco sul tema, il report avrà molte lacune.
Mista EIL come fonte primaria; Gemini (web + conoscenza propria) interviene solo dove EIL tace. La "Ricerca approfondita" resta disponibile come rete di sicurezza sulle lacune. L'equilibrio consigliato: parte dai documenti certificati, ma non si blocca su ciò che non c'è.
Mista integrata Come Mista, più una ricerca Gemini di arricchimento per ogni macro-sezione: cerca attivamente elementi pertinenti che EIL non copre e li aggiunge, etichettati come non certificati. Quando vuoi il quadro più completo possibile. Aumenta tempo e costo (una chiamata Gemini in più per sezione).

Come EIL viene interrogato

Non una domanda per ogni fase, ma una per macro-sezione: una sull'inquadramento del tema (P03–P04), una sui caratteri dello spazio (P06), una sugli attori / sull'attore dominante (P07–P09). La stessa risposta viene riusata da tutte le fasi di quella sezione. Ogni interrogazione può richiedere qualche decina di secondi.

Da dove viene ogni informazione, nel report

Nelle modalità che usano EIL, il report finale distingue l'origine di ogni dato:

  • le citazioni di documenti EIL portano il marcatore [EIL] subito dopo la parentesi — es. (limes-13062026.pdf, n.d.) [EIL] — e in bibliografia hanno il chip 📚 documento certificato (EIL);
  • le fonti web trovate da Gemini restano (Autore, Anno) senza marcatore, con l'indirizzo cliccabile in bibliografia;
  • ciò che non ha fonte è dichiarato nel testo come inferenza propria ("in base alla conoscenza pregressa"), e non compare in bibliografia.

Costo

Ogni interrogazione a EIL ha un costo (EIL usa Gemini al proprio interno per rispondere): compare come riga EIL nel pannello Token / Costo ed è già sommato al totale della sessione e alla tua quota. In Mista integrata si aggiunge anche il costo delle chiamate di arricchimento.

⚠️ Se EIL non risponde (solo modalità Certificata): l'analisi si sospende con un avviso — la modalità Certificata non ammette alternative. Puoi reinviare il messaggio per riprovare, o avviare una nuova analisi scegliendo un'altra modalità. Nelle modalità Mista, un problema di EIL non blocca nulla: l'analisi prosegue usando il web.

Quando la pipeline attende una tua scelta

L'app si ferma dopo ogni fase e attende il tuo input. Ecco cosa succede in ciascun punto:

P01 — Ammissibilità

Il tema proposto viene valutato. Se ammesso in quanto ritenuto suscettibile di essere affrontato in una prospettiva geopolitica (e quindi non di diverso approccio disciplinare), la pipeline ti chiede di continuare. Se rifiutato o riformulabile, suggerisce un'alternativa.

P02–P05, P06, P07–P09, P11–P12

Al termine di ogni fase, digita qualcosa (comando slash o testo libero) per proseguire. L'output mostra i risultati della fase corrente in forma strutturata (chip colorati, tabelle, sezioni).

P10 — Autoverifica ⚠️

Questa è la fase critica: P10 revisiona tutta l'analisi precedente e segnala:

  • Coerenza complessiva (soddisfacente / con riserve / problematica)
  • Problemi rilevati (leader-centrismo, monocausalità, strutturale/contingente non distinti)
  • Correzioni proposte per ogni problema

Vedi la sezione P10 (Autoverifica) per capire come interpretare e applicare le correzioni.

P13 — Report

Dopo P12, fai click su /report per generare il report narrativo assemblato. Se non hai già cliccato su /report, la pipeline ti suggerirà di farlo.

P14 — Comparazione (opzionale)

Dopo P11, puoi usare /compara [descrizione] per confrontare la tua analisi con un altro caso. Non è obbligatorio; P13 si genera in ogni caso.

Fase P01: Ammissibilità

P01 è il gate d'ingresso della pipeline: prima di avviare l’analisi l’applicazione si preoccupa di verificare che il tema proposto sia davvero trattabile con il metodo geopolitico strutturale. È l'unica fase che può interrompere l'analisi (esito RESPINTO) invece di limitarsi a segnalare un problema e proseguire.

Fase P02: Parametri

Subito dopo che P01 ammette il tema, P02 fissa il perimetro e l'impostazione dell'analisi: dove guardare, quanto in profondità, e su quale arco temporale. Sono le decisioni che condizionano tutte le fasi successive — un perimetro tracciato male o un solo fattore causale individuato qui si trascinano fino al report finale.

Puoi accettarli così, oppure correggerli

Sotto il riepilogo dei parametri proposti trovi un pulsante "✏️ Modifica parametri". Se i valori ti convincono, non serve toccarlo: scrivi qualcosa (o usa /continua) per proseguire, come faresti normalmente. Se invece qualcosa non ti convince, il pulsante apre un modulo dove correggere ogni valore scegliendolo da un elenco — non devi indovinare come si scrive un valore valido, scegli tra quelli proposti.

Puoi modificare, scegliendo da una lista:

  • il criterio con cui è tracciato il perimetro;
  • gli ambienti coinvolti (terrestre, marittimo in superficie o in profondità, aerospaziale, extra-atmosferico, digitale — anche più di uno);
  • le scale coinvolte (globale, macroregionale, regionale, statuale, sub-statuale, locale — anche più di una);
  • il taglio (ampiezza oppure profondità) e l'impianto (teorico, empirico o bilanciato);
  • la scala temporale di ciascun fattore causale in profondità storica, e se è invariante.

La descrizione del perimetro, i limiti di generalizzabilità e i fattori causali stessi (nome e punto di partenza) restano campi di testo libero: puoi riscriverli, ma non sono "a scelta" — nel modulo trovi comunque un pulsante per aggiungere o togliere un fattore causale.

✓ Nessun costo, nessuna attesa: correggere i parametri non consuma token né richiama di nuovo il modello — è una sostituzione immediata di ciò che P02 aveva proposto. Puoi correggere quante volte vuoi prima di premere "✓ Conferma modifiche e prosegui a P03".
💡 Solo qui, solo ora: la modifica è possibile finché P02 resta la fase corrente, cioè prima che tu scriva qualcosa per andare avanti. Una volta passato a P03, i parametri sono fissati: per cambiarli a quel punto devi /abbandona e ricominciare l'analisi.

Fase P03: Introduzione

P03 costruisce la cornice introduttiva dell'analisi, prima ancora della classificazione (P04): perché il tema merita uno studio strutturato, quale domanda guiderà l'analisi, e — quando è già formulabile — un'ipotesi di partenza. Riceve in input l'esito di P01 e i parametri di P02.

Fase P04: Classificazione

P04 è il cuore decisionale della pipeline: assegna il tipo (A, B, C.1, C.2 o SOSPESO) da cui dipende l'intero ramo successivo — se il tema è di tipo C, la pipeline devia prima su P05 (Spazializzazione); da lì in poi, e per i tipi A/B fin da subito, il tipo effettivo decide se si procede verso P07/P08 (ramo A) o P09a/b/c (ramo B).

✓ Non convinto del tipo assegnato? Dopo P04 (e di nuovo dopo P10) puoi usare /riclassifica, una sola volta per analisi, per farlo rifare — vedi la sezione P10 (Autoverifica) per la strategia completa e per come scrivere una nota facoltativa che P04 terrà in considerazione.

Fase P05: Spazializzazione

P05 esiste solo per i temi classificati tipo C in P04 — uno spazio non pre-individuato, come un settore merceologico o un fenomeno sociale. Il suo compito è ricostruire un vero perimetro spaziale a partire da un oggetto di studio che inizialmente non ne ha uno esplicito, e infine ricondurre il tema al tipo A o B, sbloccando così le fasi successive (P06 in poi).

Fase P06: Proprietà strutturali dello spazio

P06 non è una singola chiamata ma una catena di dodici sotto-fasi, una per ciascuna proprietà strutturale dello spazio, seguite da una sintesi trasversale (P06_sintesi). Il frontend le presenta come un unico passo della pipeline, ma tecnicamente sono tredici richieste separate .

Fase P07: Relazioni tra gruppi

P07 apre il ramo di tipo A (spazio senza attore dominante): analizza come i gruppi umani coinvolti si relazionano tra loro, prima ancora di descrivere i singoli attori (che arriva dopo, in P08). Riceve in input parametri, classificazione e la sintesi di P06.

Fase P08: Attori geopolitici

P08 completa il ramo di tipo A: mappa i singoli attori dello spazio, il loro peso e le loro narrazioni, sulla base delle relazioni già descritte in P07. La tassonomia delle categorie, i ruoli e la visibilità sono descritti in dettaglio nella sezione Attori: categorie, ruoli, visibilità — qui trovi come la fase li usa.

Fasi P09a/b/c: il ramo dell'attore dominante

Quando il tipo effettivo è B (uno spazio sottoposto al controllo di un attore dominante), la pipeline segue tre fasi in sequenza invece di P07/P08: coesione interna, intensità della presa, fattori di forza per la proiezione esterna. Tutte e tre si concentrano sullo stesso attore, identificato per primo in P09a.

P09a — Coesione interna

Prima cosa: identifica e nomina l'attore dominante (nome_attore). Poi vaglia sistematicamente tutti e dodici i piani della coesione interna — storico, demografico, istituzionale, immigratorio, mediatico, sociale, politico_ideologico, geografico, etnico, religioso, culturale, infrastrutturale — un validatore impone che compaiano tutti e dodici nell'array piani_coesione, anche quelli dichiarati non pertinenti. Per ognuno: pertinente sì/no e, se sì, un'analisi con valutazione (fattore di coesione / divisione / neutro). Chiude con valutazione_complessiva (alta/media/bassa) e un' inferenza_principale.

Fase P10: Autoverifica

P10 è la revisione critica dell'intera analisi. Legge tutte le fasi precedenti e identifica incoerenze, pregiudizi, assunzioni non fondate.

Cosa segnala P10

  • Coerenza complessiva: soddisfacente / con riserve / problematica
  • Fattori strutturali vs contingenti: sono chiaramente distinti?
  • Leader-centrismo: l'analisi dipende troppo da un singolo attore?
  • Monocausalità: si assegna troppo peso a una sola causa?
  • Problemi rilevati: lista di problemi specifici con gravità (alta/media/bassa)
  • Lacune non dichiarate: a differenza delle lacune viste durante l'analisi (vedi sezione Lacune dichiarate), qui P10 rilegge tutto il lavoro già fatto e segnala mancanze che avrebbero dovuto essere dichiarate prima e non lo sono state — un controllo a posteriori, non una dichiarazione nel momento in cui si scrive

Come applicare una correzione

Quando P10 suggerisce una correzione (es: "Riconsiderare i fattori basici di P07: la conflittualità non è sufficientemente radicata in fattori strutturali"), il suggerimento è informativo, non esecutivo.

  • Se il problema è in P04 (classificazione): Usa /riclassifica una sola volta. La pipeline ricomincerà da P04 e ripeterà tutte le fasi successive — passando anche i problemi rilevati da P10 e le correzioni proposte, così la nuova classificazione li tiene esplicitamente in considerazione invece di ripartire alla cieca. Puoi anche scrivere tu stesso, dopo il comando, una nota con quello che pensi sia sbagliato o da tenere in conto (es. /riclassifica il dominio è solo formale, nella sostanza nessuno lo controlla davvero): P04 la legge con priorità, insieme ai problemi di P10, ma può comunque non seguirla se contrasta con il metodo o con le evidenze già raccolte — in quel caso te lo spiega nella motivazione della nuova classificazione.
  • Se il problema è in P07, P08, P09a/b/c (rami analitici): Al momento non è possibile "rifare" una singola fase intermedia. Puoi resettare tutto (Nuova analisi) se il problema è critico, oppure procedere comunque verso P11/P12/P13.
  • Se il problema è di coerenza complessiva: La nota di P10 rimane nel report finale (P13) come dichiarazione di limite metodologico. Serve a segnalare ai lettori i vincoli dell'analisi.
  • Strategia consigliata

    1. Leggi attentamente il riepilogo di P10
    2. Se sono presenti problemi di gravità alta in P04, considera /riclassifica
    3. Per problemi in fasi successive, continua comunque verso P11/P12/P13
    4. Nel report finale (P13), i limiti metodologici saranno documentati
    ⚠️ Importante: /riclassifica può essere usato una sola volta per analisi. Usalo solo se il tipo di classificazione è significativamente sbagliato secondo P10. La nota facoltativa che puoi scrivere insieme al comando conta come indicazione, non come garanzia di cambiare il risultato: se scrivi la stessa cosa due volte o non aggiungi nulla di nuovo, il tentativo si consuma comunque e potresti ottenere di nuovo la stessa classificazione.
    ✓ Ricorda: Dichiarare i limiti (leader-centrismo, assunzioni non testate) è parte del metodo strutturale. Non è un fallimento, è trasparenza metodologica.

    Fase P11: Conclusioni

    P11 chiude la parte analitica della pipeline: rilegge introduzione, sintesi di P06, il ramo completato (P07/P08 o P09a/b/c) e l'autoverifica di P10, e ne trae le conclusioni. È l'ultima fase prima degli scenari (P12) e del report (P13).

    Fase P12: Scenari

    P12 costruisce gli scenari futuri a partire dalle conclusioni di P11. È, per esplicita scelta del metodo, la fase con i vincoli più stringenti di tutta la pipeline .

    Fase P13: Report narrativo

    P13 non produce nuova analisi: assembla in prosa continua tutto ciò che le fasi precedenti hanno già stabilito. Va invocata esplicitamente col comando /report dopo P12 — non parte da sola. È l'unica fase il cui output non è pensato per essere letto come un messaggio strutturato in un certo formato, ma come testo narrativo leggibile.

    Fase P14: Comparazione (opzionale)

    P14 non fa parte del percorso lineare: si invoca col comando /compara [descrizione del caso] dopo P11, per confrontare l'analisi appena condotta con un altro caso proposto da te. Non è mai obbligatoria — P13 si genera comunque senza passare da qui.

    I tre divieti, verificati prima di tutto

    Prima di procedere al confronto vero e proprio, P14 verifica esplicitamente tre condizioni di ammissibilità — se anche una sola è violata, la comparazione viene rifiutata (ammissibilita.ammessa = false), con motivazione e, quando possibile, una proposta alternativa di confronto tra singoli aspetti omologhi invece che tra i due casi nella loro interezza:

    Se la comparazione è ammessa

    Il confronto procede aspetto per aspetto (mai i due casi nella loro interezza): per ciascun aspetto, caso_principale vs caso_confronto, le differenze_rilevanti e un'inferenza. Chiude con variazioni_locali_emerse (differenze che illuminano aspetti non visibili in una singola analisi) e nuove_chiavi_lettura.

    ℹ️ Dichiarazione obbligatoria: il giudizio sulla liceità di una comparazione non ha regole prestabilite in astratto — un validatore richiede sempre la dichiarazione_limite_soggettivo, per rendere esplicito che è comunque un giudizio interpretativo, non un calcolo oggettivo.

    Lacune dichiarate

    Durante l'analisi vedi comparire, nella sidebar "Lacune dichiarate", elementi che il modello segnala come mancanti invece di inventarli. Questa sezione spiega da dove nascono, cosa significano davvero, e come usarle.

    Da dove nascono

    Ogni fase riceve, tra le sue regole permanenti (lo stesso blocco iniettato in ogni fase, vedi Fonti e bibliografia), questa istruzione letterale:

    "Nessun fatto senza fonte. Non asserire dati specifici (cifre, date, quote, assetti attuali, dichiarazioni) senza una fonte verificabile o fornita dall'utente. In assenza, usa il campo lacune con impatto dichiarato e prosegui al livello strutturale."

    In pratica: quando il modello dovrebbe affermare un dato preciso ma non ha una fonte verificabile a sostegno, l'alternativa all'inventare (o all'affermarlo comunque, senza basi) è dichiarare esplicitamente cosa manca. Ogni lacuna ha due parti:

    CampoCosa contiene
    cosa_servirebbe Che informazione mancherebbe per colmare il punto (es. "dato demografico aggiornato al 2025", "testo integrale dell'accordo non reso pubblico")
    impatto_sulla_analisi Quanto quella mancanza pesa sulle conclusioni — testo libero scritto dal modello, non un valore da un elenco fisso (vedi più sotto perché questo conta)

    In quali fasi possono comparire

    Solo le fasi che devono affermare fatti verificabili hanno un campo lacune nel proprio schema: P03 (Introduzione), P05 (Spazializzazione), ogni sotto-fase di P06 (le 12 proprietà strutturali) più P06_sintesi, P07 (Relazioni), P08 (Attori), P09a/P09b/P09c (coesione, presa, fattori di forza — solo tipo B, attore dominante).

    Non compaiono in P01, P02, P04, P12, P13, P14. Sono fasi di setup, classificazione, generazione di scenari o assemblaggio — P04, ad esempio, esprime l'incertezza in altro modo, con il campo confidenza (alta/media/bassa), non con lacune.

    Due campi diversi, spesso confusi con le lacune

    P10 e P11 hanno campi che sembrano lacune ma non lo sono, nello stesso senso:

    FaseCampoCosa rappresenta davvero
    P10 — Autoverifica lacune_non_dichiarate_rilevate Audit a posteriori: il modello rilegge tutto il lavoro già fatto e segnala mancanze che avrebbero dovuto essere dichiarate prima (con il meccanismo qui sopra) e non lo sono state — non è una dichiarazione nel momento in cui si scrive, è un controllo di qualità retrospettivo
    P11 — Conclusioni lacune_rimaste_aperte Sintesi finale: semplice elenco di frasi, quello che resta irrisolto una volta arrivati alle conclusioni — un riepilogo per il lettore, non una nuova dichiarazione puntuale

    Come vengono raccolte e mostrate

    Il server cerca ricorsivamente un array lacune ovunque si trovi nell'output di ogni fase (a seconda della fase può essere alla radice o annidato, come per le fonti — vedi Fonti e bibliografia) e lo accumula per l'intera sessione. La sidebar mostra sempre il totale accumulato fino a quel momento, non solo quelle dell'ultima fase completata.

    Le lacune in sidebar sono ordinate per gravità stimata, dedotta dal testo di impatto_sulla_analisi cercando parole chiave comuni in italiano (es. "critico", "significativo" → gravità alta; "marginale", "trascurabile" → gravità bassa) — quelle ad alto impatto salgono in cima con un bordo rosso e ⚠, quelle a basso impatto scendono con un bordo grigio.

    ⚠️ È un'euristica, non un giudizio affidabile al 100%: impatto_sulla_analisi è testo libero scritto dal modello, non un valore strutturato tra alternative fisse — non c'è modo di leggerne la gravità con certezza meccanica. Una lacuna il cui testo non contiene nessuna delle parole chiave riconosciute resta "non specificato" e mantiene l'ordine di arrivo: leggi comunque il testo per intero prima di dare peso alla posizione in lista.

    Dove le trovi

    • Sidebar "Lacune dichiarate" durante l'analisi, sempre aggiornata al totale reale
    • Scrivendo stato in chat, che riporta comunque l'elenco completo accumulato
    • Nei documenti salvati ("Salva chat" e "Salva report finale"): una sezione dedicata elenca tutte le lacune dichiarate, nello stesso ordine per gravità della sidebar

    Come interpretarle

    ✓ Non bloccano l'analisi. Sono il meccanismo con cui il sistema preferisce dichiarare onestamente un limite piuttosto che inventare un dato plausibile — coerente con lo spirito generale dell'app (vedi anche P10 — Autoverifica). Una lacuna ad alto impatto su un punto centrale del tema merita più attenzione di una a basso impatto su un dettaglio marginale: usa il testo di impatto_sulla_analisi (non solo la sua posizione in lista) per decidere se vale la pena colmarla — ad esempio fornendo tu stesso l'informazione mancante nel messaggio successivo, prima che la pipeline prosegua oltre il punto in cui servirebbe.

    Fonti e bibliografia

    Ogni fase può citare fonti a sostegno delle proprie affermazioni. Alla fine dell'analisi (P13), tutte le fonti raccolte lungo il percorso confluiscono in una bibliografia unica, allegata al report.

    Da dove vengono raccolte

    Non solo alla fine: dopo ogni singola fase, l'app cerca ricorsivamente un array fonti ovunque si trovi nell'output — a seconda della fase può essere alla radice, oppure annidato (es. dentro ogni indizio di P04, dentro ogni proprietà di P06, dentro ogni attore di P08) — e lo accumula in una lista di sessione. Alla fine, quella lista diventa la bibliografia completa.

    La regola che genera le fonti

    Ogni fase riceve, oltre alle sue istruzioni specifiche, un identico blocco di regole permanenti. Due riguardano direttamente le fonti:

    • Nessun fatto senza fonte: il modello non può asserire dati specifici (cifre, date, citazioni, assetti attuali) senza una fonte verificabile o fornita da te. Se non ce l'ha, deve dichiarare una lacuna invece di inventare.
    • Ogni affermazione "accertata" richiede una fonte: se il tipo di un'informazione è informazione_accertata ma non c'è una fonte reale a supporto, il modello scrive inferenza_propria — un modo per segnalare "questo è un mio ragionamento, non un dato verificato". Anche il valore "Analista" con anno assente ("n.d.") ha lo stesso significato.
    ℹ️ Perché non le vedi in bibliografia: Inferenza propria e Analista (n.d.) non sono fonti verificabili dal lettore — sono etichette che il modello usa quando non ne ha una vera. La bibliografia finale le esclude automaticamente, insieme ai duplicati (stesso autore, titolo e URL).

    Da dove viene, davvero, ogni fonte

    Ogni fonte dichiara una provenienza, uno dei quattro valori seguenti:

    ProvenienzaEtichetta mostrata in bibliografiaCosa significa in pratica
    ricerca_web_attiva 🌐 verificata via ricerca web Il modello dichiara di averla trovata cercando sul web
    fornita_da_utente fornita dall'utente L'hai indicata tu nel testo scritto in chat
    file_conoscenza da file di conoscenza del metodo Riferita ai file metodologici interni dell'app (usati per guidare il ragionamento, non come fatti da citare — vedi sotto)
    documento_allegato da documento allegato Valore previsto dallo schema, ma l'app non ha oggi una funzione per allegare documenti: in pratica non compare
    eil_certificato 📚 documento certificato (EIL) Un documento della base di conoscenza certificata EIL (vedi la sezione Modalità di conoscenza). Compare solo nelle modalità Certificata / Mista
    eil_elaborazione 📚 elaborazione interna (EIL) Una sintesi interna di EIL (voce wiki / evidence): non entra in bibliografia come fonte, resta solo contesto
    ⚠️ Da sapere sulla ricerca web reale (grounding): i prompt delle fasi chiedono al modello di "usare la ricerca web attiva", e questo diventa una ricerca davvero eseguita se l'accesso a internet è attivo — è attivo di default e torna sempre su "attivato" ad ogni ricaricamento dell'app (non riaprendo la pagina di configurazione, che invece mostra lo stato reale), quindi un amministratore deve spegnerlo di proposito ogni volta che si vuole evitare il costo aggiuntivo del grounding per le analisi in corso. Con l'accesso a internet spento, le fonti con provenienza ricerca_web_attiva vengono comunque dalla conoscenza pregressa del modello, non da una verifica in tempo reale — vanno trattate come affermazioni da controllare tu stesso, non come citazioni già verificate. Anche con il grounding acceso, non dare per scontato ogni risultato: verifica comunque le fonti che contano davvero per la tua analisi.

    I file di conoscenza (knowledge/*.md) sono invece un caso diverso: vengono caricati per davvero nelle istruzioni della fase, ma sono guide sul metodo (come ragionare), non fatti sul tema analizzato — una regola permanente vieta esplicitamente al modello di citare come dato gli esempi contenuti in quei file.

    Quanto è autorevole ogni fonte — il campo natura

    Sotto ogni voce della bibliografia trovi una o più etichette (es. fonte primaria, fonte secondaria — verificare, oltre alla provenienza vista sopra): sono due campi diversi e indipendenti. La provenienza dice da dove il modello l'ha presa; natura dice quanto dovresti fidartene — la stessa gerarchia di autorevolezza descritta in dettaglio nel file di metodo knowledge/06-fonti-e-retorica.md, che ogni fase consulta prima di accettare una fonte.

    Etichetta in bibliografiaCampo naturaCosa significa
    fonte primaria primaria Massima autorevolezza: riviste scientifiche peer-reviewed (in particolare Fascia A ANVUR o indicizzate su Scopus/Web of Science), libri e collettanee accademiche, atti di convegni ed enciclopedie scientifiche (es. Treccani), manuali universitari di settore, rapporti e banche dati di organizzazioni intergovernative (ONU, UE, NATO, Banca Mondiale, FMI, OCSE...) e think tank riconosciuti (ISPI, IAI, SIPRI, RAND Corporation, Chatham House, CSIS...), siti e archivi ufficiali di questi enti.
    fonte secondaria — verificare secondaria_verificata Autorevolezza minore, da usare con circospezione e possibilmente previo riscontro incrociato con una fonte primaria: recensioni su riviste di settore o blog accademici, resoconti non ufficiali di convegni, contenuti audio/video di canali indipendenti o divulgativi (solo se le tesi esposte sono riscontrabili altrove in fonti primarie), articoli di stampa internazionale o nazionale di comprovata reputazione (es. Foreign Affairs, Le Monde Diplomatique, Financial Times, The Economist) — distinguendo sempre un reportage fattuale da un editoriale d'opinione.
    ⚠️ Un terzo livello che non vedrai mai in bibliografia: esiste anche un "livello escluso" — propaganda non dichiarata, blog personali privi di affiliazione accreditata, post sui social senza riscontro ufficiale, siti clickbait, contenuti generati da altre intelligenze artificiali non revisionati da esperti umani — che non ha un valore natura valido: una regola permanente vieta al modello di aggiungere queste fonti a fonti[], nemmeno come voce secondaria. Se l'unica informazione disponibile su un punto viene da una fonte di questo livello, il modello deve dichiarare una lacuna invece di citarla — coerente con la regola "nessun fatto senza fonte".

    Il formato della citazione cambia in base al tipo di fonte

    Ogni fonte dichiara anche un campo tipo_fonte, che determina quali dettagli compaiono nella citazione stile APA — non è lo stesso identico formato per tutte le voci:

    Campo tipo_fonteDettagli aggiuntivi mostrati
    rivista_scientifica Volume ed eventuale fascicolo tra parentesi, pagine (es. Rivista di Studi Politici, 12(3), 45-67) — se presenti nella fonte
    libro Edizione tra parentesi e luogo di pubblicazione, se presenti (es. L'analisi geopolitica (3ª ed.). Carocci, Roma)
    sito_web Nessun dettaglio aggiuntivo nel corpo della citazione, ma se la fonte dichiara una data di consultazione il link viene introdotto da "Consultato il [data], da:" invece del generico "Disponibile su:" (vedi sotto)
    rapporto_istituzionale, articolo_stampa, altro Formato generico: autore, anno, titolo in corsivo, editore — nessun campo specifico aggiuntivo

    Volume, fascicolo, pagine, edizione, luogo di pubblicazione e data di consultazione sono tutti campi facoltativi: se il modello non li valorizza, la citazione ricade comunque nel formato generico corretto per quel tipo, senza campi vuoti o mancanti visibili.

    Il link alla fonte

    Quando una fonte ha un URL, compare in coda alla citazione preceduto da "Disponibile su:" (o "Consultato il [data], da:" per i siti web con data di consultazione dichiarata, vedi sopra). Il testo del link normalmente è l'indirizzo stesso — con un'eccezione:

    ℹ️ "Link alla fonte" al posto dell'URL: quando una fonte proviene da ricerca web reale (grounding), Google restituisce l'indirizzo come un link di redirect (vertexaisearch.cloud.google.com/grounding-api-redirect/...), non l'URL reale della pagina. L'app prova a risolverlo lato server prima di mostrarlo; se ci riesce, vedi l'indirizzo vero per intero. Se il redirect sopravvive (risoluzione fallita o non disponibile su quel server), il link resta comunque funzionante al click, ma il testo mostrato diventa la dicitura fissa "Link alla fonte" invece della stringa di redirect, illeggibile e poco utile da mostrare per intero.

    Citazioni in-text e numerazione

    Nel testo del report, le affermazioni che derivano da una fonte specifica sono accompagnate da una citazione tra parentesi quadre e in corsivo, del tipo [Autore, Anno, N] — dove N è il numero della voce corrispondente qui in bibliografia (mostrato anch'esso tra parentesi quadre davanti a ogni voce, riferimento metodologico compreso, che è sempre la voce numero 1). Quando un'affermazione è confermata da più fonti indipendenti, compaiono insieme nella stessa parentesi, es. [Rossi, 2021, 3; Bianchi, 2022, 5] — un modo semplice per distinguere a colpo d'occhio un dato corroborato da più fonti da uno sorretto da una sola. Una parentesi nel testo che non corrisponde esattamente a una voce della bibliografia resta tonda, non quadra: non è una citazione, solo un inciso del testo.

    Orientamento dichiarato

    Quando una fonte esprime un punto di vista riconoscibile — un think tank vicino a un determinato governo, un editoriale schierato, un canale che rappresenta gli interessi di un attore specifico — il modello può valorizzare il campo facoltativo orientamento_dichiarato. In bibliografia compare come nota a margine sotto la citazione (es. "Orientamento dichiarato: vicino al governo di X"): non è un giudizio di valore dell'app, serve solo a segnalarti che quella fonte non è neutra "per definizione" e va letta tenendone conto — coerente con la regola di pluralismo delle prospettive del report finale.

    Come si arriva alla bibliografia finale

    1. Ogni fase completata contribuisce le proprie fonti alla lista di sessione
    2. A P13, i link di redirect da ricerca web (grounding) vengono risolti all'URL reale, dove possibile (vedi sopra)
    3. La lista completa viene deduplicata (stesso autore+titolo+URL, senza distinguere maiuscole)
    4. Le voci segnaposto (Inferenza propria, Analista) vengono escluse
    5. Viene aggiunto un riferimento fisso, sempre presente: Boria, E. — L'analisi geopolitica (il testo metodologico su cui si basa l'intero approccio)
    6. L'elenco finale è ordinato alfabeticamente per autore
    7. Ogni voce riceve il numero progressivo mostrato tra parentesi quadre (il riferimento metodologico è sempre il numero 1) — lo stesso numero usato nelle citazioni in-text del report
    ✓ In pratica: tratta la bibliografia come un punto di partenza per verificare, non come una lista già controllata. È coerente con lo spirito dell'app: dichiarare i limiti (vedi anche la sezione P10 — Autoverifica) fa parte del metodo, non è un difetto da nascondere.

    Attori: categorie, ruoli, visibilità

    Nella sezione P08 — Attori geopolitici del report (ramo di tipo A, multi-attore), ogni riga della tabella descrive un attore con quattro campi: Nome, Categoria, Ruolo e Visibilità. Sono tre vocabolari chiusi (il modello sceglie da un elenco fisso, non inventa etichette), definiti nel file di metodo knowledge/04-attori.md che la fase usa per costruire il proprio prompt.

    Categoria — la tassonomia degli undici attori

    Undici categorie, classificate per orizzonte d'azione, obiettivo reale e grado di istituzionalizzazione. Non è un dettaglio formale: la categoria condiziona cosa quell'attore può realisticamente ottenere e quali vincoli subisce — ignorarla porta a giudicare le mosse di un attore con il metro di un altro.

    CategoriaCosa persegue tipicamente
    potenza_globaleEgemonia estesa anche oltre i propri confini formali, proiettata sia direttamente (presenza militare) sia indirettamente (dipendenza economica, sudditanza politica)
    organizzazione_internazionale_universaleGestire pacificamente l'ordine vigente promuovendo la cooperazione — capacità in genere bassa, dipende dagli stati membri che la finanziano
    colosso_transnazionale_privato_lucroProfitto da un'attività economica; sottostà (almeno formalmente) alle leggi statali
    entita_transnazionale_privata_no_profitProselitismo: il numero di aderenti è la sua misura di potenza, per portare avanti battaglie ideali
    movimento_contestazione_radicaleRovesciare, corrompere o intralciare il modello e l'autorità dominanti; tipicamente non istituzionalizzato, rischia la repressione
    potenza_regionaleAcquisire influenza e status nella propria area, spesso approfittando del disordine internazionale
    organizzazione_internazionale_regionaleIntegrare e stabilizzare un'area per rafforzarne coesione e status
    raggruppamento_umano_non_politicizzatoEtnie, civiltà, nazioni: rafforzare la coesione interna e diffondersi, spinte da un forte richiamo identitario
    ente_pubblicoContribuire al funzionamento dello stato — capacità in genere bassa, molto variabile tra modelli accentrati e decentrati
    realta_ufficiale_anti_statalePartiti regionalisti, movimenti localistici: difendere interessi e identità locali contro l'autorità centrale
    entita_non_istituzionalizzataPoteri mediatici, logge, lobby, movimenti d'opinione, gruppi terroristici: interessi di parte, spesso perseguiti in modo occulto

    Ruolo — oltre dominatore e dominato

    Il metodo mette in guardia esplicitamente dal farsi attrarre dalle due figure "idealtipiche" di dominatore e dominato: molti attori reali ricadono in posizioni intermedie, ed è per questo che lo schema ne prevede sette, non due. Un validatore impone che nell'elenco compaia almeno un ruolo non polarizzato, proprio per impedire che l'analisi collassi sui due estremi.

    RuoloSignificato
    dominatoreEsercita il controllo effettivo sullo spazio o sulla situazione contesa
    dominatoSubisce quel controllo
    mediatoreSi frappone tra i poli, senza essere parte del controllo o della contesa
    coinvolto_indirettamenteNon è un polo della contesa, ma ne è comunque toccato
    beneficiario_passivoTrae vantaggio da un assetto di potere che non ha contribuito a determinare
    garanteAssicura la tenuta di un equilibrio tra altri attori, senza essere lui stesso uno dei poli
    guastatoreAgisce per alterare o disturbare un equilibrio esistente tra altri attori
    ℹ️ Ruoli multipli e asimmetrie: lo stesso attore può rivestire ruoli diversi a seconda dell'interlocutore e del momento — il report può descriverlo di conseguenza. Il peso di un attore inoltre non è mai presunto proporzionale alla sua taglia: va accertato caso per caso, non dedotto dalle dimensioni.

    Visibilità — non è la stessa cosa del peso reale

    Alta, media o bassa: quanto un attore è esposto/riconoscibile pubblicamente — non quanto conta davvero. Il metodo segnala un rischio specifico: la copertura mediatica dà risalto in base a ciò che colpisce il pubblico, non in base all'importanza politica reale, per cui attori a bassa visibilità (reti informali, lobby, apparati poco trasparenti) rischiano di restare fuori da un'analisi che parte dai soggetti più evidenti. Per questo un validatore impone che nell'elenco compaia almeno un attore a visibilità bassa: è una spinta a cercarli attivamente, non un dettaglio decorativo.

    Salvataggio e gestione dei report

    L'app ti permette di salvare l'intera chat di analisi e il report finale in formato HTML, gestendoli su server: scaricare, rinominare, eliminare.

    Accesso alla gestione report

    Nel sidebar sinistro, clicca il pulsante 📋 I miei report per aprire la modalità di gestione. Qui trovi:

    • Due pulsanti di salvataggio rapido
    • Elenco di tutti i report già salvati
    • Azioni per ciascun report (scarica, rinomina, elimina)

    Tipi di report

    L'app ti permette di salvare due cose diverse:

    1. Chat di analisi completa (analisi_del_[data].html)

    • Contiene tutta la conversazione (messaggi dell'utente e risposte del sistema)
    • Utile per documentare l'intero processo di analisi
    • Formattato come pagina HTML leggibile
    • Pulsante: 💾 Salva chat

    2. Report finale (report_finale_analisi_del_[data].html)

    • Contiene solo il report narrativo generato da P13
    • Più professionale e compatto rispetto alla chat completa
    • Include solo le sezioni finali e le conclusioni
    • Pulsante: 💾 Salva report finale

    Naming convention

    I file vengono salvati automaticamente con la data e ora corrente:

    analisi_del_12-08-2026_14-30-45.html report_finale_analisi_del_12-08-2026_14-30-45.html

    Formato: [tipo]_del_[DD-MM-YYYY_HH-MM-SS].html

    Azioni sui report

    ⬇ Scarica

    Scarica il file HTML nel tuo computer. Puoi aprirlo in qualsiasi browser senza necessità di connessione internet.

    ✏ Rinomina

    Rinomina il file con un nome personalizzato. Esempi:

    • analisi_Stretto_di_Hormuz.html
    • report_geopolitica_Pacifico.html
    • 2026_Q3_area_MENA.html

    L'estensione .html viene aggiunta automaticamente se omessa.

    ✕ Elimina

    Elimina definitivamente il file dal server. Richiede conferma. Non è possibile recuperare un file eliminato, quindi usa con cautela.

    Informazioni metadata

    Per ciascun report salvato, puoi vedere:

    • Tipo: analisi | report_finale
    • Dimensione: in KB
    • Data di salvataggio: GG/MM/AAAA HH:MM

    Come usare i report HTML

    I file HTML salvati sono documenti autoportanti e professionali:

    1. Scarica il file dal pannello report
    2. Apri nel browser (o condividi per email)
    3. Stampa in PDF (Ctrl+P) se hai bisogno di un formato statico
    4. Modifica con un editor HTML se vuoi personalizzarlo ulteriormente
    ✓ Consiglio: Salva il report finale dopo aver completato P13, e la chat completa se vuoi documentare l'intero processo decisionale.

    Dove vengono archiviati

    I file vengono salvati nel server backend in storage/reports/. Rimangono disponibili per il download finché non li elimini.

    ℹ️ Nota: La gestione dei report è del tutto locale/server-side. I file non vengono inviati a Google Gemini o a servizi terzi.

    Domande frequenti

    Che cosa succede se non digito nulla?

    L'app rimane in attesa. Digita qualcosa (anche solo "continua") o fai click su un comando per proseguire alla fase successiva.

    Posso tornare indietro a una fase precedente?

    No, tranne con /riclassifica che ricomincia da P04. Se hai bisogno di riconsiderare fasi precedenti, devi resettare l'analisi (pulsante "Nuova analisi") e ricominciare dal principio.

    Cosa significa "Tipo SOSPESO"?

    Se in P04 la classificazione non è chiara (né A né B), il tipo rimane SOSPESO. P06 (Caratteri dello spazio) fornisce ulteriori indizi per risolverlo in P06_sintesi. Se rimane indeterminato, si usa A come fallback.

    Le lacune dichiarate bloccano l'analisi?

    No. Le lacune (dati mancanti, fonti non disponibili, ipotesi non testate) si registrano lungo il percorso, senza mai bloccare il flusso — vedi la sezione Lacune dichiarate per il dettaglio completo su come nascono, dove trovarle e come interpretarle.

    Cosa fare se P10 segnala molti problemi?

    Leggi la gravità di ciascun problema. Se ci sono problemi alti in P04, considera /riclassifica — puoi scrivere dopo il comando una nota con la tua valutazione, che P04 leggerà con priorità insieme ai problemi di P10. Per problemi in fasi successive, procedi verso il report finale (P13) che documentarà i limiti metodologici.

    Posso salvare l'analisi?

    Al momento l'analisi rimane nella sessione del browser. Se chiudi il tab o il browser, i dati si perdono. Usa il comando /report per generare il report narrativo che puoi copiare/stampare.

    Quale modello usa questa app?

    Di default, Gemini 2.5 Pro con output strutturato (JSON conforme agli schemi di ogni fase). Configurabile in config.php.

    I dati della mia analisi vengono inviati da qualche parte?

    I dati vengono inviati a Google Gemini API per l'elaborazione (tema, parametri, contesto dello spazio, ecc.). Non vengono archiviati su server terzi oltre Google Cloud. Il costo token è calcolato localmente nel tuo browser.

    Posso fare più analisi contemporaneamente?

    Ogni tab/finestra del browser mantiene una sessione indipendente. Apri nuovi tab per analisi parallele. Il reset da un tab non influenza gli altri.

    Ulteriore aiuto: Se hai domande specifiche non coperte qui, riprovao il comando /stato per verificare lo stato corrente della pipeline.