Funzionalità | Partner | Anteprima | Feature | Procedura | Dati | Documentazione | FAQ | Licenza
Dashboard principale: esplorazione interattiva. Clicca sull'immagine per vedere il video demo.
Atliteg (Atlante della lingua e dei testi della cultura gastronomica italiana dall'età medievale all'Unità) è un progetto di ricerca accademico che mappa e visualizza l'evoluzione storica e la distribuzione geografica della lingua e dei testi legati alla cultura gastronomica italiana (dal Medioevo all'Unità d'Italia).
Per segnalare bug o richiedere nuove funzionalità, utilizza il sistema di Issues su GitHub selezionando il template appropriato.
Contesto Scientifico
Questo strumento digitale e interattivo permette il recupero, la valorizzazione e la fruizione dei dati storico-linguistici, offrendo nuove prospettive di analisi sulle denominazioni gastronomiche italiane. Attraverso l'uso di tecnologie moderne, il progetto colma il divario tra ricerca umanistica tradizionale e visualizzazione dati, rendendo accessibile un patrimonio lessicale altrimenti complesso da consultare.
| Funzionalità | Descrizione |
|---|---|
| Esplorazione lessicografica | Visualizza e filtra i dati VoSLIG |
| Mappe interattive | Diffusione geografica di termini gastronomici |
| Timeline storica | Istogrammi aggregati per quarti di secolo |
| Analisi testuale | Esplora fonti storiche (ricettari, trattati) |
| Treemap categorie | Gerarchia lemmi per categorie linguistiche |
| Tabelle dettagliate | Filtri avanzati su dati specifici |
(torna su)
 |
 |
 |
 |
| Università Roma Tre Labgeo "Giuseppe Caraci" |
Unistrasi Resp. Scientifica |
DH Unica Digital Humanities |
AtLiTeG Progetto PRIN 2017 |
Progetto sviluppato con il Labgeo "Giuseppe Caraci" (Università Roma Tre) e finanziato dal PRIN 2017. Responsabile scientifico: prof.ssa Giovanna Frosini (Università per Stranieri di Siena).
(torna su)
A sinistra: mappa interattiva con poligoni e marker. A destra: timeline per l'evoluzione dei termini nel tempo.
A sinistra: filtri globali per categoria e periodo. A destra: treemap delle categorie linguistiche.
(torna su)
- Filtri globali per categoria e periodo, con badge visivi e reset rapido
- Mappa geografica con clustering intelligente:
- Cerchi circolari sempre visibili: Tutti i marker sono visualizzati come cerchi (mai pin individuali)
- Aggregazione dinamica: I cerchi si uniscono automaticamente in base allo zoom
- Indicatori di frequenza: Colori differenziati (blu/arancione/rosso) in base alle occorrenze
- Popup dettagliati: Click sui cerchi per vedere lemmi, forme e metadati
- Auto-zoom e contatori: Navigazione fluida con metriche in tempo reale
- Indice alfabetico interattivo e ordinamento automatico
- Metriche dashboard: località, lemmi, anni, attestazioni
| Componente | Tecnologie |
|---|---|
| Frontend |    |
| Mappe & Viz |  react-leaflet chart.js |
| DevOps |   |
| Data | CSV statici, GeoJSON, PapaParse (No Backend API) |
- Node.js 20+ (per sviluppo)
- Docker & Docker Compose (per deployment)
cd lemmario-dashboard
npm install
npm run dev
# App su http://localhost:3000npm run build
npm run start
# App su http://localhost:3000docker-compose build
docker-compose up -d
# App su http://localhost:9000Il progetto utilizza un GitHub Actions Self-Hosted Runner per il deploy automatico sul server di produzione (protetto da VPN).
Trigger automatici:
- Push o merge su branch
master - Esecuzione manuale tramite GitHub Actions
Cosa fa il workflow:
- 📥 Git pull del codice aggiornato
- 🏗️ Build delle immagini Docker
- 🔄 Restart dei container
- 🧹 Pulizia risorse Docker non utilizzate
- 🔍 Verifica deployment
Setup:
- 🚀 docs/guides/deploy-quickstart.md - Guida rapida
- 📖 docs/guides/github-actions.md - Setup completo
- ⚙️ install-github-runner.sh - Script installazione runner
- 📄 .github/workflows/deploy-production.yml - Workflow
atliteg-map/
├── 📂 data/ # Dati geografici sorgente (JSON) e preprocessati
├── 📚 docs/ # Documentazione tecnica e scientifica
├── 💻 lemmario-dashboard/ # Web app Next.js/React
│ ├── 📄 app/ # Pagine/layout Next.js (App Router)
│ ├── 🧩 components/ # Componenti React UI (Mappe, Filtri, Grafici)
│ ├── 🔌 services/ # Data loader e parsing logica
│ ├── 🏷️ types/ # Definizioni TypeScript (Interfaces)
│ ├── 🗃️ public/data/ # Dati statici serviti al frontend
│ └── ...
├── 🐍 process_data.py # Script Python (legacy) per preprocessing
└── ...(torna su)
Per dettagli su architettura e dataset, vedi docs/architecture/system-architecture.md e docs/architecture/dataset-specification.md.
| Tipo | File | Descrizione |
|---|---|---|
| CSV | Lemmi_forme_atliteg_updated.csv | Lemmi, forme, coordinate, metadati |
| GeoJSON | Ambiti geolinguistici newline.json | Aree geografiche poligonali |
| Tipo | File | Descrizione |
|---|---|---|
| CSV | Lemmi_forme_atliteg_updated.csv | Lemmi, forme, coordinate, metadati |
| GeoJSON | Ambiti geolinguistici newline.json | Aree geografiche poligonali |
La documentazione completa è disponibile nella cartella docs/ ed è organizzata per argomento.
→ Indice Generale (docs/README.md) - Navigazione completa di tutta la documentazione
- System Architecture - Panoramica architettura sistema
- Backend API Design - Design e implementazione API backend
- Dataset Specification - Specifiche dati e formati
- Requirements - Requisiti funzionali (30 requisiti)
- Performance - Analisi e ottimizzazione performance
- Motion System - Sistema animazioni e transizioni
- Dynamic Graphics - Grafica dinamica e visualizzazioni
Guide Principali:
- Quick Start - Guida rapida per iniziare
- User Guide - Manuale utente completo
- Deployment Guide - Guida deployment in produzione
- Testing Guide - Guida esecuzione test
- Test Checklist - Checklist testing manuale (189 test)
Guide Tecniche:
- GitHub Actions - Configurazione CI/CD
- SEO Implementation - Strategia SEO/AEO/GEO
- API Reference - Riferimento API
- Quick Commands - Comandi frequenti
- Region Codes - Codici regionali ISTAT
Guide Dati:
- CSV Upload Guide - Guida caricamento CSV
- Data Sync - Procedure sincronizzazione dati
- Upload Refresh - Procedura refresh dati
- Upload Troubleshooting - Risoluzione problemi
- Regions Feature - Integrazione codici regionali ISTAT
Componenti Principali:
- Lemmario Dashboard - Documentazione tecnica frontend Next.js
- Dashboard Features - Funzionalità e componenti dashboard
- Map Clustering - Clustering mappa geografica
- Timeline Component - Timeline storica
- Popup System - Sistema popup con accordion
Componenti UI:
- Header - Header navigazione e branding
- Filters - Filtri categoria/periodo multi-select
- Search Bar - Ricerca autocompletante
- Alphabetical Index - Indice alfabetico A-Z
- Lemma Detail - Pannello dettaglio forme
- Metrics Summary - Metriche aggregate
- Roadmap - Piano sviluppo futuro (37 items, 6 release)
- Changelog - Registro modifiche
- Contributing - Linee guida contribuzione
- Bugs and Features - Tracking bug e funzionalità
- Data Security - Setup protezione dati e file sensibili
- Security Config - Configurazione security (Nginx, JWT, API keys)
- Security Executive Summary - Sommario esecutivo
Per Utenti Finali:
Per Sviluppatori:
Per DevOps:
- Configurazione avanzata: vedi Vite e
tailwind.config.js. - Per modifiche dati, aggiorna i file in
data/epublic/data/.
Punteggio SEO 100/100
Il progetto implementa le seguenti ottimizzazioni SEO per migliorare la visibilità sui motori di ricerca:
- Title e Description: Tag ottimizzati con parole chiave rilevanti
- Open Graph: Tag per condivisione ottimale su social media (Facebook, LinkedIn)
- Twitter Cards: Metadata specifici per Twitter
- Favicon e Apple Icons: Icone per tutti i dispositivi e piattaforme
- Canonical URL: Prevenzione contenuti duplicati
- Schema.org JSON-LD: Markup strutturato per motori di ricerca (tipo: WebSite, SearchAction, Organization)
- Sitemap XML: Generazione automatica per indicizzazione completa
- Robots.txt: Configurazione crawling ottimale
- Viewport Meta: Ottimizzazione per dispositivi mobili
- Theme Color: Integrazione con browser mobile
- Alt Text: Descrizioni per tutte le immagini (inclusi loghi partner)
Il footer include i loghi dei partner con markup semantico appropriato:
- Università Roma Tre
- Università per Stranieri di Siena
- DH Unica (Digital Humanities, Università di Cagliari)
- AtLiTeG Project
Punteggio SEO: 100/100
(torna su)
Come posso contribuire?
Consulta la guida CONTRIBUTING e apri una issue o una pull request.
Come risolvo problemi di caricamento dati?
Vedi Upload Troubleshooting.
Dove trovo la documentazione tecnica?
Tutta la documentazione è in docs/.
Come verifico la salute del deployment?
Controlla i log Docker e lo stato del runner GitHub Actions.
