Il seguente progetto è stato creato unicamente ai fini di un portfolio personale.

La presente demo emula una versione semplificata del portale Airbnb per l'affitto di appartamenti online tra privati . Gli utenti una volta registrati possono effettuare delle prenotazioni sugli appartamenti inseriti nel sistema.

Ogni utente a sua volta può registrare degli appartamenti, sponsorizzarli, ricevere e inviare messaggi in piattaforma.

Sono presenti tre dashboard principali:

• Appartamenti - gestione degli appartamenti registrati nel sito. In questa dashboard è possibile inserire, modificare, cancellare e sponsorizzare i propri appartamenti.
• Prenotazioni - gestione delle prenotazioni fatte e ricevute. In questa dashboard gli utenti che hanno registrato appartamenti nel sito possono verificare le prenotazioni ricevute in modalità lista e calendario. E' inoltre possibile controllare le prenotazioni fatte presso altre strutture e scaricare la ricevuta in PDF.
• Messaggi - piattaforma dei messaggi. E' possibile controllare i messaggi ricevuti o inviati per un dato appartamento quindi accedere alla conversazione specifica.

Funzionalità specifiche

Appartamenti

Ogni appartamento possiede un'immagine principale, fino a un massimo di altre 4 immagini secondarie, un titolo rappresentativo, una descrizione e altre informazioni comuni. Il proprietario può scegliere se inserire una percentuale di sconto, una permanenza massima per ogni singola prenotazione e dei giorni nei quali si riserva di non accettare ospiti. Inoltre è possibile indicare dei servizi predefiniti o personalizzati. I servizi possono essere gratuiti o a pagamento. L'indirizzo dell'appartamento viene inserito tramite una casella di ricerca che sfrutta le API TomTom dalle quali si ottiene una lista di possibili risultati e la relativa mappa.

Prenotazioni

E' possibile effettuare una prenotazione dalla pagina vetrina di ogni singolo appartamento dov'è verificabile anche la disponibilità per un dato periodo scelto dall'utente. Nell'atto della prenotazione l'utente può scegliere se e quali servizi a pagamento inserire per il soggiorno scelto. Il pagamento avviene mediante la piattaforma Braintree. Nel caso in cui il pagamento non venga effettuato, la prenotazione viene salvata nello stato in sospeso ed è richiamabile nella dashboard prenotazioni. Quando si avvia la procedura per una nuova prenotazione, l'appartamento in oggetto viene bloccato per il periodo scelto per un tempo definito nel sistema (attualmente impostato a 30 minuti.

Utenti

Gli utenti guest possono effettuare ricerche, visitare la vetrina di ogni singolo appartamento e controllare disponibilità degli appartamenti. Con una prima regitrazione l'utente può inviare messaggi ai proprietari di appartamenti. Per effettuare prenotazioni, inserire propri appartamenti e promuoverli è richiesto un ulteriore step di registrazione che prevede l'inserimento dei dati per la fatturazione. Per identificare un utente viene usato un nickname. Gli utenti non possono conoscere il vero nome di altri utenti se non dopo aver concluso la prenotazione di un appartamento.

Messaggi

I messaggi tra utenti vengono scambiati all'interno della piattaforma per mezzo dell'appartamento ovvero l'appartamento rappresenta il topic di un thread. Gli utenti interessati a un alloggio possono inviare messaggi al proprietario della struttura direttamente nella vetrina dell'appartamento. Una volta inviato un messaggio possono controllare eventuali risposte nell'area messaggi. Nuovi messaggi ricevuti vengono notificati nella navbar. Un thread è costituito quindi da due soli utenti, utente proprietario e utente interessato. All'interno del thread i messaggi vengono contrassegnati con delle spunte per indicare l'avvenuta lettura del messaggio.

Pagamenti

I pagamenti sono simulati attraverso la sandbox di Braintree. I pagamenti previsti riguardano la sponsorizzazione di un appartamento e la prenotazione presso di una struttura. Le ricevute in PDF delle sponsorizzazioni possono essere scaricate dal percorso Appartamenti / Promuovi / Mostra elenco promozioni. Le ricevute per le strutture prenotate sono disponibili al percorso Prenotazioni / Prenotazioni fatte / Mostra prenotazioni fatte.

Promozioni

L'utente può secgliere di promuovere i propri appartamenti ponendoli in vetrina nella home page. Gli appartamenti in vetrina sono mostrati con delle card la cui grandezza dipende dal tipo di promozione attivata. Le promozioni attivabili al momento sono quattro: card piccola, card grande, card allungata in verticale e card allungata in orizzontale.

Ricerche

La ricerca viene avviata dalla home page dov'è possibile selezionare una città italiana dall'elenco. Le date per il check-in e per il check-out sono facoltative. In alternativa è possibile cliccare sopra una delle venti card capoluogo per attivare la ricerca nella medesima città. Nella pagina dei risultati è possibile effettuare una ricerca avanzata inserendo ad esempio i servizi che deve possedere la struttura, allargare la ricerca per un dato raggio chilometrico dal luogo scelto, impostare una fascia di prezzo e altro ancora.

Ai fini della presente demo, per effettuare prenotazioni e promozioni, è accettabile unicamente un carta di credito con codice 4111 1111 1111 1111. E' necessario inserire anche un data di scadenza valida (ovvero futura nel tempo), un codice di sicurezza e il CAP (entrambi a piacimento rispettando però la lunghezza mostrata dal segnaposto).

Gli appartamenti sono generati attraverso un algoritmo che inserisce un appartamento per ogni principale città italiana (113 in totale). Inoltre vengono generati ulteriori 40 appartamenti a Nord, Sud, Est e Ovest di ogni città a una distanza l'uno dall'altro pari a 2 km. In totale sono presenti 18193 appartamenti.

Eventuali modifiche come nuovi utenti creati, appartamenti inseriti, promozioni effettuate e altro, rimangono salvate per un periodo di tempo limitato. Con cadenza giornaliera il database è ricreato da zero in modo da garantire la stessa esperienza d'uso a chinque volesse testare la demo.

E' stato appositamente inserito un utente già configurato con il quale è possibile effettuare il login. Le credenziali d'accesso sono:

• E-mail: demo@gmail.com
• Password: secret

E' comunque possibile creare nuovi utenti a proprio piacimento.

Il codice sorgente del presente progetto è disponibile su GitHub.

Puoi tranquillamente scrivermi a questo indirizzo.

La licenza applicata è la licenza MIT:

Copyright 2019-2024 Emanuele Mazzante

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

La puoi trovare a questa pagina.