Web application Laravel che permette agli utenti di autenticarsi, ottenere un token e utilizzare le API di OpenBreweryDB tramite un proxy per visualizzare una lista di birre paginata.
- Autenticazione tramite token (Laravel Sanctum)
- Proxy API verso OpenBreweryDB
- Lista paginata di birre
- Documentazione Swagger
- Test delle performance per valutare l'architettura ottimale
- Docker
- Composer
- PHP >= 8.1
- Clona il repository:
git clone https://github.com/LeonardD93/daimon.git
cd daimon- Copia il file .env per i container: Copia il file .env.example come .env e configuralo se necessario:
cp .env.example .env
- eseguire la stessa cosa anche per il file .env dell applicazione laravel
cd app_beer
cp .env.example .env
- Avvia i container Docker: tornarea alla cartella padre e avviare i containers
cd ..
docker-compose up -d
- Entrare nel contaier
docker exec -it daimon_app bash- scaricare le dipendenze ( se ci sono problemi di permessi settare propriamente i permessi della cartella app_beer)
composer update- Genera la chiave dell'applicazione:
php artisan key:generate
- Genera l'utente root nel db per fare il test (username=>root password=>password)
php artisan db:seed
- Per testare l'applicazione se non sono state cambiate le impostazioni docker si puo fare il login al url locale con le credenziali appena inserite nel db
http://localhost:8080
- La documentazione delle API è disponibile all'indirizzo:
http://localhost:8080/api/documentation
- Se viene modificata la documentazione puoi rigenerare la pagina di swagger
php artisan l5-swagger:generate
Per utilizzare le api si puo utilizzare direttamente swagger quindi fare il login con la relativa (Authentication/login => try it out =>Execute) una volta ricevuto il token si puo salvare nella pagina (pulsante Authorize con bordo verde in alto a destra ) una volta salvato il token quindi si possono provare anche il risultato del altra api (Breweries =>get)
oppure si puo guardare l'implementazione del front end dentro la vista welcome