Domande frequenti (FAQ)
Il programma, interamente sviluppato all'interno del settore Sviluppo di AGP-INF, nasce da una specifica necessità di I.S.P.R.A. nel gestire le domande frequenti (FAQ) per i dipendenti ISPRA.
Il programma è stato appositamente sviluppato su piattaforma web per consentire l'accesso alle risorse interne tramite l'utilizzo di un comune browser web.
All'interno dell'applicazione è possibile gestire la pubblicazione di eventi e le partecipazioni nelle varie date.
Licenza
Il codice sorgente del sito progetto è rilasciato sotto licenza MIT License (codice SPDX: MIT). La licenza è visibile nel file LICENSE
Repository
Questo repository contiene il codice sorgente del programma.
Il sito è sviluppato in linguaggio Ruby 2.7, framework Rails 6.0 e webpacker StimulusJS.
Specifiche tecniche progetto
- Ruby 3.0.x
- RVM
- Ruby on Rais 7.0
- NodeJS
- Yarn
- Webpack StimulusJS
- Postgresql
- HTML5 + CSS3
- no jQuery
- Server CAS - autenticazione SingleSignOn
- Openssl -
* In alternativa al server CAS e' necessario sviluppare altri sistemi di autenticazione come ldap
Requisiti tecnici per ambiente server
- Sistema operativo: Linux
- Gestore pacchetto ruby: RVM
- Linguaggio di programmazione: Ruby 3.0
- Framework: Rais 7.0
- Webpacker: StimulusJS
- Database: PostgreSQL >= 14
- NodeJS: JavaScript runtime >= v13.10
- Package Manager: Yarn >= 1.22
- Deploy applicazione: Accesso ssh per deploy applicazione via Capistrano
- Webserver: Nginx + Puma
- Autenticazione utenti: CAS Server
Requisiti minimi per i client
- Mozilla Firefox 53, Chrome 58, Microsoft Edge, Internet Explorer 11, Safari 9.0 o altro browser compatibile con HTML 5, CSS 3;
- Internet Explorer 11 non supportato;
- Javascript abilitato;
- Cookie abilitati;
- Supporto ai certificati SSL;
- Risoluzione schermo 1024x768.
Configurazione consigliata per i client
- Mozilla Firefox >= 53, Chrome >= 58, Microsoft Edge, Safari 9.0 o altro browser compatibile con HTML 5 e CSS 3;
- Javascript abilitato;
- Cookie abilitati;
- Supporto ai certificati SSL;
Installazione ambiente
Installare ruby 3.0.2, consigliato RVM.
Installazione applicazione
In sviluppo
Clonare il progetto in sviluppo
git clone https://github.com/isprambiente/domando.git
Da una shell posizionarsi sulla root del progetto ed eseguire
gem install bundle bundle install yarn install
Creare il file
config/settings.local.yml
partendo daconfig/settings.yml
per sovrascrivere i parametri di default. Il file è incluso nel.gitignore
pertanto sarà necessario ricopiarlo manualmente sul server nel pathshared/config/settings.local.yml
Demo con docker / docker compose
Clonare il progetto in sviluppo
git clone https://github.com/isprambiente/domando.git
Configurare il DNS o modificare il proprio file hosts per risolvere il nome cas-mock-server sull'indirizzo del server docker.
Nel seguente esempio il docker viene eseguito localmente e viene modificato il file /etc/hosts
del computer locale.
127.0.0.1 localhost cas-mock-server
la modifica è necessaria per raggiungere con un nome condiviso il server CAS
- Eseguire la build del docker tramite compose
sudo docker-compose up --build -d
- Per accedere utilizzare le seguenti credenziali:
- user - password # per utente standard
- editor - password # per utente editor
- admin - password # per utente admin
Partecipa!
Puoi collaborare allo sviluppo dell'applicazione e della documentazione tramite github.
Tramite Github discussions è possibile richiedere e offrire aiuto.
Se riscontrate errori e bug potete segnalarli nella paggina delle Issues