Aggiorna tesi.md, catalogo figure, bibliografia e wiki alla nuova versione (tesi_new.docx)

- raw/tesi.md allineato al docx; aggiunta Figura 52 e nuovo riferimento 51
- raw/immagini.json, raw/bibliografia.json e raw/fonti rinumerati; wiki/figures e wiki/bibliografia rigenerate
- pagine wiki, difetti-noti, CLAUDE.md e log aggiornati

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-13 15:05:14 +02:00
1 parent d011927488
commit 3855b21d6d
89 files changed
+1866 -1578

No files matched your search

+9 -9
View File
@@ -17,10 +17,10 @@ Tesi magistrale in Chimica Industriale (Università di Bologna, Dipartimento "To
## Fonti (`raw/`, SOLA LETTURA — mai modificare, rinominare o cancellare)
| Percorso | Contenuto |
|---|---|
| `raw/tesi.md` | Sorgente canonico (1411 righe). Cap. 1 Introduzione (r.66), 2 Scopo (r.545), 3 Procedure sperimentali (r.562), 4 Discussione dei risultati (r.717), 5 Conclusioni (r.1279); bibliografia in fondo |
| `raw/immagini/` | 79 file figura (nomi = hash) |
| `raw/immagini.json` | Catalogo di 78 figure logiche: pannelli, didascalia stampata e generata, testo visibile, composti, concetti, contesto, qualità |
| `raw/bibliografia.json` | 59 riferimenti parsati con righe e sezioni di citazione; `text` è la fonte di verità, gli altri campi sono euristici |
| `raw/tesi.md` | Sorgente canonico (1432 righe; aggiornato il 2026-10-13 alla nuova versione `tesi_new.docx`). Cap. 1 Introduzione (r.66), 2 Scopo (r.545), 3 Procedure sperimentali (r.562), 4 Discussione dei risultati (r.714), 5 Conclusioni (r.1298); bibliografia in fondo (r.1312) |
| `raw/immagini/` | 80 file figura (nomi = hash) |
| `raw/immagini.json` | Catalogo di 79 figure logiche: pannelli, didascalia stampata e generata, testo visibile, composti, concetti, contesto, qualità |
| `raw/bibliografia.json` | 60 riferimenti parsati con righe e sezioni di citazione; `text` è la fonte di verità, gli altri campi sono euristici |
| `raw/fonti/NN-cognome-anno.md` | Una scheda per riferimento (citazione verificata, DOI, abstract, frasi della tesi in cui è citato) |
I numeri di riga (`md_line`, `cited_in_md_lines`…) riferiscono `raw/tesi.md` e sono stabili perché `raw/` è immutabile: sono il localizzatore standard.
@@ -38,7 +38,7 @@ wiki/
overview.md sintesi evolutiva, research question, risultati
tesi.md mappa capitolo/sezione → pagine wiki (unica pagina "source" della tesi)
dati.md indice «grandezza → pagina» con intervalli di valori (aggiornarlo a ogni nuova tabella)
bibliografia.md i 59 riferimenti (GENERATA dallo script), con link alle schede raw/fonti/
bibliografia.md i 60 riferimenti (GENERATA dallo script), con link alle schede raw/fonti/
concepts/ meccanismi, ROP, ACQ, bottle brush, π-stacking, ciclovoltammetria…
compounds/ un file per composto numerato (composto-32.md) o polimero/campione
techniques/ NMR, FT-IR, GPC, UV-Vis, fluorescenza, DSC, CV: condizioni usate nella tesi
@@ -77,17 +77,17 @@ status: draft | stable
## Figure
- `wiki/figures/*.md` e `wiki/bibliografia.md` sono **derivate**: `python scripts/gen_figures.py` le rigenera da `raw/immagini.json`, riportando ogni campo (didascalie, descrizioni e testo visibile per pannello, composti, concetti, contesto, righe di citazione, note di revisione) senza riassumere. Eccezione alla regola "solo l'LLM scrive in `wiki/`"; non modificarle a mano, correggi `raw/immagini.json` solo se l'utente lo chiede e poi rigenera.
- **Attendibilità:** solo `caption_printed` è testo della tesi. Descrizioni, `visible_text` e didascalia generata derivano dall'immagine e non sono verificati: valori letti da grafici o schemi (rese, picchi, potenziali) vanno confermati sull'immagine/tesi prima di riusarli.
- Le pagine concept/compound/technique richiamano le figure con `[[fig-026]]` o con l'embed `![[immagini/<file>]]` (da `panels[].embed`). Le figure con `flags` o `review_notes` (Figure 26, 27, 29, 57, 62, 65, 66, 68 hanno discrepanze didascalia/testo) vanno citate con l'avvertenza.
- Le pagine concept/compound/technique richiamano le figure con `[[fig-026]]` o con l'embed `![[immagini/<file>]]` (da `panels[].embed`). Le figure con `flags` o `review_notes` (Figure 26, 27, 29, 58, 63, 66, 67, 69 hanno discrepanze didascalia/testo) vanno citate con l'avvertenza.
- `compounds` nel catalogo sono numeri della tesi; `concepts` sono slug candidati, non nomi definitivi: crea la pagina solo se la regola dei ≥2 usi è soddisfatta.
## Regole di organizzazione dei dati
- Pagine sopra ~1.500 parole vanno spezzate per argomento (es. `ciclovoltammetria` = metodo; i risultati in `cv-risultati`).
- Una tabella o un dato sta in **una sola pagina**: quella dove la tesi lo discute (per es. Tab. 5 in `dpp-2`, Tab. 13-14 in `ciclovoltammetria`). Le altre pagine rimandano con wikilink; fanno eccezione i riepiloghi comparativi (es. in `uv-vis-fluorescenza`), che citano la tabella di origine.
- Una tabella o un dato sta in **una sola pagina**: quella dove la tesi lo discute (per es. Tab. 5 in `dpp-2`, Tab. 14-15 in `cv-risultati`). Le altre pagine rimandano con wikilink; fanno eccezione i riepiloghi comparativi (es. in `uv-vis-fluorescenza`), che citano la tabella di origine.
- Le pagine riorganizzano per argomento, non per capitolo, senza eliminare informazioni: procedure con quantità in tabella, condizioni, assegnazioni e ragionamenti della tesi restano, con `tesi_loc` e righe.
- Composti sperimentali: `dpp-1`, `dpp-2`, `copolimeri-3a-3b-3c`, `bottle-brush-3-x`. La numerazione dei composti del cap. 1 (1-48) è un'altra: non confonderle.
## Difetti noti della tesi
Raccolti in `wiki/analyses/difetti-noti.md` (una sola pagina; le altre rimandano lì): bibliografia con voce 44 duplicata della 1; voci 20, 22, 36, 53 incomplete; DOI errati nelle voci 47, 48 (corretto 10.1080/15583720802231833) e 49; voci 47, 49, 53 non identificabili; segnaposto "paragrafo XX (XX)" in 4.4.4; discrepanze figura/testo sopra elencate.
Raccolti in `wiki/analyses/difetti-noti.md` (una sola pagina; le altre rimandano lì): bibliografia con voce 44 duplicata della 1; voci 20, 22, 36, 54 incomplete; DOI errati nelle voci 47, 48 (corretto 10.1080/15583720802231833) e 49; voci 47, 49, 54 non identificabili; segnaposto "paragrafo XX (XX)" in 4.4.4 (risolto nella versione del 2026-10-13); discrepanze figura/testo sopra elencate.
## Workflow
@@ -107,7 +107,7 @@ Leggi `index.md` e le pagine rilevanti (non rileggere `raw/` se la wiki basta);
Esegui `python scripts/lint.py` (link rotti, pagine orfane, frontmatter, coerenza `figures`/`refs` con il corpo, numeri non presenti in `raw/tesi.md`, slug concetto candidati). Poi controlli semantici a mano: contraddizioni, valori che non tornano con `raw/tesi.md`, pagine oltre ~1.500 parole da spezzare. Riporta; le correzioni meccaniche (spaziatura, frontmatter) si applicano subito, il resto dopo conferma. Log `lint`.
## index.md e log.md
- `index.md`: catalogo per categoria (Overview, Tesi e bibliografia, Concetti, Composti, Tecniche, Figure, Analisi), voci `- [[pagina]] — riga di sintesi`, ordine alfabetico, conteggi aggiornati. Le 78 figure non si elencano una per una: una riga con link alla cartella e il conteggio per tipo.
- `index.md`: catalogo per categoria (Overview, Tesi e bibliografia, Concetti, Composti, Tecniche, Figure, Analisi), voci `- [[pagina]] — riga di sintesi`, ordine alfabetico, conteggi aggiornati. Le 79 figure non si elencano una per una: una riga con link alla cartella e il conteggio per tipo.
- `log.md`: append-only, mai riscrivere le voci vecchie. Prefisso `## [YYYY-MM-DD] tipo | titolo` con tipo ∈ `setup, ingest, query, lint, schema`. Parsing: `grep "^## \[" log.md | tail -5`.
## Regole d'oro