GuestCraft

GuestCraft gestisce il ricevimento di una struttura: camere, prenotazioni, ospiti, tariffe, il planning, check-in e check-out, il conto dell’ospite. Si collega al tuo account Channex per importare le prenotazioni delle OTA e pubblicare disponibilità e prezzi. È software libero: il nucleo è AGPL-3.0, l’SDK e il contratto dell’API sono MIT, e lo installi tu, su Vercel o con Docker.

GuestCraft è in pre-alpha. Oggi può già gestire il ricevimento quotidiano di una struttura, ma alcune aree sono parziali e altre ancora da fare. Lo stato del prodotto è il riferimento, aggiornato a ogni pull request che cambia ciò che un operatore può fare; il riepilogo qui sotto lo segue. La documentazione tecnica è in inglese.

Cosa funziona oggi

Disponibile

Installazione, primo operatore e accesso. Strutture, tipologie e camere. Disponibilità per tipologia e notte. La schermata Oggi, con arrivi, partenze e ospiti in casa. Check-in e check-out. Tariffe, restrizioni e preventivi. Camere fuori servizio e fuori uso. Import delle prenotazioni OTA da Channex. Inglese, temi chiaro, scuro e ad alto contrasto.

Parziale

Team, ruoli e accesso alle strutture, ospiti, prenotazioni dirette, planning, pulizie, ticket di manutenzione, conto, pagamenti manuali e online (account Stripe proprio), policy di cancellazione e no-show, chiusura giornaliera e data operativa, report, connessione a Channex, pubblicazione ARI e messaggi degli ospiti su Channex, chiavi API e webhook in uscita, app mobile, API pubblica e SDK, e rilasci (nessuno pubblicato finora). Ogni riga dello stato del prodotto elenca cosa manca.

In programma

Gruppi e allotment, check-in online, rendiconti per i proprietari e booking engine. Moduli per paese come imposta di soggiorno, registrazione degli ospiti e fatturazione elettronica: le imposte non vengono calcolate finché non esiste un modulo per il paese.

Guardalo

Schermate storiche di un’istanza reale con una struttura di fantasia. Alcune mostrano la precedente interfaccia italiana; l’applicazione attuale è solo in inglese.

• 

  Oggi: arrivi, partenze e ospiti in casa al ricevimento

• 

  Una prenotazione con soggiorno, ospite, prezzo e azioni

• 

  Tariffe e disponibilità: prezzi per notte e restrizioni in un calendario

• 

  Il conto dell'ospite: addebiti, extra, pagamenti e rimborsi

• 

  Channex: abbinamento di strutture e tipologie prima di importare le prenotazioni

• 

  Planning con un blocco datato di una camera per manutenzione

• 

  Oggi su smartphone

Installalo

Installa su VercelInstallazione in un clic con un database Neon o Supabase e i segreti generati nel browser.

Avvia con Docker ComposePostgreSQL, migrazioni e applicazione web sul tuo server.

Collega ChannexAbbina strutture e tipologie, importa le prenotazioni, poi prendi in carico disponibilità e prezzi.

Riferimento APITutte le operazioni dell'API HTTP, dal documento OpenAPI del repository.

Contribuisci

GuestCraft è sviluppato in modo aperto: decisioni architetturali scritte, test su un vero PostgreSQL e controlli di qualità su ogni pull request.

Guida per chi contribuisceFlusso di lavoro, convenzioni e controlli da eseguire prima di una pull request.

Struttura del repositoryPacchetti, confini e architettura di riferimento.

Decisioni architetturaliPerché GuestCraft è fatto così, una decisione alla volta.

Programma qualitàTest, copertura, controlli di sicurezza e revisioni.

GuestCraft non è affiliato a Channex.