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
/reportdopo P12
/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
continuaook - 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
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.
| Opzione | Da dove attinge l'analisi | Quando 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.
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.
/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).
/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.
/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.
Nuova analisi) se il problema è critico,
oppure procedere comunque verso P11/P12/P13.
Strategia consigliata
- Leggi attentamente il riepilogo di P10
- Se sono presenti problemi di gravità alta in P04, considera
/riclassifica - Per problemi in fasi successive, continua comunque verso P11/P12/P13
- Nel report finale (P13), i limiti metodologici saranno documentati
/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.
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_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:
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:
| Campo | Cosa 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:
| Fase | Campo | Cosa 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.
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
statoin 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
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_accertatama non c'è una fonte reale a supporto, il modello scriveinferenza_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.
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:
| Provenienza | Etichetta mostrata in bibliografia | Cosa 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 |
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 bibliografia | Campo natura | Cosa 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. |
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_fonte | Dettagli 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:
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
- Ogni fase completata contribuisce le proprie fonti alla lista di sessione
- A P13, i link di redirect da ricerca web (grounding) vengono risolti all'URL reale, dove possibile (vedi sopra)
- La lista completa viene deduplicata (stesso autore+titolo+URL, senza distinguere maiuscole)
- Le voci segnaposto (
Inferenza propria,Analista) vengono escluse - Viene aggiunto un riferimento fisso, sempre presente: Boria, E. — L'analisi geopolitica (il testo metodologico su cui si basa l'intero approccio)
- L'elenco finale è ordinato alfabeticamente per autore
- 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
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.
| Categoria | Cosa persegue tipicamente |
|---|---|
potenza_globale | Egemonia estesa anche oltre i propri confini formali, proiettata sia direttamente (presenza militare) sia indirettamente (dipendenza economica, sudditanza politica) |
organizzazione_internazionale_universale | Gestire pacificamente l'ordine vigente promuovendo la cooperazione — capacità in genere bassa, dipende dagli stati membri che la finanziano |
colosso_transnazionale_privato_lucro | Profitto da un'attività economica; sottostà (almeno formalmente) alle leggi statali |
entita_transnazionale_privata_no_profit | Proselitismo: il numero di aderenti è la sua misura di potenza, per portare avanti battaglie ideali |
movimento_contestazione_radicale | Rovesciare, corrompere o intralciare il modello e l'autorità dominanti; tipicamente non istituzionalizzato, rischia la repressione |
potenza_regionale | Acquisire influenza e status nella propria area, spesso approfittando del disordine internazionale |
organizzazione_internazionale_regionale | Integrare e stabilizzare un'area per rafforzarne coesione e status |
raggruppamento_umano_non_politicizzato | Etnie, civiltà, nazioni: rafforzare la coesione interna e diffondersi, spinte da un forte richiamo identitario |
ente_pubblico | Contribuire al funzionamento dello stato — capacità in genere bassa, molto variabile tra modelli accentrati e decentrati |
realta_ufficiale_anti_statale | Partiti regionalisti, movimenti localistici: difendere interessi e identità locali contro l'autorità centrale |
entita_non_istituzionalizzata | Poteri 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.
| Ruolo | Significato |
|---|---|
dominatore | Esercita il controllo effettivo sullo spazio o sulla situazione contesa |
dominato | Subisce quel controllo |
mediatore | Si frappone tra i poli, senza essere parte del controllo o della contesa |
coinvolto_indirettamente | Non è un polo della contesa, ma ne è comunque toccato |
beneficiario_passivo | Trae vantaggio da un assetto di potere che non ha contribuito a determinare |
garante | Assicura la tenuta di un equilibrio tra altri attori, senza essere lui stesso uno dei poli |
guastatore | Agisce per alterare o disturbare un equilibrio esistente tra altri attori |
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:
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.htmlreport_geopolitica_Pacifico.html2026_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:
- Scarica il file dal pannello report
- Apri nel browser (o condividi per email)
- Stampa in PDF (Ctrl+P) se hai bisogno di un formato statico
- Modifica con un editor HTML se vuoi personalizzarlo ulteriormente
Dove vengono archiviati
I file vengono salvati nel server backend in storage/reports/.
Rimangono disponibili per il download finché non li elimini.
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.
/stato
per verificare lo stato corrente della pipeline.