Il progetto
Tecnologie
Aggiornato: marzo 2026
Stack tecnico
Il sito è un'applicazione web monolitica con rendering lato server e idratazione lato client, costruita su queste tecnologie principali:
Backend
- Laravel — framework PHP
- Inertia.js — bridge server/client senza API REST
- MySQL — database relazionale
- Filament — pannello di amministrazione
Frontend
- Vue 3 — framework JavaScript reattivo
- TailwindCSS — utility-first CSS
- Leaflet.js — mappe interattive
- Vite — bundler e dev server
Il rendering SSR di Inertia.js garantisce tempi di caricamento rapidi e una buona indicizzabilità da parte dei motori di ricerca, pur mantenendo un'esperienza utente fluida lato client.
Strumenti AI
Alcuni strumenti di intelligenza artificiale sono stati utilizzati nel processo di costruzione del sito e nella redazione dei contenuti.
Claude Code — sviluppo software
Agente AI di Anthropic usato come assistente alla programmazione: scrittura e revisione del codice, progettazione dei componenti, debugging, refactoring. Il codice prodotto è sempre revisionato e validato dall'autore.
Modelli LLM Anthropic — testi botanici
Le schede descrittive delle specie sono state elaborate con assistenza di modelli linguistici a partire da fonti scientifiche cartacee (Flora d'Italia, Flora analitica della Toscana, ecc.) in possesso dell'autore. Il testo finale è rivisto e verificato manualmente. Ogni scheda riporta esplicitamente la presenza di contenuto elaborato con AI.
L'uso di AI è uno strumento di supporto, non un sostituto della conoscenza botanica. Tutte le determinazioni floristiche e le fotografie sono dell'autore.
Metodologia di sviluppo
Il sito è sviluppato seguendo la metodologia Spec-Driven Development (SDD) con il tool OpenSpec: ogni nuova funzionalità segue un ciclo formale di proposta → specifica → design → implementazione → archiviazione.
- proposeSi descrive il cambiamento desiderato: perché, cosa cambia, quali funzionalità introduce
- designSi prendono le decisioni architetturali chiave, si valutano alternative e rischi
- specsSi scrivono requisiti verificabili con scenari WHEN/THEN
- applySi implementa task per task, marcando il progresso
- archiveIl cambiamento viene archiviato e le spec promosse al catalogo principale
Questo approccio, applicato anche con l'assistenza di Claude Code, garantisce che ogni modifica sia motivata, documentata e tracciabile nel tempo.
Dati aperti
I dati del catalogo sono parzialmente accessibili in formato aperto.
Schede in formato Markdown
Ogni scheda specie e ogni famiglia botanica è disponibile in formato Markdown aggiungendo .md all'URL:
- /specie/{slug}.md
- /famiglia/{slug}.md
Indice per LLM
Il file /llms.txt espone un indice del catalogo leggibile da modelli linguistici e agenti AI, seguendo la convenzione emergente llms.txt.
API pubblica — in sviluppo
È in corso di sviluppo un'API pubblica che consentirà l'accesso strutturato ai dati botanici del catalogo (specie, famiglie, avvistamenti, forme biologiche). I dettagli saranno pubblicati qui non appena disponibili.
I contenuti del sito sono rilasciati sotto licenza CC BY-NC-SA 4.0: liberi per usi non commerciali con attribuzione a piante-spontanee.it.
Chi siamo · Accessibilità · Privacy Policy · Aggiornato: marzo 2026