appschedweb
appschedweb è una web application per la gestione delle prenotazioni effettuate dagli utenti delle pubbliche amministrazioni. Permette di gestire sia gli appuntamenti presi ad uno sportello fisico dell'ente sia quelli con modalità remota con l'aggancio al modulo vide-pwa che crea la videoconferenza tra operatore e cittadino.
appschedweb è un prodotto CSI realizzato a partire da easyappointments-mu che a sua volta è un fork pesantemente modificato del progetto GitHub alextselegidis/easyappointments. Per appschedweb si è deciso di partire da easyappointments-mu (versione presente sul branch master il 19 giugno 2020) perché permette la realizzazione del multi tenant. Le differenze rispetto ai progetti originari alextselegidis/easyappointments e easyappointments-mu sono elencate qui di seguito:
- aggiunta interazione - mediante invocazioni di API e navigazione Web - con il modulo esterno di videoconferenza vide-pwa;
- differenziazione dello sportello per consentire sia gli appuntamenti in presenza sia quelli da remoto in videoconferenza;
- modifica dei template delle email spedite a cittadino ed operatore di sportello una volta conclusa la prenotazione da interfaccia web;
- azzerato il prezzo a servizio e aggiunto controllo sul numero massimo di servizi (sportelli) per ente;
- inserita la gestione dei giorni di chiusura di ciascun sportello;
- implementata la possibilità di caricare il logo dell'ente sull'interfaccia web.
Il template di file di configurazione si trova nel file .env.example che contiene i seguenti parametri.
- BASE_URL: URL sulla quale sarà esposto l'appschedweb, ad esempio http://comune-esempio.vide.csi.it/appschedweb;
- MYSQL_SERVER: macchina (o indirizzo) che ospita il server MySQL;
- MYSQL_DATABASE: database MySQL per appschedweb;
- MYSQL_USER: utente impiegato per la connessione al database MySQL;
- MYSQL_PASSWORD: password dell'utente impiegato per la connessione al database MySQL;
- SMTP: indirizzo del mailserver usato per la spedizione delle email;
- SMTP_USER: utente SMTP;
- SMTP_PASS: password dell'utente SMTP;
- VIDE_BASE_URL_API: indirizzo delle API esposte dal modulo VIDE (videoconferenza);
- VIDE_API_PSW: utente usato nella basic authentication delle API VIDE;
- VIDE_API_USER: password dell'utente usato nella basic authentication delle API VIDE;
Appschedweb è multi-tenant, quindi per ogni tenant corrisponde un file di configurazione che deve essere presente nella directory storage/mu; a titolo di esempio, l'applicativo richiamabile alla URL http://comune-esempio.vide.csi.it/appschedweb ci sarà il file di configurazione storage/mu/comune-esempio.vide.csi.it.
Per predisporre il progetto ed avviare il server in locale, verificare di avere installato sul PC la versione 7.2.x del PHP e che il composer sia stato installato puntanto alla versione del PHP appena riportata. Inoltre deve essere abilitata l'estensione gd2 (extension=gd2) in php.ini (presente nella directory di installazione del PHP impiegato da composer). Poi mandare in esecuzione:
composer install
che popola la directory vendor con le dipendenze di terze parti.
Per gli sviluppi in locale, utilizzare XAMPP (https://www.apachefriends.org/it/index.html). Eseguirne il download e installarlo sul proprio PC Windows.
Aprire con un editor di testo il file di configurazione di Apache (httpd.conf) presente in XAMPP che è posizionato nella
directory xampp/apache/conf e all'interno del tag <IfModule alias_module> inserire
Alias /appschedweb <PATH_APPSCHEDWEB>/src
<Directory <PATH_APPSCHEDWEB>/src>
AllowOverride All
Options Indexes MultiViews FollowSymLinks
Require all granted
</Directory>
dove <PATH_APPSCHEDWEB> è il path sul proprio disco locale che punta alla directory che ospita appschedweb.
Poi modicare il file C:\Windows\System32\drivers\etc\hosts del proprio PC aggiungendo la riga seguente:
127.0.0.1 comune-esempio.vide.csi.it/appschedweb
Copiare il file .env.example in /storage/mu/.comune-esempio.vide.csi.it e valorizzare i parametri di configurazione nel seguente modo:
PREFIX =
BASE_URL = http://comune-esempio.vide.csi.it/appschedweb/appschedweb
LANGUAGE = italian
MYSQL_SERVER = 127.0.0.1
MYSQL_DATABASE = appsched_comune-esempio_db
MYSQL_USER = appsched_comune-esempio
MYSQL_PASSWORD = 12345678
MYSQL_PORT = 3306
MYSQL_PREFIX =
SMTP = <mailserver_da_usare>
SMTP_USER = <utente_smtp>
SMTP_PASS = <passwd_utente_smtp>
VIDE_BASE_URL_API='<URL_API_VIDE>'
VIDE_API_PSW=mypass
VIDE_API_USER=12345678
Aprire come amministratore il pannello di controllo di XAMPP e avviare Apache e MySQL. Mediante DBeaver - o altro tool - connettersi come root al MySQL in esecuzione su localhost e procedere con la creazione del database appsched_comune-esempio_db con charset UTF8, e dell'utente appsched_comune-esempio (cfr. file di env del tenant locale), assegnando i permessi all'utente per poter agire sul database del progetto.
Inserire sulla barra degli indirizzi del browser la URL http://comune-esempio.vide.csi.it/appschedweb/appschedweb che avvia il web installer per la configurazione dell'istanza di progetto deployata in locale. Scegliere i parametri più consoni alla propria installazione in locale (admin/12345678) e poi fare click su Install Easy!Appointment
I logs applicativi sono presenti nella cartella storage/logs
I prerequisiti per l'installazione della componente sono i seguenti:
Per far sì che lo stesso applicativo possa servire più tenant differenti si usano - come documentato in easyappointments-mu(https://github.com/Kuvvu/easyappointments-mu) - database diversi per ogni hostname.
Dopo aver aggiunto il file .env per il nuovo tenant (ad esempio, .comune-esempio.vide.csi.it all'interno del quale si punta al proprio database
mediante MYSQL_USER), è sufficiente far puntare la configurazione del Web Server alla direcory /src di appschedweb.
Trasferire via FTP il codice sorgente (directory appschedweb) dalla macchina locale al server dell'ambiente di deploy. Ripetere in remoto la parte di configurazione illustrata in Getting Started con l'esclusione della modifica del file hosts.
Per i tenant successivi al primo, ripetere la copia di .env.example in /storage/mu assegnando il nome che avrà il virtual host del nuovo tenant (ad esempio, .comune-nuovo.vide.csi.it) e su DNS definire il il virtual host del nuovo tenant come alias della macchina di deploy di appschedweb.
Per la gestione del codice sorgente viene utilizzata la metodologia Semantic Versioning.
Gli autori della componente Appschedweb sono:
(C) Copyright 2020 CSI Piemonte
Questo software è distribuito con licenza GPL-3.0-or-later
Consulta il file LICENSE.txt per i dettagli sulla licenza.
In Bom.csv è presente l'elenco delle librerie di terze parti utilizzate in appschedweb.