Web system for emergency management - Sistema informativo per la gestione delle emergenze a scala comunale
Next documentation is in Italian because the system has been developed for an Italian public administration.
Gter srl - +39 010 - 0899150
Da alcuni anni la Protezione Civile del Comune di Genova ha deciso di dotarsi di un proprio sistema informativo per la gestione delle emergenze. In questo contesto, l’informazione territoriale gioca un ruolo fondamentale. Si tratta du un applicativo web che permette la condivisione delle informazioni fra i vari soggetti sia interni al Comune che esterni (volontari di protezione civile, aziende municipalizzate, VVF, Regione, etc) coinvolti a vario titolo nella gestione delle emergenze e quindi di supportare le operazioni di gestione e mitigazione del rischio. Tale sistema, inizialmente realizzato dal Comune di Genova con risorse interne quale replica di altri sistemi informativi in dotazione all’Ente è stato recentemente completamente rinnovato grazie a dei finanziamenti PON Metro 2014-2020. Il nuovo sistema, realizzato da Gter srl , oltre ad aver subito un importante restyling grafico che, a detta degli operatori di protezione civile, ha permesso di incrementarne sostanzialmente l’usabilità, ha ora al centro l’aspetto territoriale. Ogni segnalazione e/o intervento svolto è infatti georeferenziato grazie al collegamento con la toponomastica comunale. Questo nuovo approccio permette di avere in ogni istante un quadro preciso di quanto sta avvenendo sul territorio e pertanto di ottimizzare la gestione delle poche risorse a disposizione. Collegato alle banche dati territoriali, non solo alla toponomastica, ma anche all’anagrafe, e ai principali elementi a rischio (rii, sottopassi etc), il sistema permette di gestire e registrare interventi puntuali quali sgomberi o interdizioni all’accesso in maniera sicura ed efficiente.
Il sistema è web-based e basato su un tema bootstrap con una serie di strumenti web che si trovano nella cartella vendor
Lato server:
- il DBMS è PostgreSQL v.11 (min 9.6) con estensione spaziale PostGIS v.2.5 (min 2.4)
- PHP v 7.2 (min 7.1) è il linguaggio con cui sono implementate le pagine web
- Python 3.7 (min 2.7) è il linguaggio di programmazione principalmente usato per l'interazione con altri sistemi (es. webservice di ARPA Liguria, sistema delle manutenzioni, etc.)
Le principali cartelle usate dal repository sono
- dist: file javascript e di stile ereditati dal tema sb-admin-2 (http://startbootstrap.com/template-overviews/sb-admin-2/ )
- img cartella con le immagini usate dall'applicazione
- pages: pagine web dell'applicazione e script
- vendor: librerie utilizzate (jquery e javascript)
- altre cartelle (data, js, less): eredità del tema bootstrap utilizzato
Ci sono alcune librerie che sono state aggiunte come dipendenze. Si tratta di altri repository github che sono direttamente caricati dentro il repo:
Un esempio è la libreria bootstrap-table per realizzare grafici:
Con il comando git submodule
si aggiunge il repository:
git submodule add https://github.com/wenzhixin/bootstrap-table.git vendor/bootstrap-table
Quindi si può aggiornare ad una specifica versione il submodule per aggiornare il repository (analogo del comando push).
git submodule update --remote vendor/bootstrap-table
cd vendor/bootstrap-table
git checkout 1.16.0
Per "scaricare" l'aggiornamento ai submodules sul proprio server è possibile fare un sync:
git submodule sync
Le dipendenze (al 2020-05-29) sono:
- https://github.com/stefanocudini/leaflet-search.git
- https://github.com/PHPMailer/PHPMailer.git
- https://github.com/simsalabim/sisyphus.git
- https://github.com/l-lin/font-awesome-animation.git
- https://github.com/gtergeomatica/omirl_data_ingestion.git
- https://github.com/snapappointments/bootstrap-select.git
- https://github.com/stefanocudini/leaflet-list-markers.git
- https://github.com/wenzhixin/bootstrap-table.git
Con pip3 (python package installer) sono stati installati i seguenti moduli necessari al funzionamento del sistema:
- emoji
- psycopg2
- pymssql
- requests
- setuptools
- simplejson
- telepot
- urllib3
- logging
- tempfile
Il DB è PostgreSQL con estensione spaziale PostGIS (v 2.5).
All'interno di questa repository è presente un template del DB del sistema Emergenze ottenuto mediante i seguenti comandi PostgreSQL:
pg_dump -O -x -d emergenze -t *.tipo_* > emergenze_codifica.sql
pg_dump -s -O -x -d emergenze -T *.tipo_* > emergenze.sql
Il dump è suddiviso nei due file:
- emergenze.sql - contiene la struttura del DB (schemi e tabelle)
- emergenze_codifica.sql - popola le tabelle di decodifica nominate con prefisso tipo_ utilizzate per popolare ad esempio i menù a discesa presenti nel Sistema
Il template può essere ricreato con i seguenti passi:
- Creazione di un nuovo database vuoto di destinazione:
create database newdb;
- Restore della struttura e dei dati:
psql -d newdb -f emergenze.sql psql -d newdb -f emergenze_codifica.sql
Sono stati sviluppati due bot telegram, uno dedicato all'interazione con Sistema Emergenze per quanto riguarda la notifica di apertura eventi, affidamento degli incarichi, ecc. e uno specificatamente sviluppato per gestire la convocazione del COC Direttivo in caso di emanazione di un'allerta.
La configurazione principale dei bot telegram avviene nella cartella pages/eventi laddove deve essere incluso il file config.py che ha il seguente contenuto:
TOKEN="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" #da sostituire
TOKEN_COC="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" #da sostituire
#per ora solo un test su Roberto
chat_id= "XXXXX"
website= "https://emergenze.comune.genova.it/emergenze"
link= "https://emergenze.comune.genova.it/emergenze" #da sostituire con li
Il file che regola il bot di Sistema Emergenze si chiama bot_sistema_emergenze.py e viene lanciato all'avvio del sistema dal file avvio_bot.sh che a sua volta usa lo script python forever.py Il file forever.py richiama il file forever_conf.py che ha il seguente contenuto:
py_path = 'xxxxxxxxxxxxxxxx ' #da sostituire con il percorso a python 3.8
Il file che regola il bot di Convocazione COC si chiama bot_convocazione_coc.py e viene lanciato all'avvio del sistema dal file avvio_bot_coc.sh che a sua volta usa lo script python forever.py che richiama il file forever_conf.py
In fase di installazione occorre eseguire i seguenti passaggi da root:
- fare un link dello script sh /etc/init.d/ -->
ln -s /home/......./pages/eventi/avvio_bot.sh /etc/init.d/
chmod +x /etc/init.d/avvio_bot.sh
update-rc.d avvio_bot.sh defaults
Gli stessi passaggi vanno eseguiti anche per l'installazione del bot di Convocazione COC utilizzando il file avvio_bot_coc.sh
I bot si possono creare e gestire tramite BotFather
In questo momento il sistema usa le API del comune di Genova usate per interazione con altri servizi. In questo momento per interagire con il SW Manutenzioni. Le API del Comune di Genova sono richiamate dal codice python pages/segnalazioni/emergenze2manutenzioni.py che è a sua volta richiamato dalla pagina php pages/segnalazioni/chiudi_segnalazione.php utilizzata appunto alla chiusura di una segnalazione. Il sistema di API del Comune di Genova utilizza endpoint comuni a tutti i servizi che gestiscono l'autenticazione e reindirizzando ai singoli webservice (nel caso specifico ai webservice SOAP delle manutenzioni sviluppati da Goadev srl
Come illustrato nel manuale utente l'accesso all'applicazione emergenze è consentito con
- il sistema SPID per gli utenti esterni
- il sistema di autenticazione dell'ente per utenti interni La gestione dell'autenticazione è garantita dal sistema SIRAC SSO che è definito tra i service provider SPID (https://registry.spid.gov.it/service-providers)
Noto il CF dell'utente il sistema verifica in una tabella del DB PostgreSQL l'appartenenza dell'utente tra quelli di sistema.
Il CF viene passato nel request header e viene controllato dal file pages/check_evento.php (https://github.com/ComuneDiGenova/emergenze-pcge/blob/dbdb9f4911d9032b4c3b60712d98018f2e13a64e/pages/check_evento.php#L212)
Come si può vedere dal file .gitignore ci sono alcuni file con dati sensibili che non sono parte del presente repository e vanno ricreati manualmente per far funzionare il sistema:
- conn.php :contiene le credenziali di accesso al DB
<?php
$conn = pg_connect("host=127.0.0.1 port=5432 dbname=emergenze user=XXXXXX password=XXXXXXX");
if (!$conn) {
die('Could not connect to DB, please contact the administrator.');
}
?>
- pages/eventi/conn.py
#credenziali DB
ip='127.0.0.1'
db='emergenze'
user='XXXXXX'
pwd='XXXXXX'
port='5432'
- pages/eventi/conn_mssql.py
#! /usr/bin/env python
# -*- coding: utf-8 -*-
#creadenziali DB Comune sensoristica
server='XXXXXXXXXXXX'
user='XXXXXX'
password='XXXXXX'
database='XXXXXX'
- pages/eventi/config.py
- pages/eventi/forever_conf.py
- pages/incarichi/credenziali_mail.php
<?php
$mail->Host = $mail_smtp;
//Set the SMTP port number - likely to be 25, 465 or 587
$mail->Port = XX;
//We don't need to set this as it's the default value
//$mail->SMTPAuth = false;
$mail->CharSet = 'UTF-8';
?>
- pages/incarichi_interni/credenziali_mail.php
<?php
$mail->Host = $mail_smtp;
//Set the SMTP port number - likely to be 25, 465 or 587
$mail->Port = XX;
//We don't need to set this as it's the default value
//$mail->SMTPAuth = false;
$mail->CharSet = 'UTF-8';
?>
- pages/sopralluoghi/credenziali_mail.php
<?php
$mail->Host = $mail_smtp;
//Set the SMTP port number - likely to be 25, 465 or 587
$mail->Port = XX;
//We don't need to set this as it's the default value
//$mail->SMTPAuth = false;
$mail->CharSet = 'UTF-8';
?>
- pages/provvedimenti_cautelari/credenziali_mail.php
<?php
$mail->Host = $mail_smtp;
//Set the SMTP port number - likely to be 25, 465 or 587
$mail->Port = XX;
//We don't need to set this as it's the default value
//$mail->SMTPAuth = false;
$mail->CharSet = 'UTF-8';
?>
- pages/token_telegram.php
<?php
$bot_name="XXXXXXXXXXXXXXXXXXXXXXXXX";
// token gesteremert bot
$token = "XXXXXXXXXXXXXXXXXXXXXXXXX";
// token convocazione coc bot
$tokencoc = "XXXXXXXXXXXXXXXXXXXXXXXXX";
$link="https://gestemert.comune.genova.it/emergenze/";
?>
- pages/segnalazioni/token_api_ge.py
#! /usr/bin/env python
# -*- coding: utf-8 -*-
# Gter copyleft 2020
url = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
token='XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' # TEST
IdSegnalante='XXXXXX' # test
- pages/segnalazioni/conn.py
#credenziali DB
ip='127.0.0.1'
db='emergenze'
user='xxxxxxxxxx'
pwd='xxxxxxxx'
port='5432'
- pages/segnalazioni/conn_mssql.py
#! /usr/bin/env python
# -*- coding: utf-8 -*-
#credenziali DB valide per DB manutenzioni
server='xxxxxxxxxxxxx'
user='xxxxxxxxxxxx'
password='xxxxxxxxxx'
database='xxxxxxxxxxxx'
- Amministrazione proprietaria: Comune di Genova
- Soggetto incaricato al mantenimento: Gter srl
- Contatto e-mail referente di progetto (per segnalazioni e richiesta informazioni): roberta.fagandini@gter.it
- Contatto e-mail presso l'amministrazione: applicazionisit@comune.genova.it
- Gestione segnalazioni: tramite issues github
La prima versione stabile è stata creata nel giugno 2020 all'atto dell'inserimento del SW nel catalogo del riuso.
Altri tag possono essere creati su singoli commit da linea di comando con il seguente comando
git tag -a vX.X.X Commit_number -m "Messaggio"
git push origin vX.X.X
Il progetto è stabile al netto di continue migliorie e bug detection che sono possibili attraverso l'uso dell'ambiente in produzione presso la Protezione Civile del Comune di Genova
This web page was developed starting from Start Bootstrap - SB Admin 2
SB Admin 2 is an open source, admin dashboard template for Bootstrap created by Start Bootstrap.
which use the following license: Copyright 2013-2018 Blackrock Digital LLC. Code released under the MIT license.
Start Bootstrap was created by and is maintained by David Miller, Owner of Blackrock Digital.
Start Bootstrap is based on the Bootstrap framework created by Mark Otto and Jacob Thorton.
Gter srl change the license to GPL v.3 (see license file attached)
This work is financed by PON Metro 2014-2020 funding.