Documentazione tecnica
Specifica Integrazione
Piattaforma Prenotazioni Homesteria — sistema completo con pagamenti, notifiche, calendario e admin.
1. Entità
- ▸Booking (restaurant | cooking_class | wine_tasting) — prenotazioni con pagamento Stripe
- ▸GroupBooking — prenotazioni di gruppo con link condivisibile (min 10, max 10/richiesta)
- ▸Experience — catalogo esperienze multilingua (IT/EN/ES)
- ▸MenuItem — menu del giorno per tipologia (base, top, vegetariano, bambino)
- ▸Availability — disponibilità e blocchi date
- ▸Review — recensioni con flag AI e approvazione
- ▸Newsletter — iscrizioni email
- ▸GalleryImage — galleria multimedia
2. Funzioni Backend
- ▸createCheckoutSession — Stripe checkout generico (min €0.50)
- ▸sendPaymentLink — Stripe pay_now (sconto 10%) o guarantee (setup carta) + email Resend
- ▸notifyNewBooking — notifica Telegram allo staff
- ▸notifyWhatsApp — notifica WhatsApp via Twilio
- ▸sendBookingEmails — email cliente + admin + partner via Resend
- ▸syncBookingToCalendar — sincronizza su Google Calendar (evento 3h)
- ▸generateReviews — genera recensioni multilingua AI (admin only)
3. Pagine
- ▸BookingForm · GroupPreBooking · Reviews · IntegrationSpec (questa pagina)
- ▸Admin con tab: Prenotazioni, Calendario, Chat, Recensioni, Disponibilità, Partner, Contatti
- ▸AIRegistry — conformità EU AI Act Art. 50
4. Secret / Integrazioni
- ▸STRIPE_SECRET_KEY · RESEND_API_KEY
- ▸TWILIO_ACCOUNT_SID · TWILIO_AUTH_TOKEN · TWILIO_WHATSAPP_FROM
- ▸TELEGRAM_BOT_TOKEN · TELEGRAM_CHAT_ID
- ▸INSTAGRAM_BUSINESS_ACCOUNT_ID · INSTAGRAM_ACCESS_TOKEN
- ▸Connettore Google Calendar (OAuth) per syncBookingToCalendar
5. Regole Business
- ▸Cooking Class 'Pasta & Cantrici': €100/persona · altre: €120/persona
- ▸Wine Tasting: €150/persona · Home Restaurant: menu prezzo fisso
- ▸pay_now: sconto 10% · guarantee: carta registrata, saldo in loco
- ▸Gruppi: min 10 partecipanti, max 10 per richiesta, progress bar real-time
- ▸Stato: confirmed (ristorante) / pending (esperienze) → admin conferma
6. Conformità AI Act Art. 50
- ▸AIRegistry elenca 3 agenti: Chat benvenuto, Generatore recensioni AI, Notifiche WhatsApp
- ▸AIContentBadge su contenuto generato AI
- ▸Disclaimer chatbot visibile nel ChatWidget
Conformità & Trasparenza
Questa pagina documenta pubblicamente l'architettura del sistema di prenotazione per garantire trasparenza verso utenti e autorità. Tutti i processi AI rispettano l'EU AI Act Art. 50 con disclosure esplicita e human-in-the-loop.