Newer
Older
## Descrizione
Il progetto OpenCruise è composto da due applicativi web che interagiscono tra di loro
con lo scopo di fornire una applicazione che offre all'utente la possibilità di creare/configurare
dei report di consumo e poi visualizzarli in qualsiasi browser.
## Installazione ed esecuzione del progetto in ambiente locale
#### Prerequisiti
- [ ] Installazione di GIT
- [ ] Installazione di Docker
- [ ] Linea di commandi, cmd/poweshell per sistema operativo Windows e Shell per sistemi operativi Linux
#### Installazione
- [ ] Installare GIT da [qui](https://git-scm.com/download/win).
- [ ] Installare Docker da [qui](https://www.docker.com/products/docker-desktop/).
- [ ] Clonazione del progetto da GIT tramite linea di comandi
> git clone https://crossserv.bologna.enea.it/gitlab/open/opencruise
#### Esecuzione
Per eseguire il progetto fare click sul file __start.bat__, presente nella cartella clonata da GIT
> oppure
aprire la linea di comandi posizionandosi nella cartella clonata ed eseguire il commando:
> docker-compose up
Se l'installazione finisce con successo sarà possibile ragiungere l'applicativo
da questo [link](http://localhost:4200).
Per chiudere l'esecuzione clic-are sul file __stop.bat__
> oppure
premere CTRL+C nella finestra
della linea di commando aperta precedentemente.
#### Accesso con utente registrato
> __*Username*__: user@demo.com
>
> __*Password*__: demo
#### Accesso con utente admin
> __*Username*__: admin@demo.com
>
> __*Password*__: demo
#### Esecuzione test
Dopo l'accesso al portale, è possibile visualizzare 2 report impostando la lingua del portale in Italiano.
I report presenti sono:
> Reporto consumo
>
> Consumo e produzione abitazione
La fonte dati dei 2 report si trova nel percorso __\<cartella progetto clonato\>/report-data__ e i file utilizzati sono __getData_10.json__
e __getData_35.json__.
Se si ha la necessità di utilizzare un insieme di dati diversi da quelli attuali bisogna seguire questi passi:
1. Eliminare i file __getData_10.json__ e __getData_35.json__ dalla cartella __\<cartella progetto clonato\>/report-data__.
2. Per avere dati gia preparati copiare il contenuto della cartella __\<cartella progetto clonato\>/report-data/examples/02__ in __\<cartella progetto clonato\>/report-data__
3. Per avere i dati eliminati nel passo 1 copiare il contenuto della cartella __\<cartella progetto clonato\>/report-data/examples/01__ in __\<cartella progetto clonato\>/report-data__
4. E' importante che il nome e la struttura dei file sia mantenuto uguale a quello indicato sopra.
6. Modificare il file json dei dati solo nella sezione __result: [{}...]__ a seconda delle esigenze.
> Non è necessario riavviare Docker per questa operazione
Se si desidare avere un altra cartella per i dati si puo aggionare la variabile __MOCK_DATA_FOLDER_LOCAL__ nel file __.env__, es: __C:/folder-data__.
> E' necessario riavviare Docker per questa operazione
#### Configurazione accesso Keycloak
###### Configurazione progetto Lec
Configurare il seguente parametro nel file environment.ts (Percorso: lec/src/environments)
> authenticationType: 'oid'
###### Configurazione progetto Lecservice
Configurare il seguente parametro nel file Dockerfile (Percorso: lecsevice)
> ENV ACTIVE_PROFILE=oid
###### Configurazione progetto GecoRegistration
Configurare la seguente variabile globale nel file Dockerfile .ts (Percorso: gecoregistration)
> ENV ACTIVE_PROFILE=dev
#### Configurazione accesso locale
###### Configurazione progetto Lec
Configurare il seguente parametro nel file environment.ts (Percorso: lec/src/environments)
> authenticationType: ''
> ###### Configurazione progetto Lecservice
Configurare il seguente parametro nel file Dockerfile (Percorso: lecsevice)
> ENV ACTIVE_PROFILE=dev
###### Configurazione progetto Lecservice
Non viene utilizzato in questa modalità
#### Comandi utili
> __*docker-compose up --build <service_name oppure vuoto> *__ - Commando per avviare Docker pulendo la cache per riflettere i cambiamenti in configurazione
>
> __*docker-compose stop*__ - Commando per stoppare i container
>
> __*docker-compose start*__ - Commando per riavviare i container
>
> __*docker-compose down*__ - Commando per terminare Docker e rimuovere tutti i container creati
>
> __*docker build --no-cache --progress=plain -t geco .\gecoregistration*__ - Commando per eseguire un specifico servizio visualizzando i log