Crediti e licenze
Questo sito è un progetto didattico di Giuseppe Bosi, Dottore in Ingegneria Elettronica e Professore di Scienze e Tecnologie Informatiche. Serve a far vedere, con un esempio che si può provare, come un assistente conversazionale lavora dentro un sito: cerca nei documenti, calcola le disponibilità, prenota solo dopo la conferma di chi scrive, e rifiuta di fare ciò che non gli compete.
Come si possono riusare
- Testi e contenuti di queste pagine (specialità, prestazioni, pagine informative, spiegazioni): licenza Creative Commons Attribuzione 4.0 (CC BY 4.0). Si possono copiare, adattare e riusare anche a scopo commerciale, citando «Giuseppe Bosi».
- Codice del sito, dell'assistente e del widget: licenza MIT. Si può usare, modificare e ridistribuire, mantenendo la nota di copyright.
- I nomi della clinica, dei medici e i prezzi sono inventati per l'esempio: qualsiasi somiglianza con strutture o persone reali è casuale.
Con cosa è fatto
Tutto il software usato è libero o gratuito. Per ogni pezzo, il link porta alla documentazione ufficiale.
- Next.js e React
- il sito, le pagine e il form di prenotazione
- Vercel AI SDK
- lo streaming della chat e gli strumenti che l'assistente può chiamare
- PostgreSQL con pgvector
- il database: prestazioni, turni, prenotazioni e l'indice per la ricerca per significato
- Drizzle ORM
- le tabelle e le migrazioni del database
- Transformers.js (modello multilingual-e5-small)
- gli embedding calcolati sul server, senza servizi esterni
- OpenRouter
- il modello linguistico che scrive le risposte, attraverso il router gratuito
- Tailwind CSS, shadcn/ui e AI Elements
- l'aspetto delle pagine e della chat
- Lucide
- le icone
- Bodoni Moda e Hanken Grotesk
- i caratteri, incorporati nel sito al momento della compilazione: il browser non contatta servizi di terzi
- Playwright
- le prove automatiche: prenotazione, disdetta, widget, limiti dell'assistente
- Docker e Caddy
- la pubblicazione: due container su un server in Europa, HTTPS automatico
Per approfondire
- Com'è fatta questa demo — cosa è vero, cosa è inventato, cosa l'assistente non fa.
- Privacy — quali dati passano di qui, dove vanno e per quanto restano.
- Il tutorial — il codice spiegato passo per passo sul sito gemello, e come mettere lo stesso assistente in un altro sito.