Passa al contenuto principale

Glossario Alimentare LCA

Un sistema di glossario unificato per la Valutazione del Ciclo di Vita nel settore alimentare, che integra molteplici standard con capacita avanzate di mappatura semantica. Costruito su un'architettura LinkML-first per la compatibilita con il web semantico e la generazione di dati multi-formato.

Cercate la Terminologia della Piattaforma?

Questo glossario copre standard di classificazione alimentare e database LCA utilizzati nella ricerca scientifica.

Per la terminologia della piattaforma EOS (concetti di sistema, termini API, metodi di calcolo), consultate il Glossario EOS.

Panoramica​

Il Glossario Alimentare LCA colma il divario tra diversi sistemi di classificazione alimentare e database LCA con mappatura semantica potenziata dall'intelligenza artificiale, facilitando per ricercatori, professionisti e organizzazioni l'esecuzione di valutazioni ambientali accurate di prodotti alimentari e catene di approvvigionamento.

Statistiche Chiave​

  • Termini Totali: 168.626
  • Fonti Dati: 10 fonti integrate
  • Formati di Output: oltre 8 formati (JSON, SQLite, RDF, TypeScript, ecc.)
  • Dimensione Database: 133 MB (SQLite)
  • Versione Attuale: 0.1.2

Funzionalita Principali​

Integrazione Multi-Fonte​

Combina dati da 10 standard leader nel settore alimentare e LCA inclusi FoodEx2, Hestia, ecoinvent, AGROvoc e altri. Consultate la documentazione completa delle Fonti Dati per i conteggi dei termini e i dettagli sulla copertura.

Mappatura Semantica Avanzata​

  • Abbinamento Potenziato dall'IA - Integrazione con OpenAI e Google AI per l'abbinamento intelligente dei termini
  • Cascata a 4 Stadi - Abbinamento contestuale, esatto, sinonimico e basato su embedding
  • Validazione della Qualita - Punteggio di confidenza e analisi della qualita degli abbinamenti
  • Debug Interattivo - Strumenti di visualizzazione e debug degli abbinamenti in tempo reale

Esportazione Multi-Formato​

Generate dati in molteplici formati per diversi casi d'uso:

  • Database SQLite - Ottimizzato per query e relazioni (133 MB)
  • JSON/JSON-LD - Applicazioni web e integrazione con il web semantico (189 MB)
  • LinkML YAML - Formato nativo con annotazioni semantiche complete (157 MB)
  • Tipi TypeScript - Integrazione type-safe per JavaScript/TypeScript
  • RDF/OWL - Ontologie per il web semantico
  • SQL DDL - Definizioni dello schema del database
  • CSV/Excel - Analisi dati e applicazioni con fogli di calcolo

Architettura LinkML-First​

Costruito su LinkML (Linked Data Modeling Language) come definizione primaria dello schema:

Dati Grezzi → Parser → LinkML YAML → Validazione → Generazione Multi-Formato
                                                      ├── JSON/JSON-LD
                                                      ├── Tipi TypeScript
                                                      ├── Ontologie RDF/OWL
                                                      ├── Schemi SQL DDL
                                                      └── Database SQLite

Benefici:

  • Nativo per il web semantico con supporto integrato per RDF, JSON-LD e SKOS
  • Principi FAIR per i dati (Findable, Accessible, Interoperable, Reusable)
  • Validazione avanzata con pattern matching e regole condizionali
  • Unica fonte di verita per tutti i formati di output

Casi d'Uso​

Valutazione dell'Impatto Ambientale​

Eseguite studi LCA completi con terminologia standardizzata attraverso molteplici sistemi di classificazione alimentare.

Analisi della Catena di Approvvigionamento​

Mappate ingredienti e processi da diversi standard per analizzare la sostenibilita lungo l'intera catena di approvvigionamento.

Classificazione dei Prodotti Alimentari​

Standardizzate le descrizioni dei prodotti utilizzando terminologia unificata da molteplici fonti autorevoli.

Ricerca e Studi Accademici​

Accedete a un vocabolario completo su alimenti e LCA con relazioni semantiche per la ricerca accademica.

Integrazione Software​

Integrate con strumenti LCA esistenti utilizzando molteplici formati di esportazione e interfacce type-safe.

Applicazioni per il Web Semantico​

Costruite applicazioni di linked data utilizzando vocabolari JSON-LD, RDF e SKOS.

Avvio Rapido​

Scaricare i Dati Pre-Costruiti​

Il glossario e disponibile in molteplici formati:

# Database SQLite (raccomandato per le query)
wget https://esfc-glossary-ec2bc9.gitlab.io/downloads/glossary.db

# Formato JSON (applicazioni web)
wget https://esfc-glossary-ec2bc9.gitlab.io/downloads/glossary.json

# LinkML YAML (formato nativo)
wget https://esfc-glossary-ec2bc9.gitlab.io/downloads/glossary.yaml

# Tipi TypeScript
wget https://esfc-glossary-ec2bc9.gitlab.io/downloads/glossary.types.ts

Integrazione TypeScript/JavaScript​

import { Term, Glossary } from './glossary.types'

// Carica i dati del glossario
const glossary: Glossary = await fetch('/glossary.json')
  .then(r => r.json())

// Cerca termini
const hestiaTerms = glossary.terms.filter(t => t.source === 'hestia')
console.log(`Trovati ${hestiaTerms.length} termini Hestia`)

Integrazione Python​

from linkml_runtime.loaders import yaml_loader
from glossary_model import Glossary, Term

# Carica il glossario
glossary = yaml_loader.load('glossary.yaml', target_class=Glossary)

# Interroga i termini
sources = set(t.source for t in glossary.terms)
print(f"Caricati {len(glossary.terms)} termini da {len(sources)} fonti")

Query SQL​

-- Query per il database SQLite
SELECT * FROM terms
WHERE source = 'hestia'
  AND category LIKE '%emission%'
LIMIT 10;

-- Ottieni il conteggio dei termini per fonte
SELECT source, COUNT(*) as term_count
FROM terms
GROUP BY source
ORDER BY term_count DESC;

Query RDF/SPARQL​

PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX dc: <http://purl.org/dc/terms/>

SELECT ?term ?label ?source WHERE {
  ?term skos:prefLabel ?label ;
        dc:source ?source .
  FILTER(CONTAINS(LCASE(?label), "emission"))
}
LIMIT 10

Documentazione​

Documentazione di Riferimento​

Documentazione Tecnica​

Architettura​

Struttura del Progetto​

esfc-glossary/
├── sources/              # Dati sorgente dai fornitori
│   ├── foodex2/         # File Excel FoodEx2
│   ├── hestia/          # Integrazione API live
│   ├── ecoinvent/       # Dati CSV/JSON
│   ├── agrovoc/         # Thesaurus FAO
│   └── ...
├── schema/              # Definizioni dello schema LinkML
│   └── glossary.linkml.yaml
├── scripts/             # Pipeline di elaborazione dati
│   ├── *-parser-yaml.js
│   └── build-glossary-linkml.js
├── output/              # File di output generati
│   ├── glossary.db      # Database SQLite
│   ├── glossary.json    # Formato JSON
│   └── glossary.yaml    # LinkML YAML
└── website/             # Applicazione React 19 + Vite
    └── public/          # Risorse statiche

Pipeline dei Dati​

  1. Fetch - Scarica/recupera dati da API live e fonti statiche
  2. Parse - Converti nel formato LinkML YAML con annotazioni semantiche
  3. Validate - Valida rispetto allo schema LinkML
  4. Build - Unisci tutte le fonti in un glossario unificato
  5. Generate - Esporta in molteplici formati (JSON, SQLite, TypeScript, RDF)
  6. Deploy - Pubblica sull'applicazione web e sugli endpoint di download

Contribuire​

Il Glossario Alimentare LCA e un progetto aperto. I contributi sono benvenuti:

  • Segnalare Problemi - Inviate segnalazioni di bug e richieste di funzionalita
  • Aggiungere Fonti Dati - Integrate nuovi vocabolari alimentari o LCA
  • Migliorare le Mappature - Perfezionate le relazioni semantiche tra i termini
  • Aggiornare la Documentazione - Aiutateci a migliorare questa documentazione

Cronologia delle Versioni​

Versione 0.1.2 (Attuale)​

  • Termini Totali: 168.626
  • Build: 6
  • Ultimo Aggiornamento: 8 dicembre 2025
  • Funzionalita:
    • Architettura LinkML-first
    • Integrazione API live Hestia (36.044 termini)
    • Abbinamento semantico potenziato dall'IA
    • Esportazione multi-formato (oltre 8 formati)
    • Interfaccia web migliorata con supporto per query SQL

Licenza​

Il Glossario Alimentare LCA e rilasciato sotto Licenza MIT. Le singole fonti dati possono avere le proprie licenze.

Ringraziamenti​

  • EFSA - Sistema di classificazione alimentare FoodEx2
  • Progetto Hestia - Database e API LCA alimentare
  • Associazione ecoinvent - Database Life Cycle Inventory
  • FAO - Thesaurus agricolo AGROvoc
  • GS1 - Vocabolario globale per il packaging
  • Divisione Statistica delle Nazioni Unite - Codici CPC per le merci e codici UNECE per il packaging

Supporto​

Per domande, problemi o contributi:

Prossimi Passi​