Atlante della Conoscenza · Fase 0

Atlante v1 — Specifica dei Nodi e delle Relazioni

Documento fondativo · Standard stabile · Non modificabile senza revisione formale

Revisione 1.2 — Luglio 2026 · Stato: Approvato · Autori: Alex Barry, GP, Claude

Natura di questo documento

Questo documento è lo standard fondativo dell'Atlante. Una volta approvato, i tipi di nodo, le relazioni, le proprietà e le convenzioni qui definite non cambiano senza una revisione formale con numero di versione. Ogni componente tecnico (micro-Atlante HTML, database, API) è costruito su questa specifica — non il contrario.

Il documento si ispira al metodo dei Quaderni del Senzar: prima i criteri, poi il catalogo. Prima lo standard, poi i dati.

Indice

1Principi fondativiApprovato 2Tipi di nodoApprovato 3Schema UUIDApprovato 4Tipi di relazione — Vocabolario controllatoApprovato 5Proprietà dei nodiApprovato 6Proprietà delle relazioni — ConfidenceApprovato 7Livelli epistemiciApprovato 8Struttura dei file JSONApprovato 9Regole editorialiApprovato 10Roadmap — Fasi di sviluppoApprovato 11Tassonomia — Classi e SottoclassiApprovato 12Alias e Nomi AlternativiApprovato 13Versionamento dei NodiApprovato

Sezione 1

Principi Fondativi

Le decisioni progettuali che governano tutto il resto.

P-001 L'Atlante è un sistema della conoscenza, non un Atlante del Senzar. I nodi di livello 1 sono categorie universali (Filosofia, Religione, Scienza, Simbolismo). Il Senzar è un nodo di livello 2, dentro Teosofia, dentro Simbolismo.

P-002 Nessuna infrastruttura prima dei contenuti. La sequenza è: Specifica → JSON → HTML → Integrazione → Database → AI. Non il contrario.

P-003 Ogni nodo ha un UUID stabile. Il titolo può cambiare — l'UUID no. Le relazioni referenziano UUID, mai titoli.

P-004 Le relazioni usano un vocabolario controllato. Nessuna relazione libera. Se una relazione non è nel vocabolario, si apre una revisione formale.

P-005 Ogni relazione ha una proprietà Confidence (0–100). La Confidence è coerente con la legenda epistemica dei Quaderni: 🟢=95–100, 🟠=70–90, 🔴=40–65, 🔵=20–40.

P-006 I file JSON sono separati per entità (nodes, edges, sources, articles, quaderni). Ogni file diventerà una tabella PostgreSQL senza trasformazioni.

P-007 Le analogie non diventano mai identità. ANALOGO_A ≠ DERIVA_DA ≠ COLLEGATO_A. Le distinzioni del vocabolario sono semanticamente precise.

P-008 Ogni nuova funzione deve rendere più facile scoprire la conoscenza, non solo mostrarla. Un sito mostra pagine. Un Atlante aiuta a fare scoperte. Ogni decisione futura viene valutata con la domanda: "Questa funzione aiuta il visitatore a scoprire connessioni che altrimenti non avrebbe visto?"

Sezione 2

Tipi di Nodo

Quattordici tipi. Stabili. Ogni nodo appartiene a esattamente uno di questi tipi.

Concetto CONC- Idea, principio, categoria astratta. Es: Fohat, Logos, Karma, Senzar.

Persona PERS- Individuo storico o mitico. Es: Blavatsky, Skinner, Jung, Leibniz.

Opera OPER- Libro, trattato, manoscritto. Es: Secret Doctrine, Isis Unveiled, Mahatma Letters.

Fonte Primaria FPRI- Passo specifico da un'opera con citazione e pagina. Es: SD 1:109 (Fohat).

Fonte Secondaria FSEC- Testo critico o interpretativo. Es: Algeo 1988, Cranston 1994.

Simbolo SIMB- Elemento grafico o geometrico con funzione simbolica. Es: Cerchio, Punto, Croce.

Tradizione TRAD- Corrente di pensiero, sistema religioso o filosofico. Es: Teosofia, Ermetismo, Vedanta.

Evento EVEN- EVEN- Fatto storico databile. Es: Fondazione della TS (1875), Pubblicazione SD (1888).

Luogo LUOG- Luogo geografico o simbolico. Es: Tibet, Adyar, Atlantide.

Articolo ARTI- Articolo pubblicato sul blog di Frammenti dell'Eterno.

Quaderno QUAD- Quaderno del Senzar o altro quaderno di ricerca del progetto.

Voce Glossario GLOS- Voce del glossario del sito con definizione e fonti.

Schema SCHE- Diagramma, infografica o rappresentazione visiva.

Immagine IMMG- Risorsa visiva: fotografia, illustrazione, riproduzione di manoscritto.

Struttura gerarchica dei contenuti

I nodi di tipo Tradizione e Concetto hanno una gerarchia interna a due livelli. Livello 1: categorie universali. Livello 2: nodi specifici dentro la categoria.

Livello 1 → Tradizione: Filosofia, Religione, Scienza, Simbolismo, Storia
Livello 2 → Dentro Filosofia: Idealismo, Neoplatonismo, Teosofia...
Livello 2 → Dentro Teosofia: Blavatsky, Secret Doctrine, Fohat, Senzar...

Regola: Fra un anno, Jung, Bohm, Plotino, Leibniz entrano
come nodi di livello 2 nelle rispettive categorie.
Nessuna modifica alla struttura del livello 1.

Sezione 3

Schema UUID

Ogni nodo ha un identificatore stabile e univoco. Il titolo cambia — l'UUID no.

Formato TIPO-NNNNNN

Tipo Prefisso 4 lettere del tipo di nodo (CONC, PERS, OPER, FPRI, FSEC, SIMB, TRAD, EVEN, LUOG, ARTI, QUAD, GLOS, SCHE, IMMG)

Numero 6 cifre progressive, zero-padded. Inizia da 000001 per tipo.

Esempi

"id": "CONC-000001" // Fohat
"id": "CONC-000002" // Logos
"id": "CONC-000003" // Senzar
"id": "PERS-000001" // Helena P. Blavatsky
"id": "OPER-000001" // The Secret Doctrine
"id": "QUAD-000001" // Quaderno I — Il Senzar nelle Fonti Originali
"id": "TRAD-000001" // Teosofia
"id": "SIMB-000001" // Punto (·)

Regola di assegnazione

Gli UUID sono assegnati in ordine di inserimento nel file nodes.json. Non vengono mai riutilizzati — nemmeno se un nodo viene eliminato. Un nodo eliminato riceve lo stato "deprecato" ma mantiene il suo UUID nei log.

Sezione 4

Tipi di Relazione — Vocabolario Controllato

Tredici relazioni. Nessuna altra. Stabili fino a revisione formale.

Relazione	Significato	Esempio
AUTORE_DI	Una persona ha creato un'opera o un testo	Blavatsky AUTORE_DI Secret Doctrine
CONTIENE	Un'opera o concetto include un altro elemento	Secret Doctrine CONTIENE Libro di Dzyan
CITA	Un'opera o persona menziona un'altra entità con riferimento esplicito	Secret Doctrine CITA Skinner
DESCRIVE	Un'opera o persona fornisce una descrizione di un concetto	Theosophical Glossary DESCRIVE Senzar
INTERPRETA	Una fonte secondaria offre un'interpretazione di un concetto o opera	Algeo INTERPRETA Senzar
DOCUMENTA	Un Quaderno o articolo raccoglie dati documentari su un nodo	Quaderno I DOCUMENTA Senzar
ISPIRA	Un'entità ha influenzato la formazione di un'altra	Skinner ISPIRA Blavatsky
COLLEGATO_A	Relazione generica documentata ma non classificabile con precisione	Simbolismo Sacro COLLEGATO_A Senzar
ANALOGO_A	Due entità condividono struttura o funzione senza derivazione diretta	Enochiano ANALOGO_A Senzar
PRECEDE	Relazione temporale o logica — A precede B	Isis Unveiled PRECEDE Secret Doctrine
SEGUE	Relazione temporale o logica — A segue B	Voice of the Silence SEGUE Secret Doctrine
DERIVA_DA	B ha origine documentata in A	Libro di Dzyan DERIVA_DA tradizione tibetana
CONTRASTA_CON	Due entità sono in tensione o opposizione documentata	Interpretazione_A CONTRASTA_CON Interpretazione_B

Regola di uso

Se una relazione non è in questo vocabolario, non viene usata. Si apre invece una proposta di revisione con motivazione scritta. COLLEGATO_A è la relazione di fallback — va usata solo quando nessuna altra si adatta, e va documentata con una nota che spiega perché.

Sezione 5

Proprietà dei Nodi

Ogni nodo ha un insieme di proprietà. Alcune sono obbligatorie, alcune facoltative.

Proprietà obbligatorie — tutti i nodi

{
"id": "CONC-000001", // UUID — obbligatorio
"tipo": "concetto", // tipo di nodo — obbligatorio
"titolo": "Fohat", // nome visualizzato — obbligatorio
"descrizione_breve": "...", // max 160 caratteri — obbligatorio
"stato_epistemico": "documentato" // vedi Sezione 7 — obbligatorio
}

Proprietà facoltative per tipo

// Per CONCETTO e TRADIZIONE
"livello": 1, // 1=categoria, 2=specifico
"categoria_padre": "TRAD-000001", // UUID della categoria padre

// Per OPERA e FONTE PRIMARIA
"anno": 1888,
"lingua": "en",
"volume": "I",
"pagina": "109",
"citazione": "Fohat is the steed...",

// Per PERSONA
"nascita": 1831,
"morte": 1891,
"nazionalita": "russa",

// Per ARTICOLO e QUADERNO
"url": "quaderni/quaderno-1-senzar-fonti-originali.html",
"data_pubblicazione": "2026-07"

Sezione 6

Proprietà delle Relazioni — Confidence

Ogni relazione ha una forza. L'Atlante non mostra solo connessioni — mostra quanto sono solide.

La Confidence è un numero intero da 0 a 100. Non è un giudizio soggettivo — segue la legenda epistemica dei Quaderni, tradotta in valori numerici.

🔵	Livello	Range	Significato
🟢	Fonte primaria	95–100	Relazione attestata in una fonte primaria con citazione verificabile. Es: Blavatsky AUTORE_DI Secret Doctrine.
🟠	Fonte secondaria	70–90	Relazione documentata in una fonte secondaria autorevole o in più fonti concordanti. Es: Skinner ISPIRA Blavatsky.
🔴	Interpretazione	40–65	Relazione basata su un'interpretazione critica o su inferenza documentata. Es: Enochiano ANALOGO_A Senzar.
🔵	Ipotesi del progetto	10–35	Relazione ipotetica generata dall'analisi interna del progetto. Es: Senzar ANALOGO_A Linguaggio Universale di Leibniz.

Struttura di una relazione completa

{
"id": "EDGE-000001",
"sorgente": "PERS-000001", // Blavatsky
"relazione": "AUTORE_DI",
"destinazione": "OPER-000001", // Secret Doctrine
"confidence": 100,
"livello_epistemico": "fonte_primaria",
"fonte_uuid": "FPRI-000001", // frontespizio SD
"note": ""
}

Sezione 7

Livelli Epistemici

La legenda dei Quaderni diventa una proprietà nativa dell'Atlante.

Il campo stato_epistemico di ogni nodo e il campo livello_epistemico di ogni relazione usano i seguenti valori controllati:

🔵	Valore	Descrizione
🟢	`fonte_primaria`	Il nodo o la relazione è attestato direttamente in un documento originale di HPB o equivalente.
🟠	`fonte_secondaria`	Il nodo o la relazione è documentato in una fonte critica autorevole.
🔴	`interpretazione`	Il nodo o la relazione è il prodotto di un'interpretazione critica esplicita.
🔵	`ipotesi_progetto`	Il nodo o la relazione è un'ipotesi generata internamente dall'analisi del progetto.
—	`documentato`	Valore generico per nodi ben attestati ma non riconducibili a una singola fonte primaria.

Sezione 8

Struttura dei File JSON

Cinque file separati. Ogni file diventerà una tabella PostgreSQL senza trasformazioni.

atlante-data/
├── nodes.json // tutti i nodi con proprietà
├── edges.json // tutte le relazioni con confidence
├── sources.json // fonti primarie e secondarie con citazioni
├── articles.json // articoli del blog con metadata
└── quaderni.json // quaderni di ricerca con metadata

nodes.json — struttura array

[
{
"id": "CONC-000001",
"tipo": "concetto",
"titolo": "Fohat",
"descrizione_breve": "Principio dinamico della cosmogenesi teosofica",
"stato_epistemico": "fonte_primaria",
"livello": 2,
"categoria_padre": "TRAD-000001"
},
...
]

edges.json — struttura array

[
{
"id": "EDGE-000001",
"sorgente": "PERS-000001",
"relazione": "AUTORE_DI",
"destinazione": "OPER-000001",
"confidence": 100,
"livello_epistemico": "fonte_primaria",
"fonte_uuid": "FPRI-000001",
"note": ""
},
...
]

Sezione 9

Regole Editoriali

Quattro regole fondative. Stabili. Valgono per ogni nodo e ogni relazione.

R-001 Nessuna relazione senza una fonte dichiarabile. Ogni edge deve avere un campo fonte_uuid o una nota che giustifica la confidence assegnata. Una relazione senza fonte non entra nel file edges.json.

R-002 Nessuna affermazione documentaria senza fonte. Il campo citazione nelle fonti primarie non è facoltativo se la confidence è ≥ 70.

R-003 Le analogie non diventano mai identità. ANALOGO_A con confidence 40 non diventa DERIVA_DA con confidence 80. Cambiare tipo di relazione richiede una nuova giustificazione documentaria.

R-004 Articoli e Quaderni condividono i nodi ma non il livello epistemico. Un articolo divulgativo può riferirsi allo stesso nodo di un Quaderno di ricerca — ma la relazione DOCUMENTA appartiene al Quaderno, non all'articolo. L'articolo usa COLLEGATO_A o CITA.

R-005 Le relazioni non vengono cancellate — vengono deprecate. Una relazione deprecata mantiene il suo UUID e riceve il campo "stato": "deprecata" con data e motivazione. Il log delle modifiche è permanente.

R-006 Ogni modifica a un nodo esistente (titolo, descrizione, stato epistemico) viene registrata nel campo changelog del nodo con data e motivazione. La versione precedente non viene cancellata.

Sezione 10

Roadmap — Fasi di Sviluppo

Sequenza approvata. Non si salta una fase per arrivare prima alla successiva.

Fase 0

Specifica ✓

Questo documento. Standard stabile. Approvato.

Fase 1

Micro-Atlante HTML

10 nodi reali, ~30 relazioni. D3.js. Zero backend. Solo JSON. Integrato nel sito esistente. Verifica: i tipi di nodo sono sufficienti? Le relazioni sono troppo generiche? La navigazione è intuitiva?

Fase 2

JSON definitivo

Tutti i nodi del corpus esistente (Quaderni I–XII, articoli, glossario). File separati stabili.

Fase 3

Integrazione nel sito

Atlante navigabile come sezione permanente di Frammenti dell'Eterno. Collegamento bidirezionale con Quaderni e articoli.

Fase 4

Neo4j

Migrazione dei file JSON su database a grafo. I file JSON diventano le tabelle. Zero riscrittura del modello.

Fase 5

AI — Ricerca Semantica

Qdrant per ricerca per significato. "Mostrami tutti i concetti vicini a Fohat" — cerca significati, non parole.

Fase 6

Atlante Completo

Grafo animato, timeline interattiva, biblioteca delle fonti, assistente AI specializzato sul corpus.

Sezione 11

Tassonomia — Classi e Sottoclassi

Ogni tipo di nodo può avere classi e sottoclassi. La struttura è definita ora — i valori si popolano durante la Fase 1.

La tassonomia aggiunge due campi facoltativi a ogni nodo: classe e sottoclasse. Questi campi permettono la ricerca per categoria e il filtraggio semantico — essenziali per l'AI della Fase 5.

Regola: i valori di classe e sottoclasse sono stringhe controllate. Ogni nuovo valore richiede approvazione. Il campo è facoltativo in Fase 1 — obbligatorio dalla Fase 3 in poi.

Sezione 12

Alias e Nomi Alternativi

Lo stesso nodo può avere molti nomi. L'UUID è uno solo.

Il campo alias è un array di stringhe che raccoglie tutti i nomi alternativi con cui un nodo è conosciuto — abbreviazioni, varianti linguistiche, nomi storici diversi. La ricerca e il grafo usano tutti gli alias per trovare il nodo, ma lo visualizzano sempre con il titolo canonico.

{
"id": "PERS-000001",
"titolo": "Helena Petrovna Blavatsky", // titolo canonico
"alias": [
"HPB",
"Madame Blavatsky",
"Helena Blavatsky",
"H.P. Blavatsky"
]
}

{
"id": "OPER-000001",
"titolo": "The Secret Doctrine",
"alias": [
"SD",
"La Dottrina Segreta",
"Secret Doctrine"
]
}

Regola alias

Il titolo canonico è quello ufficiale, preferibilmente nella lingua originale. Gli alias includono abbreviazioni comuni, varianti ortografiche, traduzioni. La ricerca AI tratta alias e titolo come equivalenti. Il grafo visuale usa sempre il titolo canonico.

Sezione 13

Versionamento dei Nodi

La conoscenza evolve. L'Atlante tiene traccia di come.

Ogni nodo ha un campo versione e un array changelog. Ogni modifica significativa (nuova fonte, cambio di stato epistemico, nuova relazione importante) genera una voce nel changelog con data e motivazione. L'implementazione completa del versionamento navigabile appartiene alla Fase 4 — ma il campo è presente nel JSON dalla Fase 1, così la migrazione non richiede trasformazioni.

{
"id": "CONC-000003",
"titolo": "Senzar",
"versione": 3,
"changelog": [
{
"versione": 1,
"data": "2026-07",
"modifica": "Creazione nodo — fonti Quaderno I",
"stato_epistemico": "fonte_primaria"
},
{
"versione": 2,
"data": "2026-08",
"modifica": "Aggiunta tesi Algeo — Quaderno II",
"stato_epistemico": "fonte_secondaria"
},
{
"versione": 3,
"data": "2029-03",
"modifica": "Nuova fonte primaria trovata in CW vol. 5",
"stato_epistemico": "fonte_primaria"
}
]
}

La funzione "Come è cambiata la conoscenza su Senzar dal 2026 al 2030" diventa possibile perché il changelog è stato scritto fin dal primo giorno. Questa è la differenza tra aggiungere il versionamento adesso e aggiungerlo in futuro — in futuro costerebbe riscrivere tutto il corpus.

Nota conclusiva

Questo documento è lo "Quaderno Zero" tecnico dell'Atlante. Come i Quaderni del Senzar stabiliscono un metodo prima di applicarlo, questa specifica stabilisce le regole prima di costruire qualsiasi interfaccia.

La prossima azione è la Fase 1: costruire il micro-Atlante con i 10 nodi del nucleo iniziale usando esattamente questa specifica. Se qualcosa nella specifica non funziona, lo scopriremo in Fase 1 — quando il costo di correggere è minimo.

← Frammenti dell'Eterno Atlante v1 · Rev. 1.2 · Luglio 2026 · Approvato