Configurazione dell'Ambiente di Sviluppo

Questo repository ha lo scopo di facilitare l'orchestrazione dei servizi frontend, backend e database necessari al funzionamento del progetto BookingHub, le linee guida che seguono sono testate su ambienti unix-like (linux, macos) con le versioni di docker e docker compose su menzionate ed i comandi sono pensati per un utilizzo da terminale.

---

Indice

• Introduzione
• Caratteristiche
• Prerequisiti
• Installazione
• Deployment
• Licenza

---

Introduzione

BookingHub-Dev-Environment rappresenta l'orchestratore di un progetto composto da backend (https://github.com/bugman80/bookinghub-backend) e frontend (https://github.com/bugman80/bookinghub-frontend), questo repository e' nato per facilitare il setup e run dell'ambiente di sviluppo tramite un docker-compose che consente di orchestrare entrambi i layer ed il database PostgreSQL

Caratteristiche

• docker-compose file per il build e run dei servizi frontend, backend e database
• .env.example file per facilitare la creazione di un file con le variabili di ambiente necessarie

Prerequisiti

• Git
• Docker
• Docker-Compose

Installazione

Segui questi passaggi per configurare l'applicazione in locale, questo comportera' clonare il repository backend, il repository frontend ed il repository contenente l'orchestratore dei servizi. I tre repository devono essere clonati nella stessa directory che deve avere quindi la seguente struttura finale:

/bookinghub-dev-environment/   # Clone del repository di orchestrazione
|
├── docker-compose.yml
├── .env
└── README.md

/bookinghub-backend/           # Clone del repository backend
/bookinghub-frontend/          # Clone del repository frontend

1. Entra nella directory che hai scelto per contenere i tre repository di progetto

cd CartellaDiPreferenza

2. Clona il repository backend

git clone https://github.com/bugman80/bookinghub-backend.git

3. Clona il repository frontend

git clone https://github.com/bugman80/bookinghub-frontend.git

4. Clona il repository di orchestrazione e configura le variabili di ambiente

git clone https://github.com/bugman80/bookinghub-dev-environment.git
cd bookinghub-dev-environment

Crea un file .env nella root di questo repository, utilizza il file .env.example, rinominalo e sostituisci i valori con quelli che preferisci. Le variabili relative a Gmail sono opzionali, se si vuole attivare l'invio di notifiche email e' necessario configurare un account Gmail esistente o crearne uno ad hoc e configurarlo: https://support.google.com/a/answer/176600?hl=en altrimenti se si lasciano i valori attuali/fake semplicemente le email non verranno inviate.

5. Costruisci e Avvia i Servizi

Esegui il seguente comando per costruire e avviare i servizi:

docker compose up

Questo comando:

• Costruirà le immagini per backend e frontend
• Avvierà i servizi backend, frontend e il database PostgreSQL
• Creera' le tabelle sul database
• Creera' un superuser iniziale

6. Accedi ai Servizi

• Frontend: http://localhost:3000
• Backend (API): http://localhost:8000
• PostgreSQL: Accessibile sulla porta 5432

7. Arrestare i Servizi

Per arrestare i servizi, premi Ctrl+C

Deployment

L'applicazione e' attualmente rilasciata automaticamente su Railway (https://railway.app/) ed e' disponibile all'indirizzo https://bookinghub-frontend-production.up.railway.app/

Licenza

Nessuna licenza e' associata alla applicazione.